PyInventory

Web based management to catalog things including state and location etc. using Python/Django. Store information in WYSIWYG-HTML-Editor field and tag them and add Files, Images and Links to them.

pyinventory_ynh allows you to install PyInventory quickly and simply on a YunoHost server. If you don't have YunoHost, please consult the guide to learn how to install it.

Pull requests welcome!

about

The focus of this project is on the management of retro computing hardware.

Current features:

• Web-based
• Multiuser ready (Every user see and manage only his own entries)
• Chaotic warehousing
  • Grouped "Items" e.g.: Graphics card Foo is in computer Bar
• Data structure kept as general as possible
• Manage information to every item:
  • Description: free WYSIWYG-HTML-Editor field
  • Storage location
  • State
  • Images, Files and Web-Links
  • receiving and delivering (when, from whom, at what price, etc.)
• Manage "Memos" (Information independent of item/location):
  • A free WYSIWYG-HTML-Editor field
  • Tags
  • Images, Files and Web-Links

Future ideas:

• 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... ;)

Screenshots

More screenshots are here: jedie.github.io/tree/master/screenshots/PyInventory

Multi user support

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.:

More screenshots are here: jedie.github.io/tree/master/screenshots/PyInventory

local development installation

e.g.:

# Clone project (Use your fork SSH url!):
~$ git clone https://github.com/jedie/PyInventory.git
~$ cd PyInventory
~/PyInventory$ ./manage.py

Helpful for writing and debugging unittests is to run a local test server. e.g.:

~/PyInventory$ ./manage.py run_dev_server

The web page is available via: http://127.0.0.1:8000/

You can also pass a other port number or ipaddr:port combination. See: ./manage.py run_dev_server --help

Run tests, e.g.:

~/PyInventory$ ./manage.py test
~/PyInventory$ ./manage.py coverage
~/PyInventory$ ./manage.py tox

Install Playwright browsers, e.g.:

~/PyInventory$ .venv/bin/playwright install

Run only Playwright tests with the Playwright Inspector, e.g.:

~/PyInventory$ PWDEBUG=1 ./manage.py test --tag playwright

Backwards-incompatible changes

v0.19.0

• Remove "/development/" (unmaintained "docker-compose" installation), please use YunoHost ;)
• Removed django-processinfo and django-axes in test project.
• Remove poetry, pytest and devshell
• Use pip-tools, unittests and manage_django_project

v0.20

Because of security reasons, the ckeditor package was replaced by prose-editor.

In 0.20.1 we switched to https://github.com/jazzband/django-tinymce/ because prose-editor has no table support.

Make new release

We use cli-base-utilities to generate the history in this README.

To make a new release, do this:

• Increase your project version number
• Run tests to update the README
• commit the changes
• Create release

history

• v0.20.1
  • 2024-09-05 - switched to https://github.com/jazzband/django-tinymce/
• v0.20.0
  • 2024-09-05 - Replace django-ckeditor with django-prose-editor and fix tests
  • 2024-09-05 - Project updates
  • 2024-01-16 - Use typeguard in tests
  • 2024-01-16 - Update requirements
• v0.19.3
  • 2023-11-01 - Auto generate README history
  • 2023-11-01 - Update requirements
  • 2023-10-31 - Bugfix the "parent" field on location admin page
  • 2023-10-31 - Bugfix local test settings for development
  • 2023-10-08 - Use playwrigth manage command from manage-django-project
  • 2023-09-24 - Update test snapshot files
  • 2023-09-24 - Add playwright CLI wrapper command
• v0.19.2
  • 2023-08-17 - Bugfix packaging by adding "requests" as normal dependencies
  • 2023-08-17 - Bugfix packageing by adding "requests" as normal dependencies

links

Discuss here:

• vogons.org Forum Thread (en)
• Python-Forum (de)
• VzEkC e. V. Forum Thread (de)
• dosreloaded.de Forum Thread (de)

donation

• paypal.me/JensDiemer
• Flattr This!
• Send Bitcoins to 1823RZ5Md1Q2X5aSXRC5LRPcYdveCiVX6F