jobapis/jobs-goremote

Making it simple to integrate your application with the GoRemote RSS Feed.

0.1.0 2017-02-09 13:22 UTC

README

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

About

This package helps PHP developers connect with the GoRemote.io job board's RSS feed. In just a couple lines of code, you can grab job listings from GoRemote's feed.

Example

$client = new GoRemoteProvider(new GoRemoteQuery());
$jobs = $client->getJobs();

See Usage section below for more detailed examples.

Mission

JobApis makes job board and company data more accessible through open source software. To learn more, visit JobApis.com, or contact us at admin@jobapis.com.

Requirements

Installation

You can install this package using Composer. From the command line, run:

$ composer require jobapis/jobs-goremote

Usage

GoRemote provides no search parameters, just a feed of all their latest jobs via RSS. In order to get the latest job listings, first create a query object.

$query = new JobApis\Jobs\Client\Queries\GoRemoteQuery();

Then inject the query object into the provider.

$client = new JobApis\Jobs\Client\Providers\GoRemoteProvider($query);

And call the "getJobs" method to retrieve results.

$jobs = $client->getJobs();

The getJobs() method will return a Collection of Job objects based on Schema.org's JobPosting specification.

Testing

  1. Clone this repository from Github.
  2. Install the dependencies with Composer: $ composer install.
  3. Run the test suite: $ ./vendor/bin/phpunit.
  4. (Optional) Run the test suite with real HTTP calls to the API: $ REAL_CALL=1 ./vendor/bin/phpunit.

A code coverage report will be generated in the build/ directory at the root of the project.

Contributing

Please see JobApis' contribution guidelines for details.

Legal

Disclaimer

This package is not affiliated with or supported by GoRemote and we are not responsible for any use or misuse of this software.

License

This package uses the Apache 2.0 license. Please see the License File for more information.

Copyright

Copyright 2017, Karl Hughes.