Changelog¶

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.0.2] - 2026-07-19¶

Move empty-source validation before import requests in HttpLoader.load() so ValueError is raised regardless of whether requests is installed.
Add http extra to CI dependencies so HTTP loader tests can run with requests installed.

Fixed mypy cross-version compatibility: removed --strict flag from CI command (already in pyproject.toml), allowing warn_unused_ignores = false to take effect across Python 3.11–3.14.
Removed redundant cast() in TypedTableWrapper.headings property.

First stable release. The API is frozen and ready for production use.

excel schema alias for @load_examples tags (in addition to xlsx).
wrap and TableWrapper re-exports documented in the API reference.
docs/migration.md — step-by-step migration guide from behave-tables.
MANIFEST.in to ensure LICENSE and README are included in the sdist.
pre-commit to the dev extras.
Regression tests for TableLike compatibility, resolve_placeholder type checking, and Config marker validation.

TypedTableWrapper now fully satisfies the TableLike protocol, exposing headings and rows properties.
TypedTableWrapper can re-wrap an existing TableWrapper or TypedTableWrapper without re-extracting rows.
resolve_placeholder raises a clear TypeError when given a non-string value.
Config validates that null_markers and null_markers_by_column contain only string values.
Codecov action updated to v4 with token authentication in CI.

Version bumped to 1.0.0 — API is considered stable.
Development Status classifier set to Production/Stable.
Coverage threshold enforced at 90% in Makefile and pyproject.toml.
Polished README, documentation, contributing guidelines, security policy, and package metadata for public release.
Improved TypedTableWrapper.typed_dicts() performance by precomputing column type and null-marker metadata once per call.

Sphinx documentation site with furo theme
13 documentation pages: quickstart, installation, typed tables, null handling, diff, raw tables, dynamic examples, fixtures, builders, secrets, tags, hooks, configuration, API reference, migration guide, changelog
GitHub Actions workflow docs.yml to build and deploy docs to GitHub Pages
Documentation URL in pyproject.toml
docs and all optional dependency extras

test_to_pandas_raises_without_pandas now uses monkeypatch on sys.modules["pandas"] for robustness when pandas extra is installed

75 edge case unit tests covering hooks, secrets, examples, raw_table, yaml, types, diff, fixtures, loaders, config, and manager
4 new E2E Behave integration features: fixtures_builders, secrets, typed_table_edge, dynamic_examples
27 E2E scenarios with 64 steps testing all behave-data features in real Behave

tags.py now strips @ prefix from Behave tags (Behave strips @ from scenario tags)
tags.py @needs_data now sets attribute on context in addition to _behave_data_loaded
tags.py cleanup functions now support both func(context) and func() signatures

Fixtures registry with scoping, nesting (ref:), and parametrization (@data_fixture)
Builders registry with derived fields, overrides, and count support (@data_builder)
Full DataManager — unified access to fixtures, builders, and secret resolution
Secret masking — values resolved via secret: are automatically masked with ***
Advanced secret backends: env, vault (HashiCorp Vault via hvac), aws (AWS Secrets Manager via boto3)
Declarative tags: @needs_data:name, @with_fixture:name, @cleanup_after
before_feature_hook — loads dynamic Examples before a feature runs
before_scenario_hook / after_scenario_hook — tag processing and cleanup
process_tags_before_scenario / process_tags_after_scenario — tag processing functions
Comprehensive README with full API reference, examples, and migration guide

DataManager is no longer a stub — full implementation with fixture(), build(), resolve(), mask()
resolve_placeholder now supports secret: prefix with configurable backends
setup_data now accepts Config | None (defaults to Config())

Core types: int, float, bool, str, date, datetime with register_type() and convert_cell()
Null resolution: configurable null markers, per-column overrides, is_null(), resolve_null()
TypedTableWrapper with typed_dicts() and typed_objects()
RawTable for headerless table access
Table diff with Cucumber-style output and TableDiffError
Config dataclass with from_file() for behave_data.yml
Behave patches: apply_patches() / revert_patches()
Data loaders: CSV, JSON, YAML, Excel, SQL, HTTP with lazy imports
Dynamic Examples loading via @load_examples:source tags
Secret placeholders: env:VAR, file:path, ref:fixture
setup_data() and before_step_hook() for Behave integration
DataManager stub (full implementation in 0.1.1)
Project scaffolding: CI/CD, community files, Makefile, pre-commit