feat: add citation helper and update README for scholarly use

Author: tae898

README.md

@@ -8,6 +8,7 @@ Native Python bindings for ArcadeDB (forked from the official Java project).
 [![Test Python Bindings](https://github.com/humemai/arcadedb-embedded-python/actions/workflows/test-python-bindings.yml/badge.svg)](https://github.com/humemai/arcadedb-embedded-python/actions/workflows/test-python-bindings.yml)
 [![Test Python Examples](https://github.com/humemai/arcadedb-embedded-python/actions/workflows/test-python-examples.yml/badge.svg)](https://github.com/humemai/arcadedb-embedded-python/actions/workflows/test-python-examples.yml)
 [![Release to PyPI](https://github.com/humemai/arcadedb-embedded-python/actions/workflows/release-python-packages.yml/badge.svg)](https://github.com/humemai/arcadedb-embedded-python/actions/workflows/release-python-packages.yml)
+[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.18399208.svg)](https://doi.org/10.5281/zenodo.18399208)
 
 ---
 
@@ -75,6 +76,20 @@ This repo is a fork of ArcadeDB Java. For the server, Java API, and core databas
 - Issues (Python bindings): https://github.com/humemai/arcadedb-embedded-python/issues
 - ArcadeDB Discord: https://discord.gg/w2Npx2B7hZ
 
+## 🧾 Citing
+
+If you use this project in scholarly work, please cite the version you used via Zenodo:
+
+[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.18399208.svg)](https://doi.org/10.5281/zenodo.18399208)
+
+You can also get a version-specific DOI URL from the installed package:
+
+```python
+import arcadedb_embedded as arcadedb
+
+arcadedb.cite()
+```
+
 ## 📄 License
 
 Both upstream ArcadeDB (Java) and this ArcadeDB Embedded Python project are licensed under Apache 2.0, fully open and free for everyone, including commercial use.

bindings/python/src/arcadedb_embedded/__init__.py

@@ -14,6 +14,9 @@
 # Import batch processing
 from .batch import BatchContext
 
+# Import citation helper
+from .citation import cite
+
 # Import core database classes
 from .core import (
     Database,

bindings/python/src/arcadedb_embedded/citation.py

@@ -0,0 +1,52 @@
+"""Citation helpers for ArcadeDB Embedded Python."""
+
+from __future__ import annotations
+
+from typing import Optional
+
+from ._version import __version__
+from .exceptions import ArcadeDBError
+
+# Map released package versions to Zenodo version-specific DOIs.
+# Update this mapping on each release.
+_VERSION_DOI_MAP = {
+    "26.1.1.post3": "10.5281/zenodo.18399749",
+}
+
+
+def cite(version: Optional[str] = None) -> str:
+    """Return the DOI URL for a given ArcadeDB Embedded Python version.
+
+    Parameters
+    ----------
+    version : str or None
+        The version to cite. If None, the current installed version is used.
+
+    Returns
+    -------
+    doi_url : str
+        The DOI URL for the given version.
+
+    Raises
+    ------
+    ArcadeDBError
+        If the requested version is not found in the citation index.
+
+    Examples
+    --------
+    >>> import arcadedb_embedded as arcadedb
+    >>> arcadedb.cite("26.1.1.post3")
+    "https://doi.org/10.5281/zenodo.18399749"
+    """
+
+    if version is None:
+        version = __version__
+
+    if version not in _VERSION_DOI_MAP:
+        if "dev" in version:
+            raise ArcadeDBError(
+                f"Version {version} is not yet released and therefore does not yet have a citable DOI."
+            )
+        raise ArcadeDBError(f"Version {version} not found in the citation index")
+
+    return f"https://doi.org/{_VERSION_DOI_MAP[version]}"