{
    "info": {
        "author": "FAS GmbH",
        "author_email": "daniel.ramirez@fahrerassistenzsysteme.de",
        "bugtrack_url": null,
        "classifiers": [
            "Development Status :: 3 - Alpha",
            "License :: OSI Approved :: MIT License",
            "Operating System :: Microsoft :: Windows",
            "Programming Language :: Python :: 2",
            "Topic :: Software Development :: Pre-processors",
            "Topic :: Utilities"
        ],
        "description": "# YAML Project Configuration Reader\r\n\r\n## Who needs this module?\r\n\r\nAny developer who is developing an application that has to be configured through text files. If you can call a set of such configurations \"a project\", this module might be for you.\r\n\r\n## Example\r\n\r\n* Your application is a code generator.\r\n* The users of your application should be able to decide how the code is generated for different **projects**.\r\n* It can generate code automatically for many languages. You decided that each language would be a **plugin** of your software.\r\n* Depending on different conditions, the code must contain some stuff or not (comments, optimizations, verbose content...). It seems you have different **contexts**\r\n* You would like to have an easy way to define what a project of your application is regarding all possible configurations, like:\r\n  * User wants to generate MATLAB and C code in a project, for debug and release. And for debug it has to generate the development documentation too.\r\n  * This user also wants to generate Python, Node.js and Dockerfiles, for development and release. Roll-out credentials and URLs are different for each context.\r\n\r\n## What is a project?\r\n\r\nWhen developing an application, sometimes it is worth to define a *project* as the entity that our software will work with.\r\n\r\nA project is a set of files with a known format and arranged in a known set of folders.\r\n\r\nIt is defined by a path where the root of such file structure is saved.\r\n\r\n## What provides this module?\r\n\r\n1. This module provides a **convention** about how to arrange your project files and a Python API to read that set of files.\r\n1. It will apply a logic about how plugin and context configurations have to be merged into a **single configuration object**.\r\n\r\n## What does this module not provide?\r\n\r\nThis module does not tell you what configuration attributes you need in your projects, or what plugins or contexts.\r\nYou have to decide if the structure of ```plugins + contexts``` suits your software and decide where to put what.\r\nThen, using the module, you can just call an API function and get a full object where you can read all the attributes you need.   \r\n\r\n### Contexts\r\n\r\nA context is a set of conditions which relate to different ways to run for your application.\r\nThink of ```debug``` or ```release``` in classic development. Or ```development``` and ```production``` when rolling-out.\r\n\r\n### Plugins\r\n\r\nA plugin is an optional piece of your application that needs to be configured in each project.\r\nThe plugin configurations are most of the time the same within a project.\r\n\r\nThink of a report generator plugin; your application does whatever logic with the project and has the option to generate reports.\r\nSuch reports need a format, an output folder, maybe some conventions, a language...These are plugin configurations and they almost do not change, regardless of the context.\r\n\r\n### Overrides\r\n\r\nContexts can, sometimes, override plugin configurations for specific tasks. It is not common, but this module provides an easy way to do this.\r\n\r\n### Configs\r\n\r\nConfigs are mixes of **one context and one or more plugins configurations**.\r\nYour application will probably:\r\n1. Ask for the defined configs in the project\r\n1. Choose one of them\r\n1. Call the YAMLProject API to retrieve the merged configuration from the chosen config\r\n1. Pass the merged object to your logic so values can be used to modify the behavior\r\n\r\n## This module\r\n\r\nThis module creates a structure in memory from a set of YAML files that define a configuration for a project.\r\nA project is an abstract concept modeled as a set of files and folders that is going to be read/written by some software.\r\nThe structure of a project is:\r\n\r\n* A root set of attributes defined at ```root.yaml```. For example: a name, a description, etc.\r\n* A set of plugin configurations. The application processing your project can have plugins. The project configuration provides\r\n\r\n\r\n",
        "description_content_type": "text/markdown",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "http://fahrerassistenzsysteme.de",
        "keywords": "",
        "license": "",
        "maintainer": "",
        "maintainer_email": "",
        "name": "YAML-Project-Loader",
        "package_url": "https://pypi.org/project/YAML-Project-Loader/",
        "platform": "",
        "project_url": "https://pypi.org/project/YAML-Project-Loader/",
        "project_urls": {
            "Homepage": "http://fahrerassistenzsysteme.de",
            "Internal Repository": "http://gogs.kse.local/ramirda/YAML_Project_Loader"
        },
        "release_url": "https://pypi.org/project/YAML-Project-Loader/0.0.4/",
        "requires_dist": null,
        "requires_python": "",
        "summary": "YAML Project Loader",
        "version": "0.0.4"
    },
    "last_serial": 3953313,
    "releases": {
        "0.0.4": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "d048218a62fc88e9a9f7b8434fc7458c",
                    "sha256": "dbc343151eadd9bd6843b93fad81d760afa3fdf95cd2820184f559c2928ed85b"
                },
                "downloads": -1,
                "filename": "YAML_Project_Loader-0.0.4-py2-none-any.whl",
                "has_sig": false,
                "md5_digest": "d048218a62fc88e9a9f7b8434fc7458c",
                "packagetype": "bdist_wheel",
                "python_version": "py2",
                "requires_python": null,
                "size": 5908,
                "upload_time": "2018-06-12T09:48:36",
                "url": "https://files.pythonhosted.org/packages/8f/ef/bdd9c9a3d694ff8d89d8c52c37c552823724b041a9073d38d91f1ed806b1/YAML_Project_Loader-0.0.4-py2-none-any.whl"
            },
            {
                "comment_text": "",
                "digests": {
                    "md5": "64b68c2cb5e89f345e3102292e52d7d6",
                    "sha256": "584e6200bc4bf3f6acd498cf0bc9b985e1c617930c6d7351276bf7053302f59e"
                },
                "downloads": -1,
                "filename": "YAML_Project_Loader-0.0.4.tar.gz",
                "has_sig": false,
                "md5_digest": "64b68c2cb5e89f345e3102292e52d7d6",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 5265,
                "upload_time": "2018-06-12T09:48:37",
                "url": "https://files.pythonhosted.org/packages/f7/ee/afad788d55c79a85cc1ce6cafa4da4e66dc75a0af03f0f8b7fff4bc9247b/YAML_Project_Loader-0.0.4.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "d048218a62fc88e9a9f7b8434fc7458c",
                "sha256": "dbc343151eadd9bd6843b93fad81d760afa3fdf95cd2820184f559c2928ed85b"
            },
            "downloads": -1,
            "filename": "YAML_Project_Loader-0.0.4-py2-none-any.whl",
            "has_sig": false,
            "md5_digest": "d048218a62fc88e9a9f7b8434fc7458c",
            "packagetype": "bdist_wheel",
            "python_version": "py2",
            "requires_python": null,
            "size": 5908,
            "upload_time": "2018-06-12T09:48:36",
            "url": "https://files.pythonhosted.org/packages/8f/ef/bdd9c9a3d694ff8d89d8c52c37c552823724b041a9073d38d91f1ed806b1/YAML_Project_Loader-0.0.4-py2-none-any.whl"
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "64b68c2cb5e89f345e3102292e52d7d6",
                "sha256": "584e6200bc4bf3f6acd498cf0bc9b985e1c617930c6d7351276bf7053302f59e"
            },
            "downloads": -1,
            "filename": "YAML_Project_Loader-0.0.4.tar.gz",
            "has_sig": false,
            "md5_digest": "64b68c2cb5e89f345e3102292e52d7d6",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 5265,
            "upload_time": "2018-06-12T09:48:37",
            "url": "https://files.pythonhosted.org/packages/f7/ee/afad788d55c79a85cc1ce6cafa4da4e66dc75a0af03f0f8b7fff4bc9247b/YAML_Project_Loader-0.0.4.tar.gz"
        }
    ]
}