aemo-mdff-reader 2.0.4__tar.gz → 2.2.0__tar.gz

{aemo_mdff_reader-2.0.4 → aemo_mdff_reader-2.2.0}/CHANGELOG.md

@@ -4,6 +4,29 @@ All notable changes are documented here. The format is based on
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the
 project follows [Semantic Versioning](https://semver.org/).
 
+## [2.2.0](https://github.com/Utilified/aemo-mdff-reader/compare/v2.1.0...v2.2.0) (2026-05-10)
+
+
+### ⚠ BREAKING CHANGES
+
+* minimum Python version is now 3.11. Users on 3.10 should pin to `aemo-mdff-reader<2.2`.
+
+### Features
+
+* drop Python 3.10, bump dev floor to pandas 3 / numpy 2.x ([876c863](https://github.com/Utilified/aemo-mdff-reader/commit/876c863186a7de14b05fa35b0a864b38e4292701))
+
+## [2.1.0](https://github.com/Utilified/aemo-mdff-reader/compare/v2.0.4...v2.1.0) (2026-05-10)
+
+
+### Features
+
+* drop Python 3.9, hash-pin CI installs, scope release-please permissions ([447ec98](https://github.com/Utilified/aemo-mdff-reader/commit/447ec98408edabfab45d28841a2e714d54f8dd11))
+
+
+### Documentation
+
+* remove broken OpenSSF Best Practices badge ([#21](https://github.com/Utilified/aemo-mdff-reader/issues/21)) ([91a68d5](https://github.com/Utilified/aemo-mdff-reader/commit/91a68d5a4b4fd4c027488b4fe770c4cd142a7454))
+
 ## [2.0.4](https://github.com/Utilified/aemo-mdff-reader/compare/v2.0.3...v2.0.4) (2026-05-10)
 
 First release published to PyPI after the supply-chain hardening landed

{aemo_mdff_reader-2.0.4 → aemo_mdff_reader-2.2.0}/CONTRIBUTING.md

@@ -24,6 +24,32 @@ pip install -e .[dev]
 pytest
 ```
 
+## CI requirements files
+
+`requirements/{dev,lint,build,audit}.txt` are hash-pinned lock files
+consumed by CI (`pip install --require-hashes`). They satisfy
+Scorecard's `PinnedDependenciesID` and protect CI against a compromised
+PyPI mirror. Dependabot refreshes them weekly.
+
+Source `.in` files are committed alongside the locks in `requirements/`.
+To regenerate manually after editing them or `pyproject.toml`:
+
+```bash
+pip install uv
+uv pip compile --generate-hashes --strip-extras --python-version 3.11 --output-file requirements/dev.txt   requirements/dev.in
+uv pip compile --generate-hashes --strip-extras --python-version 3.11 --output-file requirements/lint.txt  requirements/lint.in
+uv pip compile --generate-hashes --strip-extras --python-version 3.11 --output-file requirements/build.txt requirements/build.in
+uv pip compile --generate-hashes --strip-extras --python-version 3.11 --output-file requirements/audit.txt requirements/audit.in
+```
+
+`uv` is used over `pip-tools` because its resolver handles the
+3.11–3.12 matrix without back-tracking failures, and it emits hashes
+for every wheel of each pinned version (so a single lock file works
+across the whole CI matrix). The `--python-version 3.11` flag pins
+resolution to the lowest supported interpreter so packages whose
+latest releases dropped support for it are correctly stepped back
+to a compatible version.
+
 ## Running the test suite
 
 ```bash

{aemo_mdff_reader-2.0.4/aemo_mdff_reader.egg-info → aemo_mdff_reader-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aemo-mdff-reader
-Version: 2.0.4
+Version: 2.2.0
 Summary: Fast streaming reader for AEMO MDFF NEM12 / NEM13 metering files. Zero required dependencies.
 Author: Utilified Holdings Pty Ltd
 License-Expression: MIT
@@ -15,28 +15,26 @@ Classifier: Intended Audience :: Information Technology
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Office/Business :: Financial
 Classifier: Topic :: Scientific/Engineering
 Classifier: Topic :: Utilities
-Requires-Python: >=3.9
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Provides-Extra: pandas
-Requires-Dist: pandas>=1.3; extra == "pandas"
+Requires-Dist: pandas>=2; extra == "pandas"
 Provides-Extra: parquet
-Requires-Dist: pandas>=1.3; extra == "parquet"
+Requires-Dist: pandas>=2; extra == "parquet"
 Requires-Dist: pyarrow>=10; extra == "parquet"
 Provides-Extra: mysql
 Requires-Dist: PyMySQL>=1.0; extra == "mysql"
 Provides-Extra: dev
 Requires-Dist: pytest>=7; extra == "dev"
 Requires-Dist: pytest-cov>=4; extra == "dev"
-Requires-Dist: pandas>=1.3; extra == "dev"
+Requires-Dist: pandas>=2; extra == "dev"
 Requires-Dist: pyarrow>=10; extra == "dev"
 Requires-Dist: mypy>=1.8; extra == "dev"
 Requires-Dist: ruff>=0.5; extra == "dev"
@@ -49,12 +47,10 @@ Dynamic: license-file
 
 [![CI](https://github.com/Utilified/aemo-mdff-reader/actions/workflows/ci.yml/badge.svg)](https://github.com/Utilified/aemo-mdff-reader/actions/workflows/ci.yml)
 [![PyPI](https://img.shields.io/pypi/v/aemo-mdff-reader.svg)](https://pypi.org/project/aemo-mdff-reader/)
-[![Python versions](https://img.shields.io/pypi/pyversions/aemo-mdff-reader.svg)](https://pypi.org/project/aemo-mdff-reader/)
+[![Python versions](https://img.shields.io/badge/python-3.11%20%7C%203.12%20%7C%203.13-blue)](https://pypi.org/project/aemo-mdff-reader/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 [![CodeQL](https://github.com/Utilified/aemo-mdff-reader/actions/workflows/codeql.yml/badge.svg)](https://github.com/Utilified/aemo-mdff-reader/actions/workflows/codeql.yml)
 [![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/Utilified/aemo-mdff-reader/badge)](https://scorecard.dev/viewer/?uri=github.com/Utilified/aemo-mdff-reader)
-<!-- TODO: replace PROJECTID after registering at https://www.bestpractices.dev/ -->
-[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/PROJECTID/badge)](https://www.bestpractices.dev/projects/PROJECTID)
 
 Fast, zero-dependency streaming reader for AEMO **NEM12** and **NEM13**
 metering files. Implements AEMO MDFF (Meter Data File Format) v2.6.
@@ -241,7 +237,7 @@ pip install -e .[dev]
 pytest
 ```
 
-CI runs ruff, mypy --strict, the test matrix on Python 3.9 → 3.12 /
+CI runs ruff, mypy --strict, the test matrix on Python 3.11 → 3.12 /
 Linux / macOS / Windows, `pip-audit`, `bandit`, CodeQL, OpenSSF
 Scorecard, and a wheel-install smoke test.
 

{aemo_mdff_reader-2.0.4 → aemo_mdff_reader-2.2.0}/README.md

@@ -2,12 +2,10 @@
 
 [![CI](https://github.com/Utilified/aemo-mdff-reader/actions/workflows/ci.yml/badge.svg)](https://github.com/Utilified/aemo-mdff-reader/actions/workflows/ci.yml)
 [![PyPI](https://img.shields.io/pypi/v/aemo-mdff-reader.svg)](https://pypi.org/project/aemo-mdff-reader/)
-[![Python versions](https://img.shields.io/pypi/pyversions/aemo-mdff-reader.svg)](https://pypi.org/project/aemo-mdff-reader/)
+[![Python versions](https://img.shields.io/badge/python-3.11%20%7C%203.12%20%7C%203.13-blue)](https://pypi.org/project/aemo-mdff-reader/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 [![CodeQL](https://github.com/Utilified/aemo-mdff-reader/actions/workflows/codeql.yml/badge.svg)](https://github.com/Utilified/aemo-mdff-reader/actions/workflows/codeql.yml)
 [![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/Utilified/aemo-mdff-reader/badge)](https://scorecard.dev/viewer/?uri=github.com/Utilified/aemo-mdff-reader)
-<!-- TODO: replace PROJECTID after registering at https://www.bestpractices.dev/ -->
-[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/PROJECTID/badge)](https://www.bestpractices.dev/projects/PROJECTID)
 
 Fast, zero-dependency streaming reader for AEMO **NEM12** and **NEM13**
 metering files. Implements AEMO MDFF (Meter Data File Format) v2.6.
@@ -194,7 +192,7 @@ pip install -e .[dev]
 pytest
 ```
 
-CI runs ruff, mypy --strict, the test matrix on Python 3.9 → 3.12 /
+CI runs ruff, mypy --strict, the test matrix on Python 3.11 → 3.12 /
 Linux / macOS / Windows, `pip-audit`, `bandit`, CodeQL, OpenSSF
 Scorecard, and a wheel-install smoke test.
 

{aemo_mdff_reader-2.0.4 → aemo_mdff_reader-2.2.0}/aemo_mdff_reader/__init__.py

@@ -48,7 +48,7 @@ from .types import (
     NMIDetails,
 )
 
-__version__ = "2.0.4"  # x-release-please-version
+__version__ = "2.2.0"  # x-release-please-version
 
 __all__ = [
     "INTERVAL_DATA_OUTPUT_HEADERS",

{aemo_mdff_reader-2.0.4 → aemo_mdff_reader-2.2.0}/aemo_mdff_reader/cli.py

@@ -223,6 +223,7 @@ def main(argv: Optional[Sequence[str]] = None) -> int:
         try:
             sys.stdout.flush()
         except BrokenPipeError:
+            # Pipe is already gone; nothing to flush.
             pass
     return 0
 

{aemo_mdff_reader-2.0.4 → aemo_mdff_reader-2.2.0}/aemo_mdff_reader/sql/__init__.py

@@ -7,8 +7,14 @@ The dependency is only required when you actually instantiate
 
 from __future__ import annotations
 
+from typing import TYPE_CHECKING
+
 from .query import COLUMNS, QueryBuilder
 
+if TYPE_CHECKING:
+    # Visible to static analysers / IDEs without forcing pymysql to load.
+    from .store import DBCredentials, Storer
+
 __all__ = ["COLUMNS", "DBCredentials", "QueryBuilder", "Storer"]
 
 

{aemo_mdff_reader-2.0.4 → aemo_mdff_reader-2.2.0}/aemo_mdff_reader/sql/store.py

@@ -4,7 +4,15 @@
 
 import pymysql.cursors
 
-from .query import *
+from .query import (
+    CHANNEL_TABLE,
+    IMPORT_TABLE,
+    INTERVAL_DATA_TABLE,
+    INTERVAL_TABLE,
+    INTERVAL_TYPE_TABLE,
+    NMI_TABLE,
+    QueryBuilder,
+)
 
 # Load queries once session is imported
 QUERY_FOLDER = "queries"
@@ -128,11 +136,11 @@ class Storer:
 
                     data_intervals.append(data_interval)
             query = QueryBuilder.insert_query(NMI_TABLE, data_nmi)
-            resultset = cursor.execute(query)
+            cursor.execute(query)
 
             for row in range(len(data_channel)):
                 query = QueryBuilder.insert_query(CHANNEL_TABLE, [data_channel[row]])
-                resultset = cursor.execute(query)
+                cursor.execute(query)
                 query = "SELECT channelID FROM `nem`.`channel` WHERE `NMI` = %s AND `NMISuffix` = %s AND `MeterSerialNumber` = %s"
                 cursor.execute(
                     query, (data_channel[row][0], data_channel[row][2], data_channel[row][4])

{aemo_mdff_reader-2.0.4 → aemo_mdff_reader-2.2.0/aemo_mdff_reader.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aemo-mdff-reader
-Version: 2.0.4
+Version: 2.2.0
 Summary: Fast streaming reader for AEMO MDFF NEM12 / NEM13 metering files. Zero required dependencies.
 Author: Utilified Holdings Pty Ltd
 License-Expression: MIT
@@ -15,28 +15,26 @@ Classifier: Intended Audience :: Information Technology
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Office/Business :: Financial
 Classifier: Topic :: Scientific/Engineering
 Classifier: Topic :: Utilities
-Requires-Python: >=3.9
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Provides-Extra: pandas
-Requires-Dist: pandas>=1.3; extra == "pandas"
+Requires-Dist: pandas>=2; extra == "pandas"
 Provides-Extra: parquet
-Requires-Dist: pandas>=1.3; extra == "parquet"
+Requires-Dist: pandas>=2; extra == "parquet"
 Requires-Dist: pyarrow>=10; extra == "parquet"
 Provides-Extra: mysql
 Requires-Dist: PyMySQL>=1.0; extra == "mysql"
 Provides-Extra: dev
 Requires-Dist: pytest>=7; extra == "dev"
 Requires-Dist: pytest-cov>=4; extra == "dev"
-Requires-Dist: pandas>=1.3; extra == "dev"
+Requires-Dist: pandas>=2; extra == "dev"
 Requires-Dist: pyarrow>=10; extra == "dev"
 Requires-Dist: mypy>=1.8; extra == "dev"
 Requires-Dist: ruff>=0.5; extra == "dev"
@@ -49,12 +47,10 @@ Dynamic: license-file
 
 [![CI](https://github.com/Utilified/aemo-mdff-reader/actions/workflows/ci.yml/badge.svg)](https://github.com/Utilified/aemo-mdff-reader/actions/workflows/ci.yml)
 [![PyPI](https://img.shields.io/pypi/v/aemo-mdff-reader.svg)](https://pypi.org/project/aemo-mdff-reader/)
-[![Python versions](https://img.shields.io/pypi/pyversions/aemo-mdff-reader.svg)](https://pypi.org/project/aemo-mdff-reader/)
+[![Python versions](https://img.shields.io/badge/python-3.11%20%7C%203.12%20%7C%203.13-blue)](https://pypi.org/project/aemo-mdff-reader/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 [![CodeQL](https://github.com/Utilified/aemo-mdff-reader/actions/workflows/codeql.yml/badge.svg)](https://github.com/Utilified/aemo-mdff-reader/actions/workflows/codeql.yml)
 [![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/Utilified/aemo-mdff-reader/badge)](https://scorecard.dev/viewer/?uri=github.com/Utilified/aemo-mdff-reader)
-<!-- TODO: replace PROJECTID after registering at https://www.bestpractices.dev/ -->
-[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/PROJECTID/badge)](https://www.bestpractices.dev/projects/PROJECTID)
 
 Fast, zero-dependency streaming reader for AEMO **NEM12** and **NEM13**
 metering files. Implements AEMO MDFF (Meter Data File Format) v2.6.
@@ -241,7 +237,7 @@ pip install -e .[dev]
 pytest
 ```
 
-CI runs ruff, mypy --strict, the test matrix on Python 3.9 → 3.12 /
+CI runs ruff, mypy --strict, the test matrix on Python 3.11 → 3.12 /
 Linux / macOS / Windows, `pip-audit`, `bandit`, CodeQL, OpenSSF
 Scorecard, and a wheel-install smoke test.
 

{aemo_mdff_reader-2.0.4 → aemo_mdff_reader-2.2.0}/aemo_mdff_reader.egg-info/requires.txt

@@ -2,7 +2,7 @@
 [dev]
 pytest>=7
 pytest-cov>=4
-pandas>=1.3
+pandas>=2
 pyarrow>=10
 mypy>=1.8
 ruff>=0.5
@@ -14,8 +14,8 @@ packaging>=24.2
 PyMySQL>=1.0
 
 [pandas]
-pandas>=1.3
+pandas>=2
 
 [parquet]
-pandas>=1.3
+pandas>=2
 pyarrow>=10

{aemo_mdff_reader-2.0.4 → aemo_mdff_reader-2.2.0}/pyproject.toml

@@ -11,14 +11,15 @@ build-backend = "setuptools.build_meta"
 # Pillow / PIL precedent (``pip install Pillow`` → ``import PIL``)
 # applies here.
 name = "aemo-mdff-reader"
-version = "2.0.4"
+version = "2.2.0"
 description = "Fast streaming reader for AEMO MDFF NEM12 / NEM13 metering files. Zero required dependencies."
 readme = "README.md"
 license = "MIT"
 license-files = ["LICENSE"]
-# Python 3.8 is EOL (Oct 2024) and setuptools 77+ — required for the
-# PEP 639 license metadata above — does not publish a 3.8 wheel.
-requires-python = ">=3.9"
+# Python 3.9 reached EOL in October 2025; pandas 3.0 dropped Python
+# 3.10 support. Bumping the floor to 3.11 keeps us aligned with the
+# upstream pandas/numpy/pyarrow release trains used by the dev extras.
+requires-python = ">=3.11"
 authors = [
     { name = "Utilified Holdings Pty Ltd" },
 ]
@@ -30,8 +31,6 @@ classifiers = [
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
-    "Programming Language :: Python :: 3.9",
-    "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
@@ -43,13 +42,13 @@ classifiers = [
 dependencies = []
 
 [project.optional-dependencies]
-pandas = ["pandas>=1.3"]
-parquet = ["pandas>=1.3", "pyarrow>=10"]
+pandas = ["pandas>=2"]
+parquet = ["pandas>=2", "pyarrow>=10"]
 mysql = ["PyMySQL>=1.0"]
 dev = [
     "pytest>=7",
     "pytest-cov>=4",
-    "pandas>=1.3",
+    "pandas>=2",
     "pyarrow>=10",
     "mypy>=1.8",
     "ruff>=0.5",
@@ -95,7 +94,7 @@ exclude_lines = [
 
 [tool.ruff]
 line-length = 100
-target-version = "py39"
+target-version = "py311"
 
 [tool.ruff.lint]
 select = [
@@ -109,10 +108,8 @@ select = [
 ]
 ignore = [
     "E501",   # line too long — handled by formatter
-    # We use ``Union[...]`` / ``Optional[...]`` / ``Dict[...]`` so the
-    # type aliases work at runtime on 3.9 without ``from __future__
-    # import annotations`` everywhere. Adopting PEP 604 / PEP 585 syntax
-    # is a follow-up; left as-is to keep the public-API diff small.
+    # PEP 604 / PEP 585 typing migration is a follow-up; left for now
+    # to keep the public-API surface diff small for 2.x.
     "UP007",  # Use X | Y instead of Union[X, Y]
     "UP045",  # Use X | None instead of Optional[X]
     "UP006",  # Use builtin generics (dict[X, Y]) instead of typing.Dict
@@ -128,11 +125,7 @@ ignore = [
 "aemo_mdff_reader/sql/*" = ["F401", "F403", "F405", "UP031"]
 
 [tool.mypy]
-# Lowest supported runtime is 3.9 (see ``requires-python``), but mypy
-# 1.16+ no longer accepts ``<3.10`` here. Type-checking against 3.10
-# still produces useful results — we don't use any 3.10-only typing
-# features (no ``match`` statements, no PEP 604 ``X | Y`` at runtime).
-python_version = "3.10"
+python_version = "3.11"
 strict = true
 files = ["aemo_mdff_reader"]
 # Optional dependencies that don't ship type stubs.

{aemo_mdff_reader-2.0.4 → aemo_mdff_reader-2.2.0}/tests/test_parser.py

@@ -127,7 +127,8 @@ def test_parse_to_columns_matches_to_columns():
 
 
 def test_parse_to_columns_from_iterable():
-    rows = list(csv.reader(open(FIXTURE)))
+    with open(FIXTURE) as f:
+        rows = list(csv.reader(f))
     a = parse_to_columns(FIXTURE)
     b = parse_to_columns(rows)
     assert a == b
@@ -178,7 +179,8 @@ def test_header_repr():
 
 
 def test_nem_reader_read_from_array():
-    rows = list(csv.reader(open(FIXTURE)))
+    with open(FIXTURE) as f:
+        rows = list(csv.reader(f))
     rdr = NEMReader()
     rdr.read_from_array(rows)
     assert len(rdr.readings) == 3 * 48
@@ -188,7 +190,8 @@ def test_nem_reader_read_from_array():
 def test_nem_reader_to_columns_without_filename():
     # NEMReader.to_columns falls through the Reading-iterable branch
     # when no source filename is buffered.
-    rows = list(csv.reader(open(FIXTURE)))
+    with open(FIXTURE) as f:
+        rows = list(csv.reader(f))
     rdr = NEMReader()
     rdr.read_from_array(rows)
     cols = rdr.to_columns()

{aemo_mdff_reader-2.0.4 → aemo_mdff_reader-2.2.0}/tests/test_spec.py

@@ -2,8 +2,11 @@
 
 from __future__ import annotations
 
+from urllib.parse import urlparse
+
 import aemo_mdff_reader
-from aemo_mdff_reader import spec
+
+spec = aemo_mdff_reader.spec
 
 
 def test_spec_module_is_re_exported():
@@ -16,7 +19,9 @@ def test_spec_version_metadata():
     # ISO-8601 effective date keeps callers parseable.
     assert spec.SPEC_EFFECTIVE_DATE == "2024-09-29"
     assert "Meter Data File Format" in spec.SPEC_DOCUMENT_TITLE
-    assert spec.SPEC_URL.startswith("https://www.aemo.com.au")
+    parsed = urlparse(spec.SPEC_URL)
+    assert parsed.scheme == "https"
+    assert parsed.hostname == "www.aemo.com.au"
 
 
 def test_allowed_interval_lengths_match_spec():

{aemo_mdff_reader-2.0.4 → aemo_mdff_reader-2.2.0}/tests/test_sql.py

@@ -43,7 +43,7 @@ def test_storer_attribute_lazy_loads():
     # If pymysql is not installed, accessing Storer should raise ImportError
     # only at access time, not at module import time.
     pytest.importorskip("aemo_mdff_reader.sql")
-    import aemo_mdff_reader.sql as sql_mod
+    from aemo_mdff_reader import sql as sql_mod
 
     if "pymysql" in sys.modules:
         # If pymysql is available in the test env, we can at least confirm