Skip to main content

Simple .rc file loading for your Python projects

Project description


Build Status

Simple .rc file loading for your Python projects. Looks for config files passed via --config as well as typical locations based on your app name:

  • Files provided via --config option (see below)
  • .apprc
  • ~/.config/app

Files are loaded such that files earlier in the above list override settings in later ones. The content of each file is parsed as YAML, falling back to JSON if that fails.


import dotrc

# Loads .apprc, ~/.config/app, etc.
config = dotrc.load('app')


Additional configuration files may be provided via the --config commandline option. This parses sys.argv directly, so load your configs before doing anything that might modify it. Files are loaded in order, so options in later files override options set in earlier ones.

$ python --config .extrarc .lastrc
$ python --config=.extrarc
$ python --config=.1rc --config=.2rc

A list of files will be populated from the commandline arguments until a switch or option is detected. You need to be mindful if you for some reason have config files starting with dashes, so you don't signal the end of your file list.

$ python --config .1rc --config=--.weirdrc
$ python --config=--.1rc --config=--.2rc
$ python --config ./-.1rc ./-.2rc

Project details

Download files

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

Files for dotrc, version 0.1.1
Filename, size File type Python version Upload date Hashes
Filename, size dotrc-0.1.1.tar.gz (2.7 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page