[![ZenHub] (https://raw.githubusercontent.com/ZenHubIO/support/master/zenhub-badge.png)] (https://zenhub.io)
This is the Montreal.rb organization's website. It is still in development stage so you are welcome to contribute.
- ruby 2.2.3
- Postgresql 9.3+
Fork the repository and clone it to your machine. Then change directory to Montreal.rb
$ git clone <your_fork> && cd Montreal.rb
You should have Ruby version 2.2.3
installed using your prefered Ruby version management tool (or by globally updating your system Ruby)
Most Popular Ruby Version Managers
Do you have Postgres installed?
$ postgres --version
Postgresql 9.3
For the next parts, you need Postgresql installed, configured and running and a
.pgpass
file in your home directory. The content of that file should look like:
# hostname:port:database:username:password
localhost:5432:*:sdeziel:myverysecurepassword
$ brew install postgresql
You should check out Ruby on Rails' guides if you are not familiar with the framework : http://guides.rubyonrails.org/
$ bin/setup
IMPORTANT: pg
gem installation error
If you experience an error during the execution of that script related to the installation of the pg
gem,
you might want to try the following procedure:
$ sudo find / -name "pg_config"
# Use the most appropriate path found by the command above
$ gem install pg -- --with-pg-config=<your_pg_config_path>
$ bin/setup
Once successfully completed, this setup script will:
- install
bundler
for managing your gem dependencies - install your project's required gems
- create and setup your database
- cleanup logs and temporary files
You should be ready to start your webserver using:
$ bin/rails server
By default, your application is accessible at http://localhost:3000 in your browser.
RSpec is used to test the application. You can run all the tests using
$ bin/rspec
or you can run a specific test file (example 1), or a single test (example 2, 17 is the line number of your test)
$ bin/rspec spec/path/to/your/file.rb # example 1
$ bin/rspec spec/path/to/your/file.rb:17 # example 2
You can also use guard to test automatically when you save a file
$ bundle exec guard
PROTIP: install ctags and guard will automatically generate an index (or tag) file of language objects found in source files that allows these items to be quickly and easily located by a text editor.
- ex: macos
brew install ctags && sudo mv /usr/bin/ctags /usr/bin/ctags.bak
- ex: ubuntu
sudo apt-get install exuberant-ctags
This application is automatically deployed to heroku after a successful Travis CI build of the master branch.
- The heroku url is: https://montreal-rb.herokuapp.com/
- The official url is: https://montrealrb.com/
If you find any bug, please open an issue in the project's Github repository (https://github.com/montrealrb/Montreal.rb/issues)
Please see CONTRIBUTING.md.
Everyone interacting in Montrealrb.com and its sub-projects' codebases, issue trackers, chat rooms, and mailing lists is expected to follow our code of conduct.
montrealrb.com is released under the MIT License.