Develop and run your Python applications in clean Docker environments Cage aims to be as easy to use and as familiar as possible.
- Docker
- Python 3.5+
$ pip install pycage NOTE: Docker should be running before using any of the Cage commands. All commands should be run from your project directory!
$ cage app:create <name_of_your_cage>This command will create a new Dockerfile in the root your project and initialize all the necessary environment files.
$ source <name_of_your_cage>/bin/activateThis command should be very familiar to virtualenv users. This adjusts your environment to make sure you use the caged python binaries.
(<name_of_your_cage>)$ python <file.py>Running a script with the caged python binary will build a new Docker image with your project files, create a new container using that image and run the python command you specified.
The current version of Cage only supports dependencies written in a requirements file:
(<name_of_your_cage>)$ pip install -r requirements.txtYou cannot use any other pip commands with this version. This includes simple pip install commands like:
(<name_of_your_cage>)$ pip install <dependency>(<name_of_your_cage)$ deactivateThis will return your environment to the state it was in before activating the Cage environment.
- THIS IS A WORK IN PROGRESS. DO NOT USE THIS IF YOU DON'T KNOW WHAT YOU ARE DOING
- You can only use pip with a requirements file. No other pip commands are supported.
- No ports are exposed from the docker container at the moment
- Environment variables are not sent to the docker container
Cage is released under the MIT license. See LICENSE for details.
Follow me on twitter @mcostea