cognihub-pygotemplate 0.0.1__cp310-cp310-macosx_11_0_x86_64.whl

cognihub_pygotemplate-0.0.1.data/purelib/cognihub_pygotemplate/__init__.py

@@ -0,0 +1,3 @@
+from .engine import GoTemplateEngine
+
+__all__ = ["GoTemplateEngine"]

cognihub_pygotemplate-0.0.1.data/purelib/cognihub_pygotemplate/engine.py

@@ -0,0 +1,72 @@
+"""go包的包装器."""
+import ctypes
+import json
+import os
+import platform
+from typing import Dict, Any
+
+
+class GoTemplateEngine:
+    """
+    A Python interface to Go's text/template engine.
+    It relies on a pre-compiled shared library managed by the package installation process.
+    """
+    _go_lib = None
+    _free_func = None
+
+    def __init__(self, template_content: str):
+        self._load_library()
+        self.template_content = template_content
+
+    @classmethod
+    def _load_library(cls) -> None:
+        """Loads the pre-compiled Go shared library."""
+        if cls._go_lib:
+            return
+
+        lib_name = "librenderer.so"
+        if platform.system() == "Windows":
+            lib_name = "renderer.dll"
+        elif platform.system() == "Darwin":
+            lib_name = "librenderer.dylib"
+
+        # 库文件应该和这个Python文件在同一个目录下
+        lib_path = os.path.join(os.path.dirname(__file__), lib_name)
+
+        if not os.path.exists(lib_path):
+            raise FileNotFoundError(
+                f"Shared library not found at {lib_path}. "
+                "The package may not have been installed correctly. "
+                "Try reinstalling with 'pip install .'"
+            )
+
+        cls._go_lib = ctypes.CDLL(lib_path)
+
+        cls._go_lib.RenderTemplate.argtypes = [ctypes.c_char_p, ctypes.c_char_p]
+        cls._go_lib.RenderTemplate.restype = ctypes.c_char_p
+
+        cls._go_lib.FreeString.argtypes = [ctypes.c_char_p]
+        cls._go_lib.FreeString.restype = None
+
+        cls._free_func = cls._go_lib.FreeString
+
+    def render(self, data: Dict[str, Any]) -> str:
+        """Renders the template with the given data."""
+        if not self._go_lib:
+            raise RuntimeError("Go renderer library is not loaded.")
+
+        template_bytes = self.template_content.encode('utf-8')
+        json_data_bytes = json.dumps(data).encode('utf-8')
+
+        result_ptr = self._go_lib.RenderTemplate(template_bytes, json_data_bytes)
+
+        try:
+            rendered_string = ctypes.string_at(result_ptr).decode('utf-8')
+        finally:
+            if self._free_func and result_ptr:
+                self._free_func(result_ptr)
+
+        if rendered_string.startswith(("JSON_ERROR:", "TEMPLATE_PARSE_ERROR:", "TEMPLATE_EXECUTE_ERROR:")):
+            raise ValueError(f"Error from Go renderer: {rendered_string}")
+
+        return rendered_string

cognihub_pygotemplate-0.0.1.dist-info/LICENSE

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

cognihub_pygotemplate-0.0.1.dist-info/LICENSE copy

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

cognihub_pygotemplate-0.0.1.dist-info/METADATA

