lodfile 0.1.0__tar.gz

lodfile-0.1.0/PKG-INFO

@@ -0,0 +1,56 @@
+Metadata-Version: 2.4
+Name: lodfile
+Version: 0.1.0
+Summary: Read and write Heroes of Might and Magic III .lod archives with a zipfile-like API
+Keywords: lod,homm3,hota,heroes3,archive
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Provides-Extra: core
+
+# lodfile
+
+Read and write Heroes of Might and Magic III (incl. HotA) `.lod` archives, such as
+`H3Bitmap.lod`, with an API modelled on `zipfile` / `tarfile`.
+
+## Install
+
+```bash
+pip install lodfile[core]
+```
+
+The core is pure standard library, no dependencies.
+
+## Usage
+
+```python
+import lodfile
+
+with lodfile.LodFile("H3Bitmap.lod") as lod:
+    print(lod.namelist())
+    data = lod.read("Adventure.def")
+    lod.extract("Adventure.def", "out/")
+    lod.extractall("out/")
+
+# Create / append
+with lodfile.LodFile("my.lod", "w") as lod:
+    lod.write("hero.pcx")
+    lod.writestr("notes.txt", "hello")
+
+with lodfile.LodFile("my.lod", "a") as lod:
+    lod.write("extra.pcx")
+```
+
+CLI:
+
+```bash
+lodfile list H3Bitmap.lod
+lodfile extract H3Bitmap.lod -d out/
+lodfile create my.lod a.pcx b.pcx
+```
+
+## Format
+
+Little endian. 92-byte header (`LOD\0`, type, entry count, 80 bytes padding), then
+32-byte entries (16-byte name, offset, size, type, compressed size), then data.
+Compressed entries are zlib streams (compressed size `0` means stored raw).
+Names are case-insensitive and limited to 16 bytes.

lodfile-0.1.0/README.md

@@ -0,0 +1,47 @@
+# lodfile
+
+Read and write Heroes of Might and Magic III (incl. HotA) `.lod` archives, such as
+`H3Bitmap.lod`, with an API modelled on `zipfile` / `tarfile`.
+
+## Install
+
+```bash
+pip install lodfile[core]
+```
+
+The core is pure standard library, no dependencies.
+
+## Usage
+
+```python
+import lodfile
+
+with lodfile.LodFile("H3Bitmap.lod") as lod:
+    print(lod.namelist())
+    data = lod.read("Adventure.def")
+    lod.extract("Adventure.def", "out/")
+    lod.extractall("out/")
+
+# Create / append
+with lodfile.LodFile("my.lod", "w") as lod:
+    lod.write("hero.pcx")
+    lod.writestr("notes.txt", "hello")
+
+with lodfile.LodFile("my.lod", "a") as lod:
+    lod.write("extra.pcx")
+```
+
+CLI:
+
+```bash
+lodfile list H3Bitmap.lod
+lodfile extract H3Bitmap.lod -d out/
+lodfile create my.lod a.pcx b.pcx
+```
+
+## Format
+
+Little endian. 92-byte header (`LOD\0`, type, entry count, 80 bytes padding), then
+32-byte entries (16-byte name, offset, size, type, compressed size), then data.
+Compressed entries are zlib streams (compressed size `0` means stored raw).
+Names are case-insensitive and limited to 16 bytes.

lodfile-0.1.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "lodfile"
+version = "0.1.0"
+description = "Read and write Heroes of Might and Magic III .lod archives with a zipfile-like API"
+readme = "README.md"
+requires-python = ">=3.8"
+dependencies = []
+keywords = ["lod", "homm3", "hota", "heroes3", "archive"]
+
+[project.optional-dependencies]
+# The core is pure standard library; this extra is intentionally empty so
+# that `pip install lodfile[core]` works and stays dependency-free.
+core = []
+
+[project.scripts]
+lodfile = "src.__main__:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

lodfile-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

lodfile-0.1.0/src/lodfile.egg-info/PKG-INFO

@@ -0,0 +1,56 @@
+Metadata-Version: 2.4
+Name: lodfile
+Version: 0.1.0
+Summary: Read and write Heroes of Might and Magic III .lod archives with a zipfile-like API
+Keywords: lod,homm3,hota,heroes3,archive
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Provides-Extra: core
+
+# lodfile
+
+Read and write Heroes of Might and Magic III (incl. HotA) `.lod` archives, such as
+`H3Bitmap.lod`, with an API modelled on `zipfile` / `tarfile`.
+
+## Install
+
+```bash
+pip install lodfile[core]
+```
+
+The core is pure standard library, no dependencies.
+
+## Usage
+
+```python
+import lodfile
+
+with lodfile.LodFile("H3Bitmap.lod") as lod:
+    print(lod.namelist())
+    data = lod.read("Adventure.def")
+    lod.extract("Adventure.def", "out/")
+    lod.extractall("out/")
+
+# Create / append
+with lodfile.LodFile("my.lod", "w") as lod:
+    lod.write("hero.pcx")
+    lod.writestr("notes.txt", "hello")
+
+with lodfile.LodFile("my.lod", "a") as lod:
+    lod.write("extra.pcx")
+```
+
+CLI:
+
+```bash
+lodfile list H3Bitmap.lod
+lodfile extract H3Bitmap.lod -d out/
+lodfile create my.lod a.pcx b.pcx
+```
+
+## Format
+
+Little endian. 92-byte header (`LOD\0`, type, entry count, 80 bytes padding), then
+32-byte entries (16-byte name, offset, size, type, compressed size), then data.
+Compressed entries are zlib streams (compressed size `0` means stored raw).
+Names are case-insensitive and limited to 16 bytes.

lodfile-0.1.0/src/lodfile.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+README.md
+pyproject.toml
+src/lodfile.egg-info/PKG-INFO
+src/lodfile.egg-info/SOURCES.txt
+src/lodfile.egg-info/dependency_links.txt
+src/lodfile.egg-info/entry_points.txt
+src/lodfile.egg-info/requires.txt
+src/lodfile.egg-info/top_level.txt

lodfile-0.1.0/src/lodfile.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

lodfile-0.1.0/src/lodfile.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+lodfile = src.__main__:main

lodfile-0.1.0/src/lodfile.egg-info/requires.txt

@@ -0,0 +1,2 @@
+
+[core]

lodfile-0.1.0/src/lodfile.egg-info/top_level.txt

@@ -0,0 +1 @@
+