Metadata-Version: 2.4
Name: tjost
Version: 0.1.0
Summary: Easily manage virtual machine setups for test environments.
Project-URL: Homepage, https://github.com/chronicc/tjost
Project-URL: Issues, https://github.com/chronicc/tjost/issues
License-File: LICENSE
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Requires-Dist: click>=8.3.0
Requires-Dist: gitpython>=3.1.45
Requires-Dist: jsonschema-default>=1.8.1
Requires-Dist: jsonschema>=4.25.1
Requires-Dist: pyyaml>=6.0.3
Provides-Extra: systemd
Requires-Dist: systemd-python>=235; extra == 'systemd'
Description-Content-Type: text/markdown

Tjost
=====

Easily manage virtual machine setups for test environments.

Getting started
---------------

1. Install tjost with `pip install tjost`.
2. Run `tjost` and use the help messages to navigate the tool.

Usage
-----

### Shell Completion

To enable shell completion run one of the following commands.

```shell
# Bash
eval "$(_TJOST_COMPLETE=bash_source tjost)"

# Zsh
eval "$(_TJOST_COMPLETE=zsh_source tjost)"

# Fish
_TJOST_COMPLETE=fish_source tjost | source
```

### Journald logging

To enable journald logging, install the optional dependencies for systemd.

```shell
# Use the package that is provided by your os manufacturer
sudo apt install libsystemd-dev

# Install the systemd dependencies for tjost
pip install tjost[systemd]
```

Configure journald logging in the configuration.

```yaml
# .tjost.yaml

logging:
  journal:
    enabled: true
```

Development
-----------

1. Install [uv](https://docs.astral.sh/uv/getting-started/installation/).
2. Run `uv sync` to install the python dependencies.
3. Run `source .venv/bin/activate` to activate the python virtual environment.
