Skip to main content

Turn-key configuration file management for Python packages.

Project description

Trapdoor

Actions: CI Status Actions: CI Status PyPI PyPI: Downloads Code Coverage License: MIT

Turn-key configuration file management for Python packages.
Explore the docs »

Request Feature · Report Bug · ⭐ Consider starring the repo! ⭐

🎨 Features

  • Config Files. Trapdoor makes it easy to create and maintain TOML configuration files.
  • Minimal Configuration. Set your store name and start setting and getting keys from the configuration file. Sane defaults are set and useful for most cases.
  • Secure Practices. By default, configuration directories are created to be only readable by the user who created them.

📚 Getting Started

Installation

Python Package Index

You can also install trapdoor using the Python Package Index (PyPI).

pip install trapdoor

🚌 A Quick Tour

At its foundation, trapdoor is meant to ease the process of creating and maintaining configuration files within your Python tool. Commonly, you will want to use it to create a configuration store, get existing configuration keys, and set configuration keys.

If you're interested in a complete overview of trapdoor's capabilities, please see the documentation pages.

# import trapdoor
from trapdoor import Trapdoor

t = Trapdoor('trapdoor-test')           # create a store at ~/.trapdoor-test/config.yml (by default)
t.set('some.nested.key.hello', 'world') # set a key in the configuration file
t.get('some.nested.key.hello')          # get a key from the configuration file

For more information, please see the documentation.

🤝 Contributing

Contributions, issues and feature requests are welcome!
Feel free to check issues page. Please ensure you fill out the entire template for each of these. You can also take a look at the contributing guide.

📝 License

Copyright © 2021 Clay McLeod. This project is MIT licensed.

Project details


Download files

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

Source Distribution

trapdoor-0.6.0.tar.gz (7.8 kB view details)

Uploaded Source

Built Distribution

trapdoor-0.6.0-py3-none-any.whl (8.6 kB view details)

Uploaded Python 3

File details

Details for the file trapdoor-0.6.0.tar.gz.

File metadata

  • Download URL: trapdoor-0.6.0.tar.gz
  • Upload date:
  • Size: 7.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.9.6 readme-renderer/37.3 requests/2.31.0 requests-toolbelt/1.0.0 urllib3/2.0.6 tqdm/4.66.1 importlib-metadata/6.7.0 keyring/24.1.1 rfc3986/2.0.0 colorama/0.4.6 CPython/3.11.5

File hashes

Hashes for trapdoor-0.6.0.tar.gz
Algorithm Hash digest
SHA256 ae822e4b39b7b6221be6a11a72975cf193139df299f951deb057438041a3a884
MD5 9e0439503730c18f58022aa2752f4e9f
BLAKE2b-256 ccbaa08321dd9c328ab3185cbf82552b1b67fc2276dfaa2102305758832968ae

See more details on using hashes here.

File details

Details for the file trapdoor-0.6.0-py3-none-any.whl.

File metadata

  • Download URL: trapdoor-0.6.0-py3-none-any.whl
  • Upload date:
  • Size: 8.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.8.0 pkginfo/1.9.6 readme-renderer/37.3 requests/2.31.0 requests-toolbelt/1.0.0 urllib3/2.0.6 tqdm/4.66.1 importlib-metadata/6.7.0 keyring/24.1.1 rfc3986/2.0.0 colorama/0.4.6 CPython/3.11.5

File hashes

Hashes for trapdoor-0.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f654fdfa07e64fbc1134cff268e0162b1d351de9caa16c9a379b231a92e2fda0
MD5 988b05a888f8d585731542fc826302a9
BLAKE2b-256 aeb0a5407f0d9c237fd00ad503d796f814183572d55bfb2606843882723b2a51

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page