Skip to main content

Python 3 project development tools

Project description

Python 3 project development tools. Looks like a turtle, tastes like chicken.

Chicken Turtle provides tools (CLI) for developing Python 3 projects.

Chicken Turtle is pre-alpha. None of the interface is stable, i.e. it may change in the future.


Tests must be placed in $project_name.test or subpackages. Tests are run with py.test from the project root.

Package data can be provided by placing a directory named data in the package with the data files, but no as that would turn the data directory into a package.

Simply include test dependencies in install_requires.

ct-mksetup should be run before any commit and deployment. For the latter, call ct-mksetup in your deploy scripts.

Chicken Turtle Project does not enforce a particular methodology for deployments, but we recommend shell scripts for simple deployments as they don’t have dependencies (assuming you only deploy to unix-like machines). If you need to do more complex work such as migrating data to a new database structure, include a Python script and call it from the shell script after having made the venv.

When making dependency in editable (e.g. -e path/to/setup_dir), leave the original dependency as a comment so you remember the previous version constraint when you change it back at release (though you likely need to require the version with the changes you made)

Versions should adhere to PEP-0440 and use semantic versioning. Versions are only set on release, via an argument to ct-release. ct-release then adjusts with the new version, commits and tags the commit with its version (prefixed with ‘v’). At all other times, the version in is set to 0.0.0, use commit ids instead of versions in this case.

Old notes (TODO rm)

  • create a virtual environment corresponding to If requirements.txt exists, that list of packages will be installed. If extra_requirements.txt exists (corresponding to the extra dependencies in, these will also be installed. Then’s deps are installed, without upgrading any other packages.

  • start an interpreter inside the virtual environment, ensuring the project source is in the PYTHONPATH and start an interactive session in which is first executed.

  • test data should be placed in test/data

  • output of last test runs is kept in test/last_runs

  • to run the tests, but you need to run it from withing the venv (i.e. . venv/bin/activate before running this)

See also

Python packaging recommendations:

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

chicken_turtle_project-1.0.0.dev2.tar.gz (21.0 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page