psdparse 0.1.0__cp313-cp313-win_amd64.whl

psdparse-0.1.0.dist-info/METADATA

@@ -0,0 +1,166 @@
+Metadata-Version: 2.2
+Name: psdparse
+Version: 0.1.0
+Summary: Fast PSD (Photoshop) reader/writer — C++17 core with pybind11 bindings
+Keywords: psd,photoshop,parser,image,graphics
+Author-Email: wamsoft <wtnbgo@gmail.com>
+License: MIT License
+         
+         Copyright (c) 2026 wamsoft
+         
+         Permission is hereby granted, free of charge, to any person obtaining a copy
+         of this software and associated documentation files (the "Software"), to deal
+         in the Software without restriction, including without limitation the rights
+         to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+         copies of the Software, and to permit persons to whom the Software is
+         furnished to do so, subject to the following conditions:
+         
+         The above copyright notice and this permission notice shall be included in all
+         copies or substantial portions of the Software.
+         
+         THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+         IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+         FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+         AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+         LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+         SOFTWARE.
+         
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: C++
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Multimedia :: Graphics :: Graphics Conversion
+Project-URL: Homepage, https://github.com/wamsoft/psdparse
+Project-URL: Repository, https://github.com/wamsoft/psdparse
+Project-URL: Issues, https://github.com/wamsoft/psdparse/issues
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# psdparse
+
+Pure C++17 PSD (Photoshop) reader/writer library, with pybind11-based Python bindings.
+
+- Lazy I/O: PSD pixel data is **not** copied into memory at parse time. Only the structural metadata (a few hundred KB even for large files) is read upfront; layer pixels are paged in on demand via mmap or stream callbacks.
+- Round-trip save: `load(p) -> save(q)` produces a byte-identical PSD file.
+- Python wrapper: `import psdparse` → `PSDFile.load(path) / layer_image(i) / merged_image() / save(path)`.
+
+The library was extracted from the [psdfile](https://github.com/wamsoft/psdfile) kirikiri plugin in 2026. psdfile now consumes this library as a submodule.
+
+## Architecture (quick read)
+
+See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for full details.
+
+```
+IteratorBase (psdbase.h, pure virtual — parser only sees this)
+├── MemoryReader   (psdparse.h)  ... mmap / contiguous buffer
+└── StreamReader   (psdparse.h)  ... arbitrary seekable stream
+    └── Source (pure virtual; subclass per backend)
+        ├── IStreamSource              ... std::istream
+        └── (your custom Source)       ... e.g. iTJSBinaryStream wrapper
+
+WriterBase (psdwrite.h, pure virtual — symmetric to IteratorBase)
+└── FileWriter (FILE*)
+```
+
+`psd::PSDFile::load(const char *path)` mmaps a local file. `loadFromStream(std::istream&)` / `loadFromReader(IteratorBase&)` accept arbitrary I/O. `save(const char *path)` writes the loaded data back as PSD.
+
+All public path arguments are **UTF-8** (`char *`). On Win32, conversion to UTF-16 happens internally via `psd::utf8ToWide` (inline in psdbase.h).
+
+## Install (Python)
+
+```bash
+pip install psdparse          # once published to PyPI
+```
+
+Build from source — needs only a C++17 compiler + CMake 3.16+, **no vcpkg**:
+
+```bash
+pip install .                 # or:  pip wheel . -w dist
+```
+
+`zlib` is taken from the system if present, otherwise fetched from source by
+CMake (`FetchContent`), so no package manager is required. Packaging uses
+[scikit-build-core](https://scikit-build-core.readthedocs.io/); cross-platform
+wheels are built in CI (`.github/workflows/wheels.yml`, cibuildwheel).
+
+## Build (C++ library / CLI)
+
+Requires CMake 3.16+ and a C++17 compiler. **vcpkg is no longer needed.**
+
+```powershell
+# C++ library + CLI (static CRT)
+cmake --preset x64-windows
+cmake --build --preset x64-windows --config Release
+
+# C++ library + Python module (dynamic CRT, matches CPython)
+cmake --preset x64-windows-python
+cmake --build --preset x64-windows-python --config Release
+```
+
+`Makefile` is a thin wrapper:
+
+```
+make PRESET=x64-windows prebuild build
+make PRESET=x64-windows-python prebuild build
+```
+
+Build artifacts:
+- `build/x64-windows/psdparse/Release/psdparse_cli.exe`
+- `build/x64-windows-python/python/Release/psdparse.cp312-win_amd64.pyd`
+
+Only dependency: `zlib` (system, or auto-fetched from source).
+
+## Python API
+
+```python
+import psdparse
+
+p = psdparse.PSDFile()
+p.load(r"path/to/file.psd")   # mmap-backed
+
+print(p.header.width, p.header.height, len(p.layers))
+for layer in p.layers:
+    print(layer.name_unicode, layer.blend_mode.name, layer.opacity)
+
+bgra = p.merged_image()                # bytes, BGRA, 4*W*H
+layer_bgra = p.layer_image(0, "masked") # bytes, BGRA, 4*w*h
+
+p.save(r"out.psd")              # byte-identical round-trip
+```
+
+Full API reference: [docs/PYTHON_API.md](docs/PYTHON_API.md).
+
+## Tests
+
+Tests live under `tests/` and use [pytest](https://docs.pytest.org/). They need two sample PSDs at the repo root (not in git — see below).
+
+```powershell
+# After building with x64-windows-python preset:
+python -m pytest -v
+```
+
+### Sample PSDs
+
+The 27 pytest tests use these files:
+
+| File | Size | Description |
+|---|---|---|
+| `UI-PSDサンプル.psd` | 800×600, 50 layers, ~2 MB | UI button mock-up. Folder groups, transparent overlays. |
+| `園部由夏_a.psd` | 2500×3500, 28 layers, ~21 MB | Illustration. PASS_THROUGH groups, Unicode layer names (luni records). |
+
+Place them at the repo root (the conftest.py also checks `tests/data/` first). They are listed in `.gitignore`. If you can't source them, the tests will skip rather than fail.
+
+## tools/psd_export.py
+
+```
+python tools/psd_export.py input.psd [--out-dir DIR] [--mode masked|image|mask]
+```
+
+Outputs `layers.json` (full layer metadata), `merged.png` (composite), and per-layer PNGs.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

psdparse-0.1.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+psdparse.cp313-win_amd64.pyd,sha256=mPsKVtZfaSK6ZUifdL37cyD06BY1UueOx9g46Yg9feM,408064
+psdparse-0.1.0.dist-info/METADATA,sha256=1slTZcbKkHh_xP-zMDV9Gm25fWlWrgEyQkZXyH53wl0,6485
+psdparse-0.1.0.dist-info/WHEEL,sha256=UZrbbE4r80xj7Ncfa6JoeTVe-77bdXLkKUA63V8pKWQ,106
+psdparse-0.1.0.dist-info/licenses/LICENSE,sha256=B1u-g7n_GOPvjE1noRJE13ryitgihTr5eThpwQlkmSU,1085
+psdparse-0.1.0.dist-info/RECORD,,

psdparse-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: scikit-build-core 0.12.2
+Root-Is-Purelib: false
+Tag: cp313-cp313-win_amd64
+

psdparse-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wamsoft
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.