pyobject 1.2.8__tar.gz → 1.2.9__tar.gz

{pyobject-1.2.8/pyobject.egg-info → pyobject-1.2.9}/PKG-INFO

@@ -1,15 +1,16 @@
 Metadata-Version: 2.1
 Name: pyobject
-Version: 1.2.8
+Version: 1.2.9
 Summary: A multifunctional all-in-one utility tool for managing internal Python objects, compatible with nearly all Python 3 versions. 一个多功能合一的提供操作Python对象底层工具的Python包, 支持几乎所有Python 3版本。 
 Home-page: https://github.com/qfcy/pyobject
 Author: qfcy
 Author-email: 3076711200@qq.com
-Keywords: pyobject,python,object,utility,object browser,bytecode,reflect,object search,OOP,对象,字节码,对象浏览器
+Keywords: pyobject,python,object,utility,object browser,bytecode,reflect,object search,OOP,reverse,对象,字节码,逆向
 Classifier: Programming Language :: Python
 Classifier: Topic :: Utilities
 Classifier: Topic :: Software Development :: Bug Tracking
 Classifier: Topic :: Software Development :: Debuggers
+Classifier: Topic :: Software Development :: Object Brokering
 Classifier: Topic :: Software Development :: Testing
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 License-File: LICENSE
@@ -21,19 +22,19 @@ versions.
 
 **The English introduction is shown below the Chinese version.**
 
-所包含模块
-----------
+子模块
+------
 
 pyobject.\__init\_\_ - 显示和输出Python对象的各个属性值
 
 pyobject.browser - 调用tkinter，浏览Python对象的图形界面
 
-pyobject.code\_ - Python 字节码(bytecode)的操作工具
+pyobject.code - Python 底层字节码(bytecode)的操作工具
 
-pyobject.search - 以一个起始对象为起点，查找和搜索能到达的所有python对象
+pyobject.search - 以一个对象为起点，查找和搜索能到达的所有python对象
 
 pyobject.objproxy -
-实现一个通用的对象代理，能够替换任意Python对象，包括模块，函数和类
+实现一个通用的对象代理，能够代理任意Python对象，包括模块，函数和类
 
 pyobject.pyobj_extension - C扩展模块, 提供操作Python对象底层的函数
 
@@ -197,7 +198,7 @@ Python内部的字节码对象\ ``CodeType``\ ，如\ ``func.__code__``\ ，是
 
 -  属性\ ``co_lnotab``\ ：在3.10以上的版本中，如果尝试设置\ ``co_lnotab``\ 属性，会自动转换成设置\ ``co_linetable``\ 。
 
-示例用法: (从模块的doctest中摘取):
+示例用法: (从doctest中摘取):
 
 .. code:: python
 
@@ -244,7 +245,7 @@ Python内部的字节码对象\ ``CodeType``\ ，如\ ``func.__code__``\ ，是
    plt = chain.new_object("import matplotlib.pyplot as plt","plt",
                            export_funcs = ["show"])
 
-   # 测试调用伪numpy, matplotlib模块
+   # 测试调用代理后的numpy, matplotlib模块
    arr = np.array(range(1,11))
    arr_squared = arr ** 2
    print(np.mean(arr)) # 输出平均值
@@ -393,11 +394,12 @@ Python内部的字节码对象\ ``CodeType``\ ，如\ ``func.__code__``\ ，是
 lst调用多次==运算符(``__eq__``)相比，
 本函数直接比较对象的指针，提高了效率。
 
-**``pyobject``\ 当前版本**: 1.2.8
+**``pyobject``\ 当前版本**: 1.2.9
 
 更新日志:
 ---------
 
+| 2025-4-30(v1.2.9):改进和增强了子模块pyobject.objproxy，重命名子模块pyobject.code_为pyobject.code。
 | 2025-3-31(v1.2.8):将pyobject.super_proxy重命名为pyobject.objproxy，并正式发布；修改了pyobject.pyobj_extension模块。
 | 2025-3-6(v1.2.7):为pyobject.browser新增了\ ``dir()``\ 中不存在的类属性（如\ ``__flags__``,
   ``__mro__``\ ），修改了pyobj_extension模块。
@@ -412,6 +414,8 @@ lst调用多次==运算符(``__eq__``)相比，
   code_中增加了Code类, browser中增加编辑属性功能,
   增加了Code类的doctest。
 
+--------------
+
 Submodules:
 -----------
 
@@ -421,8 +425,7 @@ objects.
 pyobject.browser - Provides a visual interface to browse Python objects
 using tkinter.
 
-pyobject.code\_ - Provides tools for manipulating Python native
-bytecode.
+pyobject.code - Provides tools for manipulating Python native bytecode.
 
 pyobject.search - Implements the utility for locating the path to a
 specific object.
@@ -625,7 +628,7 @@ Compatibility Details
    the ``co_lnotab`` attribute will automatically be converted into
    setting the ``co_linetable`` attribute.
 
-Example usage: (excerpted from the module’s doctest):
+Example usage: (excerpted from the doctest):
 
 .. code:: python
 
