pytest servers
Features
Create temporary directories on the following filesystems:
Local fs
In-memory fs
S3, both using mock S3 remotes (https://github.com/spulec/moto) and real S3 remotes
Azure, both using mock Azure remotes (https://github.com/Azure/Azurite) via docker and using real Azure Storage remotes
Google Cloud Storage, both using mock GCS remote (https://github.com/fsouza/fake-gcs-server) via docker and using real Google Storage Remotes
Installation
You can install pytest servers via pip from PyPI:
$ pip install pytest-serversTo use temporary S3 paths:
$ pip install pytest-servers[s3]To use temporary Azure paths
$ pip install pytest-servers[azure]To use temporary Google Cloud Storage paths
$ pip install pytest-servers[gcs]To install all extras:
$ pip install pytest-servers[all]Usage
The main fixture provided by pytest-servers provides is tmp_upath_factory, which can be used to generate temporary paths on different (mocked) filesystems:
def test_something_on_s3(tmp_upath_factory):
path = tmp_upath_factory.mktemp("s3")
foo = path / "foo"
foo.write_text("foo")
...mktemp supports the following filesystem types:
local (local filesystem)
memory (in-memory filesystem)
s3 (Amazon S3)
gcs (Google Cloud Storage)
azure (Azure Storage)
Some convenience fixtures that wrap tmp_upath_factory.mktemp and return a paths on these filesystems are also available:
tmp_local_path
tmp_memory_path
tmp_s3_path
tmp_gcs_path
tmp_azure_path
The tmp_upath fixture can be used for parametrizing paths with pytest’s indirect parametrization:
@pytest.mark.parametrize("tmp_upath", ["local", "s3", "gcs", "gs"], indirect=True)
def test_something(tmp_upath):
passIn order to use real remotes instead of mocked ones, use tmp_upath_factory with the following methods
tmp_upath_factory.s3(region_name, client_kwargs) where client_kwargs are passed to the underlying S3FileSystem/boto client
tmp_upath_factory.gcs(endpoint_url)
tmp_upath_factory.azure(connection_string)
Versioning support can be used by using the versioning fixture. This is currently supported for s3 and gcs remotes
# using mktemp
def test_something_on_s3_versioned(tmp_upath_factory):
path = tmp_upath_factory.mktemp("s3", version_aware=True)
assert path.fs.version_aware # bucket has versioning enabled
# or, using remote-specific fixtures
def test_something_on_s3_versioned(tmp_s3_path, versioning):
assert tmp_s3_path.fs.version_aware # bucket has versioning enabledContributing
Contributions are very welcome. To learn more, see the Contributor Guide.
License
Distributed under the terms of the Apache 2.0 license, pytest servers is free and open source software.
Issues
If you encounter any problems, please file an issue along with a detailed description.
2 maintainers
Metadata
2 maintainers
Release files for pytest-servers 0.5.14
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pytest_servers-0.5.14.tar.gz | 25.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pytest_servers-0.5.14-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 43.1 kB
Release files / pytest_servers-0.5.14.tar.gz
| Download URL | pytest_servers-0.5.14.tar.gz |
|---|---|
| Size | 25.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
010d3ed5c6c2c2b78b3e7c06cfa79de5f3086eafd9420e2290126f38bd2589b8
|
|
BLAKE2b-256 checksum How to use checksums |
51689b27efb5eb7e0ec428d543ce2b780255749b75b128c9ff83d36d1ba89b64
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 26, 2026.
Transparency logRelease files / pytest_servers-0.5.14-py3-none-any.whl
| Download URL | pytest_servers-0.5.14-py3-none-any.whl |
|---|---|
| Size | 17.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
1fc0cd958475fbb79ee10a6131bfc363fcaad086b86877d7cd044a5df5f9d137
|
|
BLAKE2b-256 checksum How to use checksums |
3184be408f71c8a734551e8df258b41b69b9c45709e464c5d1d3190d901bdf0c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jun 26, 2026.
Transparency log
