pyobject 1.2.3.2__tar.gz → 1.2.4__tar.gz

{pyobject-1.2.3.2/pyobject.egg-info → pyobject-1.2.4}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.1
 Name: pyobject
-Version: 1.2.3.2
-Summary: 一个提供操作Python底层对象工具的模块。A utility tool with some submodules for operating internal python objects.
+Version: 1.2.4
+Summary: 一个提供操作Python对象底层工具的模块。A utility tool with some submodules for operating internal python objects.
 Home-page: https://github.com/qfcy/Python/tree/main/pyobject
 Author: qfcy qq:3076711200
 Author-email: 3076711200@qq.com
@@ -13,36 +13,35 @@ Classifier: Topic :: Software Development :: Bug Tracking
 Classifier: Topic :: Software Development :: Debuggers
 Classifier: Topic :: Software Development :: Testing
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-License-File: LICENSE
 
-pyobject - 一个提供操作Python底层对象工具的Python包, 包含一些子模块。A utility tool with some submodules for operating internal python objects.
+pyobject - 一个提供操作Python对象底层工具的Python包, 包含一些子模块。A utility tool with some submodules for operating internal python objects.
 
 所包含模块 Included modules: 
 ============================
 
-__init__ - 打印出Python对象的各个属性
+__init__ - 显示和输出Python对象的各个属性值
 
-pyobject.browser - 以图形方式浏览Python对象
+pyobject.browser - 以图形界面浏览Python对象
 
-pyobject.code\_ - Python bytecode的操作工具
+pyobject.code\_ - Python 字节码(bytecode)的操作工具
 
-pyobject.search - 搜索python对象
+pyobject.search - 以一个对象为起点，搜索python对象
 
-pyobject.newtypes - 定义一些新的类型
+pyobject.newtypes - 定义一些新的类型 (实验性)
 
-pyobj_extension(新增) - 操作Python底层对象引用, 以及对象指针的模块, 使用C语言编写
+pyobj_extension(新增) - C扩展模块, 提供操作Python对象底层的函数
 
 包含的函数 Functions:
 =====================
 
-describe(obj, level=0, maxlevel=1, tab=4, verbose=False, file=sys.stdout, mode='w' encoding='utf-8')::
+describe(obj, level=0, maxlevel=1, tab=4, verbose=False, file=sys.stdout)::
 
     "描述"一个对象,即打印出对象的各个属性。
     参数说明:
     maxlevel:打印对象属性的层数。
     tab:缩进的空格数,默认为4。
     verbose:一个布尔值,是否打印出对象的特殊方法(如__init__)。
-    file:一个类似文件的对象。
+    file:一个类似文件的对象，用于打印输出。
 
 browse(object, verbose=False, name='obj')::
 
@@ -85,13 +84,17 @@ search(obj, start, recursions=3)::
     start:起点对象
     recursion:递归次数
 
-新增类: ``pyobject.newtypes.Code``
+新增类: ``pyobject.Code``
 ==================================
 
-用法\: (下面的示例是从doctest中摘取的)::
+类Code用于包装Python字节码对象(bytecode)，提供一个便利操作Python字节码的接口。
+
+Python底层的bytecode对象，如func.__code__，是不可变的，鉴于此，Code类提供了一个可变的字节码对象，以及一系列操作字节码的函数，使得操作底层字节码对象变得更容易。
+
+示例用法\: (从模块的doctest中摘取)::
 
     >>> def f():print("Hello")
-    >>> c=Code.fromfunc(f)
+    >>> c=Code.fromfunc(f) # 或 c=Code(f.__code__)
     >>> c.co_consts
     (None, 'Hello')
     >>> c.co_consts=(None, 'Hello World!')
@@ -125,27 +128,34 @@ convptr(pointer)::
     将整数指针转换为Python对象，与id()相反。
 	Convert a integer pointer to a Python object,as a reverse of id().
 
