TODO merge with devicehub | devicehub adapted to trustchain oc1 orchestral (dpp branch)
This repository has been archived on 2024-05-31. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
Xavier Bustamante Talavera 15f705dd50 Add Tests managing inventories; small bugfixes 2019-02-11 21:34:45 +01:00
docs Add sphinx extension dhclass; generate better API docs; remove cache for lots 2019-02-03 17:12:53 +01:00
ereuse_devicehub Add Tests managing inventories; small bugfixes 2019-02-11 21:34:45 +01:00
examples Use Postgres 11; enhance search query with websearch; really use indexes, add hash index; fix partially patching lots 2019-02-07 13:47:42 +01:00
tests Add Tests managing inventories; small bugfixes 2019-02-11 21:34:45 +01:00
.gitignore Initial commit 2018-04-10 17:06:06 +02:00
MANIFEST.in Better installation; add example_app 2018-07-07 18:51:15 +02:00
README.md Use Postgres 11; enhance search query with websearch; really use indexes, add hash index; fix partially patching lots 2019-02-07 13:47:42 +01:00
requirements.txt Add Tests managing inventories; small bugfixes 2019-02-11 21:34:45 +01:00
setup.cfg Enhance testing config 2018-09-16 15:56:20 +02:00
setup.py Add Tests managing inventories; small bugfixes 2019-02-11 21:34:45 +01:00

README.md

Devicehub

Devicehub is a distributed IT Asset Management System focused in reusing devices, created under the project eReuse.org.

Our main objectives are:

  • To offer a common IT Asset Management for donors, receivers and IT professionals so they can manage devices and exchange them. This is, reusing and ultimately recycling.
  • To automatically recollect, analyse, process and share (controlling privacy) metadata about devices with other tools of the eReuse ecosystem to guarantee traceability, and to provide inputs for the indicators which measure circularity.
  • To highly integrate with existing IT Asset Management Systems.
  • To be decentralized.

Devicehub is built with Teal and Flask.

Installing

The requirements are:

Install Devicehub with pip: pip3 install ereuse-devicehub -U --pre.

Running

Download, or copy the contents, of this file, and call the new file app.py.

Create a PostgreSQL database called devicehub by running create-db:

  • In a Debian 9 bash terminal, execute the following two commands:
    1. sudo su - postgres.
    2. bash examples/create-db.sh devicehub dhub, and password ereuse.
  • In MacOS: bash examples/create-db.sh devicehub dhub, and password ereuse.

Create the tables in the database by executing in the same directory where app.py is:

$ flask init-db

Finally, run the app:

$ flask run

The error flask: command not found can happen when you are not in a virtual environment. Try executing then python3 -m flask.

See the Flask quickstart for more info.

The error 'bdist_wheel' can happen when you works with virtual environment. To fix it, install in the virtual environment wheel package. pip3 install wheel

Administrating

Devicehub has many commands that allows you to administrate it. You can, for example, create a dummy database of devices with flask dummy or create users with flask create-user. See all the available commands by just executing flask and get more information per command by executing flask command --help.

Understand the software

See the docs to understand how the software works and the design principles.

Use the API

Checkout Swagger to see the schemas and endpoints (we are working in making it interactive).

Use postman as an example of how to use the API.

Run in Postman

Testing

To run the tests you will need to:

  1. git clone this project.
  2. Create a database for testing executing create-db.sh like the normal installation but changing the first parameter from devicehub to dh_test: create-db.sh dh_test dhub and password ereuse.
  3. Execute at the root folder of the project python3 setup.py test.

Generating the docs

  1. git clone this project.
  2. Install plantuml. In Debian 9 is # apt install plantuml.
  3. Execute pip3 install -e .[docs] in the project root folder.
  4. Go to <project root folder>/docs and execute make html. Repeat this step to generate new docs.

To auto-generate the docs do pip3 install -e .[docs-auto], then execute, in the root folder of the project sphinx-autobuild docs docs/_build/html.