Daktari is a tool to help the initial setup and ongoing maintenance of developer environments. It runs a series of checks (for example, that required software is installed) and provides suggestions on how to fix the issue if the check fails.
Configuration
In the root of the project repository, create a .daktari.py configuration file listing the checks you want run. For example,
from daktari.checks.git import *
version = "0.0.355"
title = "My Project"
checks = [
GitInstalled(),
GitLfsInstalled(),
GitLfsSetUpForUser(),
GitLfsFilesDownloaded(),
GitCryptInstalled(),
]
Then run daktari to diagnose your environment:
$ daktari
✅ [git.installed] Git is installed
✅ [git.lfs.installed] Git LFS is installed
✅ [git.lfs.setUpForUser] Git LFS is set up for the current user
✅ [git.lfs.filesDownloaded] Git LFS files have been downloaded
❌ [git.crypt.installed] git-crypt is not installed
┌─💡 Suggestion ─────────┐
│ brew install git-crypt │
└────────────────────────┘
Custom Check
You can write a custom check as a Python class within .daktari.py, and include it in your list of checks. Example of a check implementation:
class GitCryptInstalled(Check):
name = "git.crypt.installed"
depends_on = [GitInstalled]
suggestions = {
OS.OS_X: "<cmd>brew install git-crypt</cmd>",
OS.UBUNTU: "<cmd>sudo apt install git-crypt</cmd>",
OS.GENERIC: "Install git-crypt (https://www.agwa.name/projects/git-crypt/)",
}
def check(self):
return self.verify(can_run_command("git crypt version"), "git-crypt is <not/> installed")
Testing Daktari changes locally
Having cloned the repo into ~/daktari, you can make use of PYTHONPATH to run daktari using your local changes.
To do this, navigate into a directory that has a .daktari.py (e.g. another repository intending to use your change) and run:
PYTHONPATH=~/daktari python3 -m daktari --debug
Release instructions
Daktari is continuously deployed via a github action - see release.yaml. In case of a need to manually release, the steps are:
bumpversion --verbose patch
python -m build
twine check dist/*
twine upload dist/*
2 maintainers
Metadata
2 maintainers
Release files for daktari 0.0.355
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| daktari-0.0.355.tar.gz | 47.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| daktari-0.0.355-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 114.7 kB
Release files / daktari-0.0.355.tar.gz
| Download URL | daktari-0.0.355.tar.gz |
|---|---|
| Size | 47.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3e95f9589dae01a5eb3d56ba70f2b5865b17f5273f4b6fbe9b2a88b983e77635
|
|
BLAKE2b-256 checksum How to use checksums |
7770d57492a90b233cd0a7996ed435cb2460769eccdad1e48b4ae88c0cc58bf0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / daktari-0.0.355-py3-none-any.whl
| Download URL | daktari-0.0.355-py3-none-any.whl |
|---|---|
| Size | 67.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
207da99f84bd25b2abc35fb6e2588dea8bae8ae83a6fe24c48e1b7034d852dd4
|
|
BLAKE2b-256 checksum How to use checksums |
39f77faeed19f4c5f02ab2ccfd4e5d6a1892ef072b1ebf0a2555fe6405bb9aab
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
