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 hashes)

Uploaded Source

Built Distribution

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

Uploaded Python 3

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