mock-pyspark 0.0.1.dev20260804__tar.gz

mock_pyspark-0.0.1.dev20260804/PKG-INFO

@@ -0,0 +1,142 @@
+Metadata-Version: 2.4
+Name: mock-pyspark
+Version: 0.0.1.dev20260804
+Summary: Drop-in mock for Apache PySpark 4.x — Arrow-backed, no JVM required
+Author-email: Peter Dowdy <peter.dowdy@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/PeterDowdy/mock-pyspark
+Project-URL: Repository, https://github.com/PeterDowdy/mock-pyspark
+Project-URL: Issues, https://github.com/PeterDowdy/mock-pyspark/issues
+Keywords: pyspark,mock,testing,arrow,duckdb
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Testing
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: pyarrow>=14
+Requires-Dist: duckdb>=1.0
+Requires-Dist: pandas>=2.0
+Requires-Dist: numpy>=1.24
+Provides-Extra: avro
+Requires-Dist: fastavro>=1.9; extra == "avro"
+Provides-Extra: delta
+Requires-Dist: deltalake>=1.0; extra == "delta"
+Provides-Extra: all
+Requires-Dist: mock-pyspark[avro,delta]; extra == "all"
+
+# mockpyspark
+
+A drop-in mock for Apache PySpark 4.x for unit and integration testing. Runs entirely in Python — no JVM, no Hadoop, no cluster — using PyArrow as the compute engine and DuckDB for SQL.
+
+```bash
+pip install mock-pyspark
+```
+
+`mockpyspark` (the PyPI distribution is `mock-pyspark`; you still `import mockpyspark`) installs alongside real `pyspark`; there is no namespace collision. Tests opt in via a one-liner so that `from pyspark.sql import ...` in your production code transparently resolves to the mock.
+
+---
+
+## Quick start
+
+```python
+# conftest.py
+import mockpyspark
+mockpyspark.activate()
+```
+
+```python
+# tests/test_my_pipeline.py
+from pyspark.sql import SparkSession, functions as F
+
+def test_normalize(spark=None):
+    spark = SparkSession.builder.getOrCreate()
+    df = spark.createDataFrame([
+        {"id": 1, "name": "  alice ", "score": 10},
+        {"id": 2, "name": "BOB",      "score": 20},
+    ])
+    out = (
+        df.withColumn("name", F.initcap(F.trim(F.col("name"))))
+          .filter(F.col("score") > 15)
+          .select("id", "name", "score")
+          .collect()
+    )
+    assert out == [(2, "Bob", 20)]
+```
+
+No changes to your Spark logic. The alias just makes `pyspark.*` imports resolve to `mockpyspark.*` for the test process.
+
+---
+
+## Version targeting
+
+`mockpyspark` supports both PySpark 4.0.x and 4.1.x. APIs that only exist in 4.1 (e.g. `current_time`, `TimeType`) raise `AttributeError` when running in 4.0 mode.
+
+It picks a target version automatically, in order:
+
+1. `PYSPARK_VERSION` env var
+2. The `pyspark` pin in `pyproject.toml`, `requirements*.txt`, `poetry.lock`, `uv.lock`, `Pipfile.lock`, or `setup.cfg` (walking up from the working directory)
+3. `SparkSession.builder.config("spark.mock.targetVersion", "4.0").getOrCreate()` — per-session override
+4. If nothing is found, defaults to the latest supported version and emits a `UserWarning`. Set `MOCKPYSPARK_STRICT_VERSION=1` to raise instead.
+
+So if your project pins `pyspark==4.0.1` in `pyproject.toml`, the mock will refuse 4.1-only APIs without any configuration on your part.
+
+---
+
+## Usage modes
+
+| Mode                         | What to do                                                       |
+| ---------------------------- | ---------------------------------------------------------------- |
+| **Mock for tests (default)** | `mockpyspark.activate()` in conftest.                            |
+| **Pytest plugin**            | `pytest_plugins = ["mockpyspark.pytest_plugin"]` in conftest.    |
+| **Real PySpark for a run**   | Pass `--no-mock-pyspark` to pytest, or don't call `activate()`.  |
+
+The pytest plugin also accepts `--no-mock-pyspark` to bypass activation for a single invocation, useful for running the same suite against real PySpark for integration coverage.
+
+See **[docs/usage.md](docs/usage.md)** for the full pattern, including switching between mock and real PySpark in the same suite, and known limitations.
+
+---
+
+## Detecting the mock at runtime
+
+```python
+import pyspark
+if getattr(pyspark, "__mock__", False):
+    print("running against mockpyspark")
+```
+
+---
+
+## Contributing
+
+**Run unit tests** (no Java, no Docker):
+
+```bash
+git clone https://github.com/PeterDowdy/mock-pyspark.git && cd mock-pyspark
+pip install pyarrow duckdb pandas numpy pytest
+PYTHONPATH=. pytest -q -m unit
+```
+
+**Run integration tests** against real PySpark (requires Java 17):
+
+```bash
+# Via Docker (easiest)
+./start.sh 4.1 --integration-test
+
+# Or locally with a PySpark venv
+python -m venv /opt/spark-venv && /opt/spark-venv/bin/pip install pyspark==4.1.0
+PYTHONPATH=. PYSPARK_VERSION=4.1 PYSPARK_PYTHON=/opt/spark-venv/bin/python pytest -q -m integration
+```
+
+See **[docs/contributing.md](docs/contributing.md)** for the full setup guide.
+
+---
+
+## API coverage
+
+Supports PySpark 4.0.x and 4.1.x — 439+ functions, full DataFrame/Column/Window/Catalog API, CSV/JSON/Parquet IO.
+
+- [STATUS-4.1.md](STATUS-4.1.md) — PySpark 4.1 coverage
+- [STATUS-4.0.md](STATUS-4.0.md) — PySpark 4.0 coverage

