A simple fizz-buzz REST server implementation.

This fizz-buzz implementation exposes a REST API that accepts five parameters: three integers int1, int2 and limit and two strings str1 and str2. The API returns a list of strings with numbers from 1 to limit, where: all multiples of int1 are replaced by str1, all multiples of int2 are replaced by str2, all multiples of int1 and int2 are replaced by str1str2.

The application also exposes a statistics endpoint allowing users to know what the most frequent request has been.

Take a look at this working example for more details.

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

In order to get the development environment up and running you need to have docker and docker-compose installed. You can find a detailed list of instructions in the official documentation page depending on your OS and distribution.

git clone https://github.com/jflbr/fizz-buzz.git

Installing your development environment is a matter of running a single command line at the root of the application folder.

docker-compose build

Under the hood, this will build the application's image (from the Dockerfile within the root folder) and link it to a Postgres image; the only external dependency we have here. The docker image build installs Python dependencies specified in the Pipfile file. This is the place to put any dependency you might need for the application. This will also mount a volume that will enable both your host machine and containers to share the application files. So any change made in your IDE will be available in the application container.

Following explains how to run the automated tests of the application.

docker-compose run test

# with the coverage report
docker-compose run --rm test pytest --cov=service tests/units/

# without the coverage
docker-compose run --rm test pytest tests/units/

# specific unit tests module
docker-compose run --rm test pytest tests/units/test_helpers_fizzbuzz.py

# specific unit test case
docker-compose run --rm test pytest tests/units/test_helpers_fizzbuzz.py::TestFizzBuzzHelpers::test_hash_fizzbuzz_request

# with the coverage report
docker-compose run --rm test pytest --cov=service tests/interface/

# without the coverage
docker-compose run --rm test pytest tests/interface/

# specific interface tests module
docker-compose run --rm test pytest tests/interface/test_fizzbuzz.py

# specific interface test case
docker-compose run --rm test pytest tests/interface/test_fizzbuzz_statistics.py::test_empty_fizzbuzz_statistics

docker-compose run --rm test black --check

docker-compose run --rm test black .

You can run the application locally with the following command:

docker-compose up fizz-buzz

This command will run the service and make it available at http://localhost:8080 .

Before using the local instance of the service, you might need to apply the application migrations if this is the first time you run that command or if you made some database schema changes.

You can run the migrations as follows

docker-compose up migrate

Or like this:

docker-compose run --rm test alembic upgrade head

The application embeds an OpenAPI documentation. After running the application, the OpenAPI documentation will be available at http://localhost:8080/api/1/doc.

The online (staging) version is available at https://rest-fizz-buzz.herokuapp.com/api/1/doc

The application CI pipeline is managed by Travis CI and the job history is available here.

The CI pipeline currently includes two stages: script and deploy.

This stage checks the code formatting with black, runs all the tests and display the code coverage.

This stage triggers a deployment of the application on Heroku if the current branch being qualified in the CI is the master branch. The deployed application will be available at https://rest-fizz-buzz.herokuapp.com and its OpenAPI documentation at https://rest-fizz-buzz.herokuapp.com/api/1/doc