Packaging: set static version; add CHANGELOG and CITATION

Author: Arturo R Montesinos

CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format loosely follows Keep a Changelog and uses semantic-ish versioning (major.minor.patch).
+
+## [0.1.0] - 2024-01-01
+Initial curated release.
+
+Highlights:
+- Pure-stdlib ODS parser (zipfile + xml.etree) with multi-sheet, multi-table extraction.
+- Dialect-aware SQL emission (sqlite, postgres/postgresql, mysql) including quoting & booleans.
+- Automatic per-column indexes (configurable / disable-able) plus composite index support.
+- PRIMARY KEY handling with redundant index suppression.
+- MySQL TEXT/BLOB index skipping with warnings.
+- Empty string → NULL normalization and numeric/boolean/date inference.
+- Identifier length limiting with deterministic hash suffix.
+- CLI batching of INSERT statements and optional single-transaction output.
+- Robust warnings for malformed instrumentation plus fail-fast on duplicate column names.
+- ADR-driven architecture documentation & AI curation policy.
+- Pre-commit quality gates (Ruff lint/format, fast tests, ADR index sync, print guard).
+- GitHub Actions CI matrix (3.9–3.12) for lint, type check, tests, build.
+
+### Packaging Note
+The dynamic version attribute configuration was replaced with a static `version = "0.1.0"` in `pyproject.toml` to resolve a CI build metadata resolution error. The module constant `__version__` remains for runtime visibility.
+
+---
+
+Future entries will document incremental improvements and bug fixes.

CITATION.cff

@@ -0,0 +1,24 @@
+cff-version: 1.2.0
+title: ods2sql-python
+message: >-
+  If you use ods2sql-python in academic work, please cite it using the metadata below.
+type: software
+authors:
+  - given-names: Arturo
+    family-names: Montesinos
+repository-code: https://github.com/your-org/ods2sql-python
+license: MIT
+version: 0.1.0
+date-released: 2024-01-01
+abstract: >-
+  Pure standard-library Python CLI that converts instrumented LibreOffice Calc .ods files into
+  SQL for SQLite, PostgreSQL, and MySQL, featuring automatic per-column indexing, optional
+  composite indexes, primary key handling, and dialect-aware quoting.
+keywords:
+  - ods
+  - libreoffice
+  - sql
+  - etl
+  - sqlite
+  - postgres
+  - mysql

pyproject.toml

@@ -23,7 +23,7 @@ classifiers = [
   "Topic :: Database",
   "Topic :: Utilities",
 ]
-dynamic = ["version"]
+version = "0.1.0"
 
 [project.scripts]
 ods2sql = "ods2sql:main"
@@ -32,9 +32,6 @@ ods2sql = "ods2sql:main"
 py-modules = ["ods2sql"]
 package-dir = {"" = "src"}
 
-[tool.setuptools.dynamic]
-version = { attr = "ods2sql:__version__" }
-
 [tool.ruff]
 line-length = 100
 target-version = "py39"