equilibrium

Equilibrium (noun): A state in which opposing forces or influences are balanced, resulting in a stable system that does not undergo significant changes. In a broader sense, equilibrium can refer to a state of mental or emotional balance, as well as the balance of forces in physical or chemical systems.

Equilibrium is a framework for implementing control loops and is heavily Kubernets-inspired. A control loop is a system that continuously monitors the state of a system and takes action to bring the system into a desired state. It is designed to be extensible and flexible, allowing you to implement control loops that are tailored to your specific use case.

Installation

Equilibrium is available on PyPI. You need at least Python 3.10.

pip install python-equilibrium

Example

Check out the examples/local_file/ directory for a simple example of a control loop that monitors a local file and takes action when the file is modified.

graph LR
  subgraph Equilibrium
    LocalFile["Resource[LocalFile]"] --> LocalFileController
  end
  subgraph "Local filesystem"
    LocalFileController --> LocalFileModification["Local filesystem changes"]
  end
  subgraph "State Backend"
    LocalFileController --> State["Last known state"]
  end

Difference to Kubernetes resources

Equilibrium does not currently support any key other than spec next to apiVersion, kind, and metadata in a resource definition. This means Equilibrium cannot be used to deserialize actual Kubernetes Secret of Config resources.

Metadata

Release files for python-equilibrium 0.7.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for python-equilibrium 0.7.2
File	Size	Uploaded
python_equilibrium-0.7.2.tar.gz	21.8 kB	Jun 29, 2023	Details

Built distribution (wheel)

Table of built distributions (wheels) for python-equilibrium 0.7.2
File	Interpreter	ABI	Platform	Reset
python_equilibrium-0.7.2-py3-none-any.whl 28.6 kB Jun 29, 2023	Python 3	none	any	Details

Total release size: 50.4 kB

Release files / python_equilibrium-0.7.2.tar.gz

Download URL	python_equilibrium-0.7.2.tar.gz
Size	21.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`34602354b84b7321117ef5617177b9a459d0e30391044b60077dc4b94f04bbaa`
BLAKE2b-256 checksum How to use checksums	`5af5a066e40bd8dd031ffd9b2931c4336ab5f6e434e8bcc378855694b3479a0e`
Upload date	Jun 29, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.8.0 pkginfo/1.8.3 readme-renderer/37.3 requests/2.28.1 requests-toolbelt/0.10.1 urllib3/1.26.12 tqdm/4.64.1 importlib-metadata/5.0.0 keyring/23.11.0 rfc3986/2.0.0 colorama/0.4.6 CPython/3.10.11`

Release files / python_equilibrium-0.7.2-py3-none-any.whl

Download URL	python_equilibrium-0.7.2-py3-none-any.whl
Size	28.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`749aca39216ed621ef588015ea341a1a5a560137ba4c1b030bdda4bfe9fb3310`
BLAKE2b-256 checksum How to use checksums	`5cbfedcbbe5b81649cd26bdcbf104b6ce953766a72cf8ca6e4a527ce60b7e9fb`
Upload date	Jun 29, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.8.0 pkginfo/1.8.3 readme-renderer/37.3 requests/2.28.1 requests-toolbelt/0.10.1 urllib3/1.26.12 tqdm/4.64.1 importlib-metadata/5.0.0 keyring/23.11.0 rfc3986/2.0.0 colorama/0.4.6 CPython/3.10.11`