You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
dockerctx is a context manager for managing the lifetime of a docker container.
The main use case is for setting up scaffolding for running tests, where you want
something a little broader than unit tests, but less heavily integrated than,
say, what you might write using Robot framework.
Install
$ pip install dockerctx
The development-specific requirements will be installed automatically.
Demo
This is taken from one of the tests:
importtimeimportredisimportpytestfromdockerctximportnew_container# First make a pytest fixture@pytest.fixture(scope='function')deff_redis():
# This is the new thing! It's pretty clear. The `ready_test` provides# a way to customize what "ready" means for each container. Here,# we simply pause for a bit.withnew_container(
image_name='redis:latest',
ports={'6379/tcp': 56379},
ready_test=lambda: time.sleep(0.5) orTrue) ascontainer:
yieldcontainer# Here is the test. Since the fixture is at the "function" level, a fully# new Redis container will be created for each test that uses this fixture.# After the test completes, the container will be removed.deftest_redis_a(f_redis):
# The container object comes from the `docker` python package. Here we# access only the "name" attribute, but there are many others.print('Container %s'%f_redis.name)
r=redis.StrictRedis(host='localhost', port=56379, db=0)
r.set('foo', 'bar')
assertr.get('foo') ==b'bar'
Note that a brand new Redis container is created here, used within the
context of the context manager (which is wrapped into a pytest fixture
here), and then the container is destroyed after the context manager
exits.
In the src, there is another, much more elaborate test which
runs a postgres container;
waits for postgres to begin accepting connections;