This repo is for testing the capabilities of Bluemix DevOps Insights. The intent is to understand what metrics can be gathered and analysed about a GitHub repository.
The sample code is using Flask microframework and is intented to test the Python support on IBM's Bluemix environment which is based on Cloud Foundry. It also uses Redis as a database for storing JSON objects.
One of my favorite quotes is:
“If it's worth building, it's worth testing. If it's not worth testing, why are you wasting your time working on it?”
As Software Engineers we need to have the discipline to ensure that our code works as expected and continues to do so regardless of any changes, refactoring, or the introduction of new functionality.
This repo introduces Test Driven Development using PyUnit and nose. It also introduces Behavior Driven Development using Behave as a way to define Acceptance Tests that customer can understand and developers can execute!
For easy setup, you need to have Vagrant and VirtualBox installed. Then all you have to do is clone this repo and invoke vagrant:
git clone https://github.ibm.com/DevOpsResearch/res-devops-insights.git
cd lres-devops-insights
vagrant up
vagrant ssh
cd /vagrant
You can now run behave and nosetests to run the BDD and TDD tests respectively.
Run the tests using behave
$ behave
Run the tests using nose
$ nosetests
Nose is configured to automatically include the flags --with-spec --spec-color so that red-green-refactor is meaningful. If you are in a command shell that supports colors, passing tests will be green while failing tests will be red.
* ./app/server.py -- the main Service using Python Flask
* ./tests/test_server.py -- unit test cases for the server
* ./tests/test_pets.py -- unit test cases for the model
* ./features/pets.feature -- Behave feature file
* ./features/steps/steps.py -- Behave step definitions
If you want to deploy this example in a Docker container, you can run the tests from the container.
This service requires Redis so first start a Redis container
docker run -d --name redis-service -p 6379:6379 redis:alpine
Next build this repo as a container
docker build -t flask-bdd .
To run nosetests just run it in a container while linking it to the redis-service container that we have running.
docker run --rm --link redis-service flask-bdd nosetests
To run behave tests we need an instance of our service running so it takes two docker commands, one to run our service and another to run the behave tests
docker run -d --name flask-service --link redis-service -p 5000:5000 flask-bdd
docker run --rm --link flask-service -e BASE_URL="http://flask-service:5000/" flask-bdd behave
Notice how we injected the URL of the running service into our container running the behave tests using an environment variable in keeping with 12-factor configuration recommendations.
To bring down these services use:
docker stop flask-bdd
docker stop redis-service
...and to remove them with:
docker rm flask-bdd
docker rm redis-service