{"id":19300657,"url":"https://github.com/fantomas42/buildout-versions-checker","last_synced_at":"2025-04-22T10:31:54.490Z","repository":{"id":10061752,"uuid":"12113419","full_name":"Fantomas42/buildout-versions-checker","owner":"Fantomas42","description":"Parse a zc.buildout versions file, and check if any updates are present.","archived":false,"fork":false,"pushed_at":"2020-03-06T11:34:08.000Z","size":168,"stargazers_count":3,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"develop","last_synced_at":"2024-10-03T18:36:36.574Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Fantomas42.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-08-14T16:14:16.000Z","updated_at":"2020-03-06T11:34:11.000Z","dependencies_parsed_at":"2022-08-28T01:51:21.373Z","dependency_job_id":null,"html_url":"https://github.com/Fantomas42/buildout-versions-checker","commit_stats":null,"previous_names":[],"tags_count":23,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fantomas42%2Fbuildout-versions-checker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fantomas42%2Fbuildout-versions-checker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fantomas42%2Fbuildout-versions-checker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Fantomas42%2Fbuildout-versions-checker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Fantomas42","download_url":"https://codeload.github.com/Fantomas42/buildout-versions-checker/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223892994,"owners_count":17220834,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-09T23:15:26.979Z","updated_at":"2024-11-09T23:15:27.548Z","avatar_url":"https://github.com/Fantomas42.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"=========================\nBuildout Versions Checker\n=========================\n\n|travis-develop| |coverage-develop|\n\nParses a `zc.buildout`_ file containing a ``versions`` section of the\npinned versions of the eggs, and checks if any updates are available.\n\nUsage\n-----\n\nIf you use the practical convention to pin the versions of all the eggs\nused in your buildout into a file, you will find this package useful for\nchecking if any newest version of the eggs are available on Pypi.\n\nHere an example of a version file: ::\n\n  $ cat versions.cfg\n  [versions]\n  Pillow                          = 2.0.0\n  pytz                            = 2012j\n  South                           = 0.8.1\n  django                          = 1.5\n  django-tagging                  = 0.3.1\n\nNow let's execute the ``check-buildout-updates`` script: ::\n\n  $ ./check-buildout-updates\n  [versions]\n  Pillow                          = 2.1.0\n  pytz                            = 2013b\n  South                           = 0.8.2\n  django                          = 1.5.2\n\nYou can now update the ``versions.cfg`` file accordingly to your needs.\n\nOptions\n-------\n\n::\n\n  usage: check-buildout-updates [-h] [--pre] [-s SPECIFIERS] [-i INCLUDES]\n                                [-e EXCLUDES] [-w] [--indent INDENTATION]\n                                [--sorting {alpha,ascii,length}]\n                                [--service-url SERVICE_URL] [--timeout TIMEOUT]\n                                [-t THREADS] [-v] [-q]\n                                [source]\n\n  Check availables updates from a version section of a buildout script\n\n  positional arguments:\n    source                The file where versions are pinned (default:\n                          versions.cfg)\n\n  optional arguments:\n    -h, --help            show this help message and exit\n\n  Allowed versions:\n    --pre                 Allow pre-releases and development versions (by\n                          default only stable versions are found)\n    -s SPECIFIERS, --specifier SPECIFIERS\n                          Describe what versions of a package are acceptable.\n                          Example \"package:\u003e=1.0,!=1.3.4.*,\u003c 2.0\" (can be used\n                          multiple times)\n\n  Filtering:\n    -i INCLUDES, --include INCLUDES\n                          Include package when checking updates (can be used\n                          multiple times)\n    -e EXCLUDES, --exclude EXCLUDES\n                          Exclude package when checking updates (can be used\n                          multiple times)\n\n  File:\n    -w, --write           Write the updates in the source file\n    --indent INDENTATION  Spaces used when indenting \"key = value\" (default:\n                          auto)\n    --sorting {alpha,ascii,length}\n                          Sorting algorithm used on the keys when writing source\n                          file (default: None)\n\n  Network:\n    --service-url SERVICE_URL\n                          The service to use for checking the packages (default:\n                          https://pypi.python.org/pypi)\n    --timeout TIMEOUT     Timeout for each request (default: 10s)\n    -t THREADS, --threads THREADS\n                          Threads used for checking the versions in parallel\n\n  Verbosity:\n    -v                    Increase verbosity (specify multiple times for more)\n    -q                    Decrease verbosity (specify multiple times for more)\n\nBuildout integration\n--------------------\n\nYou can easily integrate this script into your buildout script to\nautomaticly find and write the updates. ::\n\n  [buildout]\n  parts                   = evolution\n\n  [evolution]\n  recipe                  = zc.recipe.egg\n  eggs                    = buildout-versions-checker\n  scripts                 = check-buildout-updates=evolve\n  arguments               = '-w --indent 24 -s django:\u003c1.8 buildout.cfg'\n\nWith this part into your buildout, a new script named ``./bin/evolve`` will\nbe created. It will check for the available updates of the eggs listed in the\n``versions`` section of the ``versions.cfg`` file, then write the updates found.\n\nPython compatibility\n--------------------\n\nBuildout-versions-checker has been originally developed for Python 2.7, but\nhas been ported and tested for Python 3.4 and more.\n\nSince version 1.10.0, the project compatibility start from Python 3.7 and more.\n\nRequirements\n------------\n\n* packaging \u003e= 16\n\nExtras\n------\n\nBuildout-versions-checker also provides extra scripts for simplify the\nmaintenance of yours versions files.\n\n``indent-buildout``\n===================\n\n``indent-buildout`` is designed for just (re)indenting your buildout files.\nBecause the buildout files are sometimes mixed with spaces and tabulations\nwhich may affect viewing and editing. ::\n\n  $ ./indent-buildout buildout.cfg versions.cfg\n\n``find-unused-versions``\n========================\n\n``find-unused-versions`` just check if your have not pinned eggs which are\nnot used in your installation. For better results, run the script after a\nfull and fresh install. ::\n\n  $ ./find-unused-versions\n\n.. _`zc.buildout`: http://www.buildout.org/\n.. |travis-develop| image:: https://travis-ci.org/Fantomas42/buildout-versions-checker.png?branch=develop\n   :alt: Build Status - develop branch\n   :target: http://travis-ci.org/Fantomas42/buildout-versions-checker\n.. |coverage-develop| image:: https://coveralls.io/repos/Fantomas42/buildout-versions-checker/badge.png?branch=develop\n   :alt: Coverage of the code\n   :target: https://coveralls.io/r/Fantomas42/buildout-versions-checker\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffantomas42%2Fbuildout-versions-checker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffantomas42%2Fbuildout-versions-checker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffantomas42%2Fbuildout-versions-checker/lists"}