forker.py

#!/usr/bin/env python
"""Usage:
  forker.py [(-v|--verbose) -n <max> --test  --fork --clone  --upstream --old]
            [--locals=<list>  --dir=<dir>]
            [(-t ACCESS_TOKEN|-f ACCESS_TOKEN_FILE) --user=<username>] KEYWORD ...
  forker.py (-h|--help)

Search for Github repositories matching KEYWORDs using Github oAuth specified by ACCESS_TOKEN
or in ACCESS_TOKEN_FILE; optionally fork to the user's Github directory, clone locally, and
add upstream remote.

Arguments:
  KEYWORD             keywords to search Github repositories for

Options:
  -h --help             show this screen.
  -v --verbose          verbose mode
  -n <max>              specify <max> limit of matching repositories
  --test                test mode (no write)
  --fork                fork matching repositories
  --clone               clone matching forked repositories, if they exist
  --upstream            add remote upstream to cloned repos, if they exist
  --old                 add already forked repositories to cloning list
  --locals=<list>       specify file name where names of local repos are listed [default: git_list]
  --dir=<dir>           specify parent <dir> in which to clone repositories [default: .]
  -t ACCESS_TOKEN       specify ACCESS_TOKEN directly, takes precedence over ACCESS_TOKEN_FILE
  -f ACCESS_TOKEN_FILE  specify file in working directory with ACCESS_TOKEN [default: .oAuth]
  --user=<username>     specify user for search (optional)
"""
import time
from docopt import docopt

from githubtools import Githubtool



if __name__ == '__main__':
    arguments = docopt(__doc__)
    KEYWORD = arguments['KEYWORD']
    TEST = arguments['--test']
    VERBOSE = arguments['--verbose']
    USER = arguments['--user']
    MAXNUM = arguments.get('-n', None)
    if TEST or VERBOSE:
        print(arguments)


# Here's our top-level code:

githubtool = Githubtool(VERBOSE,
                        TEST,
                        arguments['--locals'],
                        arguments['--dir'],
                        arguments['-f'],
                        arguments['-t'])

repos = githubtool.search_github_repos(KEYWORD, USER, MAXNUM)

if arguments['--fork']:
    forked_repos = githubtool.fork_repos(repos, arguments['--old'])

if VERBOSE:
    print("Waiting 5 seconds to give Github time to complete the forks.")
time.sleep(5)

if arguments['--clone']:
    cloned_repos = githubtool.clone_repos(forked_repos)

# add upstream connection

if arguments['--upstream']:
    upstream_remotes = githubtool.add_upstream_repos(cloned_repos)