198 lines
5.3 KiB
Python
198 lines
5.3 KiB
Python
#!/usr/bin/env python3.9
|
|
# -*- coding: utf-8 -*-
|
|
"""
|
|
JFinal Template Engine Python Implementation
|
|
=============================================
|
|
|
|
This is a Python 3.9+ implementation of the JFinal Template Engine (Enjoy).
|
|
|
|
Project Structure
|
|
-----------------
|
|
|
|
py_enjoy/
|
|
├── __init__.py # Main package initialization
|
|
├── kit/ # Utility classes
|
|
│ ├── StrKit.py # String utilities
|
|
│ ├── HashKit.py # Hash and encryption utilities
|
|
│ ├── Kv.py # Key-Value dictionary
|
|
│ ├── Okv.py # Ordered Key-Value dictionary
|
|
│ ├── Prop.py # Properties file handler
|
|
│ ├── PropKit.py # Properties file management
|
|
│ ├── TypeKit.py # Type conversion utilities
|
|
│ ├── TimeKit.py # Date and time utilities
|
|
│ ├── Func.py # Lambda function utilities
|
|
│ ├── ReflectKit.py # Reflection utilities
|
|
│ ├── JavaKeyword.py # Java keyword detection
|
|
│ └── SyncWriteMap.py # Thread-safe dictionary
|
|
│
|
|
├── proxy/ # Dynamic proxy classes
|
|
│ ├── ProxyClass.py # Proxy class information
|
|
│ ├── ProxyClassLoader.py # Proxy class loader
|
|
│ └── ProxyCompiler.py # Proxy class compiler
|
|
│
|
|
└── template/ # Template engine core
|
|
├── Engine.py # Main template engine
|
|
├── Template.py # Template rendering
|
|
├── Env.py # Template environment
|
|
├── EngineConfig.py # Engine configuration
|
|
├── Directive.py # Base directive class
|
|
├── TemplateException.py # Exception handling
|
|
│
|
|
├── expr/ # Expression parsing
|
|
│ └── ast/
|
|
│ ├── Expr.py # Expression base class
|
|
│ ├── Const.py # Constant expressions
|
|
│ ├── Compare.py # Comparison expressions
|
|
│ └── Arith.py # Arithmetic expressions
|
|
│
|
|
└── stat/ # Statement parsing
|
|
├── Scope.py # Execution scope
|
|
└── ast/
|
|
└── Stat.py # Statement base classes
|
|
|
|
Features
|
|
--------
|
|
|
|
1. **Template Engine**
|
|
- String template rendering
|
|
- File-based template loading
|
|
- Template caching and hot-reloading
|
|
- Shared functions and objects
|
|
|
|
2. **Expression Language**
|
|
- Arithmetic operations (+, -, *, /, %)
|
|
- Comparison operations (==, !=, >, <, >=, <=)
|
|
- Logical operations (&&, ||, !)
|
|
- Ternary expressions (condition ? true : false)
|
|
- Variable access and assignment
|
|
|
|
3. **Directives**
|
|
- #if/#else/#end - Conditional statements
|
|
- #for - Loop statements
|
|
- #define - Template functions
|
|
- #include - Template inclusion
|
|
- #set - Variable assignment
|
|
- Custom directive support
|
|
|
|
4. **Utility Classes**
|
|
- String manipulation (StrKit)
|
|
- Hash functions (HashKit)
|
|
- Type conversions (TypeKit)
|
|
- Date/time handling (TimeKit)
|
|
- Properties file management (PropKit)
|
|
- Key-Value containers (Kv, Okv)
|
|
|
|
Requirements
|
|
------------
|
|
|
|
- Python 3.9.0 or higher
|
|
- No external dependencies
|
|
|
|
Installation
|
|
------------
|
|
|
|
```bash
|
|
# Clone or download the project
|
|
cd py_enjoy
|
|
|
|
# No installation required, just add to PYTHONPATH
|
|
import sys
|
|
sys.path.append('/path/to/py_enjoy')
|
|
```
|
|
|
|
Quick Start
|
|
-----------
|
|
|
|
```python
|
|
from py_enjoy.template.Engine import Engine
|
|
from py_enjoy.kit.Kv import Kv
|
|
|
|
# Get the template engine
|
|
engine = Engine.use()
|
|
|
|
# Create a simple template
|
|
template_content = "Hello, #(name)! Today is #(date)."
|
|
template = engine.get_template_by_string(template_content)
|
|
|
|
# Render with data
|
|
data = Kv.of("name", "World").set("date", "2024-01-01")
|
|
result = template.render_to_string(data)
|
|
|
|
print(result) # Output: Hello, World! Today is 2024-01-01.
|
|
```
|
|
|
|
Advanced Usage
|
|
--------------
|
|
|
|
### Template with Logic
|
|
|
|
```python
|
|
template_content = """
|
|
#for(item in items)
|
|
#(item_index + 1). #(item.name) - #(item.price)
|
|
#if(item.is_last)
|
|
Total: #(total_price)
|
|
#end
|
|
#end
|
|
"""
|
|
|
|
data = Kv.of("items", [
|
|
{"name": "Apple", "price": 1.5, "is_last": False},
|
|
{"name": "Banana", "price": 0.75, "is_last": True}
|
|
]).set("total_price", 2.25)
|
|
```
|
|
|
|
### Custom Directives
|
|
|
|
```python
|
|
from py_enjoy.template.Directive import Directive
|
|
|
|
class UpperDirective(Directive):
|
|
def exec(self, env, scope, writer):
|
|
value = self.expr_list.eval(scope)
|
|
if value:
|
|
writer.write(str(value).upper())
|
|
```
|
|
|
|
Performance Considerations
|
|
--------------------------
|
|
|
|
1. **Template Caching**: Enable template caching in production
|
|
```python
|
|
engine.cache_string_template = True
|
|
```
|
|
|
|
2. **Dev Mode**: Disable in production
|
|
```python
|
|
engine.dev_mode = False
|
|
```
|
|
|
|
3. **Buffer Size**: Adjust for large outputs
|
|
```python
|
|
engine.set_buffer_size(8192)
|
|
```
|
|
|
|
Testing
|
|
-------
|
|
|
|
```bash
|
|
python test.py
|
|
```
|
|
|
|
License
|
|
-------
|
|
|
|
This project is licensed under the Apache License 2.0.
|
|
See the LICENSE file for details.
|
|
|
|
Credits
|
|
-------
|
|
|
|
Original Java implementation: James Zhan 詹波 (jfinal@126.com)
|
|
Python port: Automated conversion
|
|
"""
|
|
|
|
__version__ = "5.2.2"
|
|
__author__ = "James Zhan 詹波 (original), Python port by hello@miw.cn"
|
|
__license__ = "Apache License 2.0"
|