Registry / data / polyfile-weave

polyfile-weave

JSON →
library0.5.9pypypi✓ verified 27d ago

Polyfile Weave is a utility designed to recursively map the structure of a file, providing a detailed breakdown of its components and their relationships. It helps in understanding complex binary formats by visualizing their internal layout. The current version is 0.5.9. Releases are infrequent, often addressing bug fixes or minor improvements.

pip install polyfile-weave
INSTALL
IMPORT
SIG · POLYFILE-WEAVE
P
polyfile-weave
datapythonv0.5.9
Install
6.0s avg
Import
—
Disk
102MB
Pass rate
10/ 10
Env Coverage10 / 10
glibc
3.9–3.13
musl
3.9–3.13
Install & Compatibility
Where this runs
tested against v0.5.9 · 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 · 103.3MB
glibc
py 3.10–3.95 runs
installs and imports cleanly · install 6.0s · import 0.000s · 107MB
102MB installed
● package 102MB
Code
Verified usage

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

weave
✓ from polymerge import weave
✗ from polymerge import weave
PolyfileWeave
✓ from polymerge import polymerge
✗ from polymerge import weave

This quickstart demonstrates how to use `polyfile-weave` to analyze a dummy binary file. It creates a simple file, runs the `weave` function, and directs the output (including HTML visualizations and JSON structure) to a specified directory.

import os from pathlib import Path from polyfile.weave import weave # Create a dummy file for demonstration purposes dummy_file_content = b"This is some dummy text. It might contain some structures like PK\x03\x04 to simulate a zip header, or just plain text." dummy_filename = "dummy_test_file.bin" output_dir = "weave_output_results" # Ensure the dummy file exists if not Path(dummy_filename).exists(): with open(dummy_filename, "wb") as f: f.write(dummy_file_content) print(f"Analyzing file: '{dummy_filename}'") try: # Create the output directory if it doesn't exist Path(output_dir).mkdir(parents=True, exist_ok=True) # Run the weaving process weave.weave(dummy_filename, output_dir=output_dir) print(f"Analysis complete. Detailed results are in the directory: '{output_dir}'") print("Look for 'index.html' or 'structure.json' within this directory.") except Exception as e: print(f"An error occurred during the file weaving process: {e}") finally: # Optional cleanup: remove the dummy file and output directory # import shutil # if Path(dummy_filename).exists(): # os.remove(dummy_filename) # if Path(output_dir).exists(): # shutil.rmtree(output_dir) pass
weave --version
Debug
Known issues
breakingOlder versions (prior to v0.1.7) had known import issues related to `pdfminer` (specifically `pdfminer.six`). This could lead to crashes when processing PDF files.
fix
Upgrade to version `0.1.7` or later. `pip install --upgrade polyfile-weave`.
affects: <0.1.7
deprecatedVersion 0.5.9 release notes indicate 'Fix vulnerabilities and deprecations'. While specific public API deprecations are not detailed, it implies that relying on older versions might lead to using deprecated internal functionality or facing security vulnerabilities.
fix
Always use the latest stable version of `polyfile-weave` to ensure security patches and compatibility with updated dependencies. `pip install --upgrade polyfile-weave`.
affects: <0.5.9
gotchaThe `output_dir` generated by `weave.weave()` for complex files (e.g., large PDFs, archives with many embedded files) can consume significant disk space and contain numerous files. Be mindful of disk usage, especially in automated or constrained environments.
fix
Monitor disk space when processing large or complex files. Consider periodically cleaning up generated output directories or using temporary file systems.
affects: All versions
gotcha`polyfile-weave` heavily relies on `polyfile` for parsing and `pdfminer.six` for PDF-specific analysis. Users might need to be familiar with the configurations or limitations of these underlying libraries for optimal results, especially when dealing with unusual or malformed file types.
fix
Consult the documentation for `polyfile` and `pdfminer.six` if encountering issues with specific file formats or parsing behaviors. Ensure their respective requirements are met.
affects: All versions
Upgrade
Version history
0.5.9latest on PyPI · released Jan 22, 2026
Audit
Dependencies
polyfilerequiredCore dependency for file parsing and structure definition.
hexdumprequiredUsed for generating hex dumps within the analysis process.
pdfminer.sixrequiredProvides PDF parsing capabilities; critical for PDF file analysis.
Agent activity
15 hits · last 30 days
node
14
Resources
polyfile-weave — pip install polyfile-weave · libregistry