/csh-rideboard

New ride board for CSH.

Primary LanguageHTMLMIT LicenseMIT

RideBoard

RideBoard is CSH service that allows the members to carpool, allowing those that do not have a car to participate in events.

Build Status License Contributions welcome

Contributing

All contributors are welcome! If you would like to contribute:

Dependencies

  1. You will need python3 (Install Guide).
  2. You will need pip (Install Guide).
  3. And lastly you will need to install virtualenv by running pip install virtualenv.

Setup

  1. Fork this repo and clone it locally by running git clone https://github.com/<your_username>/rideboard.git
  2. cd rides/
  3. Create a python virtual environment, activate it and install requirements.
  • virtualenv rides-venv
  • source rides-venv/bin/activate
  • pip install -r requirements.txt
  1. You will need the LDAP DN, LDAP PW, MySQL Databse, and OIDC Secret. You can create your own if you are hosting your own application or ask me for these if you would like to contribute to CSH.
export SERVER_NAME=127.0.0.1:8080
export IP=127.0.0.1
export PORT=8080
export SQLALCHEMY_DATABASE_URI=postgresql://<LDAP DN>:<LDAP PW>@<MySQL Database>
export OIDC_CLIENT_SECRET=<OIDC Secret>
  1. To run the application:
  • Set debug mode: export FLASK_ENV=development
  • Export application: export FLASK_APP=app.py
  • Run: flask run
  1. Now you can make your changes. Make sure the changes made work and that your code passes pylint (run pylint rides/). Once you do that you can make your pullrequest.