ramtable 0.3.1__tar.gz → 0.3.2__tar.gz

{ramtable-0.3.1 → ramtable-0.3.2}/.github/workflows/tests.yml

@@ -26,10 +26,11 @@ jobs:
       fail-fast: false
       matrix:
         python-version:
-          - "3.10"
           - "3.11"
           - "3.12"
           - "3.13"
+          - "3.14"
+          - "3.15"
 
     steps:
       - name: Check out repository

{ramtable-0.3.1 → ramtable-0.3.2}/CHANGELOG.md

@@ -3,6 +3,23 @@
 Notable changes to RAMTable are documented in this file. The history starts
 with the project's first version.
 
+## [0.3.2]
+
+Raises the minimum supported Python version, expands the tested versions,
+and centralizes the package version.
+
+### Added
+
+- `ramtable.__version__` exposes the installed distribution version, read
+  from package metadata.
+
+### Changed
+
+- Python 3.11 or later is now required; support for Python 3.10 was removed.
+- Added Python 3.14 and 3.15 to the test matrix and package classifiers.
+- `pyproject.toml` is the single source of truth for the version; the README
+  uses a dynamic PyPI badge instead of a hardcoded number.
+
 ## [0.3.1]
 
 Publishes RAMTable to the official PyPI index alongside TestPyPI.
@@ -19,7 +36,6 @@ Publishes RAMTable to the official PyPI index alongside TestPyPI.
 
 - Installation documentation covers stable releases from PyPI and
   pre-releases from TestPyPI.
-- `pyproject.toml` reports version `0.3.1rc0`.
 
 ## [0.3.0]
 

