detail


Namedetail JSON
Version 0.3.0 PyPI version JSON
download
home_pagehttps://github.com/Opus10/detail
SummaryBuild automations off of structured notes in your project
upload_time2024-10-27 00:10:28
maintainerNone
docs_urlNone
authorWes Kendall
requires_python<4,>=3.9.0
licenseBSD-3-Clause
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # detail

`detail` allows contributors to create structured and configurable notes in a project, providing the ability to do automations such as:

1. Ensuring that contributors add information to pull requests that provide QA instructions, release notes, and associated tickets. The `detail lint` command ensures that notes are present in a pull request and adhere to the schema.

2. Rendering dynamic logs from the notes. `detail log` provides the ability to slice and dice the commit log however you need, pulling in a `notes` variable in a Jinja template with all notes that can be grouped and filtered.

3. Other automations, such as version bumping, Slack posting, ticket comments, etc can be instrumented in continuous integration from the structured notes.

When contributing a change, call `detail` to be prompted for all information defined in the project's detail schema. Information can be collected conditionally based on previous steps all thanks to the [formaldict](https://github.com/Opus10/formaldict) library.

Below is an example of a contributor creating a structured note with the type of change they are making, a summary, a description, and an associated Jira ticket:

![intro.gif](https://raw.githubusercontent.com/opus10/detail/main/docs/static/detail-intro.gif)

Notes are commited to projects, allowing review of them before they are used to perform automations in continuous integration.

## Documentation

[View the detail docs here](https://detail.readthedocs.io/).

## Installation

Install detail with:

    pip3 install detail

## Contributing Guide

For information on setting up detail for development and contributing changes, view [CONTRIBUTING.rst](CONTRIBUTING.rst).

## Creators

- @wesleykendall (Wes Kendall)
- @tomage (Tómas Árni Jónasson)

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/Opus10/detail",
    "name": "detail",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "<4,>=3.9.0",
    "maintainer_email": null,
    "keywords": null,
    "author": "Wes Kendall",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/f7/a0/a24ee062eebfc5b2b00a2d8b203850b87c91f5a339dcb9c8ea6af832d996/detail-0.3.0.tar.gz",
    "platform": null,
    "description": "# detail\n\n`detail` allows contributors to create structured and configurable notes in a project, providing the ability to do automations such as:\n\n1. Ensuring that contributors add information to pull requests that provide QA instructions, release notes, and associated tickets. The `detail lint` command ensures that notes are present in a pull request and adhere to the schema.\n\n2. Rendering dynamic logs from the notes. `detail log` provides the ability to slice and dice the commit log however you need, pulling in a `notes` variable in a Jinja template with all notes that can be grouped and filtered.\n\n3. Other automations, such as version bumping, Slack posting, ticket comments, etc can be instrumented in continuous integration from the structured notes.\n\nWhen contributing a change, call `detail` to be prompted for all information defined in the project's detail schema. Information can be collected conditionally based on previous steps all thanks to the [formaldict](https://github.com/Opus10/formaldict) library.\n\nBelow is an example of a contributor creating a structured note with the type of change they are making, a summary, a description, and an associated Jira ticket:\n\n![intro.gif](https://raw.githubusercontent.com/opus10/detail/main/docs/static/detail-intro.gif)\n\nNotes are commited to projects, allowing review of them before they are used to perform automations in continuous integration.\n\n## Documentation\n\n[View the detail docs here](https://detail.readthedocs.io/).\n\n## Installation\n\nInstall detail with:\n\n    pip3 install detail\n\n## Contributing Guide\n\nFor information on setting up detail for development and contributing changes, view [CONTRIBUTING.rst](CONTRIBUTING.rst).\n\n## Creators\n\n- @wesleykendall (Wes Kendall)\n- @tomage (T\u00f3mas \u00c1rni J\u00f3nasson)\n",
    "bugtrack_url": null,
    "license": "BSD-3-Clause",
    "summary": "Build automations off of structured notes in your project",
    "version": "0.3.0",
    "project_urls": {
        "Documentation": "https://detail.readthedocs.io",
        "Homepage": "https://github.com/Opus10/detail",
        "Repository": "https://github.com/Opus10/detail"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "6d20cd0daea937d908fc32329695e4a702a734b2d13e744b203b0cf2a536f45d",
                "md5": "6d2ebac992f7d26bc2a7215f56d4cc2a",
                "sha256": "fc976fbcdf7b036370db21f57883d7c4d1bb0d3e50b69e7b29644e60c6b33b97"
            },
            "downloads": -1,
            "filename": "detail-0.3.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "6d2ebac992f7d26bc2a7215f56d4cc2a",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<4,>=3.9.0",
            "size": 22056,
            "upload_time": "2024-10-27T00:10:27",
            "upload_time_iso_8601": "2024-10-27T00:10:27.988017Z",
            "url": "https://files.pythonhosted.org/packages/6d/20/cd0daea937d908fc32329695e4a702a734b2d13e744b203b0cf2a536f45d/detail-0.3.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "f7a0a24ee062eebfc5b2b00a2d8b203850b87c91f5a339dcb9c8ea6af832d996",
                "md5": "a028de89d4d18c667aff5aa8d8850b75",
                "sha256": "2a1e5e54ae3818c7ec6a3ef255897302b8b7425f38da97eb380c60ac8437deff"
            },
            "downloads": -1,
            "filename": "detail-0.3.0.tar.gz",
            "has_sig": false,
            "md5_digest": "a028de89d4d18c667aff5aa8d8850b75",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<4,>=3.9.0",
            "size": 18847,
            "upload_time": "2024-10-27T00:10:28",
            "upload_time_iso_8601": "2024-10-27T00:10:28.919063Z",
            "url": "https://files.pythonhosted.org/packages/f7/a0/a24ee062eebfc5b2b00a2d8b203850b87c91f5a339dcb9c8ea6af832d996/detail-0.3.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-10-27 00:10:28",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "Opus10",
    "github_project": "detail",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "circle": true,
    "tox": true,
    "lcname": "detail"
}
        
Elapsed time: 0.38116s