An open API service indexing awesome lists of open source software.

https://github.com/0x00-0x00/ghubs

Perl script to synchronize github repositories using GitHub API.
https://github.com/0x00-0x00/ghubs

api github perl repository

Last synced: about 2 months ago
JSON representation

Perl script to synchronize github repositories using GitHub API.

Awesome Lists containing this project

README

          

# GHubS - version 0.01

## Required perl modules
1. JSON;
2. Getopt::ArgParse;
3. Data::Dumper;
4. LWP::UserAgent;

## Installation tutorial
To install the program and download all dependencies, simply run the install script.
```bash
./install.pl
```

## Usage instructions
_First, you'll need a OAuth2 token for authentication to the GitHub API. You can get one at 'Settings' in Github website._

To see the available options, type `./ghubs.pl -h`

To download all repositories from user `xxx`, type:
```bash
./ghubs.pl -u xxx -t TOKEN
```

## Advanced Usage
You can blacklist certain directories, specifing each one inside a text file, line by line, then, executing the script with the -b handle, like this:
```bash
./ghubs.pl -u xxx -b blacklist -t TOKEN
```

By default, all the repositories go to the current working directory, to direct the repositories to another local folder, add the -l handle to the script arguments, like this:
```bash
./ghubs.pl -u xxx -l folder1/ -t TOKEN
```

For private repository synchronization:
```bash
./ghubs.pl -u xxx -t TOKEN --private
```