eReuse-DeviceHub 0.2.0a13

A system to manage devices focusing reuse.

# Devicehub

Devicehub is an IT Asset Management System focused in reusing devices, created under the project [eReuse.org](https://www.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](https://github.com/bustawin/teal) and [Flask](http://flask.pocoo.org).

## Installing The requirements are:

• Python 3.5.3 or higher. In debian 9 is # apt install python3-pip.

• PostgreSQL 9.6 or higher. In debian 9 is # apt install postgresql-contrib

• passlib. In debian 9 is # apt install python3-passlib.

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

## Running Download, or copy the contents, of [this file](example/app.py), and call the new file app.py.

Create a PostgreSQL database called devicehub:

`bash sudo su - postgres # Change to Postgres main user postgres $ createdb devicehub # Create main database postgres $ psql devicehub # Access to the database postgres $ CREATE USER dhub WITH PASSWORD 'ereuse'; # Create user devicehub uses to access db postgres $ GRANT ALL PRIVILEGES ON DATABASE devicehub TO dhub; # Give access to the db postgres $ CREATE EXTENSION pgcrypto SCHEMA public; # Enable pgcrypto postgres $ CREATE EXTENSION ltree SCHEMA public; # Enable ltree postgres $ \q exit `

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

`bash $ flask init-db `

Finally, run the app:

`bash $ 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](http://flask.pocoo.org/docs/1.0/quickstart/) for more info.

## 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](docs/index.rst) to understand how the software works and the design principles.

### Use the API Checkout [Swagger](https://app.swaggerhub.com/apis/ereuse/devicehub/0.2) to see the schemas and endpoints (we are working in making it interactive).

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

[](https://documenter.getpostman.com/view/254251/RWEnmFPs)

## Testing To run the tests you will need to:

1. git clone this project.

2. Create a database for testing. By default the database used is dh_test. Execute to create it: 1. postgres $ createdb dh_test. 2. postgres $ psql dh_test. 3. postgres $ GRANT ALL PRIVILEGES ON DATABASE dh_test TO dhub;. 4. CREATE EXTENSION pgcrypto SCHEMA public; 5. CREATE EXTENSION ltree SCHEMA public;

3. Execute at the root folder of the project python3 setup.py test.