-py_decref(object,n)::
+py_decref(object, n)::
 
 	将对象的引用计数减小n。Decrease the reference count of an object for n.
 
-py_incref(object,n)::
+py_incref(object, n)::
 
     将对象的引用计数增加n。Increase the reference count of an object for n.
 
-*警告: 不恰当地使用上述3个函数可能导致Python崩溃。*
+*警告: 不恰当地使用这3个函数可能导致Python崩溃。*
+
+*Warning:Improper use of the three functions above may lead to crashes.*
 
-*Warning:improper using of three functions above may cause Python to crash.*
+list_in(obj, lst)::
 
-版本:1.2.3
+    判断obj是否在列表或元组lst中。与Python内置的obj in lst调用多次==运算符(__eq__)相比，
+    本函数直接比较对象的指针，提高了效率。
+
+版本:1.2.4
 
 更新日志: 
 
+2024-8-12(v1.2.4):针对pyobject.code_增加了对3.10及以上版本的支持；进一步优化了search模块的搜索性能，以及一些其他修复和改进。
+
 2024-6-20(v1.2.3):更新了包内test目录下的.pyc文件加壳工具，并更新了pyobject.browser中的对象浏览器，添加了显示列表和字典项，后退、前进、刷新页面，以及新增、编辑和删除项等新特性。
 
 2022-7-25(v1.2.2):增加了操作Python底层对象引用, 以及对象指针的C语言模块pyobj_extension。
 
-2022-2-2(v1.2.0):修复了一些bug,优化了search模块的性能; pyobject.code_中增加了Code类,browser中增加编辑属性功能, 增加了Code类的测试。
+2022-2-2(v1.2.0):修复了一些bug,优化了search模块的性能; code_中增加了Code类, browser中增加编辑属性功能, 增加了Code类的doctest。
 
 源码:见 https://github.com/qfcy/Python/tree/main/pyobject
 

{pyobject-1.2.3.2 → pyobject-1.2.4}/README.rst

@@ -1,31 +1,31 @@
-pyobject - һ���ṩ����Python�ײ���󹤾ߵ�Python��, ����һЩ��ģ�顣A utility tool with some submodules for operating internal python objects.
+pyobject - һ���ṩ����Python����ײ㹤�ߵ�Python��, ����һЩ��ģ�顣A utility tool with some submodules for operating internal python objects.
 
 ������ģ�� Included modules: 
 ============================
 
-__init__ - ��ӡ��Python����ĸ�������
+__init__ - ��ʾ�����Python����ĸ�������ֵ
 
-pyobject.browser - ��ͼ�η�ʽ���Python����
+pyobject.browser - ��ͼ�ν������Python����
 
-pyobject.code\_ - Python bytecode�IJ�������
+pyobject.code\_ - Python �ֽ���(bytecode)�IJ�������
 
-pyobject.search - ����python����
+pyobject.search - ��һ������Ϊ��㣬����python����
 
-pyobject.newtypes - ����һЩ�µ�����
+pyobject.newtypes - ����һЩ�µ����� (ʵ����)
 
-pyobj_extension(����) - ����Python�ײ��������, �Լ�����ָ���ģ��, ʹ��C���Ա�д
+pyobj_extension(����) - C��չģ��, �ṩ����Python����ײ�ĺ���
 
 ������� Functions:
 =====================
 
-describe(obj, level=0, maxlevel=1, tab=4, verbose=False, file=sys.stdout, mode='w' encoding='utf-8')::
+describe(obj, level=0, maxlevel=1, tab=4, verbose=False, file=sys.stdout)::
 
     "����"һ������,����ӡ������ĸ������ԡ�
     ����˵��:
     maxlevel:��ӡ�������ԵIJ�����
     tab:�����Ŀո���,Ĭ��Ϊ4��
     verbose:һ������ֵ,�Ƿ��ӡ����������ⷽ��(��__init__)��
