reef-beet-plugin 1.0.0b1__py3-none-any.whl

reef/__init__.py

@@ -0,0 +1,7 @@
+__version__ = "1.0.0-beta1"
+
+__all__ = [
+    "reef"
+]
+
+from .plugin import *

reef/options.py

@@ -0,0 +1,11 @@
+from beet import PluginOptions
+from pydantic import ConfigDict
+
+class ReefPluginOptions(PluginOptions):
+    model_config = ConfigDict(extra="ignore")
+
+    tint: int | None = None
+    cache_timeout_hours: int = 24
+
+class PdfPluginOptions(PluginOptions):
+    poppler_path: str | None = None

reef/pdf.py

@@ -0,0 +1,191 @@
+import pdf2image
+from PIL import Image
+from pathlib import Path
+from typing import ClassVar, List, Any
+from beet import (
+    Context, 
+    configurable,
+    PluginOptions, 
+    File, 
+    NamespaceFileScope, 
+    Drop, 
+    ResourcePack, 
+    Model, 
+    ItemModel, 
+    Texture
+)
+from .options import ReefPluginOptions, PdfPluginOptions
+from tempfile import TemporaryDirectory
+import shutil
+import logging
+
+__all__ = ["pdf"]
+
+PDF_NAMESPACE = "reef/pdf"
+logger = logging.getLogger(PDF_NAMESPACE)
+
+# TODO: add poppler path detection
+
+
+def create_reef_pdf_namespace(ctx: Context):
+    class ReefPdf(File):
+        """Class representing a Reef PDF file."""
+
+        scope: ClassVar[NamespaceFileScope] = ("reef",)
+        extension: ClassVar[str] = ".pdf"
+
+        reef_opts = ctx.validate("reef", ReefPluginOptions)
+        pdf_opts = ctx.validate("reef.pdf", PdfPluginOptions)
+
+        def bind(self, pack: ResourcePack, path: str):
+            super().bind(pack, path)
+
+            # Variables -----------
+
+            namespace, _, path = path.partition(":")
+            pdf_path = Path(self.ensure_source_path())
+            poppler_path: dict[str, Any] = {"poppler_path": self.pdf_opts.poppler_path} if self.pdf_opts.poppler_path is not None else {}
+
+            # ---------------------
+
+            # Start to build the file
+            logger.debug(f"Building: {pdf_path}")
+
+            # Cache the original PDF
+            ctx.cache[PDF_NAMESPACE].download(pdf_path.as_uri())
+            logger.debug("Cached pdf %s (%s)", f"{namespace}:{path}", pdf_path)
+
+            # Cache the images if we didn't hit the cache
+            if ctx.cache[PDF_NAMESPACE].has_changed(pdf_path):
+                logger.debug("Recaching image files...")
+                with TemporaryDirectory() as temp_dir:
+                    # Convert the PDF to a list of Images
+
+                    uncached_images: List[str] = pdf2image.convert_from_path(
+                        pdf_path=pdf_path,
+                        fmt="png",
+                        output_folder=temp_dir,
+                        thread_count=4,
+                        paths_only=True,
+                        **poppler_path
+                    ) # type: ignore
+
+                    # Cache the images
+                    with ctx.cache[PDF_NAMESPACE] as cache:
+                        cache.timeout(hours=self.reef_opts.cache_timeout_hours)
+                        
+                        for i in range(0, len(uncached_images)):
+                            image_path = uncached_images[i]
+
+                            cache_path = cache.get_path(f"{namespace}:{path}/{i}.png")
+                            
+                            shutil.copyfile(image_path, cache_path)
+
+                            logger.debug("Cached %s (%s)", f"{namespace}:{path}/{i}.png", cache_path)
+
+                logger.debug("Done caching!")
+            
+            # Get PDF debug
+            # NOTE: oh my god why is pdf2image typed so horribly
+            pdf_info = pdf2image.pdfinfo_from_path(
+                pdf_path=str(pdf_path),
+                **poppler_path
+            )
+
+            # Put the cached images into a list
+            images: List[Image.Image] = []
+
+            with ctx.cache[PDF_NAMESPACE] as cache:
+                logger.debug("Loading images from cache...")
+                for i in range(0, pdf_info["Pages"]):
+                    cache_path = cache.get_path(f"{namespace}:{path}/{i}.png")
+                    
+                    with Image.open(cache_path) as img:
+                        images.append(img.copy())
+                        logger.debug("Copied %s (%s)", f"{namespace}:{path}/{i}.png", cache_path)
+
+            # Generate the resource pack assets
+            self.generate_assets(pack, namespace, path, images)
+
+            # Prevent the PDF itself from getting put into the resource pack
+            raise Drop()
+
+        def generate_assets(
+            self, 
+            pack: ResourcePack, 
+            namespace: str, 
+            path: str, 
+            images: List[Image.Image]
+        ) -> None:
+            resource_location_path = f"reef/mini/{path}"
+
+            # Calculate the transformation matrix
+            image_size = images[0].size
+            offset = (
+                0.5 - image_size[0] / 16,
+                0.5 - image_size[1] / 16
+            )
+            transformation_matrix = [
+                image_size[0], 0,            0, offset[0], 
+                0,            image_size[1], 0, offset[1], 
+                0,            0,            1,       0.5, 
+                0,            0,            0,       1
+            ]
+
+            # File generation
+            logger.debug("Building resource pack files...")
+
+            item_model_entries = []
+
+            for i in range(0, len(images)):
+                logger.debug("Bulding %s", f"{resource_location_path}/{i}")
+                image = images[i]
+                
+                # Texture at `assets/<ns>/textures/item/reef/mini/<pdf_name>/<page>`
+                pack[namespace].textures[f"item/{resource_location_path}/{i}"] = Texture(image)
+
+                # Model at `assets/<ns>/models/item/reef/mini/<pdf_name>/<page>`
+                pack[namespace].models[f"item/{resource_location_path}/{i}"] = Model({
+                    "credit": "Generated with Reef",
+                    "parent": "reef:item/element_base",
+                    "textures": {
+                        "image": f"{namespace}:{resource_location_path}/{i}",
+                    }
+                })
+
+                # Build the item model entries
+                tints_field = {
+                    "tints": [{
+                        "type": "minecraft:constant",
+                        "value": self.reef_opts.tint
+                    }]
+                } if self.reef_opts.tint is not None else {}
+                item_model_entries.append({
+                    "threshold": i,
+                    "model": {
+                        "type": "minecraft:model",
+                        "model": f"{namespace}:{resource_location_path}/{i}",
+                        **tints_field
+                    }
+                })
+
+            # Item Model at `assets/<ns>/items/reef/mini/<pdf_name>`
+            pack[namespace].item_models[f"{resource_location_path}"] = ItemModel({
+                "model": {
+                    "type": "minecraft:range_dispatch",
+                    "property": "minecraft:custom_model_data",
+                    "index": 0,
+                    "entries": item_model_entries,
+                    "transformation": transformation_matrix
+                }
+            })
+
+            logger.debug("Done building resource pack files!")
+
+
+    return ReefPdf
+
+def pdf(ctx: Context):
+    """Adds support for Reef PDF asset files to generate Reef Mini compatible assets."""
+
+    ctx.assets.extend_namespace.append(create_reef_pdf_namespace(ctx))

