Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file lib/central/support
. To experiment with that code, run bin/console
for an interactive prompt.
This is a library that moves away some of the logic from Central so we can reuse in other projects. Particularly the Iteration calculation.
Add this line to your application's Gemfile:
gem 'central-support'
And then execute:
$ bundle
Or install it yourself as:
$ gem install central-support
This library expects a very specific set of pre-existing models (Team, Project, Story, User, Activity, Enrollment, Membership, and Ownership).
They are all models that exist in Central and they must also follow a specific database schema.
If you want to use this library in another application, refer to the spec/support/rails_app/
so you know exactly how your new app should look like.
The application that links against this library must add the main models manually: Team, User, Project, Story, Note, Activity, and the many-to-many relationships, Membership, Enrollment, and Ownership. Again, refer to the spec dummy app example on how to do that.
This gem is not intended to have generators of any kind, just easily includable modules (Concerns), and helper libraries for the core of Central.
After checking out the repo, run bin/setup
to install dependencies. Then, run rake spec
to run the tests. You can also run bin/console
for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install
. To release a new version, update the version number in version.rb
, and then run bundle exec rake release
, which will create a git tag for the version, push git commits and tags, and push the .gem
file to rubygems.org.
To setup the gem with docker you can execute the following steps:
cp spec/support/rails_app/config/database.yml.sample spec/support/rails_app/config/database.yml
docker-compose build
docker-compose up
This will build the image and start the postgres and the app container. The app container will keep running with a tail -f /dev/null
command, since the gem doesn't run with a server, like an traditional rails app.
To execute the tests you can run (in other shell, while the container is up) the command:
docker-compose exec app rspec
Bug reports and pull requests are welcome on GitHub at https://github.com/Codeminer-42/central-support.
The gem is available as open source under the terms of the LGPL License.