Release v0.7

.github/dependabot.yml

@@ -0,0 +1,27 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file
+
+version: 2
+updates:
+  # Enable version updates for GitHub Actions
+  - package-ecosystem: "github-actions"
+    groups:
+      actions:
+        patterns:
+          - "*"
+    directory: "/"
+    schedule:
+      # Check for updates to GitHub Actions every week
+      interval: "weekly"
+
+  # Enable version updates for pre-commit hooks
+  - package-ecosystem: "pre-commit"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    groups:
+      pre-commit:
+        patterns:
+          - "*"

.github/workflows/check.yml

@@ -6,6 +6,10 @@ on:
 permissions:
   contents: read
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
   check:
     runs-on: ubuntu-latest
@@ -16,23 +20,27 @@ jobs:
 
     steps:
       - uses: actions/checkout@v5
-      - name: Set up Python 3.12
-        uses: actions/setup-python@v6
-        with:
-          python-version: "3.12"
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v6
+        uses: astral-sh/setup-uv@v8.1.0
         with:
+          python-version: "3.12"
           enable-cache: true
           cache-dependency-glob: "pyproject.toml"
 
       - name: Install package with check dependencies
-        run: uv sync --extra check
+        run: uv sync --group check
+
+      - name: Run Ruff linter
+        uses: astral-sh/ruff-action@v3
+        with:
+          args: "check --output-format=github"
 
-      # check with ruff
-      - name: Run ruff
-        run: uv run ruff check
+      - name: Run Ruff formatter
+        # NOTE: ruff format does not currently support github output format
+        run: ruff format --check --diff  src tests
+        # Check formatting even if the previous step failed
+        if: always()
 
       # check docs build
       - name: Check that documentation builds with no errors or warnings

.github/workflows/python-publish.yml

@@ -11,6 +11,8 @@ name: Upload Python Package
 on:
   release:
     types: [published]
+  # allow manually running on main
+  workflow_dispatch:
 
 permissions:
   contents: read

.github/workflows/unit_tests.yml

@@ -4,6 +4,10 @@ permissions:
   contents: read
   id-token: write
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
 on:
   push:
     branches:
@@ -34,23 +38,23 @@ jobs:
 
       # use github python action instead of uv to take advantage of caching
       - name: Set up Python ${{ matrix.python }}
-        uses: actions/setup-python@v6
+        uses: astral-sh/setup-uv@v8.1.0
         with:
           python-version: ${{ matrix.python }}
           cache: 'pip'
           cache-dependency-path: '**/pyproject.toml'
 
-      - name: Install package with dependencies
-        run: pip install -e ".[test]"
+      - name: Install package with check dependencies
+        run: uv sync --group test
 
       # for all versions but the one we use for code coverage, run normally
       - name: Run unit tests without code coverage
-        run: pytest
+        run: uv run pytest
         if: ${{ matrix.python != env.COV_PYTHON_VERSION }}
 
       # run code coverage in one version only
       - name: Run unit tests with code coverage reporting
-        run: pytest --cov=.
+        run: uv run pytest --cov=.
         if: ${{ matrix.python == env.COV_PYTHON_VERSION }}
 
       - name: Upload coverage to Codecov

.pre-commit-config.yaml

@@ -1,22 +1,46 @@
 files: \.py
 repos:
+  # ruff for linting and formatting python
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.3.4
+    rev: v0.15.12
     hooks:
-      - id: ruff
-        args: [ --fix, --exit-non-zero-on-fix ]
+      - id: ruff-check
+        args: [ --fix, --show-fixes, --exit-non-zero-on-fix ]
       - id: ruff-format
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.3.0
+    rev: v6.0.0
     hooks:
       - id: check-case-conflict
+      - id: check-merge-conflict
       - id: check-executables-have-shebangs
       - id: debug-statements
       - id: end-of-file-fixer
       - id: mixed-line-ending
       - id: trailing-whitespace
+      - id: check-yaml
+      - id: name-tests-test
+        args: [--pytest-test-first]
+
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.13.0
+    rev: v2.0.0
     hooks:
       - id: mypy
         additional_dependencies: [numpy]
