Metadata-Version: 2.1
Name: JsonPreprocessor
Version: 0.3.1
Summary: Preprocessor for json files
Home-page: https://github.com/test-fullautomation/python-jsonpreprocessor
Author: Mai Dinh Nam Son
Author-email: son.maidinhnam@vn.bosch.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development
Requires-Python: >=3.0
Description-Content-Type: text/markdown
License-File: LICENSE

Json Preprocessor\'s Package Description
========================================

Getting Started
---------------

The **JsonPreprocessor** is a Python3 package which allows programmers
to handle additional features in JSON files such as

-   add comments
-   import other json files
-   overwrite already existing parameters with new values

These JSON files will be handled by the **JsonPreprocessor** which
returns as result a dictionary object of the deserialized data.

How to install
--------------

The **JsonPreprocessor** can be installed in two different ways.

1.  Installation via PyPi (recommended for users)

    ``` {.}
    pip install JsonPreprocessor
    ```

    [JsonPreprocessor in
    PyPi](https://pypi.org/project/JsonPreprocessor/)

2.  Installation via GitHub (recommended for developers)

    -   Clone the **JsonPreprocessor** repository to your machine.

        ``` {.}
        git clone https://github.com/test-fullautomation/python-jsonpreprocessor.git
        ```

        [JsonPreprocessor in
        GitHub](https://github.com/test-fullautomation/python-jsonpreprocessor)

    -   Install dependencies

        **JsonPreprocessor** requires some additional Python libraries.
        Before you install the cloned repository sources you have to
        install the dependencies manually. The names of all related
        packages you can find in the file `requirements.txt` in the
        repository root folder. Use pip to install them:

        ``` {.}
        pip install -r ./requirements.txt
        ```

        Additionally install **LaTeX** (recommended: TeX Live). This is
        used to render the documentation.

    -   Configure dependencies

        The installation of **JsonPreprocessor** includes to generate
        the documentation in PDF format. This is done by an application
        called **GenPackageDoc**, that is part of the installation
        dependencies (see `requirements.txt`).

        **GenPackageDoc** uses **LaTeX** to generate the documentation
        in PDF format. Therefore **GenPackageDoc** needs to know where
        to find **LaTeX**. This is defined in the **GenPackageDoc**
        configuration file

        ``` {.}
        packagedoc\packagedoc_config.json
        ```

        Before you start the installation you have to introduce the
        following environment variable, that is used in
        `packagedoc_config.json`:

        -   `GENDOC_LATEXPATH` : path to `pdflatex` executable

    -   Use the following command to install **JsonPreprocessor**:

        ``` {.}
        setup.py install
        ```

Package Documentation
---------------------

A detailed documentation of the Json Preprocessor\'s package can be
found here:
[JsonPreprocessor.pdf](https://github.com/test-fullautomation/python-jsonpreprocessor/blob/develop/JsonPreprocessor/JsonPreprocessor.pdf)

Feedback
--------

To give us a feedback, you can send an email to [Thomas
Pollerspöck](mailto:Thomas.Pollerspoeck@de.bosch.com)

In case you want to report a bug or request any interesting feature,
please don\'t hesitate to raise a ticket.

Maintainers
-----------

[Thomas Pollerspöck](mailto:Thomas.Pollerspoeck@de.bosch.com)

Contributors
------------

[Mai Dinh Nam Son](mailto:son.maidinhnam@vn.bosch.com)

[Tran Duy Ngoan](mailto:Ngoan.TranDuy@vn.bosch.com)

License
-------

Copyright 2020-2023 Robert Bosch GmbH

Licensed under the Apache License, Version 2.0 (the \"License\"); you
may not use this file except in compliance with the License. You may
obtain a copy of the License at

> [![License: Apache
> v2](https://img.shields.io/pypi/l/robotframework.svg)](http://www.apache.org/licenses/LICENSE-2.0.html)

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an \"AS IS\" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.


