guard encourages TDD behaviour through development iterations which include continuous testing. Coupling this with spring eliminates the cost of continually loading gems into a fresh environment every time the tests are run.
2.4 KiB
#OSEM
The Open Source Event Manager. An event management tool tailored to Free and Open Source Software conferences.
Install OSEM
You can run rails apps in different modes (development, production). For more information about rails and what it can do, see the rails guides.
Run OSEM in development
- Clone the git repository to the directory you want Apache to serve the content from.
git clone https://github.com/openSUSE/osem.git
- Install all the ruby gems.
bundle install
- Install ImageMagick from your distribution repository
- Copy the sample configuration files and adapt them
cp config/config.yml.example config/config.yml
cp config/database.yml.example config/database.yml
- Setup the database
bundle exec rake db:setup
- Run OSEM
rails server
- Visit the APP at
http://localhost:3000
- Sign up, the first user will be automatically assigned the admin role.
Run OSEM in production
We recommend to run OSEM in production with mod_passenger and the apache web-server. There are tons of guides on how to deploy rails apps on various base operating systems. Check Google ;-)
Documentation
OSEM is extensively (some would say maniacally ;-) documented. You can generate a nice HTML documentation with ''rdoc''
bundle exec rdoc --op doc/app --all -f fivefish app
xdg-open doc/app/index.html
Testing
We are using rspec+capybara+factory girl to build test suite. You should run it continuously when you are developing, via:
bundle exec guard
This uses spring to provide a fast feedback loop for the red/green cycle.