@@ -883,11 +886,14 @@ Python call “obj in lst” that invokes the “==” operator (``__eq__``)
 multiple times, this function directly compares the pointers to improve
 efficiency.
 
-**Current Version of ``pyobject``**: 1.2.8
+**Current Version of ``pyobject``**: 1.2.9
 
 Change Log
 ----------
 
+| 2025-4-30(v1.2.9): Improved and enhanced the sub-module
+  ``pyobject.objproxy``, and renamed the sub-module ``pyobject.code_``
+  to ``pyobject.code``.
 | 2025-3-31(v1.2.8): Renamed pyobject.super_proxy to pyobject.objproxy
   and officially released it; modified the pyobject.pyobj_extension
   module.

{pyobject-1.2.8 → pyobject-1.2.9}/README.rst

@@ -5,19 +5,19 @@ versions.
 
 **The English introduction is shown below the Chinese version.**
 
-所包含模块
-----------
+子模块
+------
 
 pyobject.\__init\_\_ - 显示和输出Python对象的各个属性值
 
 pyobject.browser - 调用tkinter，浏览Python对象的图形界面
 
-pyobject.code\_ - Python 字节码(bytecode)的操作工具
+pyobject.code - Python 底层字节码(bytecode)的操作工具
 
-pyobject.search - 以一个起始对象为起点，查找和搜索能到达的所有python对象
+pyobject.search - 以一个对象为起点，查找和搜索能到达的所有python对象
 
 pyobject.objproxy -
-实现一个通用的对象代理，能够替换任意Python对象，包括模块，函数和类
+实现一个通用的对象代理，能够代理任意Python对象，包括模块，函数和类
 
 pyobject.pyobj_extension - C扩展模块, 提供操作Python对象底层的函数
 
@@ -181,7 +181,7 @@ Python内部的字节码对象\ ``CodeType``\ ，如\ ``func.__code__``\ ，是
 
 -  属性\ ``co_lnotab``\ ：在3.10以上的版本中，如果尝试设置\ ``co_lnotab``\ 属性，会自动转换成设置\ ``co_linetable``\ 。
 
-示例用法: (从模块的doctest中摘取):
+示例用法: (从doctest中摘取):
 
 .. code:: python
 
@@ -228,7 +228,7 @@ Python内部的字节码对象\ ``CodeType``\ ，如\ ``func.__code__``\ ，是
    plt = chain.new_object("import matplotlib.pyplot as plt","plt",
                            export_funcs = ["show"])
 
-   # 测试调用伪numpy, matplotlib模块
+   # 测试调用代理后的numpy, matplotlib模块
    arr = np.array(range(1,11))
    arr_squared = arr ** 2
    print(np.mean(arr)) # 输出平均值
@@ -377,11 +377,12 @@ Python内部的字节码对象\ ``CodeType``\ ，如\ ``func.__code__``\ ，是
 lst调用多次==运算符(``__eq__``)相比，
 本函数直接比较对象的指针，提高了效率。
 
-**``pyobject``\ 当前版本**: 1.2.8
+**``pyobject``\ 当前版本**: 1.2.9
 
 更新日志:
 ---------
 
+| 2025-4-30(v1.2.9):改进和增强了子模块pyobject.objproxy，重命名子模块pyobject.code_为pyobject.code。
 | 2025-3-31(v1.2.8):将pyobject.super_proxy重命名为pyobject.objproxy，并正式发布；修改了pyobject.pyobj_extension模块。
 | 2025-3-6(v1.2.7):为pyobject.browser新增了\ ``dir()``\ 中不存在的类属性（如\ ``__flags__``,
   ``__mro__``\ ），修改了pyobj_extension模块。
@@ -396,6 +397,8 @@ lst调用多次==运算符(``__eq__``)相比，
   code_中增加了Code类, browser中增加编辑属性功能,
   增加了Code类的doctest。
 
+--------------
+
 Submodules:
 -----------
 
@@ -405,8 +408,7 @@ objects.
 pyobject.browser - Provides a visual interface to browse Python objects
 using tkinter.
 
-pyobject.code\_ - Provides tools for manipulating Python native
-bytecode.
+pyobject.code - Provides tools for manipulating Python native bytecode.
 
 pyobject.search - Implements the utility for locating the path to a
 specific object.
@@ -609,7 +611,7 @@ Compatibility Details
    the ``co_lnotab`` attribute will automatically be converted into
    setting the ``co_linetable`` attribute.
 
-Example usage: (excerpted from the module’s doctest):
+Example usage: (excerpted from the doctest):
 
 .. code:: python
 
@@ -867,11 +869,14 @@ Python call “obj in lst” that invokes the “==” operator (``__eq__``)
 multiple times, this function directly compares the pointers to improve
 efficiency.
 
-**Current Version of ``pyobject``**: 1.2.8
+**Current Version of ``pyobject``**: 1.2.9
 
 Change Log
 ----------
 