mock_pyspark-0.0.1.dev20260804/README.md

@@ -0,0 +1,113 @@
+# mockpyspark
+
+A drop-in mock for Apache PySpark 4.x for unit and integration testing. Runs entirely in Python — no JVM, no Hadoop, no cluster — using PyArrow as the compute engine and DuckDB for SQL.
+
+```bash
+pip install mock-pyspark
+```
+
+`mockpyspark` (the PyPI distribution is `mock-pyspark`; you still `import mockpyspark`) installs alongside real `pyspark`; there is no namespace collision. Tests opt in via a one-liner so that `from pyspark.sql import ...` in your production code transparently resolves to the mock.
+
+---
+
+## Quick start
+
+```python
+# conftest.py
+import mockpyspark
+mockpyspark.activate()
+```
+
+```python
+# tests/test_my_pipeline.py
+from pyspark.sql import SparkSession, functions as F
+
+def test_normalize(spark=None):
+    spark = SparkSession.builder.getOrCreate()
+    df = spark.createDataFrame([
+        {"id": 1, "name": "  alice ", "score": 10},
+        {"id": 2, "name": "BOB",      "score": 20},
+    ])
+    out = (
+        df.withColumn("name", F.initcap(F.trim(F.col("name"))))
+          .filter(F.col("score") > 15)
+          .select("id", "name", "score")
+          .collect()
+    )
+    assert out == [(2, "Bob", 20)]
+```
+
+No changes to your Spark logic. The alias just makes `pyspark.*` imports resolve to `mockpyspark.*` for the test process.
+
+---
+
+## Version targeting
+
+`mockpyspark` supports both PySpark 4.0.x and 4.1.x. APIs that only exist in 4.1 (e.g. `current_time`, `TimeType`) raise `AttributeError` when running in 4.0 mode.
+
+It picks a target version automatically, in order:
+
+1. `PYSPARK_VERSION` env var
+2. The `pyspark` pin in `pyproject.toml`, `requirements*.txt`, `poetry.lock`, `uv.lock`, `Pipfile.lock`, or `setup.cfg` (walking up from the working directory)
+3. `SparkSession.builder.config("spark.mock.targetVersion", "4.0").getOrCreate()` — per-session override
+4. If nothing is found, defaults to the latest supported version and emits a `UserWarning`. Set `MOCKPYSPARK_STRICT_VERSION=1` to raise instead.
+
+So if your project pins `pyspark==4.0.1` in `pyproject.toml`, the mock will refuse 4.1-only APIs without any configuration on your part.
+
+---
+
+## Usage modes
+
+| Mode                         | What to do                                                       |
+| ---------------------------- | ---------------------------------------------------------------- |
+| **Mock for tests (default)** | `mockpyspark.activate()` in conftest.                            |
+| **Pytest plugin**            | `pytest_plugins = ["mockpyspark.pytest_plugin"]` in conftest.    |
+| **Real PySpark for a run**   | Pass `--no-mock-pyspark` to pytest, or don't call `activate()`.  |
+
+The pytest plugin also accepts `--no-mock-pyspark` to bypass activation for a single invocation, useful for running the same suite against real PySpark for integration coverage.
+
+See **[docs/usage.md](docs/usage.md)** for the full pattern, including switching between mock and real PySpark in the same suite, and known limitations.
+
+---
+
+## Detecting the mock at runtime
+
+```python
+import pyspark
+if getattr(pyspark, "__mock__", False):
+    print("running against mockpyspark")
+```
+
+---
+
+## Contributing
+
+**Run unit tests** (no Java, no Docker):
+
+```bash
+git clone https://github.com/PeterDowdy/mock-pyspark.git && cd mock-pyspark
+pip install pyarrow duckdb pandas numpy pytest
+PYTHONPATH=. pytest -q -m unit
+```
+
+**Run integration tests** against real PySpark (requires Java 17):
+
+```bash
+# Via Docker (easiest)
+./start.sh 4.1 --integration-test
+
+# Or locally with a PySpark venv
+python -m venv /opt/spark-venv && /opt/spark-venv/bin/pip install pyspark==4.1.0
+PYTHONPATH=. PYSPARK_VERSION=4.1 PYSPARK_PYTHON=/opt/spark-venv/bin/python pytest -q -m integration
+```
+
+See **[docs/contributing.md](docs/contributing.md)** for the full setup guide.
+
+---
+
+## API coverage
+
+Supports PySpark 4.0.x and 4.1.x — 439+ functions, full DataFrame/Column/Window/Catalog API, CSV/JSON/Parquet IO.
+
+- [STATUS-4.1.md](STATUS-4.1.md) — PySpark 4.1 coverage
+- [STATUS-4.0.md](STATUS-4.0.md) — PySpark 4.0 coverage

