hydrus - GitLite

KO | EN

gitlite — search

#ai #go #machine-learning #linux #docker #macos #java #windows #kubernetes #awesome-list #pytorch #security #ios #mcp

hydrus

(★ 195)

REST server - Flask Hydra-powered for Semantic Web

File Explorer

Download Latest Version (.zip)

- - package-publish.yml
- CODE_OF_CONDUCT.md
- CONTRIBUTING.md
- ISSUE_TEMPLATE.md
- PULL_REQUEST_TEMPLATE.md
- er_diagram.pdf
- hydrus_database.md
- specs.txt
- STARTING.md
- TASKS.md
- TUTORIALS.md
- - doc.py
  - doc_gen.py
- - demo.py
  - doc.py
- - __init__.py
  - spacecraft_parsed_classes.py
  - spacecraft_vocab_jsonld.py
  - subsystem_parsed_classes.py
  - subsystem_vocab_jsonld.py
- doc.jsonld
- petstore_openapi.yaml
- - __init__.py
  - alembic.ini
  - crud.py
  - crud_helpers.py
  - db_models.py
  - doc_parse.py
  - exceptions.py
  - resource_based_classes.py
  - user.py
- - __init__.py
  - socketio_factory.py
  - stale_records_cleanup.py
  - sync_namespace.py
  - utils.py
- - __init__.py
  - doc_writer_sample.py
  - doc_writer_sample_output.py
  - hydra_doc_sample.py
  - link_open_api.yaml
  - petstore_openapi.yaml
- __init__.py
- app.py
- app_factory.py
- auth.py
- conf.py
- LogConfig
- resources.py
- utils.py
- uwsgi.ini
- - test_app.py
  - test_auth.py
  - test_socket.py
- - test_crud.py
- __init__.py
- conftest.py
- test_cli.py
- test_pep8.py
.deepsource.toml
.gitignore
.pre-commit-config.yaml
.travis.yml
cli.py
config.yml
docker-compose.yml
Dockerfile
LICENSE
poetry.lock
pylintrc
pyproject.toml
README.md
requirements-dev.txt
requirements.txt
setup.cfg
setup.py

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

hydrus [![Build Status](https://travis-ci.com/HTTP-APIs/hydrus.svg?branch=develop)](https://travis-ci.com/HTTP-APIs/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](https://en.wikipedia.org/wiki/Linked_data) to create a powerful REST APIs to serve data.
hydrus uses the [Hydra(W3C)](http://www.hydra-cg.com/) standard for creation and documentation of it's APIs.

Start-up the demo
-----------------
* with *Docker* and *docker-compose* installed, run `docker-compose up --build`
* open the browser at `http://localhost:8080/api/vocab`

You should be displaying the example API as served by the server.

Add your own Hydra documentation file
-------------------------------------
To serve your own Hydra-RDF documentation file:
* create a `doc.py` file as the ones in `examples/` directory containing your own *ApiDoc*
* set the `APIDOC_REL_PATH` variable in `docker-compose.yml`. This should the relative path from the project root
* start-up the demo as above.

You should be displaying your API as served by the server.

Table of contents
-------------
* [Features](#features)
* [Requirements](#req)
* [Demo](#demo)
* [Usage](#usage)

<a name="features"></a>
Features
-------------
hydrus supports the following features:
- A client that can understand Hydra vocabulary and interacts with a Hydra supporting server to basic [CRUD](https://en.wikipedia.org/wiki/Create,_read,_update_and_delete) operations on data.
- 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)**

<a name="req"></a>
Requirements
-------------
The system is built over the following standards and tools:
- [Flask](http://flask.pocoo.org/) a Python based micro-framework for handling server requests and responses.
- [JSON-LD](http://json-ld.org/spec/latest/json-ld/) as the preferred data format.
- [Hydra](http://www.hydra-cg.com/) as the API standard.
- [SQLAlchemy](http://www.sqlalchemy.org/) 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`. Hydrus does not support python < 3.6

<a name="demo"></a>
Demo
-------------
To run a demo for hydrus using the sample API, just do the following:

1. Clone hydrus:
```bash
git clone https://github.com/HTTP-APIs/hydrus
cd hydrus
```
2. Install a [*Python virtual environment*](https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/) using:
```bash
python3.8 -m venv .venv
```
or:
```bash
virtualenv -p python3.8 .venv
```

3. Install hydrus using:
```bash
source .venv/bin/activate
pip install -r requirements.txt
python setup.py install
```

NOTE: there is an alternative way to install dependencies with `poetry`:
```bash
pip3 install poetry
poetry install
```
This is mostly used to check dependencies conflicts among packages and to release to `PyPi`.
 
After installation is successful, to *run the server*:
```bash
hydrus serve
```

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

<a name="usage"></a>
Usage
-------------
For more info, head to the [Usage](http://www.hydraecosystem.org/01-Usage.html) section of the [wiki](http://www.hydraecosystem.org/).

Development
-------------

1. Install git hook: `pre-commit install`
2. Every time code is committed, automated checks are run using `mypy` and `pylint`