{
    "info": {
        "author": "Andres Riancho",
        "author_email": "andres.riancho@gmail.com",
        "bugtrack_url": null,
        "classifiers": [
            "Development Status :: 5 - Production/Stable",
            "Intended Audience :: Developers",
            "License :: OSI Approved :: GNU General Public License v2 (GPLv2)",
            "Natural Language :: English",
            "Operating System :: POSIX :: Linux",
            "Programming Language :: Python",
            "Programming Language :: Python :: 2.7",
            "Topic :: System :: Monitoring"
        ],
        "description": "Motivation\n==========\n\nWhen building complex docker ecosystems it's important to uniquely tag each\ndocker build before pushing it to the registry. This allows you to move back\nand forward in time by using different versions of the docker image, pin\nthe production/QA/staging environments to different tags, etc.\n\nInstallation\n============\n\n::\n\n    $ pip install --upgrade docker-tag-naming\n\n\nCommands\n========\n\nOne of the most interesting features which comes with using `docker-tag-naming`\nis that it's now possible to query which tag is the latest in a specific branch:\n\n::\n\n    $ docker-tag-naming latest andresriancho/w3af develop\n    v112-01460cd-develop\n\nAccording to our convention `112` is the version number, `01460cd` is the `git`\ncommit ID and `develop` is the branch.\n\nIt's possible to manually forge a new version tag to be used in any registry\nimage:\n\n::\n\n    $ docker-tag-naming forge --version 332 --commit-id cd14580 --branch master\n    v332-cd14580-master\n\nBut the most interesting feature is to `bump` the version:\n\n::\n\n    $ docker-tag-naming bump andresriancho/w3af develop --commit-id cd14580\n    v113-cd14580-develop\n\nPlease note that `113` was created by retrieving the latest version tag from the\n`andresriancho/w3af` repository and performing a `+1`.\n\n\nContinuous delivery usage\n=========================\n\nThese are just a couple of examples to show how to use `docker-tag-naming` with\ncontinuous delivery. First in the base image use `bump` to tag and push the\nversion:\n\n::\n\n    $ export NEXT_TAG=`docker-tag-naming bump username/base-image ${BRANCH} --commit-id ${COMMIT_ID}`\n    $ docker tag username/base-image username/base-image:$NEXT_TAG\n    $ docker push username/base-image:$NEXT_TAG\n\nThen in the build where the base image is used, query the latest:\n\n::\n\n    $ export LATEST_TAG=`docker-tag-naming latest username/base-image develop`\n    $ render-compose --latest-base-image $LATEST_TAG\n    $ docker-compose up\n\nUsing these steps will guarantee that the latest available image is always used\nin your builds.\n\nAuthentication and private images\n=================================\n\nIn order to list tag names from private images `docker-tag-naming` requires\ncredentials, these can be set using the environment variables `REGISTRY_USER`\nand `REGISTRY_PASS`:\n\n::\n\n    $ export REGISTRY_USER=username\n    $ export REGISTRY_PASS=password\n    $ docker-tag-naming bump username/private develop --commit-id cd14580\n\n\nImportant disclaimer\n====================\n\nThe docker registry/hub (https://registry.hub.docker.com/) seems to have a delay\nbetween what's shown through the web interface (your browser) and the REST API.\nTake this into account when using these commands in continuous integration\nscripts, since your recently pushed tags might not appear right away!\n\nA command that might help as a workaround is `docker-tag-naming refresh` which\nwill query the API until a new version is available or the timeout is reached:\n\n::\n\n    $ docker-tag-naming refresh username/base-image develop\n    Initial version is v113-cd14580-develop , waiting for new release...\n    New version found: v114-5151bc0-develop\n\n    $ docker-tag-naming latest andresriancho/w3af develop\n    v114-5151bc0-develop\n\n\nReporting bugs\n==============\n\nReport your issues and feature requests in `docker-tag-naming's issue\ntracker <https://github.com/andresriancho/docker-tag-naming>`_ and we'll\nbe more than glad to fix them.\n\nPull requests are more than welcome!\n\nBuild status\n============\n\n.. image:: https://circleci.com/gh/andresriancho/docker-tag-naming.svg?style=svg\n    :target: https://circleci.com/gh/andresriancho/docker-tag-naming",
        "description_content_type": null,
        "docs_url": null,
        "download_url": "UNKNOWN",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/andresriancho/docker-tag-naming/",
        "keywords": null,
        "license": "GNU General Public License v2 (GPLv2)",
        "maintainer": null,
        "maintainer_email": null,
        "name": "docker-tag-naming",
        "package_url": "https://pypi.org/project/docker-tag-naming/",
        "platform": "Linux",
        "project_url": "https://pypi.org/project/docker-tag-naming/",
        "project_urls": {
            "Download": "UNKNOWN",
            "Homepage": "https://github.com/andresriancho/docker-tag-naming/"
        },
        "release_url": "https://pypi.org/project/docker-tag-naming/1.0.6/",
        "requires_dist": null,
        "requires_python": null,
        "summary": "Name and query docker tags",
        "version": "1.0.6"
    },
    "last_serial": 1626480,
    "releases": {
        "1.0.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "a1cace8603db03a99a27cd73955e4d03",
                    "sha256": "197660b93d5521b3a1660ce17e877c7d1ed98013b98fbedd58d497ddf08a1705"
                },
                "downloads": -1,
                "filename": "docker-tag-naming-1.0.0.tar.gz",
                "has_sig": false,
                "md5_digest": "a1cace8603db03a99a27cd73955e4d03",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 5154,
                "upload_time": "2015-07-02T15:16:02",
                "url": "https://files.pythonhosted.org/packages/67/6e/aa3285e23e89e9151bfc6f4e0cedad7d0fbcbeb97060d1d230b835e092a2/docker-tag-naming-1.0.0.tar.gz"
            }
        ],
        "1.0.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "12f6ec8a3bd1c6b8e9955af1534b4dc9",
                    "sha256": "cd8f3aee66b844769beddba76a0d2034b8647e52e6737a7891c21119708c6011"
                },
                "downloads": -1,
                "filename": "docker-tag-naming-1.0.1.tar.gz",
                "has_sig": false,
                "md5_digest": "12f6ec8a3bd1c6b8e9955af1534b4dc9",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 5219,
                "upload_time": "2015-07-02T15:32:18",
                "url": "https://files.pythonhosted.org/packages/22/a7/1650a7d245ea080d072341c1b04e81feab59383bd6afef358ecb65048385/docker-tag-naming-1.0.1.tar.gz"
            }
        ],
        "1.0.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "7cb836350e98f645a99612bd656c9afe",
                    "sha256": "a6ee0e491be8114a5829dc995dc37cd9e57c777c5a027b5e059c1e6234821b04"
                },
                "downloads": -1,
                "filename": "docker-tag-naming-1.0.2.tar.gz",
                "has_sig": false,
                "md5_digest": "7cb836350e98f645a99612bd656c9afe",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 5228,
                "upload_time": "2015-07-02T15:41:02",
                "url": "https://files.pythonhosted.org/packages/68/6d/cc2b4e566baa73478089c3714a28cb13c54a4b6c868ac017882e3e1f9f25/docker-tag-naming-1.0.2.tar.gz"
            }
        ],
        "1.0.3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "284d92bd3f30a49b21fda8db790967c9",
                    "sha256": "a2130536c630743f0fb2810dfdfcbf1d00a0618ad67d085ae78bff1990e9a432"
                },
                "downloads": -1,
                "filename": "docker-tag-naming-1.0.3.tar.gz",
                "has_sig": false,
                "md5_digest": "284d92bd3f30a49b21fda8db790967c9",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 5453,
                "upload_time": "2015-07-02T15:47:01",
                "url": "https://files.pythonhosted.org/packages/b7/6f/5143d8d10c047eaa250004e892ec5f753aa7f2660075784c844f188d5d37/docker-tag-naming-1.0.3.tar.gz"
            }
        ],
        "1.0.4": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "d95c00f2da507574dd87625c9d5df784",
                    "sha256": "5bbd48257f03c43e1895c51850988b9f3e1a213713d2f2a7ec9dd02fc27e7a20"
                },
                "downloads": -1,
                "filename": "docker-tag-naming-1.0.4.tar.gz",
                "has_sig": false,
                "md5_digest": "d95c00f2da507574dd87625c9d5df784",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 5829,
                "upload_time": "2015-07-02T17:37:54",
                "url": "https://files.pythonhosted.org/packages/83/50/da41d7721e15f66a857c0ffc5162ad0bbd7812da317e6fb1b85ff5379dd0/docker-tag-naming-1.0.4.tar.gz"
            }
        ],
        "1.0.5": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "1bb9cb28795be5834974e9a78bad9f44",
                    "sha256": "d74e11508dcd7cc023ebacce9e104c9e1545245e4c47357e27f8bd2281869dc4"
                },
                "downloads": -1,
                "filename": "docker-tag-naming-1.0.5.tar.gz",
                "has_sig": false,
                "md5_digest": "1bb9cb28795be5834974e9a78bad9f44",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 6686,
                "upload_time": "2015-07-09T13:26:19",
                "url": "https://files.pythonhosted.org/packages/b9/1d/a8a1b4ca27746a5f6a49c9731bdf59b2ab953bf9a4012847155e6b632013/docker-tag-naming-1.0.5.tar.gz"
            }
        ],
        "1.0.6": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "3a0d03cebb0a33f05a16adebb671f2bd",
                    "sha256": "b8eca05cb82ed7b60afbd23ec160ad8fde10d7f9f4b542c2ab5d279172041548"
                },
                "downloads": -1,
                "filename": "docker-tag-naming-1.0.6.tar.gz",
                "has_sig": false,
                "md5_digest": "3a0d03cebb0a33f05a16adebb671f2bd",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 6679,
                "upload_time": "2015-07-09T14:53:06",
                "url": "https://files.pythonhosted.org/packages/0d/92/b152f398723bc103f980f7bdad5ce99fd9dffe542e59cba3ae19cddbd2a4/docker-tag-naming-1.0.6.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "3a0d03cebb0a33f05a16adebb671f2bd",
                "sha256": "b8eca05cb82ed7b60afbd23ec160ad8fde10d7f9f4b542c2ab5d279172041548"
            },
            "downloads": -1,
            "filename": "docker-tag-naming-1.0.6.tar.gz",
            "has_sig": false,
            "md5_digest": "3a0d03cebb0a33f05a16adebb671f2bd",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 6679,
            "upload_time": "2015-07-09T14:53:06",
            "url": "https://files.pythonhosted.org/packages/0d/92/b152f398723bc103f980f7bdad5ce99fd9dffe542e59cba3ae19cddbd2a4/docker-tag-naming-1.0.6.tar.gz"
        }
    ]
}