Borax - python农历&节日工具库 - 中文数字/设计模式/树形结构
Borax 是一个Python3工具集合库。
本文档的所有内容都是基于最新版本，函数和类签名的变化参见各自的文档说明。
本项目代码仓库位于 https://github.com/kinegratii/borax/ 。同时使用 Gitee 作为国内镜像，位于 https://gitee.com/kinegratii/borax 。
话题(Topics)
- Borax.Calendar: 农历 | 节日(festivals2) | 日期节日序列化 | 生日 | 节日界面库 | 工具类
- Borax.Datasets: 数据连接(Join) | 列选择器(fetch)
- Borax.DataStructures: 树形结构 | cjson
- Borax.Numbers:: 中文数字 | 百分数
- Borax.Pattern: 单例模式 | 选项Choices
- 其他: 序列号生成器(Pool) | Tkinter界面
- 已废弃: 节日
文章(Posts)
开发(Development)
- 开发环境: python3.11.7
- 集成测试环境: python3.9 - 3.12
- 代码仓库：Github | Gitee (镜像)
- 项目开发: 版本日志 | 技术文档(外链)
- 发布日志: v3.5 | v3.5.6 | v4.0.0 | v4.1.0
快速开始(Quickstart)
安装
Borax 的 python 版本要求如下
| borax 版本 | python版本 | 维护状态 |
|---|---|---|
| 4.1.x | 3.9+ | 维护开发 |
| 4.0.0 | 3.7+ | 维护至2024年12月31日 |
| 3.x | 3.5+ | 不再维护 |
可以通过 pip 安装 ：
$ pip install borax
导入
一般来说， 作为功能的代码基本组织形式，建议导入 包(Package) 和 模块(Module) 。
例如，导入 choices：
from borax import choices
class OffsetChoices(choices.ConstChoices):
up = choices.Item((0, -1), 'Up')
down = choices.Item((0, 1), 'Down')
left = choices.Item((-1, 0), 'Left')
right = choices.Item((0, 1), 'Right')
在某些情况下，也可以直接导入模块的 类(Class) 或 变量(Variate)。
from borax.patterns.lazy import LazyObject
class Point(object):
def __init__(self, x, y):
self.x = x
self.y = y
p = LazyObject(Point,args=[1,2])
print(p.x)
函数
borax 库在函数定义和调用方面，尽可能按照 PEP3102 声明函数参数，即某些参数必须以关键字形式传入参数。
borax.choices.Items(value, display=None, *, order=None)
类型标注
从 v1.2.0 开始，部分模块支持 Typing Hint 。