-    file:һ�������ļ��Ķ���
+    file:һ�������ļ��Ķ������ڴ�ӡ�����
 
 browse(object, verbose=False, name='obj')::
 
@@ -68,13 +68,17 @@ search(obj, start, recursions=3)::
     start:������
     recursion:�ݹ����
 
-������: ``pyobject.newtypes.Code``
+������: ``pyobject.Code``
 ==================================
 
-�÷�\: (�����ʾ���Ǵ�doctest��ժȡ��)::
+��Code���ڰ�װPython�ֽ������(bytecode)���ṩһ����������Python�ֽ���Ľӿڡ�
+
+Python�ײ��bytecode������func.__code__���Dz��ɱ�ģ����ڴˣ�Code���ṩ��һ���ɱ���ֽ�������Լ�һϵ�в����ֽ���ĺ�����ʹ�ò����ײ��ֽ�������ø����ס�
+
+ʾ���÷�\: (��ģ���doctest��ժȡ)::
 
     >>> def f():print("Hello")
-    >>> c=Code.fromfunc(f)
+    >>> c=Code.fromfunc(f) # �� c=Code(f.__code__)
     >>> c.co_consts
     (None, 'Hello')
     >>> c.co_consts=(None, 'Hello World!')
@@ -108,27 +112,34 @@ convptr(pointer)::
     ������ָ��ת��ΪPython������id()�෴��
 	Convert a integer pointer to a Python object,as a reverse of id().
 
-py_decref(object,n)::
+py_decref(object, n)::
 
 	����������ü�����Сn��Decrease the reference count of an object for n.
 
-py_incref(object,n)::
+py_incref(object, n)::
 
     ����������ü�������n��Increase the reference count of an object for n.
 
-*����: ��ǡ����ʹ������3���������ܵ���Python������*
+*����: ��ǡ����ʹ����3���������ܵ���Python������*
+
+*Warning:Improper use of the three functions above may lead to crashes.*
 
-*Warning:improper using of three functions above may cause Python to crash.*
+list_in(obj, lst)::
 
-�汾:1.2.3
+    �ж�obj�Ƿ����б���Ԫ��lst�С���Python���õ�obj in lst���ö��==�����(__eq__)��ȣ�
+    ������ֱ�ӱȽ϶����ָ�룬�����Ч�ʡ�
+
+�汾:1.2.4
 
 ������־: 
 
+2024-8-12(v1.2.4):���pyobject.code_�����˶�3.10�����ϰ汾��֧�֣���һ���Ż���searchģ����������ܣ��Լ�һЩ�����޸��͸Ľ���
+
 2024-6-20(v1.2.3):�����˰���testĿ¼�µ�.pyc�ļ��ӿǹ��ߣ���������pyobject.browser�еĶ������������������ʾ�б����ֵ�����ˡ�ǰ����ˢ��ҳ�棬�Լ��������༭��ɾ����������ԡ�
 
 2022-7-25(v1.2.2):�����˲���Python�ײ��������, �Լ�����ָ���C����ģ��pyobj_extension��
 
-2022-2-2(v1.2.0):�޸���һЩbug,�Ż���searchģ�������; pyobject.code_��������Code��,browser�����ӱ༭���Թ���, ������Code��IJ��ԡ�
+2022-2-2(v1.2.0):�޸���һЩbug,�Ż���searchģ�������; code_��������Code��, browser�����ӱ༭���Թ���, ������Code���doctest��
 
 Դ��:�� https://github.com/qfcy/Python/tree/main/pyobject
 

{pyobject-1.2.3.2 → pyobject-1.2.4}/pyobject/__init__.py

@@ -1,15 +1,14 @@
-"""一个提供操作Python底层对象工具的模块。
+"""一个提供操作Python对象底层工具的模块。
 A utility tool with some submodules for operating internal python objects.
 
 """
-
 import sys
 from warnings import warn
 from pprint import pprint
 
 __email__="3076711200@qq.com"
 __author__="qfcy qq:3076711200"
-__version__="1.2.3"
+__version__="1.2.4"
 
 _ignore_names=["__builtins__","__doc__"]
 __all__=["objectname","bases","describe","desc"]
@@ -39,7 +38,7 @@ tab:缩进的空格数,默认为4。'''
         print(*obj.__bases__,sep=',')
         for cls in obj.__bases__:
             bases(cls,level,tab)
-        
+
 
 def _shortrepr(obj,maxlength=150):
     result=repr(obj)
@@ -57,14 +56,15 @@ def _shortrepr(obj,maxlength=150):
 ##                value=getattr(obj,attr)
 ##                pprint("{}:{}".format(attr,value),**kwargs)
 ##                if needhelp:help(value)
-def describe(obj,level=0,maxlevel=1,tab=4,verbose=False,file=sys.stdout):
+def describe(obj,level=0,maxlevel=1,tab=4,verbose=False,file=None):
     '''"描述"一个对象,即打印出对象的各个属性。
 参数说明:
 maxlevel:打印对象属性的层数。
 tab:缩进的空格数,默认为4。
 verbose:一个布尔值,是否打印出对象的特殊方法(如__init__)。
-file:一个类似文件的对象。
+file:一个类似文件的对象，用于打印输出。
 '''
+    if file is None:file=sys.stdout
     if level==maxlevel:
         result=repr(obj)
         if result.startswith('[') or result.startswith('{'):pprint(result)
@@ -89,25 +89,25 @@ file:一个类似文件的对象。
                     print("<AttributeError!>",end='',file=file)
 
 desc=describe #别名
-# 导入其他模块中的函数和类
+# 导入其他子模块中的函数和类
 try:
-    from .browser import browse
+    from pyobject.browser import browse
     __all__.append("browse")
-# (ImportError,SystemError): 修复Python 3.4的bug
-except (ImportError,SystemError):warn("Failed to import module .browser .")
+# SystemError: 修复Python 3.4下的bug
+except (ImportError,SystemError):warn("Failed to import module pyobject.browser.")
 try:
-    from .search import make_list,search #,test_make_list,test_search
-    __all__.extend(["make_list","search"])
+    from pyobject.search import make_list,make_iter,search #,test_make_list,test_search
+    __all__.extend(["make_list","make_iter","search"])
 # 同上
-except (ImportError,SystemError):warn("Failed to import module .search .")
+except (ImportError,SystemError):warn("Failed to import pyobject.search.")
 
 try:
-    from .code_ import Code
+    from pyobject.code_ import Code
     __all__.append("Code")
-except (ImportError,SystemError):warn("Failed to import module .code.")
+except (ImportError,SystemError):warn("Failed to import pyobject.code_.")
 try:
     from pyobj_extension import *
-    __all__.extend(["convptr","py_incref","py_decref"])
+    __all__.extend(["convptr","py_incref","py_decref","list_in"])
 except ImportError:warn("Failed to import module pyobj_extension.")
 
 def test():
@@ -119,4 +119,4 @@ def test():
         return 1
     else:return 0
 
-if __name__=="__main__":test()
+if __name__=="__main__":sys.exit(test())

{pyobject-1.2.3.2 → pyobject-1.2.4}/pyobject/browser.py

@@ -5,11 +5,10 @@ import tkinter.ttk as ttk
 import tkinter.messagebox as msgbox
 import tkinter.simpledialog as simpledialog
 from inspect import isfunction,ismethod,isgeneratorfunction,isgenerator,iscode
-try: from . import objectname,_shortrepr
-# ImportError,SystemError: 修复Python 3.4中的bug
-except (ImportError,SystemError):from __init__ import objectname,_shortrepr
+try:from pyobject import objectname,_shortrepr
+except ImportError:from __init__ import objectname,_shortrepr
 
-_IMAGE_PATH=(os.path.split(__file__)[0]+"\\images")
+_IMAGE_PATH=os.path.join(os.path.split(__file__)[0],"images")
 
 def isfunc(obj):
     # 判断一个对象是否为函数或方法
@@ -18,8 +17,11 @@ def isfunc(obj):
     func_types=[types.LambdaType,types.BuiltinFunctionType,
                 types.BuiltinMethodType,typing.WrapperDescriptorType,
                 typing.MethodWrapperType,typing.MethodDescriptorType]
-    if sys.version_info.minor>=7: # Python 3.7及以上
-        func_types.append(types.ClassMethodDescriptorType)
+    if sys.version_info.minor>=7:
+        ClassMethodDescriptorType=types.ClassMethodDescriptorType
+    else: # 3.7之前的旧版本
+        ClassMethodDescriptorType=type(dict.__dict__['fromkeys'])
+    func_types.append(ClassMethodDescriptorType)
     for type in func_types:
         if isinstance(obj,type):
             return True
@@ -67,7 +69,7 @@ class ObjectBrowser():
 
         self.master.title(self.title)
         try:
-            self.master.iconbitmap(_IMAGE_PATH+r"\python.ico")
+            self.master.iconbitmap(os.path.join(_IMAGE_PATH,"python.ico"))
         except tk.TclError:pass
         self.load_image()
         self.create_widgets()
@@ -97,7 +99,9 @@ class ObjectBrowser():
 
         self.functions_tag=self.tvw.insert('',index=0,text="函数、方法")
         self.attributes_tag=self.tvw.insert('',index=1,text="属性")
+        self.tvw.item(self.attributes_tag,open=True) # 展开项
         self.classes_tag=self.tvw.insert('',index=2,text="类")
+        self.tvw.item(self.classes_tag,open=True)
         self.lst_tag=self.tvw.insert('',index=3,text="列表数据")
         self.dict_tag=self.tvw.insert('',index=4,text="字典数据")
         editor = ttk.Labelframe(self.master, text='编辑值',
@@ -118,33 +122,33 @@ class ObjectBrowser():
     def load_image(self):
         # 加载images文件夹下的图片
         self.back_image=tk.PhotoImage(master=self.master,
-                                     file=_IMAGE_PATH+r"\back.gif")
+                            file=os.path.join(_IMAGE_PATH,"back.gif"))
         self.forward_image=tk.PhotoImage(master=self.master,
-                                     file=_IMAGE_PATH+r"\forward.gif")
+                            file=os.path.join(_IMAGE_PATH,"forward.gif"))
         self.refresh_image=tk.PhotoImage(master=self.master,
-                                     file=_IMAGE_PATH+r"\refresh.gif")
+                            file=os.path.join(_IMAGE_PATH,"refresh.gif"))
         self.obj_image=tk.PhotoImage(master=self.master,
-                                     file=_IMAGE_PATH+r"\python.gif")
+                            file=os.path.join(_IMAGE_PATH,"python.gif"))
         self.num_image=tk.PhotoImage(master=self.master,
-                                     file=_IMAGE_PATH+r"\number.gif")
+                            file=os.path.join(_IMAGE_PATH,"number.gif"))
         self.str_image=tk.PhotoImage(master=self.master,
-                                     file=_IMAGE_PATH+r"\string.gif")
+                            file=os.path.join(_IMAGE_PATH,"string.gif"))
         self.list_image=tk.PhotoImage(master=self.master,
-                                     file=_IMAGE_PATH+r"\list.gif")
+                            file=os.path.join(_IMAGE_PATH,"list.gif"))
         self.empty_list_image=tk.PhotoImage(master=self.master,
-                                     file=_IMAGE_PATH+r"\empty_list.gif")
+                            file=os.path.join(_IMAGE_PATH,"empty_list.gif"))
         self.tuple_image=tk.PhotoImage(master=self.master,
-                                     file=_IMAGE_PATH+r"\tuple.gif")
+                            file=os.path.join(_IMAGE_PATH,"tuple.gif"))
         self.empty_tuple_image=tk.PhotoImage(master=self.master,
-                                     file=_IMAGE_PATH+r"\empty_tuple.gif")
+                            file=os.path.join(_IMAGE_PATH,"empty_tuple.gif"))
         self.dict_image=tk.PhotoImage(master=self.master,
-                                     file=_IMAGE_PATH+r"\dict.gif")
+                            file=os.path.join(_IMAGE_PATH,"dict.gif"))
         self.empty_dict_image=tk.PhotoImage(master=self.master,
-                                     file=_IMAGE_PATH+r"\empty_dict.gif")
+                            file=os.path.join(_IMAGE_PATH,"empty_dict.gif"))
         self.func_image=tk.PhotoImage(master=self.master,
-                                     file=_IMAGE_PATH+r"\function.gif")
+                            file=os.path.join(_IMAGE_PATH,"function.gif"))
         self.code_image=tk.PhotoImage(master=self.master,
-                                     file=_IMAGE_PATH+r"\codeobject.gif")
+                            file=os.path.join(_IMAGE_PATH,"codeobject.gif"))
     def clear(self):
         # 清除Treeview的数据
         for root in self.tvw.get_children(""): # 获取根项
@@ -191,7 +195,7 @@ class ObjectBrowser():
                                     text=attr, image=image,
                                     values=(value,)) # values从第二列开始
                 except Exception as error: # 显示错误消息
-                    value='<{}!>'.format(type(error).__name__)
+                    value='<{}: {}>'.format(type(error).__name__,str(error))
                     self.tvw.insert(self.attributes_tag, tk.END,
                                     text=attr, image=self.obj_image,
                                     values=(value,),tags=("error",))
@@ -202,7 +206,7 @@ class ObjectBrowser():
                             text="__bases__", image=self._get_image(bases),
                             values=(repr(bases),))
         # 添加列表数据
-        if isinstance(obj,list) or isinstance(obj,tuple):
+        if isinstance(obj,(list,tuple)):
             for i in range(len(obj)):
                 index=str(i)
                 try:
@@ -252,7 +256,14 @@ class ObjectBrowser():
         else:
             parent=self.tvw.parent(selection[0])
             if parent:
-                value_str=self.tvw.item(selection[0])["values"][0]
+                #value_str=self.tvw.item(selection[0])["values"][0] # 现已弃用，由于使用了_shortrepr()
+                attr=self.tvw.item(selection)["text"]
+                if parent==self.dict_tag:
+                    value_str=repr(self.obj[eval(attr)])
+                elif parent==self.lst_tag:
+                    value_str=repr(self.obj[int(attr)])
+                else:
+                    value_str=repr(getattr(self.obj,attr))
                 self.editor.delete(0,tk.END)
                 self.editor.insert(0,value_str)
                 if parent==self.lst_tag and isinstance(self.obj,tuple):
@@ -355,7 +366,7 @@ class ObjectBrowser():
                 # 对象的属性可能有改变，重新获取对象的属性
                 scope={self.rootobj_name:self.root_obj} # 获取第一个浏览的根对象及其名称
                 object=eval(path,scope)
-            except Exception:
+            except Exception: # 默认使用新获取的对象，只有出错时，才使用旧的对象
                 object=obj
         else:object=obj
         self.browse(object,path)
@@ -368,7 +379,7 @@ class ObjectBrowser():
             self.history_index+=1
             self.navigate_history()
 
-def browse(object,verbose=False,name="obj",
+def browse(object,verbose=True,name="obj",
            mainloop=True,multi_window=False,refresh_history=True,
            root_obj=None,rootobj_name=None):
     """以图形界面浏览一个Python对象。