Registry / http-networking / jaraco-windows

jaraco-windows

JSON →
library5.10.0pypypi✓ verified 83d ago

A library of Windows utilities and ctypes wrappers by Jason R. Coombs, providing convenient access to Windows API functions, registry, file properties, and more. Current version 5.10.0, requires Python >=3.9, and is actively maintained with regular releases.

http-networking
pip install jaraco-windows
github ↗package ↗
INSTALL
IMPORT
SIG · JARACO-WINDOWS
J
jaraco-windows
http-networkingpythonv5.10.0
Install
3.7s avg
Import
—
Disk
34MB
Pass rate
10/ 10
Env Coverage10 / 10
glibc
3.9–3.13
musl
3.9–3.13
Install & Compatibility
Where this runs
tested against v5.10.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
py 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.000s · 34.8MB
glibc
py 3.10–3.95 runs
installs and imports cleanly · install 3.7s · import 0.000s · 35MB
34MB installed
● package 34MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

jaraco.windows.api
✓ import jaraco.windows.api
✗ from jaraco import windows
Incorrect: 'jaraco.windows' is the top-level package; submodules like 'api' must be imported explicitly.
jaraco.windows.registry
✓ from jaraco.windows.registry import RegistryKey
✗ from jaraco import registry
Incorrect: 'jaraco.registry' does not exist; subpackage is 'jaraco.windows.registry'.
jaraco.windows.filesystem
✓ import jaraco.windows.filesystem
✗ from jaraco import filesystem
Incorrect: 'jaraco.filesystem' is not part of this library.

Basic import and registry access; runs on Windows only.

import jaraco.windows.api import jaraco.windows.registry # Get a registry key key = jaraco.windows.registry.RegistryKey(r'SOFTWARE\Microsoft\Windows\CurrentVersion') print(key['ProgramFilesDir']) # Use API utilities jaraco.windows.api.GetCurrentProcessId()
Debug
Known issues
breakingVersion 5.0 removed the deprecated 'winreg' module alias in favor of 'jaraco.windows.registry'.
fix
Replace 'import winreg' with 'from jaraco.windows.registry import ...'
affects: >=5.0
breakingPython 3.13 removed the old 'imp' module; jaraco-windows 5.10.0 requires Python >=3.9 but may break on Python 3.13 if dependencies aren't updated.
fix
Ensure you are using a compatible Python version (3.9-3.12 recommended).
affects: 5.10.0
gotchaLibrary is Windows-only; importing on non-Windows raises ImportError or AttributeError.
fix
Wrap imports in try/except or conditional checks (sys.platform).
affects: all
deprecatedThe 'jaraco.windows.filesystem.get_long_pathname' function is deprecated in favor of 'os.path.realpath' (Python 3.10+).
fix
Use os.path.realpath instead.
affects: >=5.6
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'jaraco.windows'
Package not installed or installed as 'jaraco-windows' but imported as 'jaraco.windows' (correct).
fix
Install the package: pip install jaraco-windows
AttributeError: module 'jaraco.windows' has no attribute 'registry'
Submodules are not automatically imported; you must import them explicitly.
fix
Use 'from jaraco.windows import registry' or 'import jaraco.windows.registry'.
ImportError: cannot import name 'winreg' from 'jaraco.windows'
The winreg alias was removed in version 5.0.
fix
Use 'from jaraco.windows.registry import RegistryKey' or similar.
Upgrade
Version history
5.10.0latest on PyPI · released May 29, 2025
Audit
Dependencies

No dependency data recorded yet.

Agent activity
6 hits · last 30 days
node
6
Resources
githubhttps://github.com/jaraco/jaraco.windows ↗
packagehttps://pypi.org/project/jaraco-windows/ ↗
jaraco-windows — pip install jaraco-windows · libregistry