rummykhan/github-reader

Github Repository Reader.

Github Repository Reader

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, _(*1)

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., _(*2)

Installation

Install using composer, _(*3)

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

Add Service Provider

Add ServiceProvider to config/app.php providers array., _(*4)

\GithubReader\GithubReaderServiceProvider::class,

Add Facade

To use with Facade add, _(*5)

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

Publish the configuration (github.php), _(*6)

Publish Config

php artisan vendor:publish

This will publish github.php in config/ directory., _(*7)

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., _(*8)

'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., _(*9)

$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, _(*10)

There are two ways you can query files., _(*11)

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

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

dd($file);

OR, _(*12)

To query in Files just add InFiles to all the collection methods., _(*13)

$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, _(*14)

To query in Dictionaries just add InDictionaries to all the Collection methods., _(*15)

$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., _(*16)

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., _(*17)

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

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

dd($found);

Third parameter in the find is to find recursively, _(*18)

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

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

dd($found);

This find method will return a collection., _(*19)

Available Methods

1. GithubReader\RepositoryReader

$reader = app('github-reader')

To only use read path., _(*20)

$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');
 ```

| Name                                          | Purpose |
| --------------------------------------------- |-------------|
| `getFiles()`                                  | Get all files in that directory. |
| `getDirectories()`                            | Get all directories in that directory. |
| `listAll()`                                   | Get all files and directories in that directory.|
| `retrieve()`                                  | Alias of `listAll()`. |
| `find($key, $name, $all = true)`              | Find in all files and directories if `$all=true` it will find recursively.|
| `findDirectory($key, $name, $all = false)`    | Find in directoris and if `$all=true` it will find recursively. |
| `findFile($key, $name, $all = false)`         | Find in files and if `$all=true` it will find recursively.      |
| `toArray()`                                   | Convert the object to array representation. |
| `toJson($options = 0)`                        | Convert the object to JSON representation. |

### 3. GithubReader\Github\File

```php
$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

rehan_manzoor@outlook.com, _(*21)