pytest_pg 0.0.28__tar.gz

pytest_pg-0.0.28/.github/CODEOWNERS

@@ -0,0 +1 @@
+*    @anna-money/backend

pytest_pg-0.0.28/.github/dependabot.yml

@@ -0,0 +1,8 @@
+version: 2
+updates:
+- package-ecosystem: pip
+  directory: "/"
+  schedule:
+    interval: weekly
+    time: "00:00"
+  open-pull-requests-limit: 10

pytest_pg-0.0.28/.github/workflows/ci.yml

@@ -0,0 +1,51 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - master
+    tags: ['v*']
+  pull_request:
+    branches:
+      - master
+
+
+jobs:
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+
+    strategy:
+      fail-fast: false
+      matrix:
+        python: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+        pytest: ["pytest>=8.0,<8.1", "pytest>=8.1,<8.2", "pytest>=8.2,<8.3", "pytest>=8.3,<8.4", "pytest>=9.0,<9.1"]
+
+    env:
+      UV_EXTRA_ARGS: --with "${{ matrix.pytest }}"
+
+    steps:
+    - uses: actions/checkout@v6
+      with:
+        fetch-depth: 0
+    - uses: astral-sh/setup-uv@v7
+    - run: echo ${{ matrix.python }} > .python-version
+    - run: make deps
+    - run: make lint MODE=ci
+    - run: make test
+
+  deploy:
+    name: Deploy
+    runs-on: ubuntu-latest
+    needs: test
+    if: github.event_name == 'push' && contains(github.ref, 'refs/tags/')
+    steps:
+    - uses: actions/checkout@v6
+      with:
+        fetch-depth: 0
+    - uses: astral-sh/setup-uv@v7
+    - run: uv build
+    - env:
+        UV_PUBLISH_TOKEN: ${{ secrets.PYPI_TOKEN }}
+      run: uv publish

pytest_pg-0.0.28/.gitignore

@@ -0,0 +1,128 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+.idea/

pytest_pg-0.0.28/.python-version

@@ -0,0 +1 @@
+3.10

pytest_pg-0.0.28/CHANGELOG.md

