jsonconfigreader 1.3.1

Python JSON configuration reader and parser

Description

Utility that allows to read and parse json config files.

Possible to specify links to the default values in the config (See Usage section).

Installation

1. Install python 3.6+

2. Ensure pip, setuptools, and wheel are installed and up to date

python -m pip install --upgrade pip setuptools wheel

3. Create virtual enviroment (make sure that is not part of the project)

python -m venv <ENV NAME>

or

python -m venv %path%\to\<ENV NAME>

4. Active virtual enviroment

%path%\to\<ENV NAME>\Script\activate

5. Install all project dependencies if needed

pip install -r requirements.txt

6. Install pandoc and pypandoc. Instruction

pip install pypandoc

Usage

Example of the config file:

C:\User\test\qa_hotfix_config.json

{
    "defaults": {
        "dataBaseUrl": "http://db:5000"
    },
    "dataBase1": "<defaults.dataBaseUrl>",
    "dataBase2": "<defaults.dataBaseUrl>"
}

1. Specify that lib in your project dependencies

2. Import from jsonconfigparser.json_config_reader import JsonConfigReader

3. Create an instance of the class passing config folder path and options

config_path = 'C:\User\test\qa_config.json'
json_config_reader = JsonConfigReader(config_path)
config = json_config_reader.get()
file_path = json_config_reader.get_config_file_path()
print(config['dataBase1'])
print(file_path)

>> http://db:5000
>> C:\User\test\qa_config.json

Uploading project to PyPi

1. Change version in setup.py

2. Upload changes to PyPi server

python setup.py sdist upload -r <Repository URL to the PyPi server>

Run unit tests (Example for Visual Studio)

1. From Visual Studio

   1. Click Test -> Run -> All Test

   2. View Test run in Test Explorer

2. From CLI

   1. Navigate into project directory

   2. python -m unittest

Generate docs and updating docs

1. Run easy_install -U sphinx

2. Navigate to docs folder

3. Run sphinx-quickstart

4. Follow instruction