The ConfigMe Configuration Generation Framework and Utility¶
ConfigMe is a small, fast, down-to-earth, open source configuration generation framework and command line utility. It makes generation of real-world configuration files and deployment more fun, more predictable, and more productive.
What Problem Does ConfigMe Solve For You?¶
Whether used in production, staging or development the majority of the configuration files are usually 95% to 99% identical and it can prove time consuming and error-prone to maintain them in sync.
ConfigMe solves this problem for you.
Narrative Documentation¶
- Tutorial
- Installation
- Defining The Problem
- Configuration Folder Skeleton
- Create etc/nginx/nginx.conf template
- Create etc/nginx/sites-available/my-site.conf template
- Add development Role Settings
- Add production Role Settings
- Resulting Configuration Skeleton
- Generate development Configuration
- Generate production Configuration
- Resulting Configuration Sets
- What’s Next?
- Usage
Support and Documentation¶
How it Works¶
ConfigMe is written in Python, uses Jinja2 for templates and INI files for settings configuration. Support for Django, Mako and other templates is planned.
Current Project Status¶
Project is still in development at 90% completion. That means it works but there no guarantees it won’t break. The names, command-line options and code interfaces may change so backward compatibility is currently not guaranteed.
Test Coverage¶
Current unit test stats:
Line Coverage (nosexcover*): | 100% |
Number of unit tests: | 84 |
* nosexcover: http://pypi.python.org/pypi/nosexcover
Source Code¶
Source code is located on GitHub: http://github.com/goodwillcoding/configme
API¶
API will be available at a later date when the implementation stabilizes.
License¶
ConfigMe is offered under the BSD-derived Repoze Public License.