BDD Workshop App

BDD (Behaviour Driven Development) Workshop App fro Rails Conf 2019 "Multi layer BDD for modern rails web apps"

Presentation slides

TL;DR Setup

• clone this repo

  git clone [email protected]:failure-driven/bdd-workshop-app.git
  

• get it up and running (Quick start install)

  make
  make start
  

  • failing that try the Manual install

• Install Kahoot for interactive review and surveys

• Documents

  • Course Outline
  • Theme - Women who created programming languages
  • Glossary

Quick start install

                        # clone repo
git clone [email protected]:failure-driven/bdd-workshop-app.git

cd bdd-workshop-app     # open directory

make                    # check versions,
                        # install libs,
                        # runs tests

make start              # startup database
                        # to run the app rails server
bin/webpack-dev-server  # for faster ReactJS compilation

Note: Make sure to pull this repo closer to the date of the workshop, like the day before 😉

Kahoot

Install Kahoot for interactive review and surveys during the workshop.

• App Store
• Google Play

---

Manual install

• clone the repository

  git clone [email protected]:failure-driven/bdd-workshop-app.git
  

• change directory into bdd workshop app

  cd bdd-workshop-app
  

• check you have node 10.15.3 installed

  node -v
  

  • try homebrew?

  brew install node@10
  

  • check you have yarn installed

  yarn -v
  

  • install node dependencies

  yarn install
  

• check you have ruby 2.6.2 installed

  ruby -v
  

  • install bundler gem

  gem install bundler
  

  • install gems
    • dependent on having postgresql installed (brew install postgresql)
    • dependant on having relatively new Chrome installed

  bundle
  

• chrome and chromedriver will be required for bundle to install successfully TODO more info

• postgresql install using homebrew

  brew info postgresql
  brew services list
  psql -V

• check you have postgresql running

  psql --list     # list out databases
  

• create and migrate your database

  bundle exec rails db:create db:migrate
  

• run the specs

  bundle exec rspec spec
  

• run the rails development server

  bundle exec rails server
  

• run the webpacker dev server

  bin/webpack-dev-server
  

• visit the development server

  • http://localhost:3000

• run the tests

  bin/full-build
  

  • or if there is no internet but dependencies have been installed

    NO_INTERNET=true ./bin/full-build
    

  • if you want to rubocop and lint

    PRETTY_CODE=true NO_INTERNET=true bin/full-build
    

asdf

Somewhat experimental script to install asdf that will manage ruby, nodejs as stipluated in .tool-versions file. Will also install PostgreSQL

make asdf_install

which runs bin/asdf-install

also may want to add to your shell as per asdf install instructions

echo -e '\n. $HOME/.asdf/asdf.sh' >> ~/.bash_profile
echo -e '\n. $HOME/.asdf/completions/asdf.bash' >> ~/.bash_profile

docker

TODO ...

Show the slides

make slides

slides are located in docs/slides/deck.mdx using mdx-deck

Docker

TODO

ORIGINAL RAILS README

This README would normally document whatever steps are necessary to get the application up and running.

Things you may want to cover:

• Ruby version

• System dependencies

• Configuration

• Database creation

• Database initialization

• How to run the test suite

• Services (job queues, cache servers, search engines, etc.)

• Deployment instructions

• ...