docs | ||
ereuse_devicehub | ||
tests | ||
.gitignore | ||
README.md | ||
setup.py |
Devicehub
Devicehub is an 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:
- Python 3.5.3 or higher.
- Python Pip 3
- PostgreSQL 9.6 or higher.
$ apt-get install python3-pip postgresql postgresql-client python3.5
Install Devicehub with pip: pip3 install ereuse-devicehub -U --pre
.
flask
is needed for running the server.
$ pip3 install flask
Running
Create a python file with the following and call it app.py
:
from ereuse_devicehub.devicehub import Devicehub
from ereuse_devicehub.config import DevicehubConfig
class MyConfig(DevicehubConfig):
ORGANIZATION_NAME = 'My org'
ORGANIZATION_TAX_ID = 'foo-bar'
app = Devicehub(MyConfig())
Create a PostgreSQL database called dh-db1:
$ sudo -u postgres psql postgres
postgres=# createdb dh-db1
postgres=# \q
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
See the Flask 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
.