# Chamber [![Build Status](https://travis-ci.org/thekompanee/chamber.png)](https://travis-ci.org/thekompanee/chamber) [![Code Climate](https://codeclimate.com/github/thekompanee/chamber.png)](https://codeclimate.com/github/thekompanee/chamber) [![Code Climate](https://codeclimate.com/github/thekompanee/chamber/coverage.png)](https://codeclimate.com/github/thekompanee/chamber)

Chamber is the auto-encrypting, extremely organizable, Heroku-loving, CLI-having,
non-extra-repo-needing, non-Rails-specific-ing, CI-serving configuration
management library.

[![TrueFact](https://cloud.githubusercontent.com/assets/285582/4803823/ad8110fa-5e5e-11e4-90d6-59320045a786.png)](https://www.youtube.com/watch?v=NNG1OoH2RwE)

**Our Ten Commandments of Configuration Management**

<img src="https://akiajm7spx4gtbhaxe3qcomhaystacksoftwarearp.s3.amazonaws.com/photos/readmes/ten-commandments.png" align="right" />

1. Thou shalt be configurable, but [use conventions so that configuration isn't
   necessary](https://github.com/thekompanee/chamber/wiki/Basic-Usage#convention-over-configuration)
1. Thou shalt [seamlessly work with Heroku](https://github.com/thekompanee/chamber/wiki/Heroku) or other deployment platforms, where custom
   settings must be stored in [environment variables](https://github.com/thekompanee/chamber/wiki/Environment-Variable-Compatibility)
1. Thou shalt seamlessly work with [Travis CI](https://github.com/thekompanee/chamber/wiki/TravisCI) and other cloud CI platforms
1. Thou shalt not force users to use arcane
   [long_variables_to_keep_their_settings_organized](https://github.com/thekompanee/chamber/wiki/Accessing-Settings)
1. Thou shalt not require users keep a separate repo or cloud share sync [just to
   keep their secure settings updated](https://github.com/thekompanee/chamber/wiki/Encrypting-Your-Settings)
1. Thou shalt not be bound to a single framework like Rails (it should be usable [in
   plain Ruby projects](https://github.com/thekompanee/chamber/wiki/Basic-Usage#in-a-plain-old-ruby-project))
1. Thou shalt have an [easy-to-use CLI](https://github.com/thekompanee/chamber/wiki/Command-Line-Reference) for scripting
1. Thou shalt easily integrate with Capistrano for deployments
1. Thou shalt be [well documented](https://github.com/thekompanee/chamber/wiki/) with full test coverage
1. Thou shalt not have to worry about [accidentally committing secure settings](https://github.com/thekompanee/chamber/wiki/Git-Commit-Hook)

## Full Reference

Visit the [wiki](https://github.com/thekompanee/chamber/wiki)