Script 'mail_helper' called by obssrc Hello community, here is the log from the commit of package python-tempora for openSUSE:Factory checked in at 2021-09-04 22:32:03 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Comparing /work/SRC/openSUSE:Factory/python-tempora (Old) and /work/SRC/openSUSE:Factory/.python-tempora.new.1899 (New) ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Package is "python-tempora" Sat Sep 4 22:32:03 2021 rev:10 rq:915552 version:4.1.1 Changes: -------- --- /work/SRC/openSUSE:Factory/python-tempora/python-tempora.changes 2020-11-23 10:46:47.946380748 +0100 +++ /work/SRC/openSUSE:Factory/.python-tempora.new.1899/python-tempora.changes 2021-09-04 22:32:12.271901031 +0200 @@ -1,0 +2,15 @@ +Wed Sep 1 11:24:10 UTC 2021 - John Paul Adrian Glaubitz <adrian.glaub...@suse.com> + +- Update to version 4.1.1 + * Fixed issue where digits were picked up in the unit when + adjacent to the last unit. +- from version 4.1.0 + * Added support for more formats in ``parse_timedelta``. + * #17: ``parse_timedelta`` now supports formats emitted by + ``timeit``, including honoring nanoseconds at the + microsecond resolution. +- from version 4.0.2 + * Refreshed package metadata. +- Update BuildRequires from setup.py + +------------------------------------------------------------------- Old: ---- tempora-4.0.1.tar.gz New: ---- tempora-4.1.1.tar.gz ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Other differences: ------------------ ++++++ python-tempora.spec ++++++ --- /var/tmp/diff_new_pack.8XjULH/_old 2021-09-04 22:32:12.795901724 +0200 +++ /var/tmp/diff_new_pack.8XjULH/_new 2021-09-04 22:32:12.795901724 +0200 @@ -1,7 +1,7 @@ # # spec file for package python-tempora # -# Copyright (c) 2020 SUSE LLC +# Copyright (c) 2021 SUSE LLC # # All modifications and additions to the file contributed by third parties # remain the property of their copyright owners, unless otherwise agreed @@ -19,7 +19,7 @@ %{?!python_module:%define python_module() python-%{**} python3-%{**}} %define skip_python2 1 Name: python-tempora -Version: 4.0.1 +Version: 4.1.1 Release: 0 Summary: Objects and routines pertaining to date and time (tempora) License: MIT @@ -27,8 +27,8 @@ Source: https://files.pythonhosted.org/packages/source/t/tempora/tempora-%{version}.tar.gz BuildRequires: %{python_module freezegun} BuildRequires: %{python_module jaraco.functools >= 1.20} +BuildRequires: %{python_module pytest > 4.6} BuildRequires: %{python_module pytest-freezegun} -BuildRequires: %{python_module pytest} BuildRequires: %{python_module pytz} BuildRequires: %{python_module setuptools_scm >= 3.4.1} BuildRequires: %{python_module setuptools} @@ -38,7 +38,7 @@ Requires: python-jaraco.functools >= 1.20 Requires: python-pytz Requires(post): update-alternatives -Requires(postun): update-alternatives +Requires(postun):update-alternatives BuildArch: noarch %python_subpackages ++++++ tempora-4.0.1.tar.gz -> tempora-4.1.1.tar.gz ++++++ diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tempora-4.0.1/.coveragerc new/tempora-4.1.1/.coveragerc --- old/tempora-4.0.1/.coveragerc 2020-10-31 04:02:51.000000000 +0100 +++ new/tempora-4.1.1/.coveragerc 2021-06-21 00:45:32.000000000 +0200 @@ -1,5 +1,7 @@ [run] -omit = .tox/* +omit = + # leading `*/` for pytest-dev/pytest-cov#456 + */.tox/* [report] show_missing = True diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tempora-4.0.1/.editorconfig new/tempora-4.1.1/.editorconfig --- old/tempora-4.0.1/.editorconfig 1970-01-01 01:00:00.000000000 +0100 +++ new/tempora-4.1.1/.editorconfig 2021-06-21 00:45:32.000000000 +0200 @@ -0,0 +1,15 @@ +root = true + +[*] +charset = utf-8 +indent_style = tab +indent_size = 4 +insert_final_newline = true +end_of_line = lf + +[*.py] +indent_style = space + +[*.{yml,yaml}] +indent_style = space +indent_size = 2 diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tempora-4.0.1/.flake8 new/tempora-4.1.1/.flake8 --- old/tempora-4.0.1/.flake8 2020-10-31 04:02:51.000000000 +0100 +++ new/tempora-4.1.1/.flake8 2021-06-21 00:45:32.000000000 +0200 @@ -1,9 +1,9 @@ [flake8] max-line-length = 88 -ignore = - # W503 violates spec https://github.com/PyCQA/pycodestyle/issues/513 - W503 - # W504 has issues https://github.com/OCA/maintainer-quality-tools/issues/545 - W504 + +# jaraco/skeleton#34 +max-complexity = 10 + +extend-ignore = # Black creates whitespace before colon E203 diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tempora-4.0.1/.github/dependabot.yml new/tempora-4.1.1/.github/dependabot.yml --- old/tempora-4.0.1/.github/dependabot.yml 1970-01-01 01:00:00.000000000 +0100 +++ new/tempora-4.1.1/.github/dependabot.yml 2021-06-21 00:45:32.000000000 +0200 @@ -0,0 +1,8 @@ +version: 2 +updates: + - package-ecosystem: "pip" + directory: "/" + schedule: + interval: "daily" + allow: + - dependency-type: "all" diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tempora-4.0.1/.github/workflows/main.yml new/tempora-4.1.1/.github/workflows/main.yml --- old/tempora-4.0.1/.github/workflows/main.yml 2020-10-31 04:02:51.000000000 +0100 +++ new/tempora-4.1.1/.github/workflows/main.yml 2021-06-21 00:45:32.000000000 +0200 @@ -1,4 +1,4 @@ -name: Automated Tests +name: tests on: [push, pull_request] @@ -6,7 +6,10 @@ test: strategy: matrix: - python: [3.6, 3.8, 3.9] + python: + - 3.6 + - 3.9 + - 3.10.0-alpha - 3.10.99 platform: [ubuntu-latest, macos-latest, windows-latest] runs-on: ${{ matrix.platform }} steps: diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tempora-4.0.1/.pre-commit-config.yaml new/tempora-4.1.1/.pre-commit-config.yaml --- old/tempora-4.0.1/.pre-commit-config.yaml 2020-10-31 04:02:51.000000000 +0100 +++ new/tempora-4.1.1/.pre-commit-config.yaml 2021-06-21 00:45:32.000000000 +0200 @@ -1,10 +1,10 @@ repos: - repo: https://github.com/psf/black - rev: stable + rev: 20.8b1 hooks: - id: black - repo: https://github.com/asottile/blacken-docs - rev: v1.8.0 + rev: v1.9.1 hooks: - id: blacken-docs diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tempora-4.0.1/CHANGES.rst new/tempora-4.1.1/CHANGES.rst --- old/tempora-4.0.1/CHANGES.rst 2020-10-31 04:02:51.000000000 +0100 +++ new/tempora-4.1.1/CHANGES.rst 2021-06-21 00:45:32.000000000 +0200 @@ -1,3 +1,22 @@ +v4.1.1 +====== + +- Fixed issue where digits were picked up in the unit when + adjacent to the last unit. + +v4.1.0 +====== + +- Added support for more formats in ``parse_timedelta``. +- #17: ``parse_timedelta`` now supports formats emitted by + ``timeit``, including honoring nanoseconds at the + microsecond resolution. + +v4.0.2 +====== + +- Refreshed package metadata. + v4.0.1 ====== diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tempora-4.0.1/PKG-INFO new/tempora-4.1.1/PKG-INFO --- old/tempora-4.0.1/PKG-INFO 2020-10-31 04:03:08.614104700 +0100 +++ new/tempora-4.1.1/PKG-INFO 2021-06-21 00:45:53.251093000 +0200 @@ -1,41 +1,11 @@ Metadata-Version: 2.1 Name: tempora -Version: 4.0.1 +Version: 4.1.1 Summary: Objects and routines pertaining to date and time (tempora) Home-page: https://github.com/jaraco/tempora Author: Jason R. Coombs Author-email: jar...@jaraco.com License: UNKNOWN -Description: .. image:: https://img.shields.io/pypi/v/tempora.svg - :target: `PyPI link`_ - - .. image:: https://img.shields.io/pypi/pyversions/tempora.svg - :target: `PyPI link`_ - - .. _PyPI link: https://pypi.org/project/tempora - - .. image:: https://github.com/jaraco/tempora/workflows/Automated%20Tests/badge.svg - :target: https://github.com/jaraco/tempora/actions?query=workflow%3A%22Automated+Tests%22 - :alt: Automated Tests - - .. image:: https://img.shields.io/badge/code%20style-black-000000.svg - :target: https://github.com/psf/black - :alt: Code style: Black - - .. image:: https://readthedocs.org/projects/tempora/badge/?version=latest - :target: https://tempora.readthedocs.io/en/latest/?badge=latest - - - Objects and routines pertaining to date and time (tempora). - - Modules include: - - - tempora (top level package module) contains miscellaneous - utilities and constants. - - timing contains routines for measuring and profiling. - - schedule contains an event scheduler. - - utc contains routines for getting datetime-aware UTC values. - Platform: UNKNOWN Classifier: Development Status :: 5 - Production/Stable Classifier: Intended Audience :: Developers @@ -45,3 +15,39 @@ Requires-Python: >=3.6 Provides-Extra: testing Provides-Extra: docs +License-File: LICENSE + +.. image:: https://img.shields.io/pypi/v/tempora.svg + :target: `PyPI link`_ + +.. image:: https://img.shields.io/pypi/pyversions/tempora.svg + :target: `PyPI link`_ + +.. _PyPI link: https://pypi.org/project/tempora + +.. image:: https://github.com/jaraco/tempora/workflows/tests/badge.svg + :target: https://github.com/jaraco/tempora/actions?query=workflow%3A%22tests%22 + :alt: tests + +.. image:: https://img.shields.io/badge/code%20style-black-000000.svg + :target: https://github.com/psf/black + :alt: Code style: Black + +.. image:: https://readthedocs.org/projects/tempora/badge/?version=latest + :target: https://tempora.readthedocs.io/en/latest/?badge=latest + +.. image:: https://img.shields.io/badge/skeleton-2021-informational + :target: https://blog.jaraco.com/skeleton + + +Objects and routines pertaining to date and time (tempora). + +Modules include: + +- tempora (top level package module) contains miscellaneous + utilities and constants. +- timing contains routines for measuring and profiling. +- schedule contains an event scheduler. +- utc contains routines for getting datetime-aware UTC values. + + diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tempora-4.0.1/README.rst new/tempora-4.1.1/README.rst --- old/tempora-4.0.1/README.rst 2020-10-31 04:02:51.000000000 +0100 +++ new/tempora-4.1.1/README.rst 2021-06-21 00:45:32.000000000 +0200 @@ -6,9 +6,9 @@ .. _PyPI link: https://pypi.org/project/tempora -.. image:: https://github.com/jaraco/tempora/workflows/Automated%20Tests/badge.svg - :target: https://github.com/jaraco/tempora/actions?query=workflow%3A%22Automated+Tests%22 - :alt: Automated Tests +.. image:: https://github.com/jaraco/tempora/workflows/tests/badge.svg + :target: https://github.com/jaraco/tempora/actions?query=workflow%3A%22tests%22 + :alt: tests .. image:: https://img.shields.io/badge/code%20style-black-000000.svg :target: https://github.com/psf/black @@ -17,6 +17,9 @@ .. image:: https://readthedocs.org/projects/tempora/badge/?version=latest :target: https://tempora.readthedocs.io/en/latest/?badge=latest +.. image:: https://img.shields.io/badge/skeleton-2021-informational + :target: https://blog.jaraco.com/skeleton + Objects and routines pertaining to date and time (tempora). diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tempora-4.0.1/docs/conf.py new/tempora-4.1.1/docs/conf.py --- old/tempora-4.0.1/docs/conf.py 2020-10-31 04:02:51.000000000 +0100 +++ new/tempora-4.1.1/docs/conf.py 2021-06-21 00:45:32.000000000 +0200 @@ -24,3 +24,6 @@ ], ) } + +# Be strict about any broken references: +nitpicky = True diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tempora-4.0.1/docs/index.rst new/tempora-4.1.1/docs/index.rst --- old/tempora-4.0.1/docs/index.rst 2020-10-31 04:02:51.000000000 +0100 +++ new/tempora-4.1.1/docs/index.rst 2021-06-21 00:45:32.000000000 +0200 @@ -1,5 +1,5 @@ -Welcome to tempora documentation! -================================= +Welcome to |project| documentation! +=================================== .. toctree:: :maxdepth: 1 @@ -12,16 +12,25 @@ :undoc-members: :show-inheritance: +Timing +------ + .. automodule:: tempora.timing :members: :undoc-members: :show-inheritance: +Schedule +-------- + .. automodule:: tempora.schedule :members: :undoc-members: :show-inheritance: +UTC +--- + .. automodule:: tempora.utc :members: :undoc-members: diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tempora-4.0.1/pyproject.toml new/tempora-4.1.1/pyproject.toml --- old/tempora-4.0.1/pyproject.toml 2020-10-31 04:02:51.000000000 +0100 +++ new/tempora-4.1.1/pyproject.toml 2021-06-21 00:45:32.000000000 +0200 @@ -7,16 +7,14 @@ [tool.setuptools_scm] -# jaraco/skeleton#22 -[tool.jaraco.pytest.plugins.black] +[pytest.enabler.black] addopts = "--black" -# jaraco/skeleton#22 -[tool.jaraco.pytest.plugins.mypy] +[pytest.enabler.mypy] addopts = "--mypy" -[tool.jaraco.pytest.plugins.flake8] +[pytest.enabler.flake8] addopts = "--flake8" -[tool.jaraco.pytest.plugins.cov] +[pytest.enabler.cov] addopts = "--cov" diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tempora-4.0.1/pytest.ini new/tempora-4.1.1/pytest.ini --- old/tempora-4.0.1/pytest.ini 2020-10-31 04:02:51.000000000 +0100 +++ new/tempora-4.1.1/pytest.ini 2021-06-21 00:45:32.000000000 +0200 @@ -5,8 +5,10 @@ # workaround for warning pytest-dev/pytest#6178 junit_family=xunit2 filterwarnings= + # Suppress deprecation warning in flake8 + ignore:SelectableGroups dict interface is deprecated::flake8 + # Suppress deprecation warning in pypa/packaging#433 + ignore:The distutils package is deprecated::packaging.tags # suppress known warnings ignore:Use native division:DeprecationWarning:tempora ignore:Use dateutil.parser:DeprecationWarning:tempora - # https://github.com/pytest-dev/pytest/issues/6928 - ignore:direct construction of .*Item has been deprecated:DeprecationWarning diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tempora-4.0.1/setup.cfg new/tempora-4.1.1/setup.cfg --- old/tempora-4.0.1/setup.cfg 2020-10-31 04:03:08.614104700 +0100 +++ new/tempora-4.1.1/setup.cfg 2021-06-21 00:45:53.251093000 +0200 @@ -1,5 +1,6 @@ [metadata] -license_file = LICENSE +license_files = + LICENSE name = tempora author = Jason R. Coombs author_email = jar...@jaraco.com @@ -14,30 +15,38 @@ Programming Language :: Python :: 3 :: Only [options] -packages = find: +packages = find_namespace: include_package_data = true python_requires = >=3.6 install_requires = pytz jaraco.functools>=1.20 -setup_requires = setuptools_scm[toml] >= 3.4.1 + +[options.packages.find] +exclude = + build* + dist* + docs* + tests* [options.extras_require] testing = - pytest >= 3.5, !=3.7.3 - pytest-checkdocs >= 1.2.3 + pytest >= 4.6 + pytest-checkdocs >= 2.4 pytest-flake8 - pytest-black >= 0.3.7; python_implementation != "PyPy" + pytest-black >= 0.3.7; python_implementation != "PyPy" and python_version < "3.10" pytest-cov - pytest-mypy; python_implementation != "PyPy" - jaraco.test >= 3.2.0 + pytest-mypy; python_implementation != "PyPy" and python_version < "3.10" + pytest-enabler >= 1.0.1 backports.unittest_mock freezegun pytest-freezegun + types-freezegun + types-pytz docs = sphinx - jaraco.packaging >= 3.2 + jaraco.packaging >= 8.2 rst.linker >= 1.9 [options.entry_points] diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tempora-4.0.1/skeleton.md new/tempora-4.1.1/skeleton.md --- old/tempora-4.0.1/skeleton.md 2020-10-31 04:02:51.000000000 +0100 +++ new/tempora-4.1.1/skeleton.md 1970-01-01 01:00:00.000000000 +0100 @@ -1,144 +0,0 @@ -# Overview - -This project is merged with [skeleton](https://github.com/jaraco/skeleton). What is skeleton? It's the scaffolding of a Python project jaraco [introduced in his blog](https://blog.jaraco.com/a-project-skeleton-for-python-projects/). It seeks to provide a means to re-use techniques and inherit advances when managing projects for distribution. - -## An SCM-Managed Approach - -While maintaining dozens of projects in PyPI, jaraco derives best practices for project distribution and publishes them in the [skeleton repo](https://github.com/jaraco/skeleton), a Git repo capturing the evolution and culmination of these best practices. - -It's intended to be used by a new or existing project to adopt these practices and honed and proven techniques. Adopters are encouraged to use the project directly and maintain a small deviation from the technique, make their own fork for more substantial changes unique to their environment or preferences, or simply adopt the skeleton once and abandon it thereafter. - -The primary advantage to using an SCM for maintaining these techniques is that those tools help facilitate the merge between the template and its adopting projects. - -Another advantage to using an SCM-managed approach is that tools like GitHub recognize that a change in the skeleton is the _same change_ across all projects that merge with that skeleton. Without the ancestry, with a traditional copy/paste approach, a [commit like this](https://github.com/jaraco/skeleton/commit/12eed1326e1bc26ce256e7b3f8cd8d3a5beab2d5) would produce notifications in the upstream project issue for each and every application, but because it's centralized, GitHub provides just the one notification when the change is added to the skeleton. - -# Usage - -## new projects - -To use skeleton for a new project, simply pull the skeleton into a new project: - -``` -$ git init my-new-project -$ cd my-new-project -$ git pull gh://jaraco/skeleton -``` - -Now customize the project to suit your individual project needs. - -## existing projects - -If you have an existing project, you can still incorporate the skeleton by merging it into the codebase. - -``` -$ git merge skeleton --allow-unrelated-histories -``` - -The `--allow-unrelated-histories` is necessary because the history from the skeleton was previously unrelated to the existing codebase. Resolve any merge conflicts and commit to the master, and now the project is based on the shared skeleton. - -## Updating - -Whenever a change is needed or desired for the general technique for packaging, it can be made in the skeleton project and then merged into each of the derived projects as needed, recommended before each release. As a result, features and best practices for packaging are centrally maintained and readily trickle into a whole suite of packages. This technique lowers the amount of tedious work necessary to create or maintain a project, and coupled with other techniques like continuous integration and deployment, lowers the cost of creating and maintaining refined Python projects to just a few, familiar Git operations. - -For example, here's a session of the [path project](https://pypi.org/project/path) pulling non-conflicting changes from the skeleton: - -<img src="https://raw.githubusercontent.com/jaraco/skeleton/gh-pages/docs/refresh.svg"> - -Thereafter, the target project can make whatever customizations it deems relevant to the scaffolding. The project may even at some point decide that the divergence is too great to merit renewed merging with the original skeleton. This approach applies maximal guidance while creating minimal constraints. - -# Features - -The features/techniques employed by the skeleton include: - -- PEP 517/518-based build relying on Setuptools as the build tool -- Setuptools declarative configuration using setup.cfg -- tox for running tests -- A README.rst as reStructuredText with some popular badges, but with Read the Docs and AppVeyor badges commented out -- A CHANGES.rst file intended for publishing release notes about the project -- Use of [Black](https://black.readthedocs.io/en/stable/) for code formatting (disabled on unsupported Python 3.5 and earlier) -- Integrated type checking through [mypy](https://github.com/python/mypy/). - -## Packaging Conventions - -A pyproject.toml is included to enable PEP 517 and PEP 518 compatibility and declares the requirements necessary to build the project on Setuptools (a minimum version compatible with setup.cfg declarative config). - -The setup.cfg file implements the following features: - -- Assumes universal wheel for release -- Advertises the project's LICENSE file (MIT by default) -- Reads the README.rst file into the long description -- Some common Trove classifiers -- Includes all packages discovered in the repo -- Data files in the package are also included (not just Python files) -- Declares the required Python versions -- Declares install requirements (empty by default) -- Declares setup requirements for legacy environments -- Supplies two 'extras': - - testing: requirements for running tests - - docs: requirements for building docs - - these extras split the declaration into "upstream" (requirements as declared by the skeleton) and "local" (those specific to the local project); these markers help avoid merge conflicts -- Placeholder for defining entry points - -Additionally, the setup.py file declares `use_scm_version` which relies on [setuptools_scm](https://pypi.org/project/setuptools_scm) to do two things: - -- derive the project version from SCM tags -- ensure that all files committed to the repo are automatically included in releases - -## Running Tests - -The skeleton assumes the developer has [tox](https://pypi.org/project/tox) installed. The developer is expected to run `tox` to run tests on the current Python version using [pytest](https://pypi.org/project/pytest). - -Other environments (invoked with `tox -e {name}`) supplied include: - - - a `docs` environment to build the documentation - - a `release` environment to publish the package to PyPI - -A pytest.ini is included to define common options around running tests. In particular: - -- rely on default test discovery in the current directory -- avoid recursing into common directories not containing tests -- run doctests on modules and invoke Flake8 tests -- in doctests, allow Unicode literals and regular literals to match, allowing for doctests to run on Python 2 and 3. Also enable ELLIPSES, a default that would be undone by supplying the prior option. -- filters out known warnings caused by libraries/functionality included by the skeleton - -Relies on a .flake8 file to correct some default behaviors: - -- disable mutually incompatible rules W503 and W504 -- support for Black format - -## Continuous Integration - -The project is pre-configured to run Continuous Integration tests. - -### Github Actions - -[Github Actions](https://docs.github.com/en/free-pro-team@latest/actions) are the preferred provider as they provide free, fast, multi-platform services with straightforward configuration. Configured in `.github/workflows`. - -Features include: -- test against multiple Python versions -- run on late (and updated) platform versions -- automated releases of tagged commits - -### Continuous Deployments - -In addition to running tests, an additional publish stage is configured to automatically release tagged commits to PyPI using [API tokens](https://pypi.org/help/#apitoken). The release process expects an authorized token to be configured with each Github project (or org) `PYPI_TOKEN` [secret](https://docs.github.com/en/free-pro-team@latest/actions/reference/encrypted-secrets). Example: - -``` -pip-run -q jaraco.develop -- -m jaraco.develop.add-github-secrets -``` - -## Building Documentation - -Documentation is automatically built by [Read the Docs](https://readthedocs.org) when the project is registered with it, by way of the .readthedocs.yml file. To test the docs build manually, a tox env may be invoked as `tox -e docs`. Both techniques rely on the dependencies declared in `setup.cfg/options.extras_require.docs`. - -In addition to building the Sphinx docs scaffolded in `docs/`, the docs build a `history.html` file that first injects release dates and hyperlinks into the CHANGES.rst before incorporating it as history in the docs. - -## Cutting releases - -By default, tagged commits are released through the continuous integration deploy stage. - -Releases may also be cut manually by invoking the tox environment `release` with the PyPI token set as the TWINE_PASSWORD: - -``` -TWINE_PASSWORD={token} tox -e release -``` diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tempora-4.0.1/tempora/__init__.py new/tempora-4.1.1/tempora/__init__.py --- old/tempora-4.0.1/tempora/__init__.py 2020-10-31 04:02:51.000000000 +0100 +++ new/tempora-4.1.1/tempora/__init__.py 2021-06-21 00:45:32.000000000 +0200 @@ -6,6 +6,7 @@ import numbers import functools import warnings +import contextlib from jaraco.functools import once @@ -459,33 +460,184 @@ >>> diff = later.replace(year=now.year) - now >>> diff.seconds 20940 - """ - deltas = (_parse_timedelta_part(part.strip()) for part in str.split(',')) - return sum(deltas, datetime.timedelta()) + >>> parse_timedelta('14 seconds foo') + Traceback (most recent call last): + ... + ValueError: Unexpected 'foo' -def _parse_timedelta_part(part): - """ - >>> _parse_timedelta_part('foo') + Supports abbreviations: + + >>> parse_timedelta('1s') + datetime.timedelta(seconds=1) + + >>> parse_timedelta('1sec') + datetime.timedelta(seconds=1) + + >>> parse_timedelta('5min1sec') + datetime.timedelta(seconds=301) + + >>> parse_timedelta('1 ms') + datetime.timedelta(microseconds=1000) + + >>> parse_timedelta('1 ??s') + datetime.timedelta(microseconds=1) + + >>> parse_timedelta('1 us') + datetime.timedelta(microseconds=1) + + And supports the common colon-separated duration: + + >>> parse_timedelta('14:00:35.362') + datetime.timedelta(seconds=50435, microseconds=362000) + + TODO: Should this be 14 hours or 14 minutes? + >>> parse_timedelta('14:00') + datetime.timedelta(seconds=50400) + + >>> parse_timedelta('14:00 minutes') Traceback (most recent call last): ... - ValueError: Unable to parse 'foo' as a time delta - """ - match = re.match(r'(?P<value>[\d.]+) (?P<unit>\w+)', part) - if not match: - msg = "Unable to parse {part!r} as a time delta".format(**locals()) - raise ValueError(msg) - unit = match.group('unit').lower() + ValueError: Cannot specify units with composite delta + + Nanoseconds get rounded to the nearest microsecond: + + >>> parse_timedelta('600 ns') + datetime.timedelta(microseconds=1) + + >>> parse_timedelta('.002 ??s, 499 ns') + datetime.timedelta(microseconds=1) + """ + return _parse_timedelta_nanos(str).resolve() + + +def _parse_timedelta_nanos(str): + parts = re.finditer(r'(?P<value>[\d.:]+)\s?(?P<unit>[^\W\d_]+)?', str) + chk_parts = _check_unmatched(parts, str) + deltas = map(_parse_timedelta_part, chk_parts) + return sum(deltas, _Saved_NS()) + + +def _check_unmatched(matches, text): + """ + Ensure no words appear in unmatched text. + """ + + def check_unmatched(unmatched): + found = re.search(r'\w+', unmatched) + if found: + raise ValueError(f"Unexpected {found.group(0)!r}") + + pos = 0 + for match in matches: + check_unmatched(text[pos : match.start()]) + yield match + pos = match.end() + check_unmatched(text[match.end() :]) + + +_unit_lookup = { + '??s': 'microsecond', + '??sec': 'microsecond', + 'us': 'microsecond', + 'usec': 'microsecond', + 'micros': 'microsecond', + 'ms': 'millisecond', + 'msec': 'millisecond', + 'millis': 'millisecond', + 's': 'second', + 'sec': 'second', + 'h': 'hour', + 'hr': 'hour', + 'm': 'minute', + 'min': 'minute', + 'w': 'week', + 'wk': 'week', + 'd': 'day', + 'ns': 'nanosecond', + 'nsec': 'nanosecond', + 'nanos': 'nanosecond', +} + + +def _resolve_unit(raw_match): + if raw_match is None: + return 'second' + text = raw_match.lower() + return _unit_lookup.get(text, text) + + +def _parse_timedelta_composite(raw_value, unit): + if unit != 'seconds': + raise ValueError("Cannot specify units with composite delta") + values = raw_value.split(':') + units = 'hours', 'minutes', 'seconds' + composed = ' '.join(f'{value} {unit}' for value, unit in zip(values, units)) + return _parse_timedelta_nanos(composed) + + +def _parse_timedelta_part(match): + unit = _resolve_unit(match.group('unit')) if not unit.endswith('s'): unit += 's' - value = float(match.group('value')) + raw_value = match.group('value') + if ':' in raw_value: + return _parse_timedelta_composite(raw_value, unit) + value = float(raw_value) if unit == 'months': unit = 'years' value = value / 12 if unit == 'years': unit = 'days' value = value * days_per_year - return datetime.timedelta(**{unit: value}) + return _Saved_NS.derive(unit, value) + + +class _Saved_NS: + """ + Bundle a timedelta with nanoseconds. + + >>> _Saved_NS.derive('microseconds', .001) + _Saved_NS(td=datetime.timedelta(0), nanoseconds=1) + """ + + td = datetime.timedelta() + nanoseconds = 0 + multiplier = dict( + seconds=1000000000, + milliseconds=1000000, + microseconds=1000, + ) + + def __init__(self, **kwargs): + vars(self).update(kwargs) + + @classmethod + def derive(cls, unit, value): + if unit == 'nanoseconds': + return _Saved_NS(nanoseconds=value) + + res = _Saved_NS(td=datetime.timedelta(**{unit: value})) + with contextlib.suppress(KeyError): + res.nanoseconds = int(value * cls.multiplier[unit]) % 1000 + return res + + def __add__(self, other): + return _Saved_NS( + td=self.td + other.td, nanoseconds=self.nanoseconds + other.nanoseconds + ) + + def resolve(self): + """ + Resolve any nanoseconds into the microseconds field, + discarding any nanosecond resolution (but honoring partial + microseconds). + """ + addl_micros = round(self.nanoseconds / 1000) + return self.td + datetime.timedelta(microseconds=addl_micros) + + def __repr__(self): + return f'_Saved_NS(td={self.td!r}, nanoseconds={self.nanoseconds!r})' def divide_timedelta(td1, td2): diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tempora-4.0.1/tempora/schedule.py new/tempora-4.1.1/tempora/schedule.py --- old/tempora-4.0.1/tempora/schedule.py 2020-10-31 04:02:51.000000000 +0100 +++ new/tempora-4.1.1/tempora/schedule.py 2021-06-21 00:45:32.000000000 +0200 @@ -1,5 +1,16 @@ """ -Classes for calling functions a schedule. +Classes for calling functions a schedule. Has time zone support. + +For example, to run a job at 08:00 every morning in 'Asia/Calcutta': + +>>> job = lambda: print("time is now", datetime.datetime()) +>>> time = datetime.time(8, tzinfo=pytz.timezone('Asia/Calcutta')) +>>> cmd = PeriodicCommandFixedDelay.daily_at(time, job) +>>> sched = InvokeScheduler() +>>> sched.add(cmd) +>>> while True: # doctest: +SKIP +... sched.run_pending() +... time.sleep(.1) """ import datetime diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tempora-4.0.1/tempora/tests/test_timing.py new/tempora-4.1.1/tempora/tests/test_timing.py --- old/tempora-4.0.1/tempora/tests/test_timing.py 2020-10-31 04:02:51.000000000 +0100 +++ new/tempora-4.1.1/tempora/tests/test_timing.py 2021-06-21 00:45:32.000000000 +0200 @@ -26,8 +26,7 @@ @pytest.fixture def alt_tz(monkeypatch): - if not hasattr(time, 'tzset'): - pytest.skip("tzset not available") + hasattr(time, 'tzset') or pytest.skip("tzset not available") @contextlib.contextmanager def change(): diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tempora-4.0.1/tempora.egg-info/PKG-INFO new/tempora-4.1.1/tempora.egg-info/PKG-INFO --- old/tempora-4.0.1/tempora.egg-info/PKG-INFO 2020-10-31 04:03:08.000000000 +0100 +++ new/tempora-4.1.1/tempora.egg-info/PKG-INFO 2021-06-21 00:45:53.000000000 +0200 @@ -1,41 +1,11 @@ Metadata-Version: 2.1 Name: tempora -Version: 4.0.1 +Version: 4.1.1 Summary: Objects and routines pertaining to date and time (tempora) Home-page: https://github.com/jaraco/tempora Author: Jason R. Coombs Author-email: jar...@jaraco.com License: UNKNOWN -Description: .. image:: https://img.shields.io/pypi/v/tempora.svg - :target: `PyPI link`_ - - .. image:: https://img.shields.io/pypi/pyversions/tempora.svg - :target: `PyPI link`_ - - .. _PyPI link: https://pypi.org/project/tempora - - .. image:: https://github.com/jaraco/tempora/workflows/Automated%20Tests/badge.svg - :target: https://github.com/jaraco/tempora/actions?query=workflow%3A%22Automated+Tests%22 - :alt: Automated Tests - - .. image:: https://img.shields.io/badge/code%20style-black-000000.svg - :target: https://github.com/psf/black - :alt: Code style: Black - - .. image:: https://readthedocs.org/projects/tempora/badge/?version=latest - :target: https://tempora.readthedocs.io/en/latest/?badge=latest - - - Objects and routines pertaining to date and time (tempora). - - Modules include: - - - tempora (top level package module) contains miscellaneous - utilities and constants. - - timing contains routines for measuring and profiling. - - schedule contains an event scheduler. - - utc contains routines for getting datetime-aware UTC values. - Platform: UNKNOWN Classifier: Development Status :: 5 - Production/Stable Classifier: Intended Audience :: Developers @@ -45,3 +15,39 @@ Requires-Python: >=3.6 Provides-Extra: testing Provides-Extra: docs +License-File: LICENSE + +.. image:: https://img.shields.io/pypi/v/tempora.svg + :target: `PyPI link`_ + +.. image:: https://img.shields.io/pypi/pyversions/tempora.svg + :target: `PyPI link`_ + +.. _PyPI link: https://pypi.org/project/tempora + +.. image:: https://github.com/jaraco/tempora/workflows/tests/badge.svg + :target: https://github.com/jaraco/tempora/actions?query=workflow%3A%22tests%22 + :alt: tests + +.. image:: https://img.shields.io/badge/code%20style-black-000000.svg + :target: https://github.com/psf/black + :alt: Code style: Black + +.. image:: https://readthedocs.org/projects/tempora/badge/?version=latest + :target: https://tempora.readthedocs.io/en/latest/?badge=latest + +.. image:: https://img.shields.io/badge/skeleton-2021-informational + :target: https://blog.jaraco.com/skeleton + + +Objects and routines pertaining to date and time (tempora). + +Modules include: + +- tempora (top level package module) contains miscellaneous + utilities and constants. +- timing contains routines for measuring and profiling. +- schedule contains an event scheduler. +- utc contains routines for getting datetime-aware UTC values. + + diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tempora-4.0.1/tempora.egg-info/SOURCES.txt new/tempora-4.1.1/tempora.egg-info/SOURCES.txt --- old/tempora-4.0.1/tempora.egg-info/SOURCES.txt 2020-10-31 04:03:08.000000000 +0100 +++ new/tempora-4.1.1/tempora.egg-info/SOURCES.txt 2021-06-21 00:45:53.000000000 +0200 @@ -1,4 +1,5 @@ .coveragerc +.editorconfig .flake8 .pre-commit-config.yaml .readthedocs.yml @@ -11,8 +12,8 @@ pytest.ini setup.cfg setup.py -skeleton.md tox.ini +.github/dependabot.yml .github/workflows/main.yml docs/conf.py docs/history.rst diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tempora-4.0.1/tempora.egg-info/requires.txt new/tempora-4.1.1/tempora.egg-info/requires.txt --- old/tempora-4.0.1/tempora.egg-info/requires.txt 2020-10-31 04:03:08.000000000 +0100 +++ new/tempora-4.1.1/tempora.egg-info/requires.txt 2021-06-21 00:45:53.000000000 +0200 @@ -3,19 +3,21 @@ [docs] sphinx -jaraco.packaging>=3.2 +jaraco.packaging>=8.2 rst.linker>=1.9 [testing] -pytest!=3.7.3,>=3.5 -pytest-checkdocs>=1.2.3 +pytest>=4.6 +pytest-checkdocs>=2.4 pytest-flake8 pytest-cov -jaraco.test>=3.2.0 +pytest-enabler>=1.0.1 backports.unittest_mock freezegun pytest-freezegun +types-freezegun +types-pytz -[testing:platform_python_implementation != "PyPy"] +[testing:platform_python_implementation != "PyPy" and python_version < "3.10"] pytest-black>=0.3.7 pytest-mypy diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tempora-4.0.1/tox.ini new/tempora-4.1.1/tox.ini --- old/tempora-4.0.1/tox.ini 2020-10-31 04:02:51.000000000 +0100 +++ new/tempora-4.1.1/tox.ini 2021-06-21 00:45:32.000000000 +0200 @@ -3,6 +3,7 @@ minversion = 3.2 # https://github.com/jaraco/skeleton/issues/6 tox_pip_extensions_ext_venv_update = true +toxworkdir={env:TOX_WORK_DIR:.tox} [testenv] @@ -18,14 +19,13 @@ testing changedir = docs commands = - python -m sphinx . {toxinidir}/build/html + python -m sphinx -W --keep-going . {toxinidir}/build/html [testenv:release] skip_install = True deps = - pep517>=0.5 - twine[keyring]>=1.13 - path + build + twine>=3 jaraco.develop>=7.1 passenv = TWINE_PASSWORD @@ -33,7 +33,7 @@ setenv = TWINE_USERNAME = {env:TWINE_USERNAME:__token__} commands = - python -c "import path; path.Path('dist').rmtree_p()" - python -m pep517.build . + python -c "import shutil; shutil.rmtree('dist', ignore_errors=True)" + python -m build python -m twine upload dist/* python -m jaraco.develop.create-github-release