navconfig 0.9.2

Configuration tool for all Navigator Services Tool for accessing Config info from different sources.

Navigator NavConfig

NavConfig is a configuration tool for getting variables from environment and other sources. Is used by Navigator Framework, but is possible to use in other applications as well.

Navigator NavConfig can load Configuration directives from different sources:

• Environment files (.env)
• Memcached Variables
• INI files (using configParser)
• Redis Server

The main goal of NavConfig is centralize configuration access in a single and immutable unique point of truth.

NavConfig can be shared across several modules.

Installation

pip install navconfig

Quickstart

First of all, let's create a simple configuration environment.

Creates a directory for an .ini file and the environment file.

mkdir {env,etc}

put a .env file inside of "env" folder, the first line is the directive to know where the "ini" file lives (even we can put the .ini file outside of current dir).

CONFIG_FILE=etc/myconfig.ini
APP_NAME=My App

Then, in your code, call navconfig "config" object, and start getting your environment variables inside your application.

from navconfig import config

APP_NAME = config.get('APP_NAME')
# the result is "My App".

but also you can use config as a object:

from navconfig import config

APP_NAME = config.APP_NAME
# the result is "My App".

Working with Environments

NavConfig can load all environment variables (and the .ini files associated with .env file) from different directories, every directory works as a new Environment and you can split your configuration for different environments, like this:

env/
.
├── dev
├── prod
├── staging
└── experimental

Then, you can load your application using the "ENV" environment variable:

ENV=dev python app.py

Configure Logging

NavConfig has owns logging facility, if you load logging_config from Navconfig, you will get a logging configuration using the Python dictConfig format.

also, if you put an environment variable called "logstash_enabled = True", there is a ready to use Logging facility using Logstash.

import logging
from navconfig.logging import (
    logdir,
    loglevel,
    logging_config
)
from logging.config import dictConfig
dictConfig(logging_config)

To use just the logger as expected with logging.getLogger(), e.g.

logger = logging.getLogger('MY_APP_NAME')
logger.info('Hello World')

By default, the current logging configuration make echo to the standard output:

[INFO] 2022-03-11 19:31:39,408 navigator: Hello World

Dependencies

• ConfigParser
• Python-Dotenv
• redis
• pylibmc

Requirements

• Python >= 3.8
• asyncio (https://pypi.python.org/pypi/asyncio/)
• python-dotenv

Contribution guidelines

Please have a look at the Contribution Guide

• Writing tests
• Code review
• Other guidelines

Who do I talk to?

• Repo owner or admin
• Other community or team contact

License

NavConfig is released under MIT license.