diff options
| author | Luc Donnet | 2018-03-01 12:46:01 +0100 | 
|---|---|---|
| committer | Luc Donnet | 2018-03-01 12:46:08 +0100 | 
| commit | 95bee6879b59eb4707f16b393863316516badc6e (patch) | |
| tree | 020b7272e377c4fa38f7e585b12f9f17a19a792f | |
| parent | c79c90e875274828bdebf3ea8e2182670f195b32 (diff) | |
| download | chouette-core-95bee6879b59eb4707f16b393863316516badc6e.tar.bz2 | |
Update INSTALL.md with last changes
| -rw-r--r-- | INSTALL.md | 146 | 
1 files changed, 32 insertions, 114 deletions
| diff --git a/INSTALL.md b/INSTALL.md index e44b072f4..392ef5d9f 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -8,6 +8,17 @@ Example with [rvm](https://rvm.io/) (other solutions : rbenv, packages..):  rvm install 2.3.1  ``` +Nokogiri on macOS + +http://www.nokogiri.org/tutorials/installing_nokogiri.html tells us that `xz` can cause troubles, here is what to do + +``` +brew unlink xz +gem install nokogiri # or bundle install +brew link xz +``` + +  ## Node and Yarn  Yarn needs node. If you use Node Version Manager [NVM](https://github.com/creationix/nvm)  you can rely on the content of `.nvmrc`. Otherwise please make sure to use a compatible version, still best to use the same as indicated by `.nvrmc`. @@ -15,7 +26,7 @@ Yarn needs node. If you use Node Version Manager [NVM](https://github.com/creati  * Install node  ```sh -nvm install 6.12.0 +nvm install 6.13.0  ```  * Install [yarn](https://yarnpkg.com/lang/en/docs/install/) @@ -36,41 +47,6 @@ sudo apt-get update && sudo apt-get install yarn  yarn install  ``` -### Installation Caveats - -#### Node Related Issue, libv8 - -`libv8` might cause you troubles, depending on your local configuration. If you have `libv8` installed (probably because of `node.js`) you might need to tell bundler/Rubygems to use the system version. - -```sh -bundle config build.libv8 --with-system-v8 -bundle -``` - -or - -```sh -gem install libv8 -v '<version>' -- --with-system-v8 -bundle -``` - -You will get the correct value of `<version>` from bundler's error message. - -#### Node Related Issue, therubyracer - -Even after `libv8` installation working, the gem `therubyracer` might not like the `libv8` version chosen. - -In that case however we can let the gem make its own choice: - -```sh -gem uninstall libv8 -gem install therubyracer -v '<version>' -``` - -The version to be installed is indicated in the error message bundler gave us in the first place. - -This will install an appropriate `libv8` version and we can continue with `bundle`. -  ## Postgres  ### Create user @@ -89,53 +65,12 @@ When promted for the password enter the highly secure string `chouette`.  As documented [here](https://github.com/dryade/georuby-ext/issues/2) we need some more libs before we can start the `rake` setup tasks. -  On mac/OS :  ```sh  brew install postgis  ``` -<<<<<<< HEAD -### Authentication - -See `config.chouette_authentication_settings`. - -Use the database authentication or get an invitation to [STIF Portail](http://stif-portail-dev.af83.priv/). - -### Run seed - -Run : - -      bundle exec rake db:seed - -Two users are created : stif-boiv@af83.com/secret and stif-boiv+transporteur@af83.com/secret - -If you have access to STIF CodifLigne and Reflex : - -      bundle exec rake codifligne:sync -      bundle exec rake reflex:sync - -To create Referential with some data (Route, JourneyPattern, VehicleJourney, etc) : - -      bundle exec rake referential:create - -# Troubleshooting - -If PG complains about illegal type `hstore` in your tests that is probably because the shared extension is not installed, here is what to do: - -#### Check installation - -* Run tests - -      bundle exec rake spec -      bundle exec rake teaspoon - -* Start local server - -      bundle exec rails server - -=======  On debian/ubuntu system :  ```sh @@ -156,50 +91,34 @@ Go into your local repository and install the gems  bundle install  ``` -#### Nokogiri on macOS - -http://www.nokogiri.org/tutorials/installing_nokogiri.html tells us that `xz` can cause troubles, here is what to do - -``` -brew unlink xz -gem install nokogiri # or bundle install -brew link xz -``` -  ### Database  #### Create database  ```sh  bundle exec rake db:create db:migrate -RAILS_ENV=test bundle exec rake db:create db:migrate  ``` -#### Load seed datas ->>>>>>> master +#### Use seed + +Run :  ```sh  bundle exec rake db:seed:stif  ``` -#### Synchronise datas with lines and stop areas referentials - -* Launch Sidekiq - -```sh -bundle exec sidekiq -``` +Two users are created : stif-boiv@af83.com/secret and stif-boiv+transporteur@af83.com/secret -* Execute the Synchronization Tasks +#### Synchronize with STIF CODIFLIGNE (Line) and REFLEX (StopArea)  ```sh  bundle exec rake codifligne:sync  bundle exec rake reflex:sync  ``` -**N.B.** These are asynchronious tasks, you can observe the launched jobs in your [Sidekiq Console](http://localhost:3000/sidekiq) +**N.B.** These are asynchronous tasks, you can observe the launched jobs in your [Sidekiq Console](http://localhost:3000/sidekiq) -#### Data in various Apartments (Referentials) +#### Create Referential  To create `Referential` objects with some data (`Route`, `JourneyPattern`, `VehicleJourney`, etc), you need to wait codifligne and reflex jobs finished. And then you can launch : @@ -207,33 +126,32 @@ To create `Referential` objects with some data (`Route`, `JourneyPattern`, `Vehi  bundle exec rake referential:create  ``` -### Check installation +### Run tests -#### Run tests - -#### Rspec +* Rspec (Rails test)  ```sh  bundle exec rake spec -bundle exec rake teaspoon  ``` -If Postgres complains about illegal type `hstore` or `unaccent` in your tests that is probably because the shared extension is not installed, here is what to do: - -      bundle exec rake db:test:purge - -Thanks to `lib/tasks/extensions.rake`. +* Jest (JavaScript tests) -#### Jest (React integration specs) +```sh +grunt jest #to run the whole specs. +grunt #to watch for changes and automatically run corresponding tests. +``` -`grunt jest` to run the whole specs. +### Run -`grunt` to watch for changes and automatically run corresponding tests. +Launch Sidekiq -#### Start local server +```sh +bundle exec sidekiq +```  ```sh  bin/webpack-dev-server // Launch webpack server to compile assets on the fly  bundle exec rails server // Launch rails server  ``` +  You need to have an account on [STIF Portail](http://stif-portail-dev.af83.priv/) to connect to the Rails application. | 