@@ -0,0 +1,103 @@
+## v0.0.28 (2026-05-06)
+
+* [Reduce PostgreSQL container startup time](https://github.com/anna-money/pytest-pg/pull/230)
+
+
+## v0.0.27 (2026-05-01)
+
+* [Resolve DOCKER_HOST from docker context](https://github.com/anna-money/pytest-pg/pull/228)
+
+
+## v0.0.26 (2026-02-23)
+
+* [Time calculation fix](https://github.com/anna-money/pytest-pg/pull/225)
+* [Add `pg_18` fixture](https://github.com/anna-money/pytest-pg/pull/226)
+* [Updated README, dropped python 3.9 support, added python 3.14 support](https://github.com/anna-money/pytest-pg/pull/227)
+
+## v0.0.25 (2025-05-18)
+
+* Add `pg_17` fixture
+
+
+## v0.0.24 (2025-05-11)
+
+* [Downgrade pytest](https://github.com/anna-money/pytest-pg/pull/224)
+
+
+## v0.0.23 (2025-04-11)
+
+* [Do not pull if we have an image locally](https://github.com/anna-money/pytest-pg/pull/223)
+
+
+## v0.0.22 (2025-04-03)
+
+* Override docker host with env variable
+
+
+## v0.0.17 (2024-04-03)
+
+* Override docker host with env variable
+
+
+## v0.0.15 (2023-05-04)
+
+* Pin version of `urllib3` ([see for more details](https://github.com/docker/docker-py/issues/3113))
+* Add `pg_15` fixture
+
+
+## v0.0.14 (2022-09-19)
+
+* Disable jit by default
+* Set bgwriter_lru_maxpages
+
+
+## v0.0.12 (2022-01-18)
+
+* Ditch logging because it seems to be useless
+
+
+## v0.0.11 (2022-01-09)
+
+* Move volume to tmpfs
+
+
+## v0.0.10 (2022-01-08)
+
+* Volumes used to remain after running test consuming disk space
+
+
+## v0.0.9 (2021-12-28)
+
+* Disable fsync, full_page_writes, synchronous_commit to speedup the tests
+
+
+## v0.0.8 (2021-12-26)
+
+* Add typing marker, mypy. Run tests in CI
+
+
+## v0.0.7 (2021-12-25)
+
+* Fix is_ready based on psycopg2
+
+
+## v0.0.6 (2021-12-25)
+
+* Add all recent major versions of PG
+
+
+## v0.0.4 (2021-12-10)
+
+* Fix is_postgres_ready usage
+
+## v0.0.3 (2021-12-10)
+
+* Fix uuid generation
+
+## v0.0.2 (2021-12-10)
+
+* Follow pytest guide for plugins
+
+## v0.0.1 (2021-12-10)
+
+* A first version

pytest_pg-0.0.28/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Yury Pliner
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pytest_pg-0.0.28/Makefile

@@ -0,0 +1,28 @@
+.PHONY: all uv deps lint test
+
+all: deps lint test
+
+UV_EXTRA_ARGS ?=
+
+uv:
+	@which uv >/dev/null 2>&1 || { \
+		echo "uv is not installed"; \
+		exit 1;\
+	}
+
+deps: uv
+	@uv sync --all-extras
+
+lint: deps
+ifeq ($(MODE), ci)
+	@uv run $(UV_EXTRA_ARGS) ruff format pytest_pg tests --check
+	@uv run $(UV_EXTRA_ARGS) ruff check pytest_pg tests
+	@uv run $(UV_EXTRA_ARGS) pyright
+else
+	@uv run $(UV_EXTRA_ARGS) ruff format pytest_pg tests
+	@uv run $(UV_EXTRA_ARGS) ruff check pytest_pg tests --fix
+	@uv run $(UV_EXTRA_ARGS) pyright
+endif
+
+test: deps
+	@uv run $(UV_EXTRA_ARGS) pytest -vv --rootdir tests .

pytest_pg-0.0.28/PKG-INFO

@@ -0,0 +1,116 @@
+Metadata-Version: 2.4
+Name: pytest_pg
+Version: 0.0.28
+Summary: A tiny plugin for pytest which runs PostgreSQL in Docker
+Project-URL: Homepage, https://github.com/anna-money/pytest-pg
+Author-email: Yury Pliner <yury.pliner@gmail.com>
+License: MIT
+License-File: LICENSE
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Framework :: Pytest
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.10
+Requires-Dist: docker>=7.0.0
+Requires-Dist: pytest>=8.0
+Provides-Extra: dev
+Requires-Dist: pyright==1.1.407; extra == 'dev'
+Requires-Dist: pytest==9.0.2; extra == 'dev'
+Requires-Dist: ruff==0.14.10; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# pytest-pg
+
+A pytest plugin that provides session-scoped fixtures for running PostgreSQL inside Docker containers.
+It automatically spins up a container, waits for PostgreSQL to become ready, exposes connection details
+(`host`, `port`, `user`, `password`, `database`) via a `PG` dataclass, and tears the container down after
+the test session. Pre-built fixtures are available for PostgreSQL versions 11 through 18 as well as `latest`.
+
+Readiness checks work with any of the common drivers — asyncpg, psycopg2, or psycopg3.
+
+To speed up tests, pytest-pg does the following tweaks:
+
+1. fsync=off
+2. full_page_writes=off
+3. synchronous_commit=off
+4. jit=off
+5. bgwriter_lru_maxpages=0
+6. data directory is mounted to a tmpfs 
+
+
+# How to use?
+
+You can use the following fixtures:
+
+* `pg` – the latest PostgreSQL image available
+* `pg_11` – PostgreSQL 11
+* `pg_12` – PostgreSQL 12
+* `pg_13` – PostgreSQL 13
+* `pg_14` – PostgreSQL 14
+* `pg_15` – PostgreSQL 15
+* `pg_16` – PostgreSQL 16
+* `pg_17` – PostgreSQL 17
+* `pg_18` – PostgreSQL 18
+
+```python
+import asyncpg
+
+
+async def test_asyncpg_query(pg):
+    conn = await asyncpg.connect(
+        user=pg.user,
+        password=pg.password,
+        database=pg.database,
+        host=pg.host,
+        port=pg.port,
+    )
+
+    await conn.execute("CREATE TABLE test_table (id serial PRIMARY KEY, value text);")
+    await conn.execute("INSERT INTO test_table (value) VALUES ($1)", "hello")
+    row = await conn.fetchrow("SELECT value FROM test_table WHERE id = $1", 1)
+
+    assert row["value"] == "hello"
+
+    await conn.close()
+```
+
+
+Also `run_pg` context manager is available, you can use it to create your own fixture, using docker image you need:
+
+```python
+import os
+
+import pytest
+import pytest_pg
+
+
+@pytest.fixture(scope='session', autouse=True)
+def postgres_env_vars() -> Generator[None]:
+    docker_image = 'postgres:18'
+    with pytest_pg.run_pg(docker_image) as pg:
+        os.environ['POSTGRES_USER'] = pg.user
+        os.environ['POSTGRES_PASSWORD'] = pg.password
+        os.environ['POSTGRES_HOST'] = pg.host
+        os.environ['POSTGRES_PORT'] = str(pg.port)
+        os.environ['POSTGRES_DBNAME'] = pg.database
+        yield
+
+
+# or like so:
+@pytest.fixture(scope='session', autouse=True)
+def postgres_env_vars(pg_18: pytest_pg.PG) -> Generator[None]:
+    os.environ['POSTGRES_USER'] = pg_18.user
+    os.environ['POSTGRES_PASSWORD'] = pg_18.password
+    os.environ['POSTGRES_HOST'] = pg_18.host
+    os.environ['POSTGRES_PORT'] = str(pg_18.port)
+    os.environ['POSTGRES_DBNAME'] = pg_18.database
+    yield
+```

pytest_pg-0.0.28/README.md

@@ -0,0 +1,87 @@
+# pytest-pg
+
+A pytest plugin that provides session-scoped fixtures for running PostgreSQL inside Docker containers.
+It automatically spins up a container, waits for PostgreSQL to become ready, exposes connection details
+(`host`, `port`, `user`, `password`, `database`) via a `PG` dataclass, and tears the container down after
+the test session. Pre-built fixtures are available for PostgreSQL versions 11 through 18 as well as `latest`.
+
+Readiness checks work with any of the common drivers — asyncpg, psycopg2, or psycopg3.
+
+To speed up tests, pytest-pg does the following tweaks:
+
+1. fsync=off
+2. full_page_writes=off
+3. synchronous_commit=off
+4. jit=off
+5. bgwriter_lru_maxpages=0
+6. data directory is mounted to a tmpfs 
+
+
+# How to use?
+
+You can use the following fixtures:
+
+* `pg` – the latest PostgreSQL image available
+* `pg_11` – PostgreSQL 11
+* `pg_12` – PostgreSQL 12
+* `pg_13` – PostgreSQL 13
+* `pg_14` – PostgreSQL 14
+* `pg_15` – PostgreSQL 15
+* `pg_16` – PostgreSQL 16
+* `pg_17` – PostgreSQL 17
+* `pg_18` – PostgreSQL 18
+
+```python
+import asyncpg
+
+
+async def test_asyncpg_query(pg):
+    conn = await asyncpg.connect(
+        user=pg.user,
+        password=pg.password,
+        database=pg.database,
+        host=pg.host,
+        port=pg.port,
+    )
+
+    await conn.execute("CREATE TABLE test_table (id serial PRIMARY KEY, value text);")
+    await conn.execute("INSERT INTO test_table (value) VALUES ($1)", "hello")
+    row = await conn.fetchrow("SELECT value FROM test_table WHERE id = $1", 1)
+
+    assert row["value"] == "hello"
+
+    await conn.close()
+```
+
+
+Also `run_pg` context manager is available, you can use it to create your own fixture, using docker image you need:
+
+```python
+import os
+
+import pytest
+import pytest_pg
+
+
+@pytest.fixture(scope='session', autouse=True)
+def postgres_env_vars() -> Generator[None]:
+    docker_image = 'postgres:18'
+    with pytest_pg.run_pg(docker_image) as pg:
+        os.environ['POSTGRES_USER'] = pg.user
+        os.environ['POSTGRES_PASSWORD'] = pg.password
+        os.environ['POSTGRES_HOST'] = pg.host
+        os.environ['POSTGRES_PORT'] = str(pg.port)
+        os.environ['POSTGRES_DBNAME'] = pg.database
+        yield
+
+
+# or like so:
+@pytest.fixture(scope='session', autouse=True)
+def postgres_env_vars(pg_18: pytest_pg.PG) -> Generator[None]:
+    os.environ['POSTGRES_USER'] = pg_18.user
+    os.environ['POSTGRES_PASSWORD'] = pg_18.password
+    os.environ['POSTGRES_HOST'] = pg_18.host
+    os.environ['POSTGRES_PORT'] = str(pg_18.port)
+    os.environ['POSTGRES_DBNAME'] = pg_18.database
+    yield
+```

pytest_pg-0.0.28/pyproject.toml

@@ -0,0 +1,80 @@
+[project]
+name = "pytest_pg"
+dynamic = ["version"]
+description = "A tiny plugin for pytest which runs PostgreSQL in Docker"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [{name = "Yury Pliner", email = "yury.pliner@gmail.com"}]
+requires-python = ">=3.10"
+dependencies = [
+    "docker>=7.0.0",
+    "pytest>=8.0",
+]
+classifiers = [
+    "License :: OSI Approved :: MIT License",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Operating System :: OS Independent",
+    "Development Status :: 5 - Production/Stable",
+    "Framework :: Pytest",
+]
+
+[project.urls]
+Homepage = "https://github.com/anna-money/pytest-pg"
+
+[project.entry-points.pytest11]
+pytest_pg = "pytest_pg"
+
+[project.optional-dependencies]
+dev = [
+    "pytest==9.0.2",
+    "ruff==0.14.10",
+    "pyright==1.1.407",
+]
+
+[build-system]
+requires = ["hatchling", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+source = "vcs"
+
+[tool.hatch.build.targets.wheel]
+packages = ["pytest_pg"]
+
+[tool.pytest.ini_options]
+norecursedirs = [".git", ".venv"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["SIM", "C4", "ANN", "N", "LOG", "G", "F", "E", "W", "Q", "I", "UP", "T20", "COM", "RSE", "RET", "ISC", "ASYNC", "SLOT", "RUF", "DTZ"]
+ignore = ["COM812", "ISC001", "ASYNC109", "RUF018", "RUF022", "ANN401", "ANN204", "E501"]
+
+[tool.pyright]
+include = ["pytest_pg", "tests"]
+pythonVersion = "3.10"
+pythonPlatform = "All"
+stubPath = ""
+typeCheckingMode = "strict"
+useLibraryCodeForTypes = true
+reportPrivateImportUsage = false
+reportMissingTypeStubs = false
+reportUnknownVariableType = false
+reportUnknownMemberType = false
+reportUnknownLambdaType = false
+reportUnknownArgumentType = false
+reportUnknownParameterType = false
+reportUntypedFunctionDecorator = false
+reportUnusedImport = false
+reportMissingTypeArgument = false
+reportImportCycles = false
+reportDeprecated = false

pytest_pg-0.0.28/pytest_pg/__init__.py

@@ -0,0 +1,19 @@
+from importlib.metadata import version as _get_version
+
+from .fixtures import PG, pg, pg_11, pg_12, pg_13, pg_14, pg_15, pg_16, pg_17, pg_18, run_pg
+
+__all__: tuple[str, ...] = (
+    "PG",
+    "run_pg",
+    "pg",
+    "pg_11",
+    "pg_12",
+    "pg_13",
+    "pg_14",
+    "pg_15",
+    "pg_16",
+    "pg_17",
+    "pg_18",
+)
+
+__version__ = _get_version("pytest_pg")