mock_pyspark-0.0.1.dev20260804/mock_pyspark.egg-info/PKG-INFO

@@ -0,0 +1,142 @@
+Metadata-Version: 2.4
+Name: mock-pyspark
+Version: 0.0.1.dev20260804
+Summary: Drop-in mock for Apache PySpark 4.x — Arrow-backed, no JVM required
+Author-email: Peter Dowdy <peter.dowdy@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/PeterDowdy/mock-pyspark
+Project-URL: Repository, https://github.com/PeterDowdy/mock-pyspark
+Project-URL: Issues, https://github.com/PeterDowdy/mock-pyspark/issues
+Keywords: pyspark,mock,testing,arrow,duckdb
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Testing
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: pyarrow>=14
+Requires-Dist: duckdb>=1.0
+Requires-Dist: pandas>=2.0
+Requires-Dist: numpy>=1.24
+Provides-Extra: avro
+Requires-Dist: fastavro>=1.9; extra == "avro"
+Provides-Extra: delta
+Requires-Dist: deltalake>=1.0; extra == "delta"
+Provides-Extra: all
+Requires-Dist: mock-pyspark[avro,delta]; extra == "all"
+
+# mockpyspark
+
+A drop-in mock for Apache PySpark 4.x for unit and integration testing. Runs entirely in Python — no JVM, no Hadoop, no cluster — using PyArrow as the compute engine and DuckDB for SQL.
+
+```bash
+pip install mock-pyspark
+```
+
+`mockpyspark` (the PyPI distribution is `mock-pyspark`; you still `import mockpyspark`) installs alongside real `pyspark`; there is no namespace collision. Tests opt in via a one-liner so that `from pyspark.sql import ...` in your production code transparently resolves to the mock.
+
+---
+
+## Quick start
+
+```python
+# conftest.py
+import mockpyspark
+mockpyspark.activate()
+```
+
+```python
+# tests/test_my_pipeline.py
+from pyspark.sql import SparkSession, functions as F
+
+def test_normalize(spark=None):
+    spark = SparkSession.builder.getOrCreate()
+    df = spark.createDataFrame([
+        {"id": 1, "name": "  alice ", "score": 10},
+        {"id": 2, "name": "BOB",      "score": 20},
+    ])
+    out = (
+        df.withColumn("name", F.initcap(F.trim(F.col("name"))))
+          .filter(F.col("score") > 15)
+          .select("id", "name", "score")
+          .collect()
+    )
+    assert out == [(2, "Bob", 20)]
+```
+
+No changes to your Spark logic. The alias just makes `pyspark.*` imports resolve to `mockpyspark.*` for the test process.
+
+---
+
+## Version targeting
+
+`mockpyspark` supports both PySpark 4.0.x and 4.1.x. APIs that only exist in 4.1 (e.g. `current_time`, `TimeType`) raise `AttributeError` when running in 4.0 mode.
+
+It picks a target version automatically, in order:
+
+1. `PYSPARK_VERSION` env var
+2. The `pyspark` pin in `pyproject.toml`, `requirements*.txt`, `poetry.lock`, `uv.lock`, `Pipfile.lock`, or `setup.cfg` (walking up from the working directory)
+3. `SparkSession.builder.config("spark.mock.targetVersion", "4.0").getOrCreate()` — per-session override
+4. If nothing is found, defaults to the latest supported version and emits a `UserWarning`. Set `MOCKPYSPARK_STRICT_VERSION=1` to raise instead.
+
+So if your project pins `pyspark==4.0.1` in `pyproject.toml`, the mock will refuse 4.1-only APIs without any configuration on your part.
+
+---
+
+## Usage modes
+
+| Mode                         | What to do                                                       |
+| ---------------------------- | ---------------------------------------------------------------- |
+| **Mock for tests (default)** | `mockpyspark.activate()` in conftest.                            |
+| **Pytest plugin**            | `pytest_plugins = ["mockpyspark.pytest_plugin"]` in conftest.    |
+| **Real PySpark for a run**   | Pass `--no-mock-pyspark` to pytest, or don't call `activate()`.  |
+
+The pytest plugin also accepts `--no-mock-pyspark` to bypass activation for a single invocation, useful for running the same suite against real PySpark for integration coverage.
+
+See **[docs/usage.md](docs/usage.md)** for the full pattern, including switching between mock and real PySpark in the same suite, and known limitations.
+
+---
+
+## Detecting the mock at runtime
+
+```python
+import pyspark
+if getattr(pyspark, "__mock__", False):
+    print("running against mockpyspark")
+```
+
+---
+
+## Contributing
+
+**Run unit tests** (no Java, no Docker):
+
+```bash
+git clone https://github.com/PeterDowdy/mock-pyspark.git && cd mock-pyspark
+pip install pyarrow duckdb pandas numpy pytest
+PYTHONPATH=. pytest -q -m unit
+```
+
+**Run integration tests** against real PySpark (requires Java 17):
+
+```bash
+# Via Docker (easiest)
+./start.sh 4.1 --integration-test
+
+# Or locally with a PySpark venv
+python -m venv /opt/spark-venv && /opt/spark-venv/bin/pip install pyspark==4.1.0
+PYTHONPATH=. PYSPARK_VERSION=4.1 PYSPARK_PYTHON=/opt/spark-venv/bin/python pytest -q -m integration
+```
+
+See **[docs/contributing.md](docs/contributing.md)** for the full setup guide.
+
+---
+
+## API coverage
+
+Supports PySpark 4.0.x and 4.1.x — 439+ functions, full DataFrame/Column/Window/Catalog API, CSV/JSON/Parquet IO.
+
+- [STATUS-4.1.md](STATUS-4.1.md) — PySpark 4.1 coverage
+- [STATUS-4.0.md](STATUS-4.0.md) — PySpark 4.0 coverage