reef/plugin.py

@@ -0,0 +1,38 @@
+from beet import Context, Model, PluginOptions
+import logging
+
+from .pdf import pdf
+
+__all__ = [
+    "reef",
+    "beet_default"
+]
+
+logger = logging.getLogger("reef")
+
+def beet_default(ctx: Context):
+    ctx.require(reef)
+    ctx.require(pdf)
+
+def reef(ctx: Context):
+    """Initializes the Reef plugin system"""
+    logger.debug("Creating base assets...")
+    
+    ctx.assets["reef"].models["item/element_base"] = Model({
+    	"credit": "Generated with Reef",
+    	"ambientocclusion": False,
+    	"elements": [
+    		{
+    			"from": [0, 0, 0],
+    			"to": [1, 1, 0],
+    			"shade": False,
+    			"light_emission": 15,
+    			"rotation": {"angle": 0, "axis": "y", "origin": [0, 0, 0]},
+    			"faces": {
+    				"north": {"uv": [0, 0, 16, 16], "texture": "#image", "tintindex": 0}
+    			}
+    		}
+    	]
+    })
+    
+    logger.debug("Created reef:item/element_base")

reef_beet_plugin-1.0.0b1.dist-info/METADATA

@@ -0,0 +1,19 @@
+Metadata-Version: 2.4
+Name: reef-beet-plugin
+Version: 1.0.0b1
+Summary: Beet plugin to autogenerate Reef compatible data packs and resource packs from PDF and Google Slides presentations.
+Keywords: beet,minecraft,datapack,resource_pack,presentation,reef
+Author: Trplnr
+Author-email: Trplnr <triopane30@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Requires-Dist: beet>=0.115.0
+Requires-Dist: pdf2image>=1.17.0
+Requires-Python: >=3.14
+Project-URL: Homepage, https://github.com/Trioplane/reef
+Project-URL: Issues, https://github.com/Trioplane/reef/issues
+Project-URL: Repository, https://github.com/Trioplane/reef/blob/main/packages/reef
+Description-Content-Type: text/markdown
+
+# Reef Beet Plugin
+> Beet plugin to autogenerate Reef compatible data packs and resource packs from PDF and Google Slides presentations.

reef_beet_plugin-1.0.0b1.dist-info/RECORD

@@ -0,0 +1,9 @@
+reef/__init__.py,sha256=45sG9-60c5g67pa6p2w0JqU7jQNlepSuXOzVFVDBLgA,82
+reef/gslides.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+reef/options.py,sha256=sVwpC9CqKkMCrB2Nb9xgB_-ysqPOMsC5qiMyB1_sE74,298
+reef/pdf.py,sha256=lqQ7JZRpuPn3rHZy4Pa7OzImbQDV1c7CuZ9bZTkHeSI,7119
+reef/plugin.py,sha256=4qfF2zz_HToZyuroODyLJtBA6Od096QI-AwdZZV1bPc,908
+reef_beet_plugin-1.0.0b1.dist-info/licenses/LICENSE,sha256=b8M9UbMguBmohcWXAcKjoOjSmohcUSFdBwx76yrKbc0,1083
+reef_beet_plugin-1.0.0b1.dist-info/WHEEL,sha256=wXwAVsgVaOZ_pwDFqQm5Rd6PID-Fc74nkLc8X8gHiDo,81
+reef_beet_plugin-1.0.0b1.dist-info/METADATA,sha256=zPl7BoKPvaVQOwgQ7yNbKqRMdbxA--d0iYZ37S90efY,824
+reef_beet_plugin-1.0.0b1.dist-info/RECORD,,

reef_beet_plugin-1.0.0b1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.11.19
+Root-Is-Purelib: true
+Tag: py3-none-any

reef_beet_plugin-1.0.0b1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Trplnr
+
+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.