rummykhan/github-reader

Github Repository Reader.

0.0.2 2017-10-30 08:59 UTC

Requires

• php: >=5.5.9
• graham-campbell/github: ^6.1
• laravel/framework: 5.2.*

MIT

• Rehan Manzoor

• repository
• github
• reader

README

This package helps reading a complete github repository & retrieve any file you want to. This package is a wrapper around GrahamCampbell/Laravel-GitHub, But this package is specifically for reading a Repository in its proper format using Github Official API

Github Official Format

name: "LICENSE"
path: "LICENSE"
sha: "c8a38eeec1767ff114eaf7caf5cda6d0a7f8f33d"
size: 1110
url: "https://api.github.com/repos/rummykhan/github-reader/contents/LICENSE?ref=master"
html_url: "https://github.com/rummykhan/github-reader/blob/master/LICENSE"
git_url: "https://api.github.com/repos/rummykhan/github-reader/git/blobs/c8a38eeec1767ff114eaf7caf5cda6d0a7f8f33d"
download_url: "https://raw.githubusercontent.com/rummykhan/github-reader/master/LICENSE"
type: "file"

Only the type is changed for directory / symlink.

Installation

Install using composer

composer require rummykhan/github-reader php-http/guzzle6-adapter

Add Service Provider

Add ServiceProvider to config/app.php providers array.

\GithubReader\GithubReaderServiceProvider::class,

Add Facade

To use with Facade add

'GithubReader' => \GithubReader\Facades\GithubReader::class,

Publish the configuration (github.php)

Publish Config

php artisan vendor:publish

This will publish github.php in config/ directory.

Update Config

Since Github has changed the api Rate Limit you may get exception for hourly rate limit reached. Then you need to Register Github App and add credentials in config/github.php.

'app' => [
    'clientId'     => 'xxx**************xxx',
    'clientSecret' => 'xxx**************xxx',
    'method'       => 'application',
    // 'backoff'      => false,
    // 'cache'        => false,
    // 'version'      => 'v3',
    // 'enterprise'   => false,
],

Reading Repository

Reading a repository is as straight forward as it could be.

$repository = app('github-reader')->read('rummykhan', 'github-reader');

dd($repository);

Getting content of a file

$repository = app('github-reader')->read('rummykhan', 'github-reader');

$files = $repository->getFiles();

// This method will retrieve file from github
$file = $files->first()->retrieve();

dd($file->getContent());

Query Files

Since files and directories are instances of Illuminate\Support\Collection, You can query both files or dictionaries just like you query a Illuminate\Support\Collection

There are two ways you can query files.

$repository = app('github-reader')
        ->read('rummykhan', 'github-reader');

$file = $repository->getFiles()->where('name', 'LICENSE')->first();

dd($file);

OR

To query in Files just add InFiles to all the collection methods.

$repository = app('github-reader')
        ->read('rummykhan', 'github-reader');

$file = $repository->whereInFiles('name', 'LICENSE')->first();

dd($file);

Query Directories

$repository = app('github-reader')
        ->read('rummykhan', 'github-reader');

$dictionary = $repository->getDirectories()->where('name', 'src')->first();

dd($dictionary);

OR

To query in Dictionaries just add InDictionaries to all the Collection methods.

$repository = app('github-reader')
        ->read('rummykhan', 'github-reader');

$dictionary = $repository->whereInDictionaries('name', 'src')->first();

dd($dictionary);

Find a file in repository

Since the structure of each item either File/Directory in the repository is like below.

name: "LICENSE"
path: "LICENSE"
sha: "c8a38eeec1767ff114eaf7caf5cda6d0a7f8f33d"
size: 1110
url: "https://api.github.com/repos/rummykhan/github-reader/contents/LICENSE?ref=master"
html_url: "https://github.com/rummykhan/github-reader/blob/master/LICENSE"
git_url: "https://api.github.com/repos/rummykhan/github-reader/git/blobs/c8a38eeec1767ff114eaf7caf5cda6d0a7f8f33d"
download_url: "https://raw.githubusercontent.com/rummykhan/github-reader/master/LICENSE"
type: "file"

We can find any all matching directory/files recursively.

$repository = app('github-reader')
        ->read('rummykhan', 'github-reader');

$found = $repository->find('type', 'file');

dd($found);

Third parameter in the find is to find recursively

$repository = app('github-reader')
        ->read('rummykhan', 'github-reader');

$found = $repository->find('name', 'File.php', true);

dd($found);

This find method will return a collection.

Available Methods

1. GithubReader\RepositoryReader

$reader = app('github-reader')

To only use read path.

$directory = app('github-reader')
	->setOrganization('rummykhan')
	->setRepositoryName('github-reader')
	->readPath('src');

2. GithubReader\Github\Directory Or Repository

$repository = app('github-reader')->read('rummykhan','github-reader');

3. GithubReader\Github\File

$repository = app('github-reader')->read('rummykhan','github-reader');

$file = $repository->getFiles()->first();

4. GithubReader\Github\FileContent

$repository = app('github-reader')->read('rummykhan','github-reader');
$file = $repository->getFiles()->first();
$fileContent = $file->retrieve();

Contact

[e-mail]