Derive LIBRARY_VERSION from package version

Use importlib.metadata.version with a fallback when the package is not
installed. Add Versioning and PyPI publishing instructions to
DEVELOPMENT.md

Author: daniel-crombie

DEVELOPMENT.md

@@ -128,3 +128,33 @@ For full Docker instructions, see [`.docker/README.md`](.docker/README.md).
 
 - Issues: https://github.com/ilovepdf/ilovepdf-python/issues
 - API Docs: https://developer.ilovepdf.com/docs
+
+## Versioning
+
+- The version is defined only in `pyproject.toml` → `[project].version`.
+
+Example: to bump from `1.0.1` to `1.0.2`, change in `pyproject.toml`:
+
+- `version = "1.0.1"` → `version = "1.0.2"`
+
+For a new release, just update the version in `pyproject.toml`.
+
+## Publishing to PyPI
+
+To publish a new version to PyPI:
+
+1. Update the version in `pyproject.toml`.
+2. Build the distributions:
+
+```bash
+pip install build twine
+python -m build
+```
+
+3. Upload to PyPI:
+
+```bash
+TWINE_USERNAME="__token__"
+TWINE_PASSWORD="<your PyPI token>"
+twine upload dist/*
+```

ilovepdf/ilovepdf_api.py

@@ -13,6 +13,7 @@
 from collections.abc import Callable
 from dataclasses import dataclass
 from datetime import datetime, timezone
+from importlib.metadata import version as pkg_version
 from typing import Any
 
 import jwt
@@ -41,7 +42,15 @@
 API_VERSION = "v1"
 START_SERVER_URL = os.getenv("START_SERVER_URL", "https://api.ilovepdf.com")
 API_HOST = os.getenv("API_HOST", "api.ilovepdf.com")
-LIBRARY_VERSION = "python.0.0.1"
+
+PACKAGE_NAME = "ilovepdf"
+
+try:
+    _package_version = pkg_version(PACKAGE_NAME)
+except Exception:
+    _package_version = "0.0.0"
+
+LIBRARY_VERSION = f"python.{_package_version}"
 
 # HTTP Status Codes
 HTTP_OK = 200