arcon

library0.4.0pypypi✓ verified 85d ago

arcon is a Python library (v0.4.0) for persistent runtime configuration. It provides a CLI argument parser that can load defaults from a pyproject.toml file, reducing boilerplate. It requires Python >=3.8, <4.0 and is released on an irregular cadence.

serialization

pip install arcon

github ↗package ↗homepage ↗docs ↗

INSTALL

IMPORT

SIG · ARCON

arcon

serializationpythonv0.4.0

Install

1.7s avg

Import

42ms

Disk

16MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.4.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.046s · 18MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 1.7s · import 0.038s · 19MB

16MB installed

● package 16MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ArgumentParser

✓ from arcon import ArgumentParser

Arcon's ArgumentParser subclass with config loading

Basic CLI with pyproject.toml support – if a pyproject.toml exists with [tool.arcon] keys, they serve as defaults.

from arcon import ArgumentParser parser = ArgumentParser() parser.add_argument('--name', type=str, default='world') args = parser.parse_args() print(f"Hello, {args.name}!")

Debug

Known issues

gotchaDashes in argument names are not supported; use underscores instead.

fix

Use underscores: --my-arg → my_arg

affects: <=0.1.1

gotchapyproject.toml must be in the current or parent directory; arcon walks up to the root.

fix

Ensure pyproject.toml is in the project root (the directory containing your script's parent).

affects: >=0.3.1

gotchaOnly simple types (str, int, float, bool) are supported for pyproject.toml defaults; complex types may cause silent failures.

fix

Use only simple types or override via command-line.

affects: >=0.1.0

Errors

Common errors & fixes

AttributeError: module 'arcon' has no attribute 'ArgumentParser'

Incorrect import: from arcon import arcon or import arcon.ArgumentParser

fix

Use: from arcon import ArgumentParser

TypeError: __init__() got an unexpected keyword argument 'config'

Trying to pass a config path directly to ArgumentParser (not supported) or using an older version.

fix

Check version; from arcon import ArgumentParser; parser = ArgumentParser() — config is handled automatically via pyproject.toml.

arcon.exceptions.ArconConfigError: No pyproject.toml found

No pyproject.toml in the project tree, or the file is not readable.

fix

Create a pyproject.toml at the project root, or use parser = ArgumentParser(pyproject=False) to disable config loading.

Upgrade

Version history

0.4.0latest on PyPI · released Apr 9, 2024

Audit

Dependencies

tomlioptionalParsing pyproject.toml config

Agent activity

23 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/jshwi/arcon ↗

packagehttps://pypi.org/project/arcon/ ↗

homepagehttps://pypi.org/project/arcon/ ↗

docshttps://arcon.readthedocs.io/en/latest ↗