-
Notifications
You must be signed in to change notification settings - Fork 10
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #38 from apiaryio/kylef/revamp-tooling
Rewrite the tooling page to reflect current reality
- Loading branch information
Showing
1 changed file
with
29 additions
and
17 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,33 +1,45 @@ | ||
# Tools | ||
# Tooling | ||
|
||
## [Fury](https://github.com/apiaryio/fury.js) | ||
|
||
Fury is a library for parsing API description documents and return API Elements. | ||
There are various API Elements tools available to interact and parse API | ||
Description Documents. | ||
|
||
## [API Description Parsing Service](http://docs.apiblueprintapi.apiary.io/#reference) | ||
|
||
API Description Parsing Serice (formerly API Bluerpint API) is a hosted service that takes API Blueprint as an input and return API Elements. | ||
API Description Parsing Serice (formerly API Bluerpint API) is a hosted service | ||
that takes API Description documents such as API Blueprint or Swagger 2.0 as | ||
input and returns API Elements. | ||
|
||
## [Drafter](https://github.com/apiaryio/drafter) | ||
## JavaScript | ||
|
||
Drafter is a library for parsing API Blueprint documents and return parse results in API Elements. | ||
### [Fury](https://github.com/apiaryio/fury.js) | ||
|
||
Fury is a library for validating and parsing API description documents, Furys | ||
API provides [API Element JS](https://api-elements-js.readthedocs.io/) objects. | ||
|
||
## [Protagonist](https://github.com/apiaryio/protagonist) | ||
### [API Element JS](https://api-elements-js.readthedocs.io/) | ||
|
||
Protagonist is a Node.js wrapper for the Drafter library. | ||
The API Elements JS Package provides an interface for querying and interacting | ||
with API Elements. This library can be used in conjunction with Fury to handle | ||
parsing of API Description documents into API Elements. | ||
|
||
## [Lodash API Description](https://github.com/apiaryio/lodash-api-description) | ||
## Python | ||
|
||
A JavaScript library provides utility functions for consuming an API Elements document. | ||
### [refract.py](https://github.com/kylef/refract.py) | ||
|
||
## [Query Tool](https://github.com/apiaryio/refract-query) | ||
A Python library for interacting with Refract and API Element in Python. | ||
|
||
A tool for querying a Refract or API Elements document. | ||
--- | ||
|
||
## [Minim API Definition](https://github.com/refractproject/minim-api-description/) | ||
## API Blueprint | ||
|
||
This JavaScript tool utilizes [Minim](https://github.com/refractproject/minim) for building and consuming API Elements. | ||
The API Blueprint ecosystem heavily uses API Elements under the hood. Although | ||
we would recommend interacting with API Elements using the JavaScript tooling | ||
above as it is generic and not API Blueprint specific. | ||
|
||
### [Drafter](https://github.com/apiaryio/drafter) | ||
|
||
Drafter is a library for parsing API Blueprint documents and return parse results in API Elements. | ||
|
||
## [refract.py](https://github.com/kylef/refract.py) | ||
### [Drafter JS](https://github.com/apiaryio/drafter-npm) | ||
|
||
A Python library for interacting with Refract and API Element. | ||
Drafter JS is a JavaScript interface to Drafter and can be used in Node.JS or natively in a browser. |