cognihub-pygotemplate 0.0.2__cp310-cp310-macosx_12_0_arm64.whl

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

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

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

@@ -0,0 +1,77 @@
+"""go包的包装器."""
+import ctypes
+import json
+import os
+import platform
+import asyncio
+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
+
+    async def render_async(self, data: Dict[str, Any]) -> str:
+        """Asynchronously renders the template with the given data."""
+        return await asyncio.to_thread(self.render, data)

cognihub_pygotemplate-0.0.2.data/purelib/cognihub_pygotemplate/librenderer.h

@@ -0,0 +1,82 @@
+/* Code generated by cmd/cgo; DO NOT EDIT. */
+
+/* package command-line-arguments */
+
+
+#line 1 "cgo-builtin-export-prolog"
+
+#include <stddef.h>
+
+#ifndef GO_CGO_EXPORT_PROLOGUE_H
+#define GO_CGO_EXPORT_PROLOGUE_H
+
+#ifndef GO_CGO_GOSTRING_TYPEDEF
+typedef struct { const char *p; ptrdiff_t n; } _GoString_;
+#endif
+
+#endif
+
+/* Start of preamble from import "C" comments.  */
+
+
+
+
+/* End of preamble from import "C" comments.  */
+
+
+/* Start of boilerplate cgo prologue.  */
+#line 1 "cgo-gcc-export-header-prolog"
+
+#ifndef GO_CGO_PROLOGUE_H
+#define GO_CGO_PROLOGUE_H
+
+typedef signed char GoInt8;
+typedef unsigned char GoUint8;
+typedef short GoInt16;
+typedef unsigned short GoUint16;
+typedef int GoInt32;
+typedef unsigned int GoUint32;
+typedef long long GoInt64;
+typedef unsigned long long GoUint64;
+typedef GoInt64 GoInt;
+typedef GoUint64 GoUint;
+typedef size_t GoUintptr;
+typedef float GoFloat32;
+typedef double GoFloat64;
+#ifdef _MSC_VER
+#include <complex.h>
+typedef _Fcomplex GoComplex64;
+typedef _Dcomplex GoComplex128;
+#else
+typedef float _Complex GoComplex64;
+typedef double _Complex GoComplex128;
+#endif
+
+/*
+  static assertion to make sure the file is being used on architecture
+  at least with matching size of GoInt.
+*/
+typedef char _check_for_64_bit_pointer_matching_GoInt[sizeof(void*)==64/8 ? 1:-1];
+
+#ifndef GO_CGO_GOSTRING_TYPEDEF
+typedef _GoString_ GoString;
+#endif
+typedef void *GoMap;
+typedef void *GoChan;
+typedef struct { void *t; void *v; } GoInterface;
+typedef struct { void *data; GoInt len; GoInt cap; } GoSlice;
+
+#endif
+
+/* End of boilerplate cgo prologue.  */
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+extern char* RenderTemplate(char* templateStr, char* jsonData);
+extern void FreeString(char* str);
+
+#ifdef __cplusplus
+}
+#endif

cognihub_pygotemplate-0.0.2.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.2.dist-info/METADATA

@@ -0,0 +1,165 @@
+Metadata-Version: 2.1
+Name: cognihub-pygotemplate
+Version: 0.0.2
+Summary: A Python wrapper for Go's text/template engine via CGo
+Author-email: hsz <hsz1273327@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/HszGitea/CogniHub/cognihub_pygotemplate
+Project-URL: Repository, https://github.com/HszGitea/CogniHub/cognihub_pygotemplate
+Project-URL: Issues, https://github.com/HszGitea/CogniHub/cognihub_pygotemplate/issues
+Keywords: template,go,cgo,text-template,golang
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: General
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Go
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: coverage>=7.0; extra == "dev"
+Requires-Dist: wheel>=0.40; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+
+# 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 Workflow
+
+Full development cycle: Clean -> Build -> Type Check -> Test. Iterate until requirements are met, then package.
+
+### Clean
+
+```bash
+python setup.py clean
+```
+
+### Build
+
+```bash
+python setup.py build_py
+```
+
+### Type Check
+
+```bash
+# Use mypy for type checking
+python setup.py type_check [--strict]
+```
+
+### Test
+
+```bash
+# 运行所有测试
+python setup.py test
+
+# 或者执行单条测试
+python -m unittest tests.test_engine.TestGoTemplateEngine.test_render
+# 或者使用自定义测试运行器
+```
+
+### 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.2.dist-info/RECORD

@@ -0,0 +1,9 @@
+cognihub_pygotemplate-0.0.2.data/purelib/cognihub_pygotemplate/__init__.py,sha256=m7jMRYxrh0lXrkjTDzymWvHEHyOaMty9MW1CJK8MPxU,68
+cognihub_pygotemplate-0.0.2.data/purelib/cognihub_pygotemplate/engine.py,sha256=0mpSivMXp6D7RTqoZLdM7gN6hydp58UGMjgzHQP9gI8,2612
+cognihub_pygotemplate-0.0.2.data/purelib/cognihub_pygotemplate/librenderer.dylib,sha256=4lUqF8VRKT66Avm2GwL12tHeXOCQlu2MEd5k-Vq5AUE,3044338
+cognihub_pygotemplate-0.0.2.data/purelib/cognihub_pygotemplate/librenderer.h,sha256=qzF3oEGwKbkvXpAnRSHcIclMelEj6owWU6ryyoaP5tQ,1745
+cognihub_pygotemplate-0.0.2.dist-info/LICENSE,sha256=3XBD597f722-JFXQre9mI-le0_Ct3-Jcf6d70THzErM,1068
+cognihub_pygotemplate-0.0.2.dist-info/METADATA,sha256=Xn8deOVB3GRhQhCu4E56eAg-70uyVynp6_JFBjAfvls,4186
+cognihub_pygotemplate-0.0.2.dist-info/WHEEL,sha256=q0TPgUxajuMfSTFwO3317FclNU7HRupUtKlJk4ZUMOs,110
+cognihub_pygotemplate-0.0.2.dist-info/top_level.txt,sha256=JQidWgxvFtP5hdUE_k1A6f-P9ySD1LcxcsFCm5Zo-s4,22
+cognihub_pygotemplate-0.0.2.dist-info/RECORD,,

cognihub_pygotemplate-0.0.2.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_12_0_arm64
+

cognihub_pygotemplate-0.0.2.dist-info/top_level.txt

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