hapi

A low-level API client architecture rest api architecture http-client
0.1.1 Latest release released

Hapi

Hapi is a low-level API client architecture for Crystal, specifically for JSON REST APIs. Hapi revolves around the following concepts:

  1. Resource:

    A Resource represents a JSON-serializable object that can be retrieved in responses from the API server.

  2. Client:

    A Client is responsible for querying all resource endpoints, and returning responses from the API server.

  3. Endpoint

    An Endpoint is a queryable path exposed by the API server, that returns a response. In Hapi, an endpoint represents a single resource endpoint, with methods that operate on its individual sub-endpoints.

  4. Response:

    A Response is Hapi's representation of the raw response body received from the API server. It is a type-safe wrapper around the JSON response object.

    A Response may be an Item (a single resource object), or a List (an array of resource objects)

Usage

See spec/support/ directory of this repository for example usage.

Example Projects

The following Crystal libraries use Hapi:

Development

Run specs with crystal spec.

Contributing

  1. Fork it
  2. Switch to the master branch: git checkout master
  3. Create your feature branch: git checkout -b my-new-feature
  4. Make your changes, updating changelog and documentation as appropriate.
  5. Commit your changes: git commit
  6. Push to the branch: git push origin my-new-feature
  7. Submit a new Pull Request against the GrottoPress:master branch.
hapi:
  github: GrottoPress/hapi
  version: ~> 0.1.1
Crystal ~> 1.0

Authors

Dependencies 0

Development Dependencies 1

  • webmock ~> 0.14.0
    {'github' => 'manastech/webmock.cr', 'version' => '~> 0.14.0'}

Dependents 1

Last synced .
search fire star recently