GithubHelp home page GithubHelp logo

leadlight's Introduction

Leadlight Build Status

Rose colored stained glass windows for HTTP.

Goals

Progressive enhancement for HTTP APIs

Don't cover up the web; just fill in the gaps here and there. Make it easy to add links and other affordances API publishers might have forgotten.

Model RESTful APIs as a web of links

Don't try to make the web look like a database.

Representations over resources

Resources are the server's job to worry about. The things we get back from a server are representations. Take representations at face value and interpret them sensibly, rather than trying to fit them into a client-side model of an imaginary server-side object graph.

Support current and emerging standards

Such as the Link header, URI templates, PATCH, ETags, and JSON-schema.

Sensible defaults

Always try to convert representations returned by the server into a form that is useful to the programmer--whether that is a Hash parsed from JSON data, a Nokogiri document, or a text string.

Backend agnostic

Using the power of Faraday.

Exception-free

Only raise exceptions in API calls which explicitly request them. Provide ample information to explain the cause of a failure.

Async-ready

Architected from the ground up with asynchrony in mind. It's easier to build a synchronous API on top of an async one than vice-versa.

Controlled abstraction leakage

All abstractions are leaky. Provide ample and convenient access points into the guts of the request lifecycle for situations when the defaults are not sufficient.

Quality

Code quality is important. Code Climate keeps a close eye on Leadlight instilling confidence and showing how any technical debt can be paid down.

Installation

gem 'leadlight'

Usage

See leadlight_spec.rb for now.

leadlight's People

Contributors

lmarburger avatar gduquesnay avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.