pytest-localftpserver
A PyTest plugin which provides an FTP fixture for your tests
Decision gist · record as of 2026-08-14
Yes. This is a stable, actively maintained pytest plugin (released 3 days ago, in production since 2016) with no known vulnerabilities, low install friction, and a clear use case: testing FTP client code locally. The MIT license is permissive. Install it if you need to test FTP functionality in your test suite.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires pytest to be installed; FTP server configuration is set via environment variables (FTP_USER, FTP_PASS, FTP_PORT, FTP_HOME) or pytest.ini/tox.ini.
- Low friction install with stable maintenance: released 3 days ago, active repository, and depends only on pyftpdlib, PyOpenSSL, and pytest—all widely used packages.
License · maintenance · safety
permissive license (permissive) — MIT license (permissive) means you can use, modify, and distribute this package freely in commercial and open-source projects with minimal restrictions.
last release 2026-08-11 (3 days) · last repo commit 2026-08-14 · 18 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 74,863 downloads/mo, #14,781 on PyPI
Alternatives
Verify before relying
# Install
pip install pytest-localftpserver
# In your test file
import pytest
def test_ftp_upload(ftpserver):
# ftpserver fixture provides a running FTP server
# Configure via environment variables: FTP_USER, FTP_PASS, FTP_PORT, FTP_HOME
pass- Whether the ftpserver_TLS fixture works reliably with modern TLS versions and certificate formats.
- Performance characteristics when running many concurrent FTP connections in tests.
What it is and what it does
pytest-localftpserver is a pytest plugin that injects ftpserver and ftpserver_TLS fixtures into your test suite, each providing a threaded, in-process FTP server instance. This lets you write tests that exercise FTP client code—uploads, downloads, authentication, directory operations—without needing an external FTP server or network access. The plugin depends on pyftpdlib for the server implementation and PyOpenSSL for TLS support.
You configure the server's behavior (username, password, port, home directory, certificate path) via environment variables or pytest configuration files. The fixture scope can be set per-function, per-module, or per-session, making it flexible for different test strategies. Since the server runs in a thread within your test process, it starts and stops with each test or test session, keeping your test environment isolated and reproducible.
Use it for
- Test FTP client libraries or custom upload/download code without a live FTP server.
- Verify authentication and permission handling in FTP-based workflows.
- Test TLS/SSL FTP connections with a local certificate in CI/CD pipelines.
- Validate error handling when FTP operations fail (connection refused, auth denied).
- Integration test file transfer workflows in isolation from external services.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
This is a stable, actively maintained pytest plugin (released 3 days ago, in production since 2016) with no known vulnerabilities, low install friction, and a clear use case: testing FTP client code locally. The MIT license is permissive. Install it if you need to test FTP functionality in your test suite.
Install
pytest-localftpserver on PyPI
Before you install
Low friction install with stable maintenance: released 3 days ago, active repository, and depends only on pyftpdlib, PyOpenSSL, and pytest—all widely used packages.
Requires pytest to be installed; FTP server configuration is set via environment variables (FTP_USER, FTP_PASS, FTP_PORT, FTP_HOME) or pytest.ini/tox.ini.
License in practice
MIT license (permissive) means you can use, modify, and distribute this package freely in commercial and open-source projects with minimal restrictions.
Quickstart
# Install
pip install pytest-localftpserver
# In your test file
import pytest
def test_ftp_upload(ftpserver):
# ftpserver fixture provides a running FTP server
# Configure via environment variables: FTP_USER, FTP_PASS, FTP_PORT, FTP_HOME
passVerify before relying
- Whether the ftpserver_TLS fixture works reliably with modern TLS versions and certificate formats.
- Performance characteristics when running many concurrent FTP connections in tests.
Package facts
| License | permissive license permissive |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 3 packagespyftpdlibPyOpenSSLpytest |
| Maintenance | Actively maintained 3 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 74,863 / month, #14,781 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableFramework :: PytestIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseNatural Language :: EnglishOperating System :: MacOS :: MacOS XOperating System :: Microsoft :: WindowsOperating System :: POSIXOperating System :: POSIX :: LinuxProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: Software Development :: TestingTopic :: Software Development :: Testing :: Mocking |
Evidence: pytest_localftpserver-1.6.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “pytest ftp server fixture”
- pytest-localftpserverProvides pytest fixtures for running local FTP and TLS-FTP servers in…
- pytest-httpbinProvides a pytest fixture that runs a local httpbin server in a test…
- pytest-localserverProvides pytest fixtures that spin up local HTTP and SMTP servers for…
Give your agent the search over MCP, or paste the wish link into any chat.
More Testing packages
Pluggy provides a plugin system that lets you define hook specifications and register implementations to be called in sequence, enabling extensible Python applications without tight coupling.
Install it if you're building an extensible application or framework.
pytest is a testing framework that lets you write test functions using plain assert statements and automatically discovers and runs them, with detailed failure reporting.
virtualenv creates isolated Python environments where packages can be installed independently without affecting the system Python or other projects.
Coverage.py measures which lines of Python code are executed during test runs, reporting coverage percentages and identifying untested code paths.
Install it if you want to measure test completeness or enforce coverage thresholds in your project.
pytest-asyncio is a pytest plugin that enables writing and running async test functions using the asyncio library, allowing developers to await code directly within test cases.
Install it if you write tests for any asyncio-based code.
A pytest plugin that generates test reports in Common Test Report Format (CTRF) as JSON, compatible with pytest-xdist and pytest-playwright for distributed and browser-based testing.
Install it if you need CTRF-formatted test output for CI/CD integration or cross-tool reporting.
See also pytest-sftpserver · pytest-regressions · pytest-rabbitmq · pytest-redis · pytest-httpbin · pytest-mock · pytest-postgresql · pytest-mysql · pytest-docker · pyftpdlib