libfelix

Felix' library of snippets.

few dependencies
keep it simple

Installation

uv add libfelix
uv add libfelix[full]

libfelix.git

>>> from libfelix.git import Repo
>>> r = Repo('.')
>>> r.head
'9e260ece8558ba9a6c4ad6a9c89905630fe0140b'

libfelix.infra

pyinfra-related stuff.

from libfelix.infra import basics, provision

# ssh-keyscan -t ssh-ed25519 -H sdf.org
basics.ensure_known_host(
    host_key=...,
)

basics.ssh_key_whitelist(
    keys=[
        'ssh-ed25519 ...',
    ]
)

provision.repo()
provision.felix_configs()
provision.docker()

basics.mise()
basics.fnox()

basics.mise_trust(dir_name=...)

See e2e-tests/deploy.py for details.

`@tofu` Connector

This also comes with a @tofu connector that is similar to the @terraform connector.

pyinfra @tofu/foo fact server.LinuxName
PYINFRA_TOFU_DIR=../another-state pyinfra @tofu/bar fact server.LinuxName

libfelix.music ¹

Controls music players via dbus (org.mpris.MediaPlayer2.Player) and scores them based on a simple heuristic (see score_players in libfelix/music/api.py).

$ music --help
Usage: music [OPTIONS] COMMAND [ARGS]...

Options:
  --help  Show this message and exit.

Commands:
  Next
  PlayPause
  Previous
  players

libfelix.logging

Opinionated settings for Structlog:

log to STDERR
configure the log level by setting the environment variable LOGLEVEL

from libfelix.logging import configure_structlog_console_from_env, get_logger

configure_structlog_console_from_env()
log = get_logger()
log.info('...')

libfelix.rename_scans ¹

Renames scanned PDFs (from the M365 Android app and shared via KDE Connect) in a directory to a sane format.

felix-kdeconnect-rename-scans ~/Downloads/kdeconnect/

Development

mise trust
mise install
prek install -f
uv sync --all-extras

# to add a dependency to the optional-dependencies [full]
uv add --optional=full boto3

e2e-tests

https://developer.hashicorp.com/vagrant

vagrant plugin install vagrant-libvirt
vagrant up

pyinfra @vagrant
vagrant ssh-config > vagrant_ssh_config

libfelix[full] is required for this feature ↩ ↩²

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

libfelix-1.6.1.tar.gz (16.1 kB view details)

Uploaded Aug 18, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

libfelix-1.6.1-py3-none-any.whl (15.9 kB view details)

Uploaded Aug 18, 2026 Python 3

File details

Details for the file libfelix-1.6.1.tar.gz.

File metadata

Download URL: libfelix-1.6.1.tar.gz
Upload date: Aug 18, 2026
Size: 16.1 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.13.1

File hashes

Hashes for libfelix-1.6.1.tar.gz
Algorithm	Hash digest
SHA256	`1e24af744335a001202718e3866ee9adb67f74828a4271f17ee3790cfc7eb938`
MD5	`f55bda555225fb1d0226768ec812c162`
BLAKE2b-256	`0828510c9586602286c8e79dc76a67cc52daecae922237457d3fb4c14e9291cb`

See more details on using hashes here.

File details

Details for the file libfelix-1.6.1-py3-none-any.whl.

File metadata

Download URL: libfelix-1.6.1-py3-none-any.whl
Upload date: Aug 18, 2026
Size: 15.9 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.13.1

File hashes

Hashes for libfelix-1.6.1-py3-none-any.whl
Algorithm	Hash digest
SHA256	`9df63f53515bd699661e4a035c83f62cb1ae6a10fd4266579106e2c9de9ff19f`
MD5	`5fe470671f8b4d9e922e3f3e46850187`
BLAKE2b-256	`e619171273b20793762b387393ce4cf28797a9512055b64b138ac07067f24733`