@@ -0,0 +1,118 @@
+Metadata-Version: 2.1
+Name: cognihub-pygotemplate
+Version: 0.0.1
+Summary: A Python wrapper for Go's text/template engine via CGo
+Author-email: hsz <hsz1273327@gmail.com>
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: LICENSE copy
+
+# cognihub_pygotemplate
+
+A simple, high-performance Python wrapper for Go's native `text/template` engine.
+
+*[中文文档](README_CN.md)*
+
+This library allows you to use Go templates (like those from Ollama) directly in your Python projects with 100% compatibility, by calling a compiled Go shared library via CGo and Python's `ctypes`.
+
+## Prerequisites
+
+- Python 3.10+
+- Go compiler (1.21+ recommended) installed and available in your system's PATH
+
+## Installation
+
+### From PyPI (Recommended)
+
+```bash
+pip install cognihub_pygotemplate
+```
+
+### From Source
+
+```bash
+# Clone the repository
+git clone https://github.com/hsz1273327/cognihub_pygotemplate.git
+cd cognihub_pygotemplate
+
+# Install the package
+pip install .
+```
+
+The library will automatically compile the Go source code during installation.
+
+## Usage
+
+```python
+from cognihub_pygotemplate import GoTemplateEngine
+
+# Your Go template string
+template_str = """
+Hello, {{.Name}}!
+{{if .Items}}You have {{len .Items}} items:
+{{range .Items}}- {{.}}
+{{end}}{{else}}You have no items.{{end}}
+"""
+
+# Data to render
+data = {
+    "Name": "World",
+    "Items": ["apple", "banana", "cherry"]
+}
+
+try:
+    # Create an engine instance
+    engine = GoTemplateEngine(template_str)
+
+    # Render the template
+    output = engine.render(data)
+
+    print(output)
+
+except (RuntimeError, ValueError) as e:
+    print(f"An error occurred: {e}")
+
+```
+
+## Development Build
+
+```bash
+python setup.py build_py
+```
+
+## Build Wheels
+
+```bash
+# For current platform
+python setup.py bdist_wheel
+```
+
+## Features
+
+- **100% Go Template Compatibility**: Uses Go's native `text/template` engine
+- **High Performance**: Direct CGo bindings with minimal overhead
+- **Cross-Platform**: Supports Windows, macOS (Intel & ARM64), and Linux
+- **Memory Safe**: Proper memory management to prevent leaks
+- **Easy Integration**: Simple Python API that feels native
+
+## Error Handling
+
+The library provides clear error messages for common issues:
+
+- `JSON_ERROR`: Invalid data format
+- `TEMPLATE_PARSE_ERROR`: Template syntax errors
+- `TEMPLATE_EXECUTE_ERROR`: Runtime template execution errors
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+

cognihub_pygotemplate-0.0.1.dist-info/RECORD

@@ -0,0 +1,9 @@
+cognihub_pygotemplate-0.0.1.data/purelib/cognihub_pygotemplate/__init__.py,sha256=m7jMRYxrh0lXrkjTDzymWvHEHyOaMty9MW1CJK8MPxU,68
+cognihub_pygotemplate-0.0.1.data/purelib/cognihub_pygotemplate/engine.py,sha256=MVbb9teb4RT31OeaiQYmD5UeatQitjMlmIfz8wlQPS8,2404
+cognihub_pygotemplate-0.0.1.data/purelib/cognihub_pygotemplate/librenderer.dylib,sha256=Xp4kakqqGz_Z3n1sW4QT1Re21Q12EbLD3Dlv1_g96kc,3101832
+cognihub_pygotemplate-0.0.1.dist-info/LICENSE,sha256=3XBD597f722-JFXQre9mI-le0_Ct3-Jcf6d70THzErM,1068
+cognihub_pygotemplate-0.0.1.dist-info/LICENSE copy,sha256=RbdVjM52einQjUtV_pIQV46Dh-4NV3Cy5mWQDO-j3dw,1069
+cognihub_pygotemplate-0.0.1.dist-info/METADATA,sha256=N-g9NusJSnx9e8LRFtXVVeOwrTLi2ohoiRDKIhKotRM,2741
+cognihub_pygotemplate-0.0.1.dist-info/WHEEL,sha256=im94mj9ajrXHvJF8-uHc2evLxe5YxO6Ibw8BaRt-Sug,111
+cognihub_pygotemplate-0.0.1.dist-info/top_level.txt,sha256=JQidWgxvFtP5hdUE_k1A6f-P9ySD1LcxcsFCm5Zo-s4,22
+cognihub_pygotemplate-0.0.1.dist-info/RECORD,,

cognihub_pygotemplate-0.0.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.45.1)
+Root-Is-Purelib: false
+Tag: cp310-cp310-macosx_11_0_x86_64
+

cognihub_pygotemplate-0.0.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+cognihub_pygotemplate