Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/JacobCallahan/apix
apix (API Explorer) is a tool for discovering, learning, and using API versions.
https://github.com/JacobCallahan/apix
Last synced: 11 days ago
JSON representation
apix (API Explorer) is a tool for discovering, learning, and using API versions.
- Host: GitHub
- URL: https://github.com/JacobCallahan/apix
- Owner: JacobCallahan
- License: other
- Created: 2018-02-11T16:28:33.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-04-08T15:46:30.000Z (7 months ago)
- Last Synced: 2024-07-05T15:17:20.575Z (4 months ago)
- Language: Python
- Homepage:
- Size: 74.2 KB
- Stars: 4
- Watchers: 3
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: HISTORY.rst
- License: LICENSE
Awesome Lists containing this project
README
# apix
apix (API Explorer) let's you quickly discover new APIs and versions.
apix can also help you generate new versions of your API interaction libraries.
**note:** apix currently only supports APIs that have an Apipie-based apidoc.
You can extend this functionality by creating your own parser class.
Installation
------------
Clone the APIx repository and install it with pip.
```pip install .```
Usage
-----
```usage: apix [-h] {explore,diff,makelib,list}```
API Exploration
---------------
Explore a target API, saving all entities, methods, and parameters to a version file.
If you don't specify a version, apix will save the results by date.
**Examples:**
```apix explore --help```
```apix explore -n satellite -u https://my.sathost.com/ -b apidoc/ -v 6.2.14 -p apipie```
```apix explore -n satellite -u https://my.sathost.com/```
Version Diff
------------
apix can give you a diff between previously explored versions of an API.
This is more helpful than performing a linux-style diff on the file, since it retains context.
By default it will use the most recently explored API and the latest known versions (with dated version sorted to the bottom).
**Examples:**
```apix diff --help```
```apix diff -n satellite -l 6.3 -p 6.2.14```
```apix diff -n satellite -l 6.3```
```apix diff -n satellite```
```apix diff```
Library Maker
-------------
You can setup apix to populate any library you may be using to interact with your API.
You will have to provide template files, as well as extend apix's code base to populate those templates.
apix comes with the ability to populate Nailgun, a python library used for Satellite 6.
Additionally, apix comes with three pre-made general purpose templates:
- basic: This template does little more than let you interact with an API
- intermediate: Building on basic, this will hold on to gained information
- advanced: Bulding on intermediate, advanced will also try to resolve dependencies
By default it will use the most recently explored API and the latest known versions (with dated version sorted to the bottom).
**Examples:**
```apix makelib --help```
```apix makelib -n satellite -v 6.3 -t nailgun```
```apix makelib -n satellite -t advanced```
```apix makelib -t intermediate```
List
----
apix can also list out the APIs and versions for an API that is currently knows about.
**Examples:**
```apix list --help```
```apix list apis```
```apix list versions -n satellite```
Docker
------
apix is also available with automatic builds on dockerhub.
You can either pull down the latest, or a specific released version.
Additionally, you can build your own image locally. You will want to mount the local apix directory to keep any data apix creates.
**Examples:**
```docker build -t apix .```
or
```docker pull jacobcallahan/apix```
```docker run -it apix explore --help```
```docker run -it -v $(pwd):/apix/:Z apix explore -n satellite -u https://my.sathost.com/ -v 6.2.14```
Note
----
This project only explicitly supports python 3.6+.