Ruby HTML JavaScript CSS Gherkin
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
models Add a toggle for showing archived cards in analysis (#50) Jan 17, 2017
public Updating site with Patreon information (#66) Feb 19, 2018
routes Upgrade to sinatra and ruby-trello 2.0.0 Jan 30, 2018
test Only getting 300 cards at a time based on new API requirements Apr 27, 2018
utils Only getting 300 cards at a time based on new API requirements Apr 27, 2018
views Updating site with Patreon information (#66) Feb 19, 2018
.gitignore Uglify the javascript and move to bottom of page; also add Grunt for … Oct 15, 2015
.ruby-version Update ruby, gems, and server (#57) Oct 13, 2017
.travis.yml Update ruby and gems (#45) Sep 15, 2016
CONTRIBUTING.md Update CONTRIBUTING.md Feb 11, 2015
Gemfile Upgrade to sinatra and ruby-trello 2.0.0 Jan 30, 2018
Gemfile.lock Upgrade to sinatra and ruby-trello 2.0.0 Jan 30, 2018
Gruntfile.js Uglify the javascript and move to bottom of page; also add Grunt for … Oct 15, 2015
LICENSE Adding LICENSE Jan 29, 2015
Procfile Update ruby, gems, and server (#57) Oct 13, 2017
README.md Update README Jan 26, 2018
Rakefile Updating site with Patreon information (#66) Feb 19, 2018
config.ru moving some middleware into a configure production block Sep 22, 2014
helpers.rb expose the board name as the title for board details Mar 20, 2015
mongoid.yml updating gems Sep 25, 2015
package.json Uglify the javascript and move to bottom of page; also add Grunt for … Oct 15, 2015
puma.rb Update ruby, gems, and server (#57) Oct 13, 2017
testem.json including new version of jquery in testem files Feb 4, 2016
web.rb Upgrade to sinatra and ruby-trello 2.0.0 Jan 30, 2018

README.md

Ollert

Description

Ollert is a data analysis tool for Trello.

Browser Support

Since Ollert depends entirely on Trello for users, Ollert will support only browsers supported by Trello. Trello officially supports the following browsers:

  • Chrome - Current stable release
  • Safari - Version 6.0 or higher
  • Firefox - Current stable release
  • Internet Explorer - Version 10.0 or higher

Development

You almost certainly want to be using a Unix-based operating system. Some dependencies will be necessary before you can run the application. On Ubuntu:

# sudo apt-get install libxslt-dev libxml2-dev build-essential libqtwebkit-dev

Note: You may need more packages. If you do, please edit this document and add them to the command above.

Requirements

In the project root folder, you should:

  • bundle install
    • Installs the required ruby gems
  • npm install
    • Installs the required node packages
  • npm install -g grunt-cli
    • Installs the grunt-cli.

Create a file called .env in the root project folder. The format of the .env file is simply:

ENVIRONMENT_VARIABLE=This is the value
ANOTHER_VARIABLE=Another value

Environment variables:

  • PUBLIC_KEY
  • TRELLO_TEST_DISPLAY_NAME
    • required
    • Display name to use while running cukes (this is your @<username> from Trello)
  • TRELLO_TEST_USERNAME
    • required
    • Username to use while running cukes
  • TRELLO_TEST_PASSWORD
    • required
    • Password to use while running cukes
  • MEMBER_TOKEN
    • required
    • this value is used to run the integration tests. To generate this value after you have entered your PUBLIC_KEY run the following command and paste the result into your .env file where it asks you to: rake test:setup
  • SESSION_SECRET
    • optional
    • Any string
  • RACK_ENV
    • optional
    • You should set this to development. Other options include testing and production.

Run rake to start the application on localhost:4000. This will fork two processes: a rack server (probably unicorn) and grunt watch (to constantly compile and minify Sass and javascript files).

All tests must pass before pushing to origin/master.

Testing

All changes checked in to origin/master must be tested. There are two types of test: spec (unit tests) and cukes (acceptance tests).

To run the spec tests, use rake test:spec.

To run the cukes, use rake test:cukes. Cukes are run using the TRELLO_TEST_USERNAME. At least one test will fail if you have the improper boards. Create an organization "Test Organization 1" on Trello. Under "Test Organization", create two boards: "Test Board #1" and "Test Board #2". Additionally, create a general board called "Empty Board" and verify that the default "Welcome Board" is still visible to you. If "Welcome Board" is no longer available, you can simply create a new "Welcome Board" without any organization.

To run all tests, use rake test:all.

testem

The JavaScript specs use testem as the test runner. By default the tests will try to use PhantomJS as the browser for the JavaScript specs. To install, PhantomJS needs to be part of your path. To install using Homebrew on OSX run the following command:

brew install phantomjs

CI

Travis CI is being used for CI. For clones of this repository, builds will run in your https://travis-ci.org/<your username>/ollert environment. Since the tests depend on the environment variables mentioned above, those also need to be carried over in your individual Travis CI setup. Please look at the documentation for environment variables for more information about setting up your environment variables.

Contributing

We want your help! Check out CONTRIBUTING.md for advice on making contributions.