Add __version__ and CLI docs

Author: DiogoRibeiro7

README.md

@@ -55,6 +55,15 @@ generate(model="thmm", n=100, qmat=[[0, 0.2, 0], [0.1, 0, 0.1], [0, 0.3, 0]],
          p0=[1.0, 0.0, 0.0], model_cens="exponential", cens_par=3.0)
 ```
 
+## ⌨️ Command-Line Usage
+
+Install the package and use ``python -m gen_surv`` to generate datasets without
+writing Python code:
+
+```bash
+python -m gen_surv dataset aft_ln --n 100 > data.csv
+```
+
 ## 🔧 Available Generators
 
 | Function     | Description                                |

TODO.md

@@ -18,8 +18,8 @@ This document outlines future enhancements, features, and ideas for improving th
 ## 📦 1. Interface and UX
 
 - [✅] Create a `generate(..., return_type="df" | "dict")` interface
-- [ ] Add `__version__` using `importlib.metadata` or `poetry-dynamic-versioning`
-- [ ] Build a CLI with `typer` or `click`
+- [✅] Add `__version__` using `importlib.metadata` or `poetry-dynamic-versioning`
+- [✅] Build a CLI with `typer` or `click`
 - [✅] Add example notebooks or scripts for each model (`examples/` folder)
 
 ---
@@ -36,7 +36,7 @@ This document outlines future enhancements, features, and ideas for improving th
 ## 🧪 3. Testing and Quality
 
 - [✅] Add tests for each model (e.g., `test_tdcm.py`, `test_thmm.py`, `test_aft.py`)
-- [ ] Add property-based tests with `hypothesis`
+- [✅] Add property-based tests with `hypothesis`
 - [ ] Cover edge cases (e.g., invalid parameters, n=0, negative censoring)
 - [ ] Run tests on multiple Python versions (CI matrix)
 

docs/source/index.md

@@ -49,6 +49,14 @@ generate(model="thmm", n=100, qmat=[[0, 0.2, 0], [0.1, 0, 0.1], [0, 0.3, 0]],
          p0=[1.0, 0.0, 0.0], model_cens="exponential", cens_par=3.0)
 ```
 
+## ⌨️ Command-Line Usage
+
+Generate datasets directly from the terminal:
+
+```bash
+python -m gen_surv dataset aft_ln --n 100 > data.csv
+```
+
 ## 🔗 Project Links
 
 - [Source Code](https://github.com/DiogoRibeiro7/genSurvPy)

gen_surv/__init__.py

@@ -1 +1,17 @@
-from .interface import generate
+"""Top-level package for ``gen_surv``.
+
+This module exposes the :func:`generate` function and provides access to the
+package version via ``__version__``.
+"""
+
+from importlib.metadata import PackageNotFoundError, version
+
+from .interface import generate
+
+try:
+    __version__ = version("gen_surv")
+except PackageNotFoundError:  # pragma: no cover - fallback when package not installed
+    __version__ = "0.0.0"
+
+__all__ = ["generate", "__version__"]
+