+| 2025-4-30(v1.2.9): Improved and enhanced the sub-module
+  ``pyobject.objproxy``, and renamed the sub-module ``pyobject.code_``
+  to ``pyobject.code``.
 | 2025-3-31(v1.2.8): Renamed pyobject.super_proxy to pyobject.objproxy
   and officially released it; modified the pyobject.pyobj_extension
   module.

{pyobject-1.2.8 → pyobject-1.2.9}/pyobject/__init__.py

@@ -6,14 +6,15 @@ import sys
 from warnings import warn
 from pprint import pprint
 
-__version__="1.2.8"
+__version__="1.2.9"
 
 __all__=["objectname","bases","describe","desc"]
 _ignore_names=["__builtins__","__doc__"]
 
+MAXLENGTH=150
+
 def objectname(obj):
-    """objectname(obj) - Returns the name of an object in the format xxmodule.xxclass.
-For example: objectname(int) -> 'builtins.int'."""
+    # 返回对象的全名，类似__qualname__属性
     # if hasattr(obj,"__qualname__"):return obj.__qualname__
     if not obj.__class__==type:obj=obj.__class__
     if not hasattr(obj,"__module__") or obj.__module__=="__main__":
@@ -21,8 +22,7 @@ For example: objectname(int) -> 'builtins.int'."""
     return "{}.{}".format(obj.__module__,obj.__name__)
 
 def bases(obj,level=0,tab=4):
-    '''bases(obj) - Prints the base classes of the given object.
-tab: The number of spaces for indentation, default is 4.'''
+    # 打印对象的基类
     if not obj.__class__==type:obj=obj.__class__
     if obj.__bases__:
         if level:print(' '*(level*tab),end='')
@@ -31,8 +31,9 @@ tab: The number of spaces for indentation, default is 4.'''
             bases(cls,level,tab)
 
 _trans_table=str.maketrans("\n\t","  ") # 替换特殊字符为空格
-def shortrepr(obj,maxlength=150):
-    result=repr(obj).translate(_trans_table)
+def shortrepr(obj,maxlength=MAXLENGTH,repr_func=None):
+    if repr_func is None:repr_func = repr
+    result=repr_func(obj).translate(_trans_table)
     if len(result)>maxlength:
         return result[:maxlength]+"..."
     return result
@@ -53,7 +54,7 @@ file: A file-like object for printing output.
     elif level>maxlevel:raise ValueError(
         "Argument level is larger than maxlevel")
     else:
-        print(_shortrepr(obj)+': ',file=file)
+        print(shortrepr(obj)+': ',file=file)
         if type(obj) is type:
             print("Base classes of the object:",file=file)
             bases(obj,level+1,tab)
@@ -65,7 +66,7 @@ file: A file-like object for printing output.
                     if not attr in _ignore_names:
                         describe(getattr(obj,attr),level+1,maxlevel,
                                 tab,verbose,file)
-                    else:print(_shortrepr(getattr(obj,attr)),file=file)
+                    else:print(shortrepr(getattr(obj,attr)),file=file)
                 except AttributeError:
                     print("<AttributeError!>",file=file)
 
@@ -84,9 +85,9 @@ try:
 except (ImportError,SystemError):warn("Failed to import pyobject.search.")
 
 try:
-    from pyobject.code_ import Code
+    from pyobject.code import Code
     __all__.append("Code")
-except (ImportError,SystemError):warn("Failed to import pyobject.code_.")
+except (ImportError,SystemError):warn("Failed to import pyobject.code.")
 try:
     from pyobject.pyobj_extension import *
     __all__.extend(["convptr","py_incref","py_decref","getrealrefcount",
@@ -96,17 +97,16 @@ try:
                     "set_type_subclasses_by_cls"])
 except ImportError:warn("Failed to import pyobject.pyobj_extension.")
 try:
-    from pyobject.objproxy import DynObj,ObjChain,ProxiedObj
-    __all__.extend(["DynObj","ObjChain","ProxiedObj"])
-except ImportError:warn("Failed to import pyobject.objproxy.")
+    from pyobject.objproxy import DynObj,ObjChain,ProxiedObj,accept_raw_obj
+    __all__.extend(["DynObj","ObjChain","ProxiedObj","accept_raw_obj"])
+except (ImportError, SyntaxError):
+    warn("Failed to import pyobject.objproxy.") # SyntaxError: Python 3.5及以下不支持f-string
 
-def demo():
+def desc_demo():
     try:
         describe(type,verbose=True)
     except BaseException as err:
         print("STOPPED!",file=sys.stderr)
-        if not type(err) is KeyboardInterrupt:raise
-        return 1
-    else:return 0
+        if type(err) is not KeyboardInterrupt:raise
 
-if __name__=="__main__":sys.exit(demo())
+if __name__=="__main__":desc_demo()

pyobject-1.2.8/pyobject/code_.py → pyobject-1.2.9/pyobject/code.py

@@ -296,8 +296,6 @@ def interactive(mode='exec'):
 
 
 if __name__=="__main__":
-    import doctest
-    doctest.testmod()
     if len(sys.argv)>1:
             ps='>>> '
             statement='c=Code.from_file(%s)'%repr(sys.argv[1].strip('"'))