Self replicating GitHub repository

This project forks an existing repository on behalf of a user authorized with GitHub OAuth. It doesn't require access to a user's private repositories since it only requests access to the public_repo scope.

To set this up on your own system, you'll need to create a new OAuth app on GitHub, and use it's client_id and client_secret. Follow these instruction if you need help: https://developer.github.com/apps/building-oauth-apps/creating-an-oauth-app/.

The "Authorization callback URL" will need to be set to the full callback URL for your environment. If you are testing on your local machine using the instructions below, this will be http://localhost:5000/callback.

Demo

Try it out here: https://replicate.jitb.tk/

Technical specification

See docs/SPEC.md

Prerequisites

These instructions were tested on Debian 9, with Python 3.5 and virtualenv installed. If you don't have Python 3.5 or virtualenv installed, run this:

sudo apt-get install python3 virtualenv

Running

You can run this one your local system by running the following.

git clone https://github.com/natruiz3555/replicate.git
cd replicate
virtualenv -p python3 venv
. venv/bin/activate
pip install -r requirements.txt

export GITHUB_CLIENT_ID=<your_github_client_id>
export GITHUB_CLIENT_SECRET=<your_github_client_id>
export GITHUB_REPO=natruiz3555/replicate # Or another repository of your choice.

python replicate/app.py

Then just point your browser to http://localhost:5000/.

Building package for AWS Lambda

Follow these steps to produce a AWS Lambda zip package:

git clone https://github.com/natruiz3555/replicate.git
cd replicate

# This gets around issues with pip --target on Debian based systems.
# See https://github.com/pypa/pip/issues/3826 for more info.
virtualenv -p python3 venv
. venv/bin/activate

# Build the lambda zip.
pip install --target package .
cp lambda_function.py package/
chmod -R 755 package/
cd package/
zip -r9 ../function.zip .