mock_pyspark-0.0.1.dev20260804/mock_pyspark.egg-info/SOURCES.txt

@@ -0,0 +1,143 @@
+README.md
+pyproject.toml
+./mockpyspark/__init__.py
+./mockpyspark/_aliasing.py
+./mockpyspark/pytest_plugin.py
+./mockpyspark/rdd.py
+./mockpyspark/_internal/__init__.py
+./mockpyspark/_internal/config.py
+./mockpyspark/_internal/engine.py
+./mockpyspark/_internal/version_detect.py
+./mockpyspark/_internal/version_guard.py
+./mockpyspark/delta/__init__.py
+./mockpyspark/delta/pip.py
+./mockpyspark/delta/pip_utils.py
+./mockpyspark/delta/tables.py
+./mockpyspark/errors/__init__.py
+./mockpyspark/ml/__init__.py
+./mockpyspark/pandas/__init__.py
+./mockpyspark/sql/__init__.py
+./mockpyspark/sql/_map_utils.py
+./mockpyspark/sql/catalog.py
+./mockpyspark/sql/column.py
+./mockpyspark/sql/dataframe.py
+./mockpyspark/sql/functions.py
+./mockpyspark/sql/functions_all.py
+./mockpyspark/sql/readwriter.py
+./mockpyspark/sql/row.py
+./mockpyspark/sql/session.py
+./mockpyspark/sql/sql_dispatcher.py
+./mockpyspark/sql/types.py
+./mockpyspark/sql/utils.py
+./mockpyspark/sql/window.py
+./mockpyspark/sql/functions/__init__.py
+./mockpyspark/sql/functions/aggregates.py
+./mockpyspark/sql/functions/arrays.py
+./mockpyspark/sql/functions/bits.py
+./mockpyspark/sql/functions/core.py
+./mockpyspark/sql/functions/crypto.py
+./mockpyspark/sql/functions/csvs.py
+./mockpyspark/sql/functions/dates.py
+./mockpyspark/sql/functions/generators.py
+./mockpyspark/sql/functions/geospatial.py
+./mockpyspark/sql/functions/hashes.py
+./mockpyspark/sql/functions/jsons.py
+./mockpyspark/sql/functions/maps.py
+./mockpyspark/sql/functions/maths.py
+./mockpyspark/sql/functions/partitioning.py
+./mockpyspark/sql/functions/predicates.py
+./mockpyspark/sql/functions/strings.py
+./mockpyspark/sql/functions/udfs.py
+./mockpyspark/sql/functions/urls.py
+./mockpyspark/sql/functions/variants.py
+./mockpyspark/sql/functions/windows.py
+./mockpyspark/sql/functions/xmls.py
+./mockpyspark/sql/io/__init__.py
+./mockpyspark/sql/io/_arrow_types.py
+./mockpyspark/sql/io/avro.py
+./mockpyspark/sql/io/base.py
+./mockpyspark/sql/io/binary_file.py
+./mockpyspark/sql/io/csv.py
+./mockpyspark/sql/io/delta.py
+./mockpyspark/sql/io/json.py
+./mockpyspark/sql/io/orc.py
+./mockpyspark/sql/io/parquet.py
+./mockpyspark/sql/io/text.py
+./mockpyspark/sql/streaming/__init__.py
+./mockpyspark/sql/streaming/readwriter.py
+./mockpyspark/streaming/__init__.py
+./mockpyspark/testing/__init__.py
+./mockpyspark/testing/utils.py
+mock_pyspark.egg-info/PKG-INFO
+mock_pyspark.egg-info/SOURCES.txt
+mock_pyspark.egg-info/dependency_links.txt
+mock_pyspark.egg-info/requires.txt
+mock_pyspark.egg-info/top_level.txt
+mockpyspark/__init__.py
+mockpyspark/_aliasing.py
+mockpyspark/pytest_plugin.py
+mockpyspark/rdd.py
+mockpyspark/_internal/__init__.py
+mockpyspark/_internal/config.py
+mockpyspark/_internal/engine.py
+mockpyspark/_internal/version_detect.py
+mockpyspark/_internal/version_guard.py
+mockpyspark/delta/__init__.py
+mockpyspark/delta/pip.py
+mockpyspark/delta/pip_utils.py
+mockpyspark/delta/tables.py
+mockpyspark/errors/__init__.py
+mockpyspark/ml/__init__.py
+mockpyspark/pandas/__init__.py
+mockpyspark/sql/__init__.py
+mockpyspark/sql/_map_utils.py
+mockpyspark/sql/catalog.py
+mockpyspark/sql/column.py
+mockpyspark/sql/dataframe.py
+mockpyspark/sql/functions.py
+mockpyspark/sql/functions_all.py
+mockpyspark/sql/readwriter.py
+mockpyspark/sql/row.py
+mockpyspark/sql/session.py
+mockpyspark/sql/sql_dispatcher.py
+mockpyspark/sql/types.py
+mockpyspark/sql/utils.py
+mockpyspark/sql/window.py
+mockpyspark/sql/functions/__init__.py
+mockpyspark/sql/functions/aggregates.py
+mockpyspark/sql/functions/arrays.py
+mockpyspark/sql/functions/bits.py
+mockpyspark/sql/functions/core.py
+mockpyspark/sql/functions/crypto.py
+mockpyspark/sql/functions/csvs.py
+mockpyspark/sql/functions/dates.py
+mockpyspark/sql/functions/generators.py
+mockpyspark/sql/functions/geospatial.py
+mockpyspark/sql/functions/hashes.py
+mockpyspark/sql/functions/jsons.py
+mockpyspark/sql/functions/maps.py
+mockpyspark/sql/functions/maths.py
+mockpyspark/sql/functions/partitioning.py
+mockpyspark/sql/functions/predicates.py
+mockpyspark/sql/functions/strings.py
+mockpyspark/sql/functions/udfs.py
+mockpyspark/sql/functions/urls.py
+mockpyspark/sql/functions/variants.py
+mockpyspark/sql/functions/windows.py
+mockpyspark/sql/functions/xmls.py
+mockpyspark/sql/io/__init__.py
+mockpyspark/sql/io/_arrow_types.py
+mockpyspark/sql/io/avro.py
+mockpyspark/sql/io/base.py
+mockpyspark/sql/io/binary_file.py
+mockpyspark/sql/io/csv.py
+mockpyspark/sql/io/delta.py
+mockpyspark/sql/io/json.py
+mockpyspark/sql/io/orc.py
+mockpyspark/sql/io/parquet.py
+mockpyspark/sql/io/text.py
+mockpyspark/sql/streaming/__init__.py
+mockpyspark/sql/streaming/readwriter.py
+mockpyspark/streaming/__init__.py
+mockpyspark/testing/__init__.py
+mockpyspark/testing/utils.py

