2020-10-14 08:03:51 +00:00
===========
PyInventory
===========
Web based management to catalog things including state and location etc. using Python/Django.
Current status: Just start the project. Nothing is done, nothing is useable, yet ;)
Pull requests welcome!
+-----------------------------------+-------------------------------------------------+
| |Build Status on github| | `github.com/jedie/PyInventory/actions`_ |
+-----------------------------------+-------------------------------------------------+
| |Build Status on travis-ci.org| | `travis-ci.org/jedie/PyInventory`_ |
+-----------------------------------+-------------------------------------------------+
| |Coverage Status on codecov.io| | `codecov.io/gh/jedie/PyInventory`_ |
+-----------------------------------+-------------------------------------------------+
| |Coverage Status on coveralls.io| | `coveralls.io/r/jedie/PyInventory`_ |
+-----------------------------------+-------------------------------------------------+
| |Status on landscape.io| | `landscape.io/github/jedie/PyInventory/master`_ |
+-----------------------------------+-------------------------------------------------+
.. |Build Status on github| image :: https://github.com/jedie/PyInventory/workflows/test/badge.svg?branch=master
.. _github.com/jedie/PyInventory/actions: https://github.com/jedie/PyInventory/actions
.. |Build Status on travis-ci.org| image :: https://travis-ci.org/jedie/PyInventory.svg
.. _travis-ci.org/jedie/PyInventory: https://travis-ci.org/jedie/PyInventory/
.. |Coverage Status on codecov.io| image :: https://codecov.io/gh/jedie/PyInventory/branch/master/graph/badge.svg
.. _codecov.io/gh/jedie/PyInventory: https://codecov.io/gh/jedie/PyInventory
.. |Coverage Status on coveralls.io| image :: https://coveralls.io/repos/jedie/PyInventory/badge.svg
.. _coveralls.io/r/jedie/PyInventory: https://coveralls.io/r/jedie/PyInventory
.. |Status on landscape.io| image :: https://landscape.io/github/jedie/PyInventory/master/landscape.svg
.. _landscape.io/github/jedie/PyInventory/master: https://landscape.io/github/jedie/PyInventory/master
2020-10-15 16:03:57 +00:00
-----
about
-----
The focus of this project is on the management of retro computing hardware.
Plan:
* Web-based
* Multiuser ready
* Chaotic warehousing
* Grouped "Storage": Graphics card is in computer XY
* Data structure kept as general as possible
* You should be able to add the following to the items:
* Storage location
* State
* Pictures
* URLs
* receiving and delivering (when, from whom, at what price, etc.)
* Information: Publicly visible yes/no
* A public list of existing items (think about it, you can set in your profile if you want to)
* administration a wish & exchange list
any many more... ;)
2020-10-14 08:03:51 +00:00
-------
install
-------
2020-10-20 15:38:08 +00:00
There exists two kind of installation/usage:
* local virtualenv (without docker)
2020-10-25 18:01:31 +00:00
* production use with docker-compose
2020-10-20 15:38:08 +00:00
2020-10-24 15:15:05 +00:00
see below
2020-10-20 15:38:08 +00:00
prepare
=======
2020-10-14 08:03:51 +00:00
::
~$ git clone https://github.com/jedie/PyInventory.git
~$ cd PyInventory
~/PyInventory$ make
help List all commands
install-poetry install or update poetry
install install PyInventory via poetry
2020-10-20 15:38:08 +00:00
manage-update Collectstatic + makemigration + migrate
2020-10-14 08:03:51 +00:00
update update the sources and installation
lint Run code formatters and linter
fix-code-style Fix code formatting
tox-listenvs List all tox test environments
tox Run pytest via tox with all environments
tox-py36 Run pytest via tox with *python v3.6*
tox-py37 Run pytest via tox with *python v3.7*
tox-py38 Run pytest via tox with *python v3.8*
pytest Run pytest
update-rst-readme update README.rst from README.creole
publish Release new version to PyPi
run-dev-server Run the django dev server in endless loop.
2020-10-20 15:38:08 +00:00
messages Make and compile locales message files
2020-10-14 08:03:51 +00:00
run-server Run the gunicorn server in endless loop.
backup Backup everything
create-starter Create starter file.
2020-10-20 15:38:08 +00:00
install-compose Install "docker-compose", too
up Start containers via docker-compose
down Stop all containers
prune Cleanup docker
build Update docker container build
2020-10-24 12:31:45 +00:00
logs Display docker logs from all containers
2020-10-24 14:34:33 +00:00
dbbackup Backup database
dbrestore Restore a database backup
2020-10-20 15:38:08 +00:00
restart Restart all containers
local install without docker
============================
::
# install or update poetry:
~/PyInventory$ make install-poetry
# install PyInventory via poetry:
2020-10-14 08:03:51 +00:00
~/PyInventory$ make install
...
2020-10-20 15:38:08 +00:00
# Collectstatic + makemigration + migrate:
~/PyInventory$ make manage-update
# Create a django super user:
~/PyInventory$ ./manage.sh createsuperuser
# start local dev. web server:
~/PyInventory$ make run-dev-server
2020-10-24 12:31:45 +00:00
The web page is available via: `` http://127.0.0.1:8000/ ``
2020-10-20 15:38:08 +00:00
docker-compose usage
====================
Install docker, e.g.: `https://docs.docker.com/engine/install/ubuntu/ <https://docs.docker.com/engine/install/ubuntu/> `_
::
# Install "docker-compose" via poetry extras:
~/PyInventory$ make install-compose
2020-10-25 18:01:31 +00:00
Create a `` .env `` file with these content, e.g.:
::
# Public domain or "localhost" for local testing:
HOSTNAME=localhost
2020-10-20 15:38:08 +00:00
2020-10-25 18:01:31 +00:00
# eMail address for Let's encrypt (Use "internal" for self signed https certificates):
LETSENCRYPT_EMAIL=internal
e.g. in production:
::
HOSTNAME=domain.tld
LETSENCRYPT_EMAIL=webmaster@domain.tld
Start containers via docker-compose:
::
2020-10-20 15:38:08 +00:00
~/PyInventory$ make up
2020-10-25 18:01:31 +00:00
Notes: At the first start it takes a little while until the database is created
Create first super user:
2020-10-20 15:38:08 +00:00
2020-10-25 18:01:31 +00:00
::
2020-10-20 15:38:08 +00:00
2020-10-25 18:01:31 +00:00
~/PyInventory$ make docker_createsuperuser
2020-10-14 08:03:51 +00:00
2020-10-17 17:38:06 +00:00
-----------
Screenshots
-----------
2020-10-24 17:34:55 +00:00
|PyInventory v0.2.0 screenshot 1.png|
2020-10-17 17:38:06 +00:00
2020-10-24 17:34:55 +00:00
.. |PyInventory v0.2.0 screenshot 1.png| image :: https://raw.githubusercontent.com/jedie/jedie.github.io/master/screenshots/PyInventory/PyInventory v0.2.0 screenshot 1.png
2020-10-17 17:38:06 +00:00
----
2020-10-17 20:26:28 +00:00
|PyInventory v0.1.0 screenshot 2.png|
2020-10-17 17:38:06 +00:00
2020-10-17 20:26:28 +00:00
.. |PyInventory v0.1.0 screenshot 2.png| image :: https://raw.githubusercontent.com/jedie/jedie.github.io/master/screenshots/PyInventory/PyInventory v0.1.0 screenshot 2.png
2020-10-17 17:38:06 +00:00
----
2020-10-17 20:26:28 +00:00
|PyInventory v0.1.0 screenshot 3.png|
2020-10-17 17:38:06 +00:00
2020-10-17 20:26:28 +00:00
.. |PyInventory v0.1.0 screenshot 3.png| image :: https://raw.githubusercontent.com/jedie/jedie.github.io/master/screenshots/PyInventory/PyInventory v0.1.0 screenshot 3.png
2020-10-17 17:38:06 +00:00
----
2020-10-24 15:15:05 +00:00
----------------
Multi user usage
----------------
PyInventory supports multiple users. The idea:
* Every normal user sees only his own created database entries
* All users used the Django admin
Note: All created Tags are shared for all existing users!
So setup a normal user:
* Set "Staff status"
* Unset "Superuser status"
* Add user to "normal_user" group
* Don't add any additional permissions
e.g.:
|normal user example|
.. |normal user example| image :: https://raw.githubusercontent.com/jedie/jedie.github.io/master/screenshots/PyInventory/PyInventory normal user example.png
2020-10-14 08:03:51 +00:00
------------------------------
Backwards-incompatible changes
------------------------------
Nothing, yet ;)
-------
history
-------
2020-10-24 17:34:55 +00:00
* `compare v0.2.0...master <https://github.com/jedie/PyInventory/compare/v0.2.0...master> `_ **dev**
2020-10-14 08:03:51 +00:00
2020-10-26 16:57:16 +00:00
* tbc
* `v0.3.0 - 26.10.2020 <https://github.com/jedie/PyInventory/compare/v0.2.0...v0.3.0> `_
* setup production usage:
* Use `caddy server <https://caddyserver.com/> `_ as reverse proxy
* Use uWSGI as application server
* autogenerate `` secret.txt `` file for `` settings.SECRET_KEY ``
* Fix settings
2020-10-25 18:01:31 +00:00
* split settings for local development and production use
2020-10-26 16:57:16 +00:00
* Bugfix init: move "setup user group" from checks into "post migrate" signal handler
* Bugfix for using manage commands `` dumpdata `` and `` loaddata ``
2020-10-14 08:03:51 +00:00
2020-10-24 17:34:55 +00:00
* `v0.2.0 - 24.10.2020 <https://github.com/jedie/PyInventory/compare/v0.1.0...v0.2.0> `_
* Simplify item change list by nested item
* Activate Django-Import/Export
* Implement multi user usage
* Add Django-dbbackup
* Add docker-compose usage
2020-10-17 17:38:06 +00:00
* `v0.1.0 - 17.10.2020 <https://github.com/jedie/PyInventory/compare/v0.0.1...v0.1.0> `_
* Enhance models, admin and finish project setup
2020-10-14 08:03:51 +00:00
* v0.0.1 - 14.10.2020
* Just create a pre-alpha release to save the PyPi package name ;)
-----
links
-----
+----------+------------------------------------------+
| Homepage | `http://github.com/jedie/PyInventory`_ |
+----------+------------------------------------------+
| PyPi | `https://pypi.org/project/PyInventory/`_ |
+----------+------------------------------------------+
.. _http: //github.com/jedie/PyInventory: http://github.com/jedie/PyInventory
.. _https: //pypi.org/project/PyInventory/: https://pypi.org/project/PyInventory/
2020-10-24 12:15:29 +00:00
Discuss here:
* `vogons.org Forum Thread (en) <https://www.vogons.org/viewtopic.php?f=5&t=77285> `_
* `VzEkC e. V. Forum Thread (de) <https://forum.classic-computing.de/forum/index.php?thread/21738-opensource-projekt-pyinventory-web-basierte-verwaltung-um-seine-dinge-zu-katalog/> `_
* `dosreloaded.de Forum Thread (de) <https://dosreloaded.de/forum/index.php?thread/3702-pyinventory-retro-sammlung-katalogisieren/> `_
2020-10-14 08:03:51 +00:00
--------
donation
--------
* `paypal.me/JensDiemer <https://www.paypal.me/JensDiemer> `_
* `Flattr This! <https://flattr.com/submit/auto?uid=jedie&url=https%3A%2F%2Fgithub.com%2Fjedie%2FPyInventory%2F> `_
* Send `Bitcoins <http://www.bitcoin.org/> `_ to `1823RZ5Md1Q2X5aSXRC5LRPcYdveCiVX6F <https://blockexplorer.com/address/1823RZ5Md1Q2X5aSXRC5LRPcYdveCiVX6F> `_
------------
2020-10-26 16:57:16 +00:00
`` Note: this file is generated from README.creole 2020-10-26 17:56:17 with "python-creole" ``
