NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #2779 most downloaded on PyPI
Pseudo terminal support for Windows from Python.
Latest stable
3.1.2
Last release 24 days ago
28 Oct 2026
Ships fairly regularly
a new release about every 4 months
Nearly every release is documented
notes for 47 of 47 stable releases
3 versions withdrawn
withdrawn after publishing
9 years old
52 releases · first in 2017
Drag across the ruler to compare, or tap a release to open it.
Require winpty-rs 1.0.8, which makes EOF detection work and fixes spawning an executable whose path contains a space. Measured through this package's
Require winpty-rs 1.0.8, which makes EOF detection work and fixes spawning
an executable whose path contains a space. Measured through this package's
own API:
| 3.1.1 | 3.1.2 | |
|---|---|---|
while not pty.iseof(): pty.read() |
never terminates | exits via iseof() |
| ...time to exit, ConPTY | 5.07 s, WinptyError('') |
0.20 s, no error |
PTY.iseof(), both backends |
always False |
True once drained |
| spawn from a path containing a space | fails, bad-image error | spawns, argv[0] intact |
| errors with an empty message | 1 | 0 |
Behavioural change. PTY.iseof() could never return True before, so
code written around that behaves differently now. A loop of the shape
while not data and not pty.iseof():
data = pty.read()Spawning from a path containing a space failed differently on each backend.
The WinPTY backend ran the right executable but split argv, so
C:\Program Files\Python\python.exe arrived as argv[0] = "C:\Program"
with the remainder shifted into the caller's arguments. The ConPTY backend
left argv[0] intact but let CreateProcessW guess which file to run,
which could fail the spawn outright with a bad-image error whose %1
placeholder was never substituted - reported in
#583 as being related to
path length, though what actually decided it was whether a shorter candidate
existed on disk.
Closing a PTY no longer waits out a fixed five seconds. A blocking read
after the child exits now returns in about 175 ms rather than 5.1 s, and
teardown no longer cancels I/O that has stopped belonging to it, which could
abort a read owned by the host application.
Still not fixed: the output truncation half of
#565 is
cpython#86210, where an
unbuffered _textiowrapper_writeflush ignores a partial write and drops the
remainder. That is a CPython bug on the producer side and is unaffected by
this release; a buffered producer, or one that checks the return value of
write, is not affected. The EOF half of that report is fixed. See also the
dated correction added to the 3.1.1 notes.
Fixed in this release:
Closed during triage after 3.1.1 - already fixed in an earlier release, not
reproducible, or answered:
In this release 19 issues were closed.
In this release 1 pull request was closed.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Pin the ConPTY NuGet package to 1.25.260930003 rather than resolving latest at build time, so an upstream ConPTY release can no longer change what the
latest at build time, so an upstream ConPTY release can no longer change
what the wheels contain without a pywinpty release.PTY.write() returning 0 for payloads the child received in full._textiowrapper_writeflush ignores a partial write and silently
drops the remainder - a producer-side CPython bug, not a pywinpty one. The
measurement behind the original claim used a buffered producer writing
line-sized chunks, so it never exercised the reported condition. EOF
detection was also still broken on the ConPTY backend in 3.1.1:
PTY.iseof() could never return True. That half is fixed in 3.1.2 by
winpty-rs 1.0.8; the CPython bug remains upstream.pythonarm64 NuGet
install landed in the same checkout that maturin sdist archives, and
twine check never inspects archive contents. The sdist is back to ~30 KB
and a content check now gates the upload.In this release 1 issue was closed.
In this release 2 pull requests were closed.
Build and test Python 3.15 and 3.15t wheels on Windows x64 and ARM64.
In this release 1 issue was closed.
In this release 1 pull request was closed.
Release upload step replaced deprecated maturin publish with maturin build --release + twine upload. Pinned twine>=6.1 and pkginfo>=1.12 so the upload…
Re-release of 3.0.4 with a build-pipeline fix: the published 3.0.4 wheels shipped without the WinPTY DLL (x64) and without any native binaries at all (arm64), making them unusable.
winpty → _winpty to avoid maturin de-duping the
colliding winpty.dll C library that lives in the same wheel directory.*.dll/*.exe from .gitignore so the
NuGet-downloaded ConPTY binaries (conpty.dll, OpenConsole.exe) actually
land in the arm64 wheel.maturin publish with
maturin build --release + twine upload. Pinned twine>=6.1 and
pkginfo>=1.12 so the upload accepts the Metadata 2.4 license-file
field that current maturin emits..github/scripts/check_wheel.py) that
verifies every expected binary is present in the wheel before it is sent
to PyPI.Wheel preflight CI workflow that exercises the full wheel
build + sanity check on x64 and arm64 on every push to main, so the
same packaging regression cannot slip out again unnoticed.Re-release of 3.0.4 with a build-pipeline fix: the published 3.0.4 wheels
shipped without the WinPTY DLL (x64) and without any native binaries at all
(arm64), making them unusable. The rust cdylib was renamed winpty → _winpty
to avoid maturin de-duping the colliding winpty.dll, the arm64 release job
now strips *.dll/*.exe from .gitignore so the NuGet-downloaded ConPTY
binaries land in the wheel, and a pre-upload sanity check verifies every
expected binary is present.
winpty.dll (x64) and all native
binaries (arm64).Bump winpty-rs to 1.0.6 (#567) — picks up the event-driven teardown for the ConPTY reader thread, which fixes data loss on quick child exit and remove
Drop CPU-spin. Also switches to the public NuGet sources for ConPTY (no more Azure feed dependency).requires-python is now >=3.10. Matrices and pyproject.toml updated accordingly.Swatinem/rust-cache@v2, conda env caching, pip wheel caching, and use-mamba in setup-miniconda. Also bumps nuget/setup-nuget v2→v4 and conda-incubator/setup-miniconda v3→v4 across all workflows. Supersedes dependabot PRs #568, #569.See CHANGELOG.md for the full list. 3 PRs in this release (supersedes 7 dependabot PRs).
In this release 3 pull requests were closed.
Minor pywinpty release that introduces arm64 testing and wheel publishing, as well as dependency updates.
Minor pywinpty release that introduces arm64 testing and wheel publishing, as well as dependency updates.
Full Changelog: https://github.com/andfoy/pywinpty/compare/v3.0.2...v3.0.3
In this release 6 pull requests were closed.
Nothing published for this version
Minor pywinpty release that fixes issues with PyPi metadata
Minor pywinpty release that fixes issues with PyPi metadata
Full Changelog: https://github.com/andfoy/pywinpty/compare/v3.0.1...v3.0.2
In this release 1 pull request was closed.
Remove deprecated actions-rs/toolchain by @cclauss in https://github.com/andfoy/pywinpty/pull/538
Minor pywinpty version, it adds support for Python 3.14(t), updates several Rust dependencies, including winpty-rs and it also fixes some build issues occurring on arm64 environments.
Full Changelog: https://github.com/andfoy/pywinpty/compare/v3.0.0...v3.0.1
In this release 7 pull requests were closed.
This a major pywinpty release that provides support for the latest winpty-rs release, which now provides async compatibility on ConPTY, it also ships
This a major pywinpty release that provides support for the latest winpty-rs release, which now provides async compatibility on ConPTY, it also ships the latest binaries published by the Windows Terminal team at Microsoft. An important improvement over the 2.x series relates to performance, where now reading from a pseudoterminal takes numbers in the orders of tenths of microseconds and not 100ms as previously.
read now does no longer accept num_bytes as a parameter, instead all available bytes in the stream will be returned directly, delegating any buffering to downstream consumers of the library.
Full Changelog: https://github.com/andfoy/pywinpty/compare/v2.0.15...v3.0.0
In this release 2 pull requests were closed.
Minor pywinpty release that provides compatibility against winpty-rs v0.4.1, PyO3 0.23.4 and enables experimental CPython 3.13 free-threaded support.
Minor pywinpty release that provides compatibility against winpty-rs v0.4.1, PyO3 0.23.4 and enables experimental CPython 3.13 free-threaded support.
Full Changelog: https://github.com/andfoy/pywinpty/compare/v2.0.14...v2.0.15
In this release 2 pull requests were closed.
Minor pywinpty release that updates several of its dependencies to their latest versions:
Minor pywinpty release that updates several of its dependencies to their latest versions:
Full Changelog: https://github.com/andfoy/pywinpty/compare/v2.0.13...v2.0.14
Minor pywinpty release that updates several of its dependencies to their latest versions:
Full Changelog: v2.0.13...v2.0.14
Minor PyWinPTY release that updates several dependencies to their latest versions, including winpty-rs
Minor PyWinPTY release that updates several dependencies to their latest versions, including winpty-rs
Full Changelog: https://github.com/andfoy/pywinpty/compare/v2.0.12...v2.0.13
Minor PyWinPTY release that updates several dependencies to their latest versions, including winpty-rs
Full Changelog: v2.0.12...v2.0.13
In this release 18 pull requests were closed.
Minor maintenance release of PyWinPTY, it updates both winpty-rs and PyO3 to their latest versions. It also provides support for Python 3.12
Minor maintenance release of PyWinPTY, it updates both winpty-rs and PyO3 to their latest versions. It also provides support for Python 3.12
Full Changelog: https://github.com/andfoy/pywinpty/compare/v2.0.10...v2.0.12
In this release 3 pull requests were closed.
Minor maintenance release of PyWinPTY, it updates both winpty-rs and PyO3 to their latest versions. It also fixes a minor bug in PtyProcess::sendcontr
Minor maintenance release of PyWinPTY, it updates both winpty-rs and PyO3 to their latest versions. It also fixes a minor bug in PtyProcess::sendcontrol
Full Changelog: https://github.com/andfoy/pywinpty/compare/v2.0.10...v2.0.11
In this release 2 pull requests were closed.
Minor pywinpty release that updates several Rust dependencies, including winpty-rs to v0.3.11
Minor pywinpty release that updates several Rust dependencies, including winpty-rs to v0.3.11
Full Changelog: https://github.com/andfoy/pywinpty/compare/v2.0.9...v2.0.10
In this release 1 issue was closed.
In this release 12 pull requests were closed.
Minor pywinpty release that updates several Rust dependencies, including the backend library winpty-rs. It also provides official Python 3.11 wheels.
Minor pywinpty release that updates several Rust dependencies, including the backend library winpty-rs. It also provides official Python 3.11 wheels.
Full Changelog: https://github.com/andfoy/pywinpty/compare/v2.0.8...v2.0.9
In this release 8 pull requests were closed.
Minor pywinpty release that updates several Rust dependencies.
Minor pywinpty release that updates several Rust dependencies.
Full Changelog: https://github.com/andfoy/pywinpty/compare/v2.0.7...v2.0.8
In this release 1 issue was closed.
In this release 9 pull requests were closed.
This is a minor pywinpty release that updates several dependencies, including winpty-rs to its latest version, v0.3.8
This is a minor pywinpty release that updates several dependencies, including winpty-rs to its latest version, v0.3.8
Full Changelog: https://github.com/andfoy/pywinpty/compare/v2.0.6...v2.0.7
In this release 1 issue was closed.
In this release 12 pull requests were closed.
Minor pywinpty release that brings support with the latest winpty-rs version, as well other dependencies.
Minor pywinpty release that brings support with the latest winpty-rs version, as well other dependencies.
Full Changelog: https://github.com/spyder-ide/pywinpty/compare/v2.0.5...v2.0.6
In this release 1 issue was closed.
In this release 3 pull requests were closed.
Minor pywinpty release that brings compatibility with winpty-rs v0.3.6
Minor pywinpty release that brings compatibility with winpty-rs v0.3.6
Full Changelog: https://github.com/spyder-ide/pywinpty/compare/v2.0.4...v2.0.5
In this release 1 issue was closed.
In this release 1 pull request was closed.
Minor pywinpty release that brings support for both winpty-rs v0.3.4 and windows-2022 CI images. Python 3.6 support was dropped officially.
Minor pywinpty release that brings support for both winpty-rs v0.3.4 and windows-2022 CI images. Python 3.6 support was dropped officially.
Full Changelog: https://github.com/spyder-ide/pywinpty/compare/v2.0.3...v2.0.4
In this release 3 issues were closed.
In this release 1 pull request was closed.
Minor PyWinPTY release that temporarily disables ConPTY testing and updates some dependencies.
Minor PyWinPTY release that temporarily disables ConPTY testing and updates some dependencies.
Full Changelog: https://github.com/spyder-ide/pywinpty/compare/v2.0.2...v2.0.3
In this release 1 issue was closed.
In this release 3 pull requests were closed.
Minor pywinpty release that provides compatibility with winpty-rs v0.3.3
Minor pywinpty release that provides compatibility with winpty-rs v0.3.3
Full Changelog: https://github.com/spyder-ide/pywinpty/compare/v2.0.1...v2.0.2
In this release 1 issue was closed.
In this release 1 pull request was closed.
Minor pywinpty release that fixed a major issue with the wheel distribution, which was not including the winpty binaries.
Minor pywinpty release that fixed a major issue with the wheel distribution, which was not including the winpty binaries.
Full Changelog: https://github.com/spyder-ide/pywinpty/compare/v2.0.0...v2.0.1
In this release 1 issue was closed.
In this release 1 pull request was closed.
Nothing published for this version
Major pywinpty release that simplifies the dependencies as well the building environment. The PTY implementation details were moved into their own lib
Major pywinpty release that simplifies the dependencies as well the building environment. The PTY implementation details were moved into their own library in rust, winpty-rs and C++ dependencies were dropped, which implies that this library functions as a simple PyO3 wrapper that calls winpty-rs without any added complexities.
PTY and PtyProcess no longer accept an encoding keyword argument.PtyProcess reading thread is now blocking, and no longer consumes CPU unnecessarily.backend argument is now working on PtyProcess.Full Changelog: https://github.com/spyder-ide/pywinpty/compare/v1.1.6...v2.0.0
In this release 1 issue was closed.
In this release 1 pull request was closed.
Minor release that improves the support on arm64 (although not tested) and re-enables support for win32 builds, thanks to @nsait-linaro and @cgohlke.
Minor release that improves the support on arm64 (although not tested) and re-enables support for win32 builds, thanks to @nsait-linaro and @cgohlke. Also, some Rust dependencies were updated to their latest versions.
Full Changelog: https://github.com/spyder-ide/pywinpty/blob/master/CHANGELOG.md#version-116-2021-11-15
In this release 1 issue was closed.
In this release 5 pull requests were closed.
Minor pywinpty release that updates some Rust dependencies and adds support for Python 3.10
Minor pywinpty release that updates some Rust dependencies and adds support for Python 3.10
In this release 2 issues were closed.
In this release 5 pull requests were closed.
This is a minor release of pywinpty that updates some Rust dependencies versions, as well it provides support for the latest Maturin release, which fi
This is a minor release of pywinpty that updates some Rust dependencies versions, as well it provides support for the latest Maturin release, which fixes some issues with PyPy wheel tag naming.
In this release 1 issue was closed.
In this release 4 pull requests were closed.
Minor release of pywinpty that fixes some issues related to stderr redirection and pseudoterminal creation inside a graphical application when using t
Minor release of pywinpty that fixes some issues related to stderr redirection and pseudoterminal creation inside a graphical application when using the ConPTY backend.
In this release 2 issues were closed.
In this release 4 pull requests were closed.
Minor pywinpty release that fixes some deprecated attributes, as well as some minor Rust dependency updates.
Minor pywinpty release that fixes some deprecated attributes, as well as some minor Rust dependency updates.
In this release 2 issues were closed.
In this release 2 pull requests were closed.
Minor pywinpty release that fixes further issues related to PyPi source distributions that are being tried to be installed on Python 2.7
Minor pywinpty release that fixes further issues related to PyPi source distributions that are being tried to be installed on Python 2.7
In this release 2 issues were closed.
In this release 1 pull request was closed.
Minor Pywinpty release that fixes some issues related to process EOF detection that caused some processes to hang.
Minor Pywinpty release that fixes some issues related to process EOF detection that caused some processes to hang.
In this release 1 issue was closed.
In this release 3 pull requests were closed.
Minor pywinpty release that prevents installation and compilation on Python 2.7
Minor pywinpty release that prevents installation and compilation on Python 2.7
In this release 2 issues were closed.
In this release 1 pull request was closed.
Major release of pywinpty after two years!
Major release of pywinpty after two years!
PTY object has no close() method anymore.In this release 8 issues were closed.
In this release 3 pull requests were closed.
Nothing published for this version
Minor pywinpty release: Fix Python 3.8 release publishing
Minor pywinpty release: Fix Python 3.8 release publishing
In this release 1 issue was closed.
In this release 1 pull request was closed.
Minor pywinpty release: Python 3.7 support.
Minor pywinpty release: Python 3.7 support.
In this release 3 issues were closed.
In this release 2 pull requests were closed.
Minor Pywinpty release: Access violation error was definitely fixed thanks to @axil
Minor Pywinpty release: Access violation error was definitely fixed thanks to @axil
In this release 4 issues were closed.
In this release 3 pull requests were closed.
Minor pywinpty release: Added MinGW GCC dependencies to wheel distributions
Minor pywinpty release: Added MinGW GCC dependencies to wheel distributions
In this release 2 issues were closed.
In this release 1 pull request was closed.
Minor Pywinpty release: Support for MSVC compilation dropped, Excessive CPU consumption on high-level API fixed and access violation error detection o
Minor Pywinpty release: Support for MSVC compilation dropped, Excessive CPU consumption on high-level API fixed and access violation error detection on Windows 7 systems
In this release 4 issues were closed.
In this release 8 pull requests were closed.
Issue 81 - Update instructions to build from source for Python 2
In this release 3 issues were closed.
In this release 3 pull requests were closed.
Major pywinpty release: Now supporting Python 2.7!
Major pywinpty release: Now supporting Python 2.7!
In this release 2 issues were closed.
In this release 1 pull request was closed.
Minor Pywinpty release: Winpty binaries were added to automatic wheel compilation on AppVeyor
Minor Pywinpty release: Winpty binaries were added to automatic wheel compilation on AppVeyor
In this release 2 issues were closed.
In this release 1 pull request was closed.
Major pywinpty release: Thanks to @blink1073 the library now provides a rich and high level interface to create processes and keep track of their exec
Major pywinpty release: Thanks to @blink1073 the library now provides a rich and high level interface to create processes and keep track of their execution. Also, all I/O bound operations were improved, sanitized and stabilized.
In this release 2 issues were closed.
In this release 4 pull requests were closed.
Major pywinpty release, some stabillity-related issues were addressed on this release. Also a higher-lever wrapper around a PTY process is introduced
Major pywinpty release, some stabillity-related issues were addressed on this release. Also a higher-lever wrapper around a PTY process is introduced
In this release 2 issues were closed.
In this release 2 pull requests were closed.
Minor pywinpty release: Some critical ctypes issues were fixed, pywinpty normal behaviour was restored.
Minor pywinpty release: Some critical ctypes issues were fixed, pywinpty normal behaviour was restored.
In this release 3 issues were closed.
In this release 1 pull request was closed.
pywinpty major version release: pywin32 package was removed from dependencies
pywinpty major version release: pywin32 package was removed from dependencies
In this release 2 issues were closed.
In this release 1 pull request was closed.
Minor pywinpty release: Library now checks size dimensions before creating/resizing a PTY
Minor pywinpty release: Library now checks size dimensions before creating/resizing a PTY
In this release 3 issues were closed.
In this release 2 pull requests were closed.
Minor pywinpty release: Python wheels now include winpty binaries.
Minor pywinpty release: Python wheels now include winpty binaries.
In this release 1 issue was closed.
In this release 1 pull request was closed.
On this version we added a brand-new function to know if a process is alive or not.
On this version we added a brand-new function to know if a process is alive or not.
In this release 5 issues were closed.
In this release 3 pull requests were closed.
One column per quarter.