{ramtable-0.3.1 → ramtable-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ramtable
-Version: 0.3.1
+Version: 0.3.2
 Summary: A lightweight in-memory table library for Python.
 Author: Thiago Valentín Stilo Limarino
 License-Expression: MIT
@@ -10,19 +10,20 @@ Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
-Requires-Python: >=3.10
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 
 # RAMTable
 
-![Python](https://img.shields.io/badge/python-3.10%2B-blue)
+![Python](https://img.shields.io/badge/python-3.11%2B-blue)
 ![License](https://img.shields.io/badge/license-MIT-green)
-[![PyPI](https://img.shields.io/badge/PyPI-ramtable-blue)](https://pypi.org/project/ramtable/)
-[![TestPyPI](https://img.shields.io/badge/TestPyPI-ramtable-orange)](https://test.pypi.org/project/ramtable/)
+[![PyPI](https://img.shields.io/pypi/v/ramtable)](https://pypi.org/project/ramtable/)
+[![TestPyPI](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Ftest.pypi.org%2Fpypi%2Framtable%2Fjson&label=TestPyPI&query=%24.info.version&color=blue)](https://test.pypi.org/project/ramtable/)
 
 RAMTable provides typed in-memory tables for data that only needs to live
 while a program is running. It gives records an explicit schema and common
@@ -62,7 +63,7 @@ temporary storage, not analytics.
 
 ## Installation
 
-RAMTable requires Python 3.10 or later.
+RAMTable requires Python 3.11 or later.
 
 Install the latest stable release from PyPI:
 
@@ -218,10 +219,12 @@ writes to disk: records disappear when the process ends.
 
 ## Project status
 
-The current development version is **0.3.1rc0**. RAMTable is published as
-`ramtable` on both [PyPI](https://pypi.org/project/ramtable/) and
+RAMTable is published as `ramtable` on
+[PyPI](https://pypi.org/project/ramtable/) and
 [TestPyPI](https://test.pypi.org/project/ramtable/). Use PyPI for stable
-releases and TestPyPI to try release candidates and other pre-releases.
+releases and TestPyPI to try release candidates and other pre-releases. The
+PyPI badge above shows the latest published version; the
+[CHANGELOG](CHANGELOG.md) records the full release history.
 
 The project is at an early stage and will continue to evolve. See the
 [CHANGELOG](CHANGELOG.md) for release history.

{ramtable-0.3.1 → ramtable-0.3.2}/README.md

@@ -1,9 +1,9 @@
 # RAMTable
 
-![Python](https://img.shields.io/badge/python-3.10%2B-blue)
+![Python](https://img.shields.io/badge/python-3.11%2B-blue)
 ![License](https://img.shields.io/badge/license-MIT-green)
-[![PyPI](https://img.shields.io/badge/PyPI-ramtable-blue)](https://pypi.org/project/ramtable/)
-[![TestPyPI](https://img.shields.io/badge/TestPyPI-ramtable-orange)](https://test.pypi.org/project/ramtable/)
+[![PyPI](https://img.shields.io/pypi/v/ramtable)](https://pypi.org/project/ramtable/)
+[![TestPyPI](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Ftest.pypi.org%2Fpypi%2Framtable%2Fjson&label=TestPyPI&query=%24.info.version&color=blue)](https://test.pypi.org/project/ramtable/)
 
 RAMTable provides typed in-memory tables for data that only needs to live
 while a program is running. It gives records an explicit schema and common
@@ -43,7 +43,7 @@ temporary storage, not analytics.
 
 ## Installation
 
-RAMTable requires Python 3.10 or later.
+RAMTable requires Python 3.11 or later.
 
 Install the latest stable release from PyPI:
 
@@ -199,10 +199,12 @@ writes to disk: records disappear when the process ends.
 
 ## Project status
 
-The current development version is **0.3.1rc0**. RAMTable is published as
-`ramtable` on both [PyPI](https://pypi.org/project/ramtable/) and
+RAMTable is published as `ramtable` on
+[PyPI](https://pypi.org/project/ramtable/) and
 [TestPyPI](https://test.pypi.org/project/ramtable/). Use PyPI for stable
-releases and TestPyPI to try release candidates and other pre-releases.
+releases and TestPyPI to try release candidates and other pre-releases. The
+PyPI badge above shows the latest published version; the
+[CHANGELOG](CHANGELOG.md) records the full release history.
 
 The project is at an early stage and will continue to evolve. See the
 [CHANGELOG](CHANGELOG.md) for release history.

{ramtable-0.3.1 → ramtable-0.3.2}/docs/api.md

@@ -1,11 +1,12 @@
 # API reference
 
 This reference covers every public symbol RAMTable exposes: the `Table`,
-`Columns`, and `Rows` classes, and the optional `TypeValidator`. For an
-example-driven introduction, read the [user guide](guide.md) first.
+`Columns`, and `Rows` classes, the optional `TypeValidator`, and the package
+version. For an example-driven introduction, read the
+[user guide](guide.md) first.
 
 ```python
-from ramtable import Columns, Rows, Table
+from ramtable import Columns, Rows, Table, __version__
 from ramtable.types import TypeValidator
 ```
 
@@ -18,9 +19,21 @@ In normal use you only create a `Table`; it constructs the coordinated
 - [`Columns`](#columns)
 - [`Rows`](#rows)
 - [`TypeValidator`](#typevalidator)
+- [Package version](#package-version)
 - [Internal helpers](#internal-helpers)
 - [Copying behavior](#copying-behavior)
 
+## Package version
+
+```python
+from ramtable import __version__
+```
+
+`__version__` is the version of the installed distribution, read from its
+package metadata. It matches `project.version` in `pyproject.toml` and the
+artifact built from it. In a source checkout that has not been installed,
+it is `"0+unknown"`.
+
 ## `Table`
 
 ```python

{ramtable-0.3.1 → ramtable-0.3.2}/docs/development.md

@@ -47,7 +47,7 @@ how to prepare a release. It does not change or extend the RAMTable API.
 
 ## Set up a local environment
 
-Python 3.10 or later is required. Install the project in editable mode:
+Python 3.11 or later is required. Install the project in editable mode:
 
 ```bash
 python -m pip install --editable .
@@ -91,7 +91,7 @@ the branch:
 
 | Branch | Version form | Example | Published to |
 |---|---|---|---|
-| `dev` | `X.Y.Z.devN` | `0.3.1.dev1` | nothing |
+| `dev` | `X.Y.Z.devN` | `0.3.2.dev0` | nothing |
 | `test_pypi` | `X.Y.ZrcN` or `X.Y.Z` | `0.3.1rc0`, `0.3.1` | TestPyPI |
 | `main` | `X.Y.Z` | `0.3.1` | PyPI |
 
@@ -101,15 +101,24 @@ the branch:
 - `MINOR` for compatible functionality;
 - `MAJOR` for breaking API or behavior changes.
 
+`pyproject.toml` is the single source of truth for the current version. The
+build backend reads it, the GitHub Actions workflows read it, and the
+installed package exposes it as `ramtable.__version__` through its
+distribution metadata. The README uses a dynamic PyPI badge instead of a
+hardcoded number. `CHANGELOG.md` is the only other file with version
+numbers, because it is a historical record of releases.
+
 Development versions are never published. TestPyPI accepts release
 candidates and stable versions, so the final stable release can be tested
 there before it reaches PyPI. PyPI accepts stable versions only.
 
 ## Preparing a release
 
-1. On `dev`, update `project.version` in `pyproject.toml` and add the
-   corresponding section to `CHANGELOG.md`.
-2. Check that the README and documentation describe current behavior.
+1. On `dev`, update `project.version` in `pyproject.toml`. This is the only
+   place where the current version is defined. Add the corresponding
+   section to `CHANGELOG.md`.
+2. Check that the README and documentation describe current behavior. The
+   README must not contain a hardcoded version.
 3. Run the example and all available build/test checks.
 4. Build and inspect the wheel and source distribution.
 5. Open a pull request from `dev` to `test_pypi`. The pull request validates

{ramtable-0.3.1 → ramtable-0.3.2}/pyproject.toml

@@ -4,10 +4,10 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ramtable"
-version = "0.3.1"
+version = "0.3.2"
 description = "A lightweight in-memory table library for Python."
 readme = "README.md"
-requires-python = ">=3.10"
+requires-python = ">=3.11"
 license = "MIT"
 authors = [
     { name = "Thiago Valentín Stilo Limarino" }
@@ -22,10 +22,11 @@ classifiers = [
     "Development Status :: 3 - Alpha",
     "Intended Audience :: Developers",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
     "License :: OSI Approved :: MIT License",
 ]
 

ramtable-0.3.2/src/ramtable/__init__.py

@@ -0,0 +1,24 @@
+"""Public RAMTable API.
+
+Expose :class:`Columns`, :class:`Rows`, and :class:`Table` from the
+``ramtable`` package as a concise, stable import path, along with the
+installed package version.
+"""
+
+from importlib.metadata import PackageNotFoundError, version
+
+from .columns import Columns
+from .rows import Rows
+from .table import Table
+
+try:
+    __version__ = version("ramtable")
+except PackageNotFoundError:  # pragma: no cover - source checkout without install
+    __version__ = "0+unknown"
+
+__all__ = [
+    "__version__",
+    "Columns",
+    "Rows",
+    "Table",
+]

ramtable-0.3.1/src/ramtable/__init__.py

@@ -1,15 +0,0 @@
-"""Public RAMTable API.
-
-Expose :class:`Columns`, :class:`Rows`, and :class:`Table` from the
-``ramtable`` package as a concise, stable import path.
-"""
-
-from .columns import Columns
-from .rows import Rows
-from .table import Table
-
-__all__ = [
-    "Columns",
-    "Rows",
-    "Table",
-]