django-hostutils 0.0.6

host utilities for django projects

django-hostutils

Host utilities package for django projects. Bootstrap 5 templates are provided. Host metric data includes:

• Host OS, release, uptime
• CPU count and utilization
• Memory usage
• Disk partations and utilization
• Processes running, idle, sleeping
• Network interfaces and connections

Author	David Slusser
Description	Host utilities package for django projects.
Requirements	Python 3.x + Django 3.2.x +

Code Quality

Workflow	Description	Status
Bandit	security checks
Black	code formatting
Coveralls	code coverage status
Mypy	static type checking
Pytest	unit testing
Radon	code complexity analysis
Ruff	static code analysis
Safety	security vulnerability checks

Code Coverage Dashboard:

https://coveralls.io/github/djangoaddicts/django-hostutils

Documentation

Workflow	Description	Status
Docs	ReadTheDocs Build

Full documentation is available here:

https://django-hostutils.readthedocs.io/en/latest/index.html

License

django-hostutils is licensed under the GNU-3 license (see the LICENSE file for details).

https://github.com/davidslusser/django-hostutils/blob/docs/LICENSE

Installation

• pip install django-hostutils

• add the following to your INSTALLED_APPS

  djangoaddicts.hostutils
  

• add the following to your project-level urls.py:

  path("hostutils/", include("djangoaddicts.hostutils.urls"), ),
  

Usage

Included Views

Several pages are available. If you have a Bootstrap 5 nav-menu you can add the following snippet in your navbar where appropriate:

{% include 'hostutils/bs5/snippets/hostutils_nav_menu.htm' %}

Individual pages can also be linked directly:

• Host overview page:

  {% url 'hostutils:host_details' %}
  

• CPU stats page:

  {% url 'hostutils:host_cpu' %}
  

• Disk stats page:

  {% url 'hostutils:host_disk' %}
  

• Memory stats page:

  {% url 'hostutils:host_memory' %}
  

• Network stats page:

  {% url 'hostutils:host_network' %}
  

• Process stats page:

  {% url 'hostutils:host_process' %}
  

Custom Views

Custom views/templates can be used to override the Bootstrap 5 templates provided by default for GUI views. In your views, import the desired views(s) from hostutils and create a class that inherits the desired hostutils view.

• Here is an example of creating a custom view using ShowHost:

  from djangoaddicts.hostutils.views import ShowHost
  
  class MyCustomShowHostView(ShowHost):
      template_name = "my_custom_template.html"
      title = "My Custom Title"