+  # yamlfmt for formatting YAML files
+  - repo: https://github.com/google/yamlfmt
+    rev: v0.21.0
+    hooks:
+      - id: yamlfmt
+  # Codespell for spell checking
+  - repo: https://github.com/codespell-project/codespell
+    rev: v2.4.2
+    hooks:
+      - id: codespell
+        additional_dependencies:
+          - tomli
+        exclude_types: ["css", "html", "javascript", "json"]
+  # Validate GitHub Actions workflow files
+  - repo: https://github.com/mpalmer/action-validator
+    rev: v0.9.0
+    hooks:
+      - id: action-validator

.readthedocs.yaml

@@ -11,8 +11,8 @@ sphinx:
   configuration: docs/conf.py
 
 python:
-  install:
-    - method: pip
-      path: .
-      extra_requirements:
-        - docs
+   install:
+      - method: uv
+        command: sync
+        groups:
+          - docs

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Change Log
 
+
+## 0.7
+
+- Add parsing to Gregorian date converter; supports month names (full or abbreviated)
+  in English, French, German, Spanish, Kinyarwanda, Ganda, and Tigrinya
+- Add support for parsing Christian liturgical dates (fixed holidays and movable feasts)
+- Include Gregorian dates and holidays in omnibus parser
+- Updates to pyproject.toml, pre-commit hooks, ruff rules, dependabot configuration
+
 ## 0.6.1
 - Updated Read the Docs build to use Ubuntu 24.04
 

DEVELOPER_NOTES.md

@@ -44,9 +44,15 @@ source .venv/bin/activate
 Install an editable version of the local package along with python dependencies needed for testing and development.
 
 ```sh
-pip install -e ".[dev]"
+pip install -e . --group=dev
 ```
 
+If using `uv`, use 
+
+```sh
+ uv sync --group test
+ ```
+
 ### Install pre-commit hooks
 
 We use [pre-commit](https://pre-commit.com/) for automated checks and consistent formatting.  If you're planning to contribute, please install these when you set up your local development.
@@ -88,4 +94,19 @@ pip install -e ".[docs]"
 sphinx-build docs docs/_build
 ```
 
-HTML documentation will be generated in `docs/_build/html`
+HTML documentation will be generated in `docs/_build/html`
+
+
+### Regenerating multilingual Gregorian month name parse file
+
+The Gregorian Lark parser includes a script-generated file, which
+populates month names based on a list of language codes using the Babel
+library.  To regenerate, run the script with hatch (which should
+be installed globally):
+
+```sh
+hatch run codegen:generate
+```
+
+When the `.lark` file is modified by the script, it must be committed to git.
+

README.md

@@ -4,12 +4,23 @@
 
 **undate** is a python library for working with uncertain or partially known dates.
 
-> [!WARNING]
-> This is beta software and is not yet feature complete! Use with caution and give us feedback.
-> Currently `undate` supports parsing and formatting dates in ISO8601, some
-> portions of EDTF (Extended Date Time Format), and parsing and conversion for dates in Hebrew Anno Mundi and Islamic Hijri calendars.
+> [!NOTE]
+> This is beta software; it is still in development and not fully feature complete. If you use it, please let us know and share your feedback.
+
+
+Currently `undate` supports parsing, formatting, and reasoning with dates in varying precision and calendars; dates with different precision and from different original calendars can be used together. Supported formats include:
+- portions of EDTF (Extended Date Time Format)
+- ISO8601
+- parsing and calendar conversion for dates in Hebrew Anno Mundi and Islamic Hijri calendars
+- Gregorian dates with full or abbreviated month names in any order for multiple languages (English, Spanish, French, German, Kinyarwanda, Ganda, Tigrinya)
+- Christian liturgical dates (fixed holidays and movable feasts)
+
+For unambiguous dates, there is an experimental omnibus parser which combines all available dates (bare years are currently assumed to be Gregorian calendar).
+
+For more about the origin and goals of `undate`, read our 2025 software paper:
+
+> Rebecca Sutton Koeser, Julia Damerow, Robert Casties, and Cole Crawford. “[Undate: Humanistic Dates for Computation](https://doi.org/10.1017/chr.2025.10006).” _Computational Humanities Research_, August 5, 2025.
 
-_Undate was initially created as part of a [DH-Tech](https://dh-tech.github.io/) hackathon in November 2022._
 
 ---
 
@@ -20,14 +31,14 @@ _Undate was initially created as part of a [DH-Tech](https://dh-tech.github.io/)
 [![codecov](https://codecov.io/gh/dh-tech/undate-python/branch/main/graph/badge.svg?token=GE7HZE8C9D)](https://codecov.io/gh/dh-tech/undate-python)
 [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
 
+Project documentation is [available on ReadTheDocs](https://undate-python.readthedocs.io/en/latest/).
+
 <!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
 
 [![All Contributors](https://img.shields.io/badge/all_contributors-5-orange.svg?style=flat-square)](CONTRIBUTORS.md)
 
 <!-- ALL-CONTRIBUTORS-BADGE:END -->
 
-Read [Contributors](CONTRIBUTORS.md) for detailed contribution information.
-
 ## Installation
 
 _Recommended_: use pip to install the latest published version from PyPI:
@@ -242,6 +253,25 @@ Project documentation is [available on ReadTheDocs](https://undate-python.readth
 
 For instructions on setting up for local development, see [Developer Notes](DEVELOPER_NOTES.md).
 
+See [Contributors](CONTRIBUTORS.md) for more detailed information about contributors.
+
+
+## Publications & Presentations
+
+* Rebecca Sutton Koeser, Julia Damerow, Robert Casties, and Cole Crawford.  “[Undate: Humanistic Dates for Computation](https://doi.org/10.1017/chr.2025.10006).”  Software paper published in _Computational Humanities Research_, August 5, 2025.
+* Rebecca Sutton Koeser. “[Undate: Computing with Uncertain and Partially-Unknown Dates](https://doi.org/10.5281/zenodo.17253974).” Computational notebook presented at USRSE’25. October 6, 2025.
+* Rebecca Sutton Koeser. “[Undate in Action](https://rlskoeser.github.io/undate-in-action/).” Presentation at [Digital Humanities Tech Symposium](https://dh-tech.github.io/2025/06/04/digital-humanities-tech-symposium-agenda/), DH2025. July 14, 2025.
+* Rebecca Sutton Koeser. 2025. “[Undate in Action](https://doi.org/10.63744/SFtXXpIE4ERh).” In Digital Humanities Tech Symposium 2025—Anthology of Computers and the Humanities, edited by Julia Damerow and Rebecca Sutton Koeser, vol. 2.
+* Rebecca Sutton Koeser. [Join me for a DHTech hackathon? It’s an un-date!](https://dh-tech.github.io/blog/2023/02/09/hackathon-undate/) DHTech, February 9, 2023.
+
+## Related Projects
+
+- ISO8601 date support and dates with unknown years, including duration, adapted from [Shakespeare and Company Project](https://shakespeareandco.princeton.edu/) ([codebase](https://github.com/Princeton-CDH/mep-django))
+- Parsing and calendar conversion for Hebrew Anno Mundi and Islamic Hijri calendars adapted from [Princeton Geniza Project (PGP)](https://geniza.princeton.edu/) ([codebase](https://github.com/Princeton-CDH/geniza/)); improved and verified with data and logic from the [Islamic Scientific Manuscripts Initiative (ISMI)](https://ismi.mpiwg-berlin.mpg.de/) 
+- Parsing for dates in African languages inspired by work on and partially checked against data from [MasakhaNER](https://github.com/masakhane-io/masakhane-ner)
+- Parsing and calendar conversion for Christian liturgical holidays adapted from work on [Hale/Eliot Letters project](https://cdh.princeton.edu/projects/haleeliot-letters/)
+
+
 ## License
 
 This software is licensed under the [Apache 2.0 License](LICENSE.md).