Skip to content

HTTP-APIs/falcon-http-hydra

Folders and files

NameName
Last commit message
Last commit date

Latest commit

d1fd24a · Sep 20, 2019
Feb 25, 2018
Jun 16, 2017
Feb 23, 2018
Mar 24, 2019
Feb 24, 2018
Jun 17, 2017
Feb 13, 2017
Jun 17, 2018
Mar 9, 2018
Mar 4, 2018
Jul 30, 2017
Jul 17, 2017
Mar 9, 2018
Sep 20, 2019
Jul 24, 2017

Repository files navigation

Hydrus

Hydrus is a set of Python based tools for easier and efficient creation of Hypermedia driven REST-APIs. Hydrus utilises the power of Linked Data to create a powerful REST APIs to serve data. Hydrus uses the Hydra(W3C) standard for creation and documentation of it's APIs.

Table of contents

Features

Hydrus supports the following features:

  • A generic server that can serve required data and metadata(in the form of API documentation) to a client over HTTP.
  • A middleware that allows users to use the client to interact with the server using Natural Language which is processed machine consumable language. (under development)

Requirements

The system is built over the following standards and tools:

  • Falcon a Python based micro-framework for handling server requests and responses.
  • JSON-LD as the preferred data format.
  • Hydra as the API standard.
  • SQLAlchemy as the backend database connector for storage and related operations.

Apart from this, there are also various Python packages that Hydrus uses. Using python setup.py install installs all the required dependencies.

NOTE: You'll need to use python3 not python2.

Demo

To run a demo for Hydrus using the sample API, just do the following:

Clone Hydrus:

git clone https://github.com/HTTP-APIs/hydrus

Change directory and switch to the develop branch:

cd hydrus

git checkout -b develop origin/develop

Install hydrus using:

pip install .

or

python setup.py install

and run the server using:

hydrus serve

The demo should be up and running on http://localhost:8080/serverapi/.

Usage

For more info, head to the Usage section of the wiki.

About

A porting of hydrus to Falcon framework

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published