软件简介

一个极简的代码生成器，可以嵌进你自己的项目中。

• 自由软件: MIT license

• English Documentation: https://agen.readthedocs.com/en/

特性

• 简化到不能再简化的API

• 支持自定义 Jinja Env

• 可以作为命令行工具使用

无模版

agen 本身并不提供任何代码模版，只是提供一种能力，将代码模版化。如果需要使用已有的公开模版，请通过另一个优秀的开源库
Cookiecutter 。

为什么?

agen 十分轻量级，可以在几分钟内完美集成到你自己的项目中。

我非常喜爱 Cookiecutter
这个非常酷的项目，但它的绝大多数功能对我来说太重了。

安装

使用 pip 安装：

pip install agen

从源代码安装：

clone https://github.com/yufeiminds/agen.git
cd agen
python setup.py install

快速指南

在 agen 中，使用 jinja2 作为模版引擎进行渲染，所以，任何
jinja2 模版的特性都可以在agen中使用。

文件生成

from agen import ( string_render, render, generate, generate_dir ) # Render text from a templated string string_render('{{key}}', {'key': 'value'}) > 'value' cat template.py > {{key}} # Render text from a template file render('template.py', {'key': 'value'}) > 'value' # Generate file from a template file generate('template.py', 'output.py', {'key': 'value'}) # Content of output.py value

目录生成

假设我们有下面这样的目录：

directory
├── __init__.py
└── {{key}}.py

调用 generate_dir 函数：

generate_dir('directory', 'mydir', {'key': 'value'})

将生成

mydir
├── __init__.py
└── value.py

每一个纯文本文件都会被模版引擎渲染， context {‘key’: ‘value’} 也会在渲染时被自动传递。