mock_pyspark-0.0.1.dev20260804/mock_pyspark.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

mock_pyspark-0.0.1.dev20260804/mock_pyspark.egg-info/requires.txt

@@ -0,0 +1,13 @@
+pyarrow>=14
+duckdb>=1.0
+pandas>=2.0
+numpy>=1.24
+
+[all]
+mock-pyspark[avro,delta]
+
+[avro]
+fastavro>=1.9
+
+[delta]
+deltalake>=1.0

mock_pyspark-0.0.1.dev20260804/mock_pyspark.egg-info/top_level.txt

@@ -0,0 +1 @@
+mockpyspark

mock_pyspark-0.0.1.dev20260804/mockpyspark/__init__.py

@@ -0,0 +1,33 @@
+"""mockpyspark — drop-in mock for Apache PySpark 4.x for testing.
+
+Activate the import alias so production code's `from pyspark.sql import ...`
+resolves to the mock without uninstalling real PySpark::
+
+    import mockpyspark
+    mockpyspark.activate()
+
+Or, in pytest, load the bundled plugin::
+
+    # conftest.py
+    pytest_plugins = ["mockpyspark.pytest_plugin"]
+"""
+from __future__ import annotations
+
+from ._aliasing import activate, deactivate, is_active
+from .rdd import RDD
+from .sql.session import SparkSession
+
+__all__ = ["SparkSession", "RDD", "activate", "deactivate", "is_active"]
+
+# Sentinel: lets user code detect at runtime that the loaded `pyspark` is the
+# mock without depending on file paths or install layout.
+__mock__ = True
+
+
+def __getattr__(name: str):
+    # Lazy so `pyspark.__version__` always reflects the current target version,
+    # even after it changes via env var or SparkSession builder config.
+    if name == "__version__":
+        from ._internal.config import CONFIG
+        return CONFIG.target_version
+    raise AttributeError(f"module 'mockpyspark' has no attribute {name!r}")