Download the PHP package rummykhan/github-reader without Composer
On this page you can find all versions of the php package rummykhan/github-reader. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download rummykhan/github-reader
More information about rummykhan/github-reader
Files in rummykhan/github-reader
Informations about the package github-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
Github Official Format
Only the type is changed for directory
/ symlink
.
Installation
Install using composer
Add Service Provider
Add ServiceProvider
to config/app.php
providers array.
Add Facade
To use with Facade add
Publish the configuration (github.php)
Publish Config
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
.
Reading Repository
Reading a repository is as straight forward as it could be.
Getting content of a file
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.
OR
To query in Files just add InFiles
to all the collection methods.
Query Directories
OR
To query in Dictionaries just add InDictionaries
to all the Collection methods.
Find a file in repository
Since the structure of each item either File/Directory in the repository is like below.
We can find any all matching directory/files recursively.
Third parameter in the find is to find recursively
This find
method will return a collection.
Available Methods
1. GithubReader\RepositoryReader
Name | Purpose |
---|---|
init($organization, $repositoryName, $connection = null) |
Initialize the repository with organization/user and repository name. |
getConnection() |
Getter for connection. |
setConnection(string $connection) |
Set the connection. |
getOrganization() |
Getter for Organization. |
setOrganization(string $organization) |
Setter for organization. |
getRepositoryName() |
Getter for repository name. |
setRepositoryName($repositoryName) |
Setter for repository name. |
read($organization = null, $repositoryName = null, $connection = null) |
read a repository completely. |
readPath($path = null) |
Read only certain path of the repository. |
To only use read path.
2. GithubReader\Github\Directory Or Repository
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
Name | Purpose |
---|---|
retrieve() |
It will give you instance of Github\Github\FileContent . |
4. GithubReader\Github\FileContent
Name | Purpose |
---|---|
getContent() |
It will give content of file in plain text. |