Skip to content

Easily integrate the Github Jobs API into your PHP application

License

Notifications You must be signed in to change notification settings

jobapis/jobs-github

Repository files navigation

Github Jobs Client

Latest Version Software License Build Status Coverage Status Quality Score Total Downloads

This package provides Github Jobs API support for the Jobs Common project.

Installation

To install, use composer:

composer require jobapis/jobs-github

Usage

Create a Query object and add all the parameters you'd like via the constructor.

// Add parameters to the query via the constructor
$query = new JobApis\Jobs\Client\Queries\GithubQuery([
    'search' => 'engineering'
]);

Or via the "set" method. All of the parameters documented in the API's documentation can be added.

// Add parameters via the set() method
$query->set('location', 'Chicago, IL');

You can even chain them if you'd like.

// Add parameters via the set() method
$query->set('page', '2')
    ->set('full_time', 'true');

Then inject the query object into the provider.

// Instantiating provider with a query object
$client = new JobApis\Jobs\Client\Provider\GithubProvider($query);

And call the "getJobs" method to retrieve results.

// Get a Collection of Jobs
$jobs = $client->getJobs();

This will return a Collection of Job objects.

Testing

$ ./vendor/bin/phpunit

Contributing

Please see CONTRIBUTING for details.

Credits

License

The Apache 2.0. Please see License File for more information.