Merge branch 'main' into ronna

.github/CONTRIBUTING.md

@@ -13,7 +13,8 @@ pre-commit run --all-files  # to run on all files now
 
 ## Docstrings
 
-Follow [Google style](https://google.github.io/styleguide/pyguide.html#38-comments-and-docstrings)
+Follow
+[Google style](https://google.github.io/styleguide/pyguide.html#38-comments-and-docstrings)
 for docstrings.
 
 ## Localization

.github/ISSUE_TEMPLATE.md

@@ -12,7 +12,10 @@
 
 Please include **code** that reproduces the issue.
 
-The [best reproductions](https://stackoverflow.com/help/minimal-reproducible-example) are [self-contained scripts](https://ericlippert.com/2014/03/05/how-to-debug-small-programs/) with minimal dependencies.
+The [best reproductions](https://stackoverflow.com/help/minimal-reproducible-example)
+are
+[self-contained scripts](https://ericlippert.com/2014/03/05/how-to-debug-small-programs/)
+with minimal dependencies.
 
 ```python
 code goes here

.github/SECURITY.md

@@ -1,4 +1,4 @@
 # Security policy
 
-Security reports can be made via [Tidelift](https://tidelift.com/security).
-Tidelift will coordinate the fix and disclosure.
+Security reports can be made via [Tidelift](https://tidelift.com/security). Tidelift
+will coordinate the fix and disclosure.

.github/renovate.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://docs.renovatebot.com/renovate-schema.json",
-  "extends": ["config:base"],
+  "extends": ["config:base", ":semanticCommitsDisabled"],
   "labels": ["changelog: skip", "dependencies"],
   "packageRules": [
     {

.github/workflows/docs.yml

@@ -7,10 +7,10 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 
       - name: Set up Python
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: "3.x"
           cache: pip

.github/workflows/labels.yml

@@ -1,4 +1,8 @@
 name: Sync labels
+
+permissions:
+  pull-requests: write
+
 on:
   push:
     branches:
@@ -11,7 +15,7 @@ jobs:
   sync:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
       - uses: micnncim/action-label-syncer@v1
         with:
           prune: false

.github/workflows/lint.yml

@@ -2,13 +2,28 @@ name: Lint
 
 on: [push, pull_request, workflow_dispatch]
 
+env:
+  FORCE_COLOR: 1
+  PIP_DISABLE_PIP_VERSION_CHECK: 1
+
+permissions:
+  contents: read
+
 jobs:
   lint:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v3
-      - uses: actions/setup-python@v4
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
         with:
           python-version: "3.x"
-      - uses: pre-commit/[email protected]
+          cache: pip
+      - uses: pre-commit/[email protected]
+
+      - name: Install dependencies
+        run: |
+          python3 -m pip install -U tox
+
+      - name: Mypy
+        run: tox -e mypy

.github/workflows/release-drafter.yml

@@ -29,6 +29,6 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       # Drafts your next release notes as pull requests are merged into "main"
-      - uses: release-drafter/release-drafter@v5
+      - uses: release-drafter/release-drafter@v6
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/require-pr-label.yml

@@ -8,6 +8,10 @@ jobs:
   label:
     runs-on: ubuntu-latest
 
+    permissions:
+      issues: write
+      pull-requests: write
+
     steps:
       - uses: mheap/github-action-required-labels@v5
         with:

.github/workflows/test.yml

@@ -11,20 +11,19 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: ["pypy3.10", "3.8", "3.9", "3.10", "3.11", "3.12"]
+        python-version: ["pypy3.10", "3.9", "3.10", "3.11", "3.12", "3.13"]
         os: [windows-latest, macos-latest, ubuntu-latest]
 
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
           allow-prereleases: true
           cache: pip
 
-
       - name: Install Linux dependencies
         if: startsWith(matrix.os, 'ubuntu')
         run: |
@@ -50,7 +49,7 @@ jobs:
           tox -e py
 
       - name: Upload coverage
-        uses: codecov/codecov-action@v3
+        uses: codecov/codecov-action@v3.1.5
         with:
           flags: ${{ matrix.os }}
           name: ${{ matrix.os }} Python ${{ matrix.python-version }}

.gitignore

@@ -158,3 +158,6 @@ cython_debug/
 #  and can be added to the global gitignore or merged into this file.  For a more nuclear
 #  option (not recommended) you can uncomment the following to ignore the entire idea folder.
 #.idea/
+
+# hatch-vcs
+src/*/_version.py

.pre-commit-config.yaml

@@ -1,89 +1,67 @@
 repos:
-  - repo: https://github.com/asottile/pyupgrade
-    rev: v3.10.1
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.6.4
     hooks:
-      - id: pyupgrade
-        args: [--py38-plus]
+      - id: ruff
+        args: [--exit-non-zero-on-fix]
 
-  - repo: https://github.com/psf/black
-    rev: 23.7.0
+  - repo: https://github.com/psf/black-pre-commit-mirror
+    rev: 24.8.0
     hooks:
       - id: black
 
-  - repo: https://github.com/PyCQA/isort
-    rev: 5.12.0
-    hooks:
-      - id: isort
-        args: [--add-import=from __future__ import annotations]
-
-  - repo: https://github.com/PyCQA/autoflake
-    rev: v2.2.0
-    hooks:
-      - id: autoflake
-        name: autoflake
-        args:
-          [
-            "--in-place",
-            "--remove-unused-variables",
-            "--remove-all-unused-imports",
-          ]
-        language: python
-        files: \.py$
-
-  - repo: https://github.com/PyCQA/flake8
-    rev: 6.1.0
-    hooks:
-      - id: flake8
-        additional_dependencies:
-          [flake8-2020, flake8-errmsg, flake8-implicit-str-concat]
-
-  - repo: https://github.com/pre-commit/pygrep-hooks
-    rev: v1.10.0
-    hooks:
-      - id: python-check-blanket-noqa
-      - id: python-no-log-warn
-
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.4.0
+    rev: v4.6.0
     hooks:
+      - id: check-added-large-files
       - id: check-case-conflict
       - id: check-merge-conflict
       - id: check-json
       - id: check-toml
       - id: check-yaml
+      - id: debug-statements
       - id: end-of-file-fixer
+      - id: forbid-submodules
       - id: trailing-whitespace
         exclude: \.github/ISSUE_TEMPLATE\.md|\.github/PULL_REQUEST_TEMPLATE\.md
 
-  - repo: https://github.com/PyCQA/pydocstyle
-    rev: 6.3.0
+  - repo: https://github.com/python-jsonschema/check-jsonschema
+    rev: 0.29.2
     hooks:
-      - id: pydocstyle
-        args: ["--convention", "google"]
-        files: "src/"
+      - id: check-github-workflows
+      - id: check-renovate
 
-  - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.5.0
+  - repo: https://github.com/rhysd/actionlint
+    rev: v1.7.1
     hooks:
-      - id: mypy
-        additional_dependencies: [pytest, types-freezegun, types-setuptools]
-        args: [--strict, --pretty, --show-error-codes]
+      - id: actionlint
 
   - repo: https://github.com/tox-dev/pyproject-fmt
-    rev: 0.13.1
+    rev: 2.2.3
     hooks:
       - id: pyproject-fmt
-        additional_dependencies: [tox]
 
   - repo: https://github.com/abravalheri/validate-pyproject
-    rev: v0.13
+    rev: v0.19
     hooks:
       - id: validate-pyproject
 
   - repo: https://github.com/tox-dev/tox-ini-fmt
-    rev: 1.3.1
+    rev: 1.3.2
     hooks:
       - id: tox-ini-fmt
 
+  - repo: https://github.com/rbubley/mirrors-prettier
+    rev: v3.3.3
+    hooks:
+      - id: prettier
+        args: [--prose-wrap=always, --print-width=88]
+        exclude: \.github/ISSUE_TEMPLATE\.md|\.github/PULL_REQUEST_TEMPLATE\.md
+
+  - repo: meta
+    hooks:
+      - id: check-hooks-apply
+      - id: check-useless-excludes
+
 ci:
   autoupdate_schedule: quarterly

README.md

@@ -9,9 +9,9 @@
 [![MIT License](https://img.shields.io/github/license/python-humanize/humanize.svg)](LICENCE)
 [![Tidelift](https://tidelift.com/badges/package/pypi/humanize)](https://tidelift.com/subscription/pkg/pypi-humanize?utm_source=pypi-humanize&utm_medium=badge)
 
-This modest package contains various common humanization utilities, like turning
-a number into a fuzzy human-readable duration ("3 minutes ago") or into a
-human-readable size or throughput. It is localized to:
+This modest package contains various common humanization utilities, like turning a
+number into a fuzzy human-readable duration ("3 minutes ago") or into a human-readable
+size or throughput. It is localized to:
 
 - Arabic
 - Basque
@@ -26,10 +26,13 @@ human-readable size or throughput. It is localized to:
 - French
 - German
 - Greek
+- Hebrew
 - Indonesian
 - Italian
 - Japanese
+- Klingon
 - Korean
+- Norwegian
 - Persian
 - Polish
 - Russian

RELEASING.md

@@ -1,8 +1,8 @@
 # Release Checklist
 
 - [ ] Get `main` to the appropriate code release state.
-      [GitHub Actions](https://github.com/python-humanize/humanize/actions) should be running
-      cleanly for all merges to `main`.
+      [GitHub Actions](https://github.com/python-humanize/humanize/actions) should be
+      running cleanly for all merges to `main`.
       [![GitHub Actions status](https://github.com/python-humanize/humanize/workflows/Test/badge.svg)](https://github.com/python-humanize/humanize/actions)
 
 * [ ] Start from a freshly cloned repo:
@@ -16,7 +16,7 @@ cd humanize
 scripts/generate-translation-binaries.sh
 ```
 
-* [ ] (Optional) Create a distribution and release on **TestPyPI**:
+- [ ] (Optional) Create a distribution and release on **TestPyPI**:
 
 ```bash
 pip install -U pip build keyring twine
@@ -33,13 +33,13 @@ pip3 install -U -i https://test.pypi.org/simple/ humanize --pre
 python3 -c "import humanize; print(humanize.__version__)"
 ```
 
-* [ ] Tag with the version number:
+- [ ] Tag with the version number:
 
 ```bash
 git tag -a 2.1.0 -m "Release 2.1.0"
 ```
 
-* [ ] Create a distribution and release on **live PyPI**:
+- [ ] Create a distribution and release on **live PyPI**:
 
 ```bash
 pip install -U pip build keyring twine
@@ -48,21 +48,23 @@ python -m build
 twine check --strict dist/* && twine upload --repository pypi dist/*
 ```
 
-* [ ] Check installation:
+- [ ] Check installation:
 
 ```bash
 pip uninstall -y humanize
 pip install -U humanize
 python3 -c "import humanize; print(humanize.__version__)"
 ```
 
-* [ ] Push tag:
- ```bash
+- [ ] Push tag:
+
+```bash
 git push --tags
 ```
 
-* [ ] Edit release draft, adjust text if needed: https://github.com/python-humanize/humanize/releases
+- [ ] Edit release draft, adjust text if needed:
+      https://github.com/python-humanize/humanize/releases
 
-* [ ] Check next tag is correct, amend if needed
+- [ ] Check next tag is correct, amend if needed
 
-* [ ] Publish release
+- [ ] Publish release

docs/index.md

@@ -2,10 +2,10 @@
 
 Welcome to the humanize API reference.
 
-* [Number](number)
-* [Time](time)
-* [Filesize](filesize)
-* [I18n](i18n)
+- [Number](number.md)
+- [Time](time.md)
+- [Filesize](filesize.md)
+- [I18n](i18n.md)
 
 {%
    include-markdown "../README.md"