GStruct
=======
GStruct is a pythonic "struct" type framework similar to Golang struct, with self-created "interface" for it.
-------------------------------------------------------------------------------------------------------------
Usage can be realized through some code in 'examples' directory on
GitHub.
Examples on GitHub: https://github.com/djun/gstruct/tree/master/examples
GStruct 快速开始(中文版)
~~~~~~~~~~~~~~~~~~~~~~~~~~
特点简述
^^^^^^^^
GStruct虽然模仿了一些Go语言的结构体(Struct)和接口(Interface)的一些形式,
但它其实是结合了Python自身的一些特色设计出来的,本意是借用Go语言的在结构体和接口上的部分设计思想,
为Python在软件工程上增添开发便利性,以及试图通过借用思想的方式实现代码质量与开发效率双提升,
并非“为了复制而复制”。
限于个人水平,GStruct目前的基本设定及实现程度大致如下: -
尽量避免使用第三方库实现,尽可能地以更Pythonic的方式实现 -
以字典(dict)作为基本数据结构,此结构可以跟JSON、BSON等无缝对接,
且数据本身也可以作为新建GStruct对象时的传入参数 -
基本用法类似Go语言的结构体类型,可以为其定义“结构”、“方法”,可以进行组合定义,
可以通过属性访问键值和组合后的方法 -
创建GStruct对象前先定义其“类型”GSBase,淡化类型指定,定义GSBase时
只需要声明键名,及对应的默认值或被组合的GSBase对象 -
由于Python是动态语言,为GSBase定义的方法在运行时被注册,不允许反注册,
便于进行运行时的动态接口推断 -
使用GSBase创建GStruct对象时,允许往其中放入字典对象,GSBase会自动根据其定义,
对放入的字典进行键名筛选,自动创建不存在的键名及其默认值,自动忽略不需要的键名,
但对嵌入其中的GStruct对象进行GSBase“类型”推断,不符合定义的将主动报错 -
实现的“接口筛选器”GSInterface可以对GStruct对象进行方法名筛选,
包装符合要求的GStruct产生GSIWrapper对象,GSIWrapper仅允许调用筛选后的方法名
- 其他细节详见示例代码 #### 用法示例 - 引入模块
.. code:: Python
from gstruct import GSBase
from gstruct import GSInterface
- 定义GSBase(GStruct的基本类型) \`\`\`Python # 简单定义 User =
GSBase({ "name": "Unknown", "sex": "intersex", "age": 0, })
组合定义
========
Student = GSBase({ "User": User, "score": 0, }) BadStudent = GSBase({
"Student": Student, "bad\_score": 0, }) Teacher = GSBase({ "User": User,
"subject": "", }) ``- GSBase注册方法``\ Python #
通过def\_method装饰器进行方法注册,注意这里的括号不能省略 #
括号内可以传参如“ref=True”表示调用方法时第一参数传的是GStruct的引用(默认ref=False表示仅传数据字典)
@Student.def\_method() def show\_score(student): print("My name is {},
and my score is {}!".format(student.User.name, student.score))
@Teacher.def\_method() def teach(teacher, student): print("My name is
{}, I'm teaching {}...".format(teacher.User.name, student.User.name))
组合时,可以定义同名方法,会覆盖被组合的GSBase中注册过的方法名,
================================================================
但被组合的GSBase之间不允许重复方法名(避免方法名冲突)
======================================================
@BadStudent.def\_method() def show\_score(bad\_student): print("My name
is {}, and my score is always
{}!".format(bad\_student.Student.User.name, bad\_student.bad\_score))
``- 定义GSInterface(接口筛选器)``\ Python IGreet =
GSInterface(['greet']) ``- GStruct常见用法``\ Python #
根据定义的默认值创建GStruct对象 u = User.new() u.greet() # 调用greet方法
print(u.data\_) # 输出GStruct包含的数据
传入嵌套GStruct对象的数据来创建GStruct对象
==========================================
u1 = User.new({ "name": "Xiao Ming", "sex": "male", "age": 10, }) s1 =
Student.new({ "User": u1, "score": 99, }) if s1(IGreet): #
使用GSInterface接口筛选器包装这个GStruct对象,并调用greet接口 si =
IGreet.wrap(s1) si.greet() s1.show\_score()
传入纯字典数据来创建GStruct对象
===============================
用协议接口实现快捷调用GSBase.new()
==================================
t1 = Teacher \* { "User": { "name": "Xiao Hua", "sex": "female", "age":
30, }, "subject": "Math", } # same as Teacher.new({ ... }) #
用协议接口实现快捷调用GSInterface.wrap() ti = IGreet \* t1 # same as
IGreet.wrap(t1) ti.greet() # ti.teach(s1) # raise error! t1.teach(s1)
print(t1.data\_) \`\`\`
完整示例代码请参考:\ https://github.com/djun/gstruct/blob/master/examples/ex_gstruct_1.py
# GStruct Quick Start (English ver.) (Temporary unavailable...)