ikwattro/github-event

Github Api Public Events to PHP Objects Mapper

GithubEvent Object Mapper

, _(*1)

Github Api Public Events to PHP Objects

Transforms the Github API Public Events into PHP Objects, _(*2)

Installation

Require the library in your composer.json, _(*3)

composer require ikwattro/github-event

Usage

Building the EventHandler

The application need to be built through the factory constructor, currently there is no need for such factory design but it aims to be extensible for future usages., _(*4)

use Ikwattro\GithubEvent\EventHandler;

$eventHandler = EventHandler::create()
                ->build();

Passing events

The mainpoint of the library is the handleEvent method that takes the GithubEvent as argument in an array format (json_decoded)., _(*5)

Once passed, you'll receive in return the corresponding PHP Object instance corresponding to the event., _(*6)

$events = json_decode('events.json', true);

foreach ($events as $e) {
    $event = $eventHandler->handleEvent($e);
}

Working with Events

An event object may contain more than the current event, for e.g., a CreateEvent will contain the payload of the event, but also the associated Repository object, RepositoryOwner, ... ., _(*7)

Please refer to the source code for discovering what is inside each event., _(*8)

Currently supported events

• [x] WatchEvent
• [x] IssuesEvent
• [x] IssueCommentEvent
• [x] CreateEvent
• [x] PushEvent
• [ ] ForkEvent
• [x] PullRequestEvent

License

The library is licensed under the MIT License, _(*9)

Author

Christophe Willemsen Twitter: @ikwattro, _(*10)