Skip to content

Quick application to aggregate/display milestones across multiple github repositories (and organizations, if desired)

License

Notifications You must be signed in to change notification settings

IQSS/milestone-reader

Repository files navigation

milestone-reader

Mini project to read/aggregate milestones from several github repositories so that they may be presented on one page. Live example: (http://roadmap.iq.harvard.edu/)

Setup

Initial Install.

(Assumes virtualenvwrapper)

git clone git@github.com:IQSS/milestone-reader.git
cd milestone-reader
mkvirtualenv milestones
pip install -r requirements/local.txt

Create file with GitHub personal access tokens

  1. Create a file name github_api_secrets.json and take proper care of it
cd ~/milestone-reader/milestone_reader/milestone_reader/settings
cp github_api_secrets_template.json github_api_secrets.json
  1. Open the newly created (copied) github_api_secrets.json
  2. For each of your repositories, add the name and an appropriate GitHub Api Token
    • If you have api read access to several repositories under one organization, you may only need one API token, but it will be repeated for each repository.

Create the database and run the server (development mode example)

cd milestone_reader
python manage.py syncdb --settings=milestone_reader.settings.local
python manage.py runserver --settings=milestone_reader.settings.local

Add your repositories

  1. Navigate to http://127.0.0.1:8000/milestone-reader-admin
  2. Enter an organization http://127.0.0.1:8000/milestone-reader-admin/repositories/organization/add/
  3. Enter a repository http://127.0.0.1:8000/milestone-reader-admin/repositories/repository/add/

Retrieve the milestones

cd ~/milestone-reader/milestone_reader/apps/milestones/
python milestone_retriever.py
  • Example of Milestones listed in the admin retrieved milestones

View the milestones (basic template)

Notes

About

Quick application to aggregate/display milestones across multiple github repositories (and organizations, if desired)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published