Codelocks
A simple gem to wrap the Codelocks NetCode API, for generating key codes to operate their physical locks.
API Versions
If you are using an API version prior to v4.1, you need to use the latest v1 release of this gem. v2 is a large rewrite in order to support the new API.
Installation
Add this line to your application's Gemfile:
gem 'codelocks'
And then execute:
$ bundle
Or install it yourself as:
$ gem install codelocks
Usage
Configure your API credentials, either by setting the following two environment variables:
CODELOCKS_BASE_URI
CODELOCKS_API_KEY
CODELOCKS_ACCESS_KEY
Or by setting them directly in Ruby:
Codelocks.base_uri = "http://something.com"
Codelocks.api_key = "blargh"
Codelocks.access_key = "argh"
API documentation with information on methods is available on RubyDoc.info.
Tests
The test suite can be run locally using the following commands:
$ cp .env.test .env
$ dotenv
$ bundle exec rspec
Contributing
- Fork it ( https://github.com/[my-github-username]/codelocks/fork )
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create a new Pull Request