Download the PHP package plin-code/job-boards-greenhouse without Composer

Job Boards Greenhouse

Greenhouse connector for the plin-code job boards family. It reads the public Greenhouse job board API, which needs no credentials and returns a whole board in one request:

Greenhouse hosts boards in two regions and the slug does not say which, so both listing calls ask boards-api.greenhouse.io first and fall back to boards-api.eu.greenhouse.io.

It implements PlinCode\JobBoards\Contracts\JobBoardClient from plin-code/job-boards-core, so it is interchangeable with every other connector in the family. Generated from plin-code/job-boards-skeleton.

Installation

Framework agnostic on purpose

GreenhouseClient takes core's HttpClient and an optional PSR-3 logger. It imports nothing from Laravel, so a Symfony or plain PHP consumer builds it directly:

GreenhouseServiceProvider is the only Laravel aware file in the package, and all it does is that same wiring out of the container.

Laravel usage

The provider is auto discovered.

Publish the config to change the base URLs, the timeouts or the request headers:

The provider binds a PSR-18 client and a PSR-17 factory with bindIf, so an application that already binds its own keeps it. It deliberately does not bind JobBoardClient itself: several connectors implement that interface and would fight over the binding. Bind the one you want in your own application service provider.

Mapping

Regions

Both fetchJobsForCompany() and validateSlug() try the US host and, on any non 2xx answer, the EU host. Whatever the EU host says is then the result. fetchCompanyDescription() asks the US host only.

Slug validation

Greenhouse publishes no account name endpoint, so the board listing doubles as one: validateSlug() returns jobs[0].company_name when it is there, and the slug itself otherwise. A board that resolves but lists nothing still validates and answers with the slug.

Error handling

fetchJobsForCompany() never throws at the caller. Everything is logged through the injected PSR-3 logger and an empty list comes back, so one broken company cannot abort a sync over hundreds of them:

Every record carries company_slug. With no logger passed, a NullLogger is used and everything is silent.

validateSlug() and fetchCompanyDescription() return null for every failure and log nothing. That is intentional: neither a 404 nor a dropped connection proves a slug is good, and callers use these to validate user input.

Timeouts

PSR-18 has no notion of a timeout, so core's HttpClient::withTimeout() is only honoured by clients implementing PlinCode\JobBoards\Http\SupportsTimeout. Guzzle's PSR-18 client does not, so the configured 30 and 15 seconds are a request the transport may ignore. If timeouts matter to you, build the Guzzle client with ['timeout' => 30] and bind it yourself, or wrap it in a small SupportsTimeout adapter.

Depending on core

Core is on Packagist, so that constraint is all this package needs: there is no repositories block to carry. Do not commit a path repository pointing at a sibling checkout of core. It resolves against the layout of one machine, and the package then fails to install from a fresh clone anywhere else.

Development

tests/Unit builds the client against core's PlinCode\JobBoards\Testing\FakePsrClient and boots no framework. tests/Feature boots Testbench and covers the service provider only.

License

The MIT License (MIT). Please see License File for more information.