Hidori

Hidori is a modern, agentless, zero-dependency¹ variation on updating system state. General rule of thumb is that changes to the system are only done if the requested state is different from the actual state. Hidori modules are idempotent if the system is already in the desired state. Every change in the destination system is reported through the modules log as "affected".

Hidori communicates with destination machines through appropriate protocol that is designated by the chosen driver.

Install

Depending on your environment you might wish to install Hidori globally or locally using chosen Python dependency manager such as poetry or pip. Ultimately, the choice is yours. Either way, Hidori is safe for your Python environment - it does not pull any dependencies from PyPI.

Example using pip:

pip install hidori

Hello World

With Hidori installed you need a single TOML file that provides where and what should be done. A simple 'hello world' example assuming that some machine is available at the given target:

[destinations]

  [destinations.vm]
  target = "192.168.122.31"
  user = "root"

[tasks]

  [tasks."Say hello"]
  module = "hello"

Now you just need to run it (example assumes the file is named pipeline.toml):

hidori-pipeline run pipeline.toml

The result on my machine is:

[root@vm: Say hello]
[16:03:19] OK: Hello from Linux debian 4.19.0-21-amd64

Support

In general, Hidori is based on Python 3.11, but hidori_core runs with any version of Python that is still supported. Reason for that is vast majority of destination systems don't have the latest Python runtime installed, so therefore hidori_core which includes all the code that runs on a destination system can be expected to be supported according to the following table:

Python Version	EOL Date
3.8	November 2024
3.9	November 2025
3.10	November 2026
3.11	November 2027(?)

Development

The dev environment can be setup with poetry:

poetry install

License

Hidori is licensed under both the MIT and the EUPL-1.2 licenses.

Footnotes

1. Except for the necessary runtime - python, and system libraries that are used by modules ↩