From c3d62e55052fb9038159291e29180e2eab390415 Mon Sep 17 00:00:00 2001 From: "Jeong, YunWon" Date: Sun, 27 Sep 2026 10:31:21 +0900 Subject: [PATCH 1/2] Skip Python-defined classes when collecting builtin type docs generate.py recorded every object.__subclasses__() entry as builtins. after importing the whole stdlib, so classes written in Python (tkinter, unittest, tarfile, ...) ended up in the doc database. Classes that are mutable heap types without C method descriptors and whose module is not a C extension are now skipped, and their entries are removed from data.inc.rs. Assisted-by: Claude:claude-opus-5-5 Assisted-by: Grok:grok-4.7 --- crates/doc/generate.py | 23 + crates/doc/src/data.inc.rs | 9137 ------------------------------------ 2 files changed, 23 insertions(+), 9137 deletions(-) diff --git a/crates/doc/generate.py b/crates/doc/generate.py index f7b86e07565..a8c05e151e5 100644 --- a/crates/doc/generate.py +++ b/crates/doc/generate.py @@ -21,6 +21,14 @@ UNICODE_ESCAPE = re.compile(r"\\u([0-9]+)") +HEAPTYPE = 1 << 9 +IMMUTABLETYPE = 1 << 8 +C_DESCRIPTORS = ( + types.MethodDescriptorType, + types.WrapperDescriptorType, + types.ClassMethodDescriptorType, +) + IGNORED_MODULES = {"this", "antigravity"} IGNORED_ATTRS = { "__annotations__", @@ -177,6 +185,18 @@ def traverse( yield DocEntry(new_parts, pydoc._getowndoc(attr)) +def is_python_class(typ: type) -> bool: + """Whether a class was defined in Python code rather than in C.""" + if not typ.__flags__ & HEAPTYPE or typ.__flags__ & IMMUTABLETYPE: + return False + # C types keep their slot wrappers and method descriptors even when + # their __module__ names a Python module (e.g. ast.AST). + if any(isinstance(attr, C_DESCRIPTORS) for attr in vars(typ).values()): + return False + module = sys.modules.get(typ.__module__) + return module is not None and not is_c_extension(module) + + def find_doc_entries() -> "Iterable[DocEntry]": yield from ( doc_entry @@ -196,6 +216,9 @@ def find_doc_entries() -> "Iterable[DocEntry]": builtin_types.append(obj) for typ in builtin_types: + # Classes defined in Python get their docs from source. + if is_python_class(typ): + continue parts = ("builtins", typ.__name__) yield DocEntry(parts, pydoc._getowndoc(typ)) yield from traverse(typ, __builtins__, parts) diff --git a/crates/doc/src/data.inc.rs b/crates/doc/src/data.inc.rs index 4b39d3eab68..38389ec5a18 100644 --- a/crates/doc/src/data.inc.rs +++ b/crates/doc/src/data.inc.rs @@ -9658,71 +9658,6 @@ pub const DB: &[(&str, &str)] = &[ ("binascii.hexlify", "Hexadecimal representation of binary data.\n\n sep\n An optional single character or byte to separate hex bytes.\n bytes_per_sep\n How many bytes between separators. Positive values count from the\n right, negative values count from the left.\n\nThe return value is a bytes object. This function is also\navailable as \"b2a_hex()\"."), ("binascii.unhexlify", "Binary data of hexadecimal representation.\n\nhexstr must contain an even number of hex digits (upper or lower case)."), ("builtins", "Built-in functions, types, exceptions, and other objects.\n\nThis module provides direct access to all 'built-in'\nidentifiers of Python; for example, builtins.len is\nthe full name for the built-in function len().\n\nThis module is not normally accessed explicitly by most\napplications, but can be useful in modules that provide\nobjects with the same name as a built-in value, but in\nwhich the built-in of that name is also needed."), - ("builtins.ABC", "Helper class that provides a standard way to create an ABC using\ninheritance."), - ("builtins.ABC.__delattr__", "Implement delattr(self, name)."), - ("builtins.ABC.__eq__", "Return self==value."), - ("builtins.ABC.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.ABC.__ge__", "Return self>=value."), - ("builtins.ABC.__getattribute__", "Return getattr(self, name)."), - ("builtins.ABC.__getstate__", "Helper for pickle."), - ("builtins.ABC.__gt__", "Return self>value."), - ("builtins.ABC.__hash__", "Return hash(self)."), - ("builtins.ABC.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.ABC.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.ABC.__le__", "Return self<=value."), - ("builtins.ABC.__lt__", "Return self=value."), - ("builtins.ALLOW_MISSING.__getattribute__", "Return getattr(self, name)."), - ("builtins.ALLOW_MISSING.__getstate__", "Helper for pickle."), - ("builtins.ALLOW_MISSING.__gt__", "Return self>value."), - ("builtins.ALLOW_MISSING.__hash__", "Return hash(self)."), - ("builtins.ALLOW_MISSING.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.ALLOW_MISSING.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.ALLOW_MISSING.__le__", "Return self<=value."), - ("builtins.ALLOW_MISSING.__lt__", "Return self=value."), - ("builtins.ANSIColors.__getattribute__", "Return getattr(self, name)."), - ("builtins.ANSIColors.__getstate__", "Helper for pickle."), - ("builtins.ANSIColors.__gt__", "Return self>value."), - ("builtins.ANSIColors.__hash__", "Return hash(self)."), - ("builtins.ANSIColors.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.ANSIColors.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.ANSIColors.__le__", "Return self<=value."), - ("builtins.ANSIColors.__lt__", "Return self=value."), - ("builtins.AbstractEventLoop.__getattribute__", "Return getattr(self, name)."), - ("builtins.AbstractEventLoop.__getstate__", "Helper for pickle."), - ("builtins.AbstractEventLoop.__gt__", "Return self>value."), - ("builtins.AbstractEventLoop.__hash__", "Return hash(self)."), - ("builtins.AbstractEventLoop.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.AbstractEventLoop.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.AbstractEventLoop.__le__", "Return self<=value."), - ("builtins.AbstractEventLoop.__lt__", "Return self=value."), - ("builtins.AbstractReducer.ForkingPickler.__getattribute__", "Return getattr(self, name)."), - ("builtins.AbstractReducer.ForkingPickler.__getstate__", "Helper for pickle."), - ("builtins.AbstractReducer.ForkingPickler.__gt__", "Return self>value."), - ("builtins.AbstractReducer.ForkingPickler.__hash__", "Return hash(self)."), - ("builtins.AbstractReducer.ForkingPickler.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.AbstractReducer.ForkingPickler.__le__", "Return self<=value."), - ("builtins.AbstractReducer.ForkingPickler.__lt__", "Return self=value."), - ("builtins.AbstractReducer.__getattribute__", "Return getattr(self, name)."), - ("builtins.AbstractReducer.__getstate__", "Helper for pickle."), - ("builtins.AbstractReducer.__gt__", "Return self>value."), - ("builtins.AbstractReducer.__hash__", "Return hash(self)."), - ("builtins.AbstractReducer.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.AbstractReducer.__le__", "Return self<=value."), - ("builtins.AbstractReducer.__lt__", "Return self=value."), - ("builtins.AbstractServer.__getattribute__", "Return getattr(self, name)."), - ("builtins.AbstractServer.__getstate__", "Helper for pickle."), - ("builtins.AbstractServer.__gt__", "Return self>value."), - ("builtins.AbstractServer.__hash__", "Return hash(self)."), - ("builtins.AbstractServer.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.AbstractServer.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.AbstractServer.__le__", "Return self<=value."), - ("builtins.AbstractServer.__lt__", "Return self=value."), - ("builtins.AddrlistClass.__getattribute__", "Return getattr(self, name)."), - ("builtins.AddrlistClass.__getstate__", "Helper for pickle."), - ("builtins.AddrlistClass.__gt__", "Return self>value."), - ("builtins.AddrlistClass.__hash__", "Return hash(self)."), - ("builtins.AddrlistClass.__init__", "Initialize a new instance.\n\n'field' is an unparsed address header field, containing\none or more addresses."), - ("builtins.AddrlistClass.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.AddrlistClass.__le__", "Return self<=value."), - ("builtins.AddrlistClass.__lt__", "Return self=value."), - ("builtins.Any.__getattribute__", "Return getattr(self, name)."), - ("builtins.Any.__getstate__", "Helper for pickle."), - ("builtins.Any.__gt__", "Return self>value."), - ("builtins.Any.__hash__", "Return hash(self)."), - ("builtins.Any.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.Any.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Any.__le__", "Return self<=value."), - ("builtins.Any.__lt__", "Return self=value."), - ("builtins.ArgResolver.__getattribute__", "Return getattr(self, name)."), - ("builtins.ArgResolver.__getstate__", "Helper for pickle."), - ("builtins.ArgResolver.__gt__", "Return self>value."), - ("builtins.ArgResolver.__hash__", "Return hash(self)."), - ("builtins.ArgResolver.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.ArgResolver.__le__", "Return self<=value."), - ("builtins.ArgResolver.__lt__", "Return self=value."), - ("builtins.ArgumentDescriptor.__getattribute__", "Return getattr(self, name)."), - ("builtins.ArgumentDescriptor.__getstate__", "Helper for pickle."), - ("builtins.ArgumentDescriptor.__gt__", "Return self>value."), - ("builtins.ArgumentDescriptor.__hash__", "Return hash(self)."), - ("builtins.ArgumentDescriptor.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.ArgumentDescriptor.__le__", "Return self<=value."), - ("builtins.ArgumentDescriptor.__lt__", "Return self=value."), - ("builtins.AsyncContextDecorator.__getattribute__", "Return getattr(self, name)."), - ("builtins.AsyncContextDecorator.__getstate__", "Helper for pickle."), - ("builtins.AsyncContextDecorator.__gt__", "Return self>value."), - ("builtins.AsyncContextDecorator.__hash__", "Return hash(self)."), - ("builtins.AsyncContextDecorator.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.AsyncContextDecorator.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.AsyncContextDecorator.__le__", "Return self<=value."), - ("builtins.AsyncContextDecorator.__lt__", "Return self=value."), - ("builtins.AsyncIterable.__getattribute__", "Return getattr(self, name)."), - ("builtins.AsyncIterable.__getstate__", "Helper for pickle."), - ("builtins.AsyncIterable.__gt__", "Return self>value."), - ("builtins.AsyncIterable.__hash__", "Return hash(self)."), - ("builtins.AsyncIterable.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.AsyncIterable.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.AsyncIterable.__le__", "Return self<=value."), - ("builtins.AsyncIterable.__lt__", "Return self=value."), - ("builtins.Awaitable.__getattribute__", "Return getattr(self, name)."), - ("builtins.Awaitable.__getstate__", "Helper for pickle."), - ("builtins.Awaitable.__gt__", "Return self>value."), - ("builtins.Awaitable.__hash__", "Return hash(self)."), - ("builtins.Awaitable.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.Awaitable.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Awaitable.__le__", "Return self<=value."), - ("builtins.Awaitable.__lt__", "Return self=value."), - ("builtins.Barrier.__getattribute__", "Return getattr(self, name)."), - ("builtins.Barrier.__getstate__", "Helper for pickle."), - ("builtins.Barrier.__gt__", "Return self>value."), - ("builtins.Barrier.__hash__", "Return hash(self)."), - ("builtins.Barrier.__init__", "Create a barrier, initialised to 'parties' threads.\n\n'action' is a callable which, when supplied, will be called by one of\nthe threads after they have all entered the barrier and just prior to\nreleasing them all. If a 'timeout' is provided, it is used as the\ndefault for all subsequent 'wait()' calls."), - ("builtins.Barrier.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Barrier.__le__", "Return self<=value."), - ("builtins.Barrier.__lt__", "Return self=value."), - ("builtins.BaseBrowser.__getattribute__", "Return getattr(self, name)."), - ("builtins.BaseBrowser.__getstate__", "Helper for pickle."), - ("builtins.BaseBrowser.__gt__", "Return self>value."), - ("builtins.BaseBrowser.__hash__", "Return hash(self)."), - ("builtins.BaseBrowser.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.BaseBrowser.__le__", "Return self<=value."), - ("builtins.BaseBrowser.__lt__", "Return self=value."), - ("builtins.BaseContext.AuthenticationError.__getattribute__", "Return getattr(self, name)."), - ("builtins.BaseContext.AuthenticationError.__getstate__", "Helper for pickle."), - ("builtins.BaseContext.AuthenticationError.__gt__", "Return self>value."), - ("builtins.BaseContext.AuthenticationError.__hash__", "Return hash(self)."), - ("builtins.BaseContext.AuthenticationError.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.BaseContext.AuthenticationError.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.BaseContext.AuthenticationError.__le__", "Return self<=value."), - ("builtins.BaseContext.AuthenticationError.__lt__", "Return self=value."), - ("builtins.BaseContext.BufferTooShort.__getattribute__", "Return getattr(self, name)."), - ("builtins.BaseContext.BufferTooShort.__getstate__", "Helper for pickle."), - ("builtins.BaseContext.BufferTooShort.__gt__", "Return self>value."), - ("builtins.BaseContext.BufferTooShort.__hash__", "Return hash(self)."), - ("builtins.BaseContext.BufferTooShort.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.BaseContext.BufferTooShort.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.BaseContext.BufferTooShort.__le__", "Return self<=value."), - ("builtins.BaseContext.BufferTooShort.__lt__", "Return self=value."), - ("builtins.BaseContext.ProcessError.__getattribute__", "Return getattr(self, name)."), - ("builtins.BaseContext.ProcessError.__getstate__", "Helper for pickle."), - ("builtins.BaseContext.ProcessError.__gt__", "Return self>value."), - ("builtins.BaseContext.ProcessError.__hash__", "Return hash(self)."), - ("builtins.BaseContext.ProcessError.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.BaseContext.ProcessError.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.BaseContext.ProcessError.__le__", "Return self<=value."), - ("builtins.BaseContext.ProcessError.__lt__", "Return self=value."), - ("builtins.BaseContext.TimeoutError.__getattribute__", "Return getattr(self, name)."), - ("builtins.BaseContext.TimeoutError.__getstate__", "Helper for pickle."), - ("builtins.BaseContext.TimeoutError.__gt__", "Return self>value."), - ("builtins.BaseContext.TimeoutError.__hash__", "Return hash(self)."), - ("builtins.BaseContext.TimeoutError.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.BaseContext.TimeoutError.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.BaseContext.TimeoutError.__le__", "Return self<=value."), - ("builtins.BaseContext.TimeoutError.__lt__", "Return self=value."), - ("builtins.BaseContext.__getattribute__", "Return getattr(self, name)."), - ("builtins.BaseContext.__getstate__", "Helper for pickle."), - ("builtins.BaseContext.__gt__", "Return self>value."), - ("builtins.BaseContext.__hash__", "Return hash(self)."), - ("builtins.BaseContext.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.BaseContext.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.BaseContext.__le__", "Return self<=value."), - ("builtins.BaseContext.__lt__", "Return self=value."), - ("builtins.BaseFilter.__getattribute__", "Return getattr(self, name)."), - ("builtins.BaseFilter.__getstate__", "Helper for pickle."), - ("builtins.BaseFilter.__gt__", "Return self>value."), - ("builtins.BaseFilter.__hash__", "Return hash(self)."), - ("builtins.BaseFilter.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.BaseFilter.__le__", "Return self<=value."), - ("builtins.BaseFilter.__lt__", "Return self=value."), - ("builtins.BaseProcess.__getattribute__", "Return getattr(self, name)."), - ("builtins.BaseProcess.__getstate__", "Helper for pickle."), - ("builtins.BaseProcess.__gt__", "Return self>value."), - ("builtins.BaseProcess.__hash__", "Return hash(self)."), - ("builtins.BaseProcess.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.BaseProcess.__le__", "Return self<=value."), - ("builtins.BaseProcess.__lt__", "Return self=value."), - ("builtins.BaseProtocol.__getattribute__", "Return getattr(self, name)."), - ("builtins.BaseProtocol.__getstate__", "Helper for pickle."), - ("builtins.BaseProtocol.__gt__", "Return self>value."), - ("builtins.BaseProtocol.__hash__", "Return hash(self)."), - ("builtins.BaseProtocol.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.BaseProtocol.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.BaseProtocol.__le__", "Return self<=value."), - ("builtins.BaseProtocol.__lt__", "Return self=value."), - ("builtins.BaseRequestHandler.__getattribute__", "Return getattr(self, name)."), - ("builtins.BaseRequestHandler.__getstate__", "Helper for pickle."), - ("builtins.BaseRequestHandler.__gt__", "Return self>value."), - ("builtins.BaseRequestHandler.__hash__", "Return hash(self)."), - ("builtins.BaseRequestHandler.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.BaseRequestHandler.__le__", "Return self<=value."), - ("builtins.BaseRequestHandler.__lt__", "Return self=value."), - ("builtins.BaseSelector.__getattribute__", "Return getattr(self, name)."), - ("builtins.BaseSelector.__getstate__", "Helper for pickle."), - ("builtins.BaseSelector.__gt__", "Return self>value."), - ("builtins.BaseSelector.__hash__", "Return hash(self)."), - ("builtins.BaseSelector.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.BaseSelector.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.BaseSelector.__le__", "Return self<=value."), - ("builtins.BaseSelector.__lt__", "Return self 0, this specifies the maximum wait time, in\n seconds\n if timeout <= 0, the select() call won't block, and will\n report the currently ready file objects\n if timeout is None, select() will block until a monitored\n file object becomes ready\n\nReturns:\nlist of (key, events) for ready file objects\n`events` is a bitwise mask of EVENT_READ|EVENT_WRITE"), - ("builtins.BaseSelector.unregister", "Unregister a file object.\n\nParameters:\nfileobj -- file object or file descriptor\n\nReturns:\nSelectorKey instance\n\nRaises:\nKeyError if fileobj is not registered\n\nNote:\nIf fileobj is registered but has since been closed this does\n*not* raise OSError (even if the wrapped syscall does)"), - ("builtins.BaseServer", "Base class for server classes.\n\nMethods for the caller:\n\n- __init__(server_address, RequestHandlerClass)\n- serve_forever(poll_interval=0.5)\n- shutdown()\n- handle_request() # if you do not use serve_forever()\n- fileno() -> int # for selector\n\nMethods that may be overridden:\n\n- server_bind()\n- server_activate()\n- get_request() -> request, client_address\n- handle_timeout()\n- verify_request(request, client_address)\n- server_close()\n- process_request(request, client_address)\n- shutdown_request(request)\n- close_request(request)\n- service_actions()\n- handle_error()\n\nMethods for derived classes:\n\n- finish_request(request, client_address)\n\nClass variables that may be overridden by derived classes or\ninstances:\n\n- timeout\n- address_family\n- socket_type\n- allow_reuse_address\n- allow_reuse_port\n\nInstance variables:\n\n- RequestHandlerClass\n- socket"), - ("builtins.BaseServer.__delattr__", "Implement delattr(self, name)."), - ("builtins.BaseServer.__eq__", "Return self==value."), - ("builtins.BaseServer.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.BaseServer.__ge__", "Return self>=value."), - ("builtins.BaseServer.__getattribute__", "Return getattr(self, name)."), - ("builtins.BaseServer.__getstate__", "Helper for pickle."), - ("builtins.BaseServer.__gt__", "Return self>value."), - ("builtins.BaseServer.__hash__", "Return hash(self)."), - ("builtins.BaseServer.__init__", "Constructor. May be extended, do not override."), - ("builtins.BaseServer.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.BaseServer.__le__", "Return self<=value."), - ("builtins.BaseServer.__lt__", "Return self=value."), - ("builtins.BaseTestSuite.__getattribute__", "Return getattr(self, name)."), - ("builtins.BaseTestSuite.__getstate__", "Helper for pickle."), - ("builtins.BaseTestSuite.__gt__", "Return self>value."), - ("builtins.BaseTestSuite.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.BaseTestSuite.__le__", "Return self<=value."), - ("builtins.BaseTestSuite.__lt__", "Return self=value."), - ("builtins.BaseTransport.__getattribute__", "Return getattr(self, name)."), - ("builtins.BaseTransport.__getstate__", "Helper for pickle."), - ("builtins.BaseTransport.__gt__", "Return self>value."), - ("builtins.BaseTransport.__hash__", "Return hash(self)."), - ("builtins.BaseTransport.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.BaseTransport.__le__", "Return self<=value."), - ("builtins.BaseTransport.__lt__", "Return self=value."), - ("builtins.Bdb.__getattribute__", "Return getattr(self, name)."), - ("builtins.Bdb.__getstate__", "Helper for pickle."), - ("builtins.Bdb.__gt__", "Return self>value."), - ("builtins.Bdb.__hash__", "Return hash(self)."), - ("builtins.Bdb.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Bdb.__le__", "Return self<=value."), - ("builtins.Bdb.__lt__", "Return self\", generated in interactive\nmode, are returned unchanged."), - ("builtins.Bdb.clear_all_breaks", "Delete all existing breakpoints.\n\nIf none were set, return an error message."), - ("builtins.Bdb.clear_all_file_breaks", "Delete all breakpoints in filename.\n\nIf none were set, return an error message."), - ("builtins.Bdb.clear_bpbynumber", "Delete a breakpoint by its index in Breakpoint.bpbynumber.\n\nIf arg is invalid, return an error message."), - ("builtins.Bdb.clear_break", "Delete breakpoints for filename:lineno.\n\nIf no breakpoints were set, return an error message."), - ("builtins.Bdb.disable_current_event", "Disable the current event."), - ("builtins.Bdb.dispatch_call", "Invoke user function and return trace function for call event.\n\nIf the debugger stops on this function call, invoke\nself.user_call(). Raise BdbQuit if self.quitting is set.\nReturn self.trace_dispatch to continue tracing in this scope."), - ("builtins.Bdb.dispatch_exception", "Invoke user function and return trace function for exception event.\n\nIf the debugger stops on this exception, invoke\nself.user_exception(). Raise BdbQuit if self.quitting is set.\nReturn self.trace_dispatch to continue tracing in this scope."), - ("builtins.Bdb.dispatch_line", "Invoke user function and return trace function for line event.\n\nIf the debugger stops on the current line, invoke\nself.user_line(). Raise BdbQuit if self.quitting is set.\nReturn self.trace_dispatch to continue tracing in this scope."), - ("builtins.Bdb.dispatch_opcode", "Invoke user function and return trace function for opcode event.\nIf the debugger stops on the current opcode, invoke\nself.user_opcode(). Raise BdbQuit if self.quitting is set.\nReturn self.trace_dispatch to continue tracing in this scope.\n\nOpcode event will always trigger the user callback. For now the only\nopcode event is from an inline set_trace() and we want to stop there\nunconditionally."), - ("builtins.Bdb.dispatch_return", "Invoke user function and return trace function for return event.\n\nIf the debugger stops on this function return, invoke\nself.user_return(). Raise BdbQuit if self.quitting is set.\nReturn self.trace_dispatch to continue tracing in this scope."), - ("builtins.Bdb.do_clear", "Remove temporary breakpoint.\n\nMust implement in derived classes or get NotImplementedError."), - ("builtins.Bdb.format_stack_entry", "Return a string with information about a stack entry.\n\nThe stack entry frame_lineno is a (frame, lineno) tuple. The\nreturn string contains the canonical filename, the function name\nor '', the input arguments, the return value, and the\nline of code (if it exists)."), - ("builtins.Bdb.get_all_breaks", "Return all breakpoints that are set."), - ("builtins.Bdb.get_bpbynumber", "Return a breakpoint by its index in Breakpoint.bybpnumber.\n\nFor invalid arg values or if the breakpoint doesn't exist,\nraise a ValueError."), - ("builtins.Bdb.get_break", "Return True if there is a breakpoint for filename:lineno."), - ("builtins.Bdb.get_breaks", "Return all breakpoints for filename:lineno.\n\nIf no breakpoints are set, return an empty list."), - ("builtins.Bdb.get_file_breaks", "Return all lines with breakpoints for filename.\n\nIf no breakpoints are set, return an empty list."), - ("builtins.Bdb.get_stack", "Return a list of (frame, lineno) in a stack trace and a size.\n\nList starts with original calling frame, if there is one.\nSize may be number of frames above or below f."), - ("builtins.Bdb.is_skipped_module", "Return True if module_name matches any skip pattern."), - ("builtins.Bdb.reset", "Set values of attributes as ready to start debugging."), - ("builtins.Bdb.restart_events", "Restart all events."), - ("builtins.Bdb.run", "Debug a statement executed via the exec() function.\n\nglobals defaults to __main__.dict; locals defaults to globals."), - ("builtins.Bdb.runcall", "Debug a single function call.\n\nReturn the result of the function call."), - ("builtins.Bdb.runctx", "For backwards-compatibility. Defers to run()."), - ("builtins.Bdb.runeval", "Debug an expression executed via the eval() function.\n\nglobals defaults to __main__.dict; locals defaults to globals."), - ("builtins.Bdb.set_break", "Set a new breakpoint for filename:lineno.\n\nIf lineno doesn't exist for the filename, return an error message.\nThe filename should be in canonical form."), - ("builtins.Bdb.set_continue", "Stop only at breakpoints or when finished.\n\nIf there are no breakpoints, set the system trace function to None."), - ("builtins.Bdb.set_next", "Stop on the next line in or below the given frame."), - ("builtins.Bdb.set_quit", "Set quitting attribute to True.\n\nRaises BdbQuit exception in the next call to a dispatch_*() method."), - ("builtins.Bdb.set_return", "Stop when returning from the given frame."), - ("builtins.Bdb.set_step", "Stop after one line of code."), - ("builtins.Bdb.set_stepinstr", "Stop before the next instruction."), - ("builtins.Bdb.set_trace", "Start debugging from frame.\n\nIf frame is not specified, debugging starts from caller's frame."), - ("builtins.Bdb.set_until", "Stop when the line with the lineno greater than the current one is\nreached or when returning from current frame."), - ("builtins.Bdb.stop_here", "Return True if frame is below the starting frame in the stack."), - ("builtins.Bdb.trace_dispatch", "Dispatch a trace function for debugged frames based on the event.\n\nThis function is installed as the trace function for debugged\nframes. Its return value is the new trace function, which is\nusually itself. The default implementation decides how to\ndispatch a frame, depending on the type of event (passed in as a\nstring) that is about to be executed.\n\nThe event can be one of the following:\n line: A new line of code is going to be executed.\n call: A function is about to be called or another code block\n is entered.\n return: A function or other code block is about to return.\n exception: An exception has occurred.\n c_call: A C function is about to be called.\n c_return: A C function has returned.\n c_exception: A C function has raised an exception.\n\nFor the Python events, specialized functions (see the dispatch_*()\nmethods) are called. For the C events, no action is taken.\n\nThe arg parameter depends on the previous event."), - ("builtins.Bdb.user_call", "Called if we might stop in a function."), - ("builtins.Bdb.user_exception", "Called when we stop on an exception."), - ("builtins.Bdb.user_line", "Called when we stop or break at a line."), - ("builtins.Bdb.user_opcode", "Called when we are about to execute an opcode."), - ("builtins.Bdb.user_return", "Called when a return trap is set here."), ("builtins.Blob.__delattr__", "Implement delattr(self, name)."), ("builtins.Blob.__delitem__", "Delete self[key]."), ("builtins.Blob.__enter__", "Blob context manager enter."), @@ -10741,28 +9906,6 @@ pub const DB: &[(&str, &str)] = &[ ("builtins.Blob.seek", "Set the current access position to offset.\n\nThe origin argument defaults to os.SEEK_SET (absolute blob\npositioning). Other values for origin are os.SEEK_CUR (seek\nrelative to the current position) and os.SEEK_END (seek relative to\nthe blob's end)."), ("builtins.Blob.tell", "Return the current access position for the blob."), ("builtins.Blob.write", "Write data at the current offset.\n\nThis function cannot change the blob length. Writing beyond the end\nof the blob will result in an exception being raised."), - ("builtins.BlockFinder", "Provide a tokeneater() method to detect the end of a code block."), - ("builtins.BlockFinder.__delattr__", "Implement delattr(self, name)."), - ("builtins.BlockFinder.__eq__", "Return self==value."), - ("builtins.BlockFinder.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.BlockFinder.__ge__", "Return self>=value."), - ("builtins.BlockFinder.__getattribute__", "Return getattr(self, name)."), - ("builtins.BlockFinder.__getstate__", "Helper for pickle."), - ("builtins.BlockFinder.__gt__", "Return self>value."), - ("builtins.BlockFinder.__hash__", "Return hash(self)."), - ("builtins.BlockFinder.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.BlockFinder.__le__", "Return self<=value."), - ("builtins.BlockFinder.__lt__", "Return self=value."), - ("builtins.BoundArguments.__getattribute__", "Return getattr(self, name)."), - ("builtins.BoundArguments.__gt__", "Return self>value."), - ("builtins.BoundArguments.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.BoundArguments.__le__", "Return self<=value."), - ("builtins.BoundArguments.__lt__", "Return self=value."), - ("builtins.Breakpoint.__getattribute__", "Return getattr(self, name)."), - ("builtins.Breakpoint.__getstate__", "Helper for pickle."), - ("builtins.Breakpoint.__gt__", "Return self>value."), - ("builtins.Breakpoint.__hash__", "Return hash(self)."), - ("builtins.Breakpoint.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Breakpoint.__le__", "Return self<=value."), - ("builtins.Breakpoint.__lt__", "Return self=value."), - ("builtins.Buffer.__getattribute__", "Return getattr(self, name)."), - ("builtins.Buffer.__getstate__", "Helper for pickle."), - ("builtins.Buffer.__gt__", "Return self>value."), - ("builtins.Buffer.__hash__", "Return hash(self)."), - ("builtins.Buffer.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.Buffer.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Buffer.__le__", "Return self<=value."), - ("builtins.Buffer.__lt__", "Return self=value."), - ("builtins.BufferingFormatter.__getattribute__", "Return getattr(self, name)."), - ("builtins.BufferingFormatter.__getstate__", "Helper for pickle."), - ("builtins.BufferingFormatter.__gt__", "Return self>value."), - ("builtins.BufferingFormatter.__hash__", "Return hash(self)."), - ("builtins.BufferingFormatter.__init__", "Optionally specify a formatter which will be used to format each\nindividual record."), - ("builtins.BufferingFormatter.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.BufferingFormatter.__le__", "Return self<=value."), - ("builtins.BufferingFormatter.__lt__", "Return self=value."), - ("builtins.BuiltinImporter.__getattribute__", "Return getattr(self, name)."), - ("builtins.BuiltinImporter.__getstate__", "Helper for pickle."), - ("builtins.BuiltinImporter.__gt__", "Return self>value."), - ("builtins.BuiltinImporter.__hash__", "Return hash(self)."), - ("builtins.BuiltinImporter.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.BuiltinImporter.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.BuiltinImporter.__le__", "Return self<=value."), - ("builtins.BuiltinImporter.__lt__", "Return self=value."), - ("builtins.Bytecode.__getattribute__", "Return getattr(self, name)."), - ("builtins.Bytecode.__getstate__", "Helper for pickle."), - ("builtins.Bytecode.__gt__", "Return self>value."), - ("builtins.Bytecode.__hash__", "Return hash(self)."), - ("builtins.Bytecode.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Bytecode.__le__", "Return self<=value."), - ("builtins.Bytecode.__lt__", "Return self.qsort -> callable object\n['qsort'] -> callable object\n\nCalling the functions releases the Python GIL during the call and\nreacquires it afterwards."), - ("builtins.CDLL.__delattr__", "Implement delattr(self, name)."), - ("builtins.CDLL.__eq__", "Return self==value."), - ("builtins.CDLL.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.CDLL.__ge__", "Return self>=value."), - ("builtins.CDLL.__getattribute__", "Return getattr(self, name)."), - ("builtins.CDLL.__getstate__", "Helper for pickle."), - ("builtins.CDLL.__gt__", "Return self>value."), - ("builtins.CDLL.__hash__", "Return hash(self)."), - ("builtins.CDLL.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.CDLL.__le__", "Return self<=value."), - ("builtins.CDLL.__lt__", "Return self=value."), - ("builtins.Calendar.__getattribute__", "Return getattr(self, name)."), - ("builtins.Calendar.__getstate__", "Helper for pickle."), - ("builtins.Calendar.__gt__", "Return self>value."), - ("builtins.Calendar.__hash__", "Return hash(self)."), - ("builtins.Calendar.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Calendar.__le__", "Return self<=value."), - ("builtins.Calendar.__lt__", "Return self=value."), - ("builtins.Callable.__getattribute__", "Return getattr(self, name)."), - ("builtins.Callable.__getstate__", "Helper for pickle."), - ("builtins.Callable.__gt__", "Return self>value."), - ("builtins.Callable.__hash__", "Return hash(self)."), - ("builtins.Callable.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.Callable.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Callable.__le__", "Return self<=value."), - ("builtins.Callable.__lt__", "Return self=value."), - ("builtins.Charset.__getattribute__", "Return getattr(self, name)."), - ("builtins.Charset.__getstate__", "Helper for pickle."), - ("builtins.Charset.__gt__", "Return self>value."), - ("builtins.Charset.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Charset.__le__", "Return self<=value."), - ("builtins.Charset.__lt__", "Return self=value."), - ("builtins.Cmd.__getattribute__", "Return getattr(self, name)."), - ("builtins.Cmd.__getstate__", "Helper for pickle."), - ("builtins.Cmd.__gt__", "Return self>value."), - ("builtins.Cmd.__hash__", "Return hash(self)."), - ("builtins.Cmd.__init__", "Instantiate a line-oriented interpreter framework.\n\nThe optional argument 'completekey' is the readline name of a\ncompletion key; it defaults to the Tab key. If completekey is\nnot None and the readline module is available, command completion\nis done automatically. The optional arguments stdin and stdout\nspecify alternate input and output file objects; if not specified,\nsys.stdin and sys.stdout are used."), - ("builtins.Cmd.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Cmd.__le__", "Return self<=value."), - ("builtins.Cmd.__lt__", "Return self to get list of completions."), - ("builtins.Cmd.completedefault", "Method called to complete an input line when no command-specific\ncomplete_*() method is available.\n\nBy default, it returns an empty list."), - ("builtins.Cmd.default", "Called on an input line when the command prefix is not recognized.\n\nIf this method is not overridden, it prints an error message and\nreturns."), - ("builtins.Cmd.do_help", "List available commands with \"help\" or detailed help with \"help cmd\"."), - ("builtins.Cmd.emptyline", "Called when an empty line is entered in response to the prompt.\n\nIf this method is not overridden, it repeats the last nonempty\ncommand entered."), - ("builtins.Cmd.onecmd", "Interpret the argument as though it had been typed in response\nto the prompt.\n\nThis may be overridden, but should not normally need to be;\nsee the precmd() and postcmd() methods for useful execution hooks.\nThe return value is a flag indicating whether interpretation of\ncommands by the interpreter should stop."), - ("builtins.Cmd.parseline", "Parse the line into a command name and a string containing\nthe arguments. Returns a tuple containing (command, args, line).\n'command' and 'args' may be None if the line couldn't be parsed."), - ("builtins.Cmd.postcmd", "Hook method executed just after a command dispatch is finished."), - ("builtins.Cmd.postloop", "Hook method executed once when the cmdloop() method is about to\nreturn."), - ("builtins.Cmd.precmd", "Hook method executed just before the command line is\ninterpreted, but after the input prompt is generated and issued."), - ("builtins.Cmd.preloop", "Hook method executed once when the cmdloop() method is called."), - ("builtins.Codec", "Defines the interface for stateless encoders/decoders.\n\nThe .encode()/.decode() methods may use different error\nhandling schemes by providing the errors argument. These\nstring values are predefined:\n\n 'strict' - raise a ValueError error (or a subclass)\n 'ignore' - ignore the character and continue with the next\n 'replace' - replace with a suitable replacement character;\n Python will use the official U+FFFD REPLACEMENT\n CHARACTER for the builtin Unicode codecs on\n decoding and '?' on encoding.\n 'surrogateescape' - replace with private code points U+DCnn.\n 'xmlcharrefreplace' - Replace with the appropriate XML\n character reference (only for encoding).\n 'backslashreplace' - Replace with backslashed escape sequences.\n 'namereplace' - Replace with \\N{...} escape sequences\n (only for encoding).\n\nThe set of allowed values can be extended via register_error."), - ("builtins.Codec.__delattr__", "Implement delattr(self, name)."), - ("builtins.Codec.__eq__", "Return self==value."), - ("builtins.Codec.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.Codec.__ge__", "Return self>=value."), - ("builtins.Codec.__getattribute__", "Return getattr(self, name)."), - ("builtins.Codec.__getstate__", "Helper for pickle."), - ("builtins.Codec.__gt__", "Return self>value."), - ("builtins.Codec.__hash__", "Return hash(self)."), - ("builtins.Codec.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.Codec.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Codec.__le__", "Return self<=value."), - ("builtins.Codec.__lt__", "Return self\"\nsymbol -- optional grammar start symbol; \"single\" (default) or\n \"eval\"\n\nReturn value / exceptions raised:\n\n- Return a code object if the command is complete and valid\n- Return None if the command is incomplete\n- Raise SyntaxError, ValueError or OverflowError if the command is a\n syntax error (OverflowError and ValueError can be produced by\n malformed literals)."), - ("builtins.CommandCompiler.__delattr__", "Implement delattr(self, name)."), - ("builtins.CommandCompiler.__eq__", "Return self==value."), - ("builtins.CommandCompiler.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.CommandCompiler.__ge__", "Return self>=value."), - ("builtins.CommandCompiler.__getattribute__", "Return getattr(self, name)."), - ("builtins.CommandCompiler.__getstate__", "Helper for pickle."), - ("builtins.CommandCompiler.__gt__", "Return self>value."), - ("builtins.CommandCompiler.__hash__", "Return hash(self)."), - ("builtins.CommandCompiler.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.CommandCompiler.__le__", "Return self<=value."), - ("builtins.CommandCompiler.__lt__", "Return self=value."), - ("builtins.Compile.__getattribute__", "Return getattr(self, name)."), - ("builtins.Compile.__getstate__", "Helper for pickle."), - ("builtins.Compile.__gt__", "Return self>value."), - ("builtins.Compile.__hash__", "Return hash(self)."), - ("builtins.Compile.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Compile.__le__", "Return self<=value."), - ("builtins.Compile.__lt__", "Return self=value."), - ("builtins.CompletedProcess.__getattribute__", "Return getattr(self, name)."), - ("builtins.CompletedProcess.__getstate__", "Helper for pickle."), - ("builtins.CompletedProcess.__gt__", "Return self>value."), - ("builtins.CompletedProcess.__hash__", "Return hash(self)."), - ("builtins.CompletedProcess.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.CompletedProcess.__le__", "Return self<=value."), - ("builtins.CompletedProcess.__lt__", "Return self=value."), - ("builtins.Completer.__getattribute__", "Return getattr(self, name)."), - ("builtins.Completer.__getstate__", "Helper for pickle."), - ("builtins.Completer.__gt__", "Return self>value."), - ("builtins.Completer.__hash__", "Return hash(self)."), - ("builtins.Completer.__init__", "Create a new completer for the command line.\n\nCompleter([namespace]) -> completer instance.\n\nIf unspecified, the default namespace where completions are performed\nis __main__ (technically, __main__.__dict__). Namespaces should be\ngiven as dictionaries.\n\nCompleter instances should be used as the completion mechanism of\nreadline via the set_completer() call:\n\nreadline.set_completer(Completer(my_namespace).complete)"), - ("builtins.Completer.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Completer.__le__", "Return self<=value."), - ("builtins.Completer.__lt__", "Return self=value."), - ("builtins.Condition.__getattribute__", "Return getattr(self, name)."), - ("builtins.Condition.__getstate__", "Helper for pickle."), - ("builtins.Condition.__gt__", "Return self>value."), - ("builtins.Condition.__hash__", "Return hash(self)."), - ("builtins.Condition.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Condition.__le__", "Return self<=value."), - ("builtins.Condition.__lt__", "Return self=value."), - ("builtins.Container.__getattribute__", "Return getattr(self, name)."), - ("builtins.Container.__getstate__", "Helper for pickle."), - ("builtins.Container.__gt__", "Return self>value."), - ("builtins.Container.__hash__", "Return hash(self)."), - ("builtins.Container.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.Container.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Container.__le__", "Return self<=value."), - ("builtins.Container.__lt__", "Return self>> ExtendedContext.abs(Decimal('2.1'))\nDecimal('2.1')\n>>> ExtendedContext.abs(Decimal('-100'))\nDecimal('100')\n>>> ExtendedContext.abs(Decimal('101.5'))\nDecimal('101.5')\n>>> ExtendedContext.abs(Decimal('-101.5'))\nDecimal('101.5')\n>>> ExtendedContext.abs(-1)\nDecimal('1')"), ("builtins.Context.add", "Return the sum of the two operands.\n\n>>> ExtendedContext.add(Decimal('12'), Decimal('7.00'))\nDecimal('19.00')\n>>> ExtendedContext.add(Decimal('1E+2'), Decimal('1.01E+4'))\nDecimal('1.02E+4')\n>>> ExtendedContext.add(1, Decimal(2))\nDecimal('3')\n>>> ExtendedContext.add(Decimal(8), 5)\nDecimal('13')\n>>> ExtendedContext.add(5, 5)\nDecimal('10')"), ("builtins.Context.canonical", "Returns the same Decimal object.\n\nAs we do not have different encodings for the same number, the\nreceived object already is in its canonical form.\n\n>>> ExtendedContext.canonical(Decimal('2.50'))\nDecimal('2.50')"), @@ -11861,30 +10550,6 @@ pub const DB: &[(&str, &str)] = &[ ("builtins.Context.to_integral_value", "Rounds to an integer.\n\nWhen the operand has a negative exponent, the result is the same\nas using the quantize() operation using the given operand as the\nleft-hand-operand, 1E+0 as the right-hand-operand, and the precision\nof the operand as the precision setting, except that no flags will\nbe set. The rounding mode is taken from the context.\n\n>>> ExtendedContext.to_integral_value(Decimal('2.1'))\nDecimal('2')\n>>> ExtendedContext.to_integral_value(Decimal('100'))\nDecimal('100')\n>>> ExtendedContext.to_integral_value(Decimal('100.0'))\nDecimal('100')\n>>> ExtendedContext.to_integral_value(Decimal('101.5'))\nDecimal('102')\n>>> ExtendedContext.to_integral_value(Decimal('-101.5'))\nDecimal('-102')\n>>> ExtendedContext.to_integral_value(Decimal('10E+5'))\nDecimal('1.0E+6')\n>>> ExtendedContext.to_integral_value(Decimal('7.89E+77'))\nDecimal('7.89E+77')\n>>> ExtendedContext.to_integral_value(Decimal('-Inf'))\nDecimal('-Infinity')"), ("builtins.Context.to_sci_string", "Converts a number to a string, using scientific notation.\n\nThe operation is not affected by the context."), ("builtins.Context.values", "Return a list of all variables' values in the context object."), - ("builtins.ContextDecorator", "A base class or mixin that enables context managers to work as decorators."), - ("builtins.ContextDecorator.__delattr__", "Implement delattr(self, name)."), - ("builtins.ContextDecorator.__eq__", "Return self==value."), - ("builtins.ContextDecorator.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.ContextDecorator.__ge__", "Return self>=value."), - ("builtins.ContextDecorator.__getattribute__", "Return getattr(self, name)."), - ("builtins.ContextDecorator.__getstate__", "Helper for pickle."), - ("builtins.ContextDecorator.__gt__", "Return self>value."), - ("builtins.ContextDecorator.__hash__", "Return hash(self)."), - ("builtins.ContextDecorator.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.ContextDecorator.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.ContextDecorator.__le__", "Return self<=value."), - ("builtins.ContextDecorator.__lt__", "Return self=value."), - ("builtins.CoverageResults.__getattribute__", "Return getattr(self, name)."), - ("builtins.CoverageResults.__getstate__", "Helper for pickle."), - ("builtins.CoverageResults.__gt__", "Return self>value."), - ("builtins.CoverageResults.__hash__", "Return hash(self)."), - ("builtins.CoverageResults.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.CoverageResults.__le__", "Return self<=value."), - ("builtins.CoverageResults.__lt__", "Return self=value."), - ("builtins.DEPRECATED_DEFAULT.__getattribute__", "Return getattr(self, name)."), - ("builtins.DEPRECATED_DEFAULT.__getstate__", "Helper for pickle."), - ("builtins.DEPRECATED_DEFAULT.__gt__", "Return self>value."), - ("builtins.DEPRECATED_DEFAULT.__hash__", "Return hash(self)."), - ("builtins.DEPRECATED_DEFAULT.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.DEPRECATED_DEFAULT.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.DEPRECATED_DEFAULT.__le__", "Return self<=value."), - ("builtins.DEPRECATED_DEFAULT.__lt__", "Return self= self. If self is infinite or a NaN then a\nPython exception is raised."), ("builtins.Decimal.__delattr__", "Implement delattr(self, name)."), ("builtins.Decimal.__divmod__", "Return (self // other, self % other)"), ("builtins.Decimal.__eq__", "Return self==value."), ("builtins.Decimal.__float__", "Float representation."), - ("builtins.Decimal.__floor__", "Return the floor of self, as an integer.\n\nFor a finite Decimal instance self, return the greatest\ninteger n such that n <= self. If self is infinite or a NaN\nthen a Python exception is raised."), ("builtins.Decimal.__floordiv__", "self // other"), - ("builtins.Decimal.__format__", "Format a Decimal instance according to the given specifier.\n\nThe specifier should be a standard format specifier, with the\nform described in PEP 3101. Formatting types 'e', 'E', 'f',\n'F', 'g', 'G', 'n' and '%' are supported. If the formatting\ntype is omitted it defaults to 'g' or 'G', depending on the\nvalue of context.capitals."), ("builtins.Decimal.__ge__", "Return self>=value."), ("builtins.Decimal.__getattribute__", "Return getattr(self, name)."), ("builtins.Decimal.__getstate__", "Helper for pickle."), @@ -12070,42 +10684,14 @@ pub const DB: &[(&str, &str)] = &[ ("builtins.Decimal.__rfloordiv__", "Swaps self/other and returns __floordiv__."), ("builtins.Decimal.__rmod__", "Swaps self/other and returns __mod__."), ("builtins.Decimal.__rmul__", "Return self * other.\n\n(+-) INF * 0 (or its reverse) raise InvalidOperation."), - ("builtins.Decimal.__round__", "Round self to the nearest integer, or to a given precision.\n\nIf only one argument is supplied, round a finite Decimal\ninstance self to the nearest integer. If self is infinite or\na NaN then a Python exception is raised. If self is finite\nand lies exactly halfway between two integers then it is\nrounded to the integer with even last digit.\n\n>>> round(Decimal('123.456'))\n123\n>>> round(Decimal('-456.789'))\n-457\n>>> round(Decimal('-3.0'))\n-3\n>>> round(Decimal('2.5'))\n2\n>>> round(Decimal('3.5'))\n4\n>>> round(Decimal('Inf'))\nTraceback (most recent call last):\n ...\nOverflowError: cannot round an infinity\n>>> round(Decimal('NaN'))\nTraceback (most recent call last):\n ...\nValueError: cannot round a NaN\n\nIf a second argument n is supplied, self is rounded to n\ndecimal places using the rounding mode for the current\ncontext.\n\nFor an integer n, round(self, -n) is exactly equivalent to\nself.quantize(Decimal('1En')).\n\n>>> round(Decimal('123.456'), 0)\nDecimal('123')\n>>> round(Decimal('123.456'), 2)\nDecimal('123.46')\n>>> round(Decimal('123.456'), -2)\nDecimal('1E+2')\n>>> round(Decimal('-Infinity'), 37)\nDecimal('NaN')\n>>> round(Decimal('sNaN123'), 0)\nDecimal('NaN123')"), ("builtins.Decimal.__rpow__", "Swaps self/other and returns __pow__."), ("builtins.Decimal.__rsub__", "Return other - self"), ("builtins.Decimal.__rtruediv__", "Swaps self/other and returns __truediv__."), ("builtins.Decimal.__setattr__", "Implement setattr(self, name, value)."), - ("builtins.Decimal.__sizeof__", "Size of object in memory, in bytes."), ("builtins.Decimal.__str__", "Return string representation of the number in scientific notation.\n\nCaptures all of the information in the underlying representation."), ("builtins.Decimal.__sub__", "Return self - other"), ("builtins.Decimal.__subclasshook__", "Abstract classes can override this to customize issubclass().\n\nThis is invoked early on by abc.ABCMeta.__subclasscheck__().\nIt should return True, False or NotImplemented. If it returns\nNotImplemented, the normal algorithm is used. Otherwise, it\noverrides the normal algorithm (and the outcome is cached)."), ("builtins.Decimal.__truediv__", "Return self / other."), - ("builtins.Decimal.__trunc__", "Converts self to an int, truncating if necessary."), - ("builtins.Decimal._check_nans", "Returns whether the number is not actually one.\n\nif self, other are sNaN, signal\nif self, other are NaN return nan\nreturn 0\n\nDone before operations."), - ("builtins.Decimal._cmp", "Compare the two non-NaN decimal instances self and other.\n\nReturns -1 if self < other, 0 if self == other and 1\nif self > other. This routine is for internal use only."), - ("builtins.Decimal._compare_check_nans", "Version of _check_nans used for the signaling comparisons\ncompare_signal, __le__, __lt__, __ge__, __gt__.\n\nSignal InvalidOperation if either self or other is a (quiet\nor signaling) NaN. Signaling NaNs take precedence over quiet\nNaNs.\n\nReturn 0 if neither operand is a NaN."), - ("builtins.Decimal._divide", "Return (self // other, self % other), to context.prec precision.\n\nAssumes that neither self nor other is a NaN, that self is not\ninfinite and that other is nonzero."), - ("builtins.Decimal._fix", "Round if it is necessary to keep self within prec precision.\n\nRounds and fixes the exponent. Does not raise on a sNaN.\n\nArguments:\nself - Decimal instance\ncontext - context used."), - ("builtins.Decimal._fix_nan", "Decapitate the payload of a NaN to fit the context"), - ("builtins.Decimal._iseven", "Returns True if self is even. Assumes self is an integer."), - ("builtins.Decimal._isinfinity", "Returns whether the number is infinite\n\n0 if finite or not a number\n1 if +INF\n-1 if -INF"), - ("builtins.Decimal._isinteger", "Returns whether self is an integer"), - ("builtins.Decimal._islogical", "Return True if self is a logical operand.\n\nFor being logical, it must be a finite number with a sign of 0,\nan exponent of 0, and a coefficient whose digits must all be\neither 0 or 1."), - ("builtins.Decimal._isnan", "Returns whether the number is not actually one.\n\n0 if a number\n1 if NaN\n2 if sNaN"), - ("builtins.Decimal._ln_exp_bound", "Compute a lower bound for the adjusted exponent of self.ln().\nIn other words, compute r such that self.ln() >= 10**r. Assumes\nthat self is finite and positive and that self != 1."), - ("builtins.Decimal._log10_exp_bound", "Compute a lower bound for the adjusted exponent of self.log10().\nIn other words, find r such that self.log10() >= 10**r.\nAssumes that self is finite and positive and that self != 1."), - ("builtins.Decimal._power_exact", "Attempt to compute self**other exactly.\n\nGiven Decimals self and other and an integer p, attempt to\ncompute an exact result for the power self**other, with p\ndigits of precision. Return None if self**other is not\nexactly representable in p digits.\n\nAssumes that elimination of special cases has already been\nperformed: self and other must both be nonspecial; self must\nbe positive and not numerically equal to 1; other must be\nnonzero. For efficiency, other._exp should not be too large,\nso that 10**abs(other._exp) is a feasible calculation."), - ("builtins.Decimal._power_modulo", "Three argument version of __pow__"), - ("builtins.Decimal._rescale", "Rescale self so that the exponent is exp, either by padding with zeros\nor by truncating digits, using the given rounding mode.\n\nSpecials are returned without change. This operation is\nquiet: it raises no flags, and uses no information from the\ncontext.\n\nexp = exp to scale to (an integer)\nrounding = rounding mode"), - ("builtins.Decimal._round", "Round a nonzero, nonspecial Decimal to a fixed number of\nsignificant figures, using the given rounding mode.\n\nInfinities, NaNs and zeros are returned unaltered.\n\nThis operation is quiet: it raises no flags, and uses no\ninformation from the context."), - ("builtins.Decimal._round_05up", "Round down unless digit prec-1 is 0 or 5."), - ("builtins.Decimal._round_ceiling", "Rounds up (not away from 0 if negative.)"), - ("builtins.Decimal._round_down", "Also known as round-towards-0, truncate."), - ("builtins.Decimal._round_floor", "Rounds down (not towards 0 if negative)"), - ("builtins.Decimal._round_half_down", "Round 5 down"), - ("builtins.Decimal._round_half_even", "Round 5 to even, rest to nearest."), - ("builtins.Decimal._round_half_up", "Rounds 5 up (away from 0)"), - ("builtins.Decimal._round_up", "Rounds away from 0."), ("builtins.Decimal.adjusted", "Return the adjusted exponent of self"), ("builtins.Decimal.as_integer_ratio", "Express a finite Decimal instance in the form n / d.\n\nReturns a pair (n, d) of integers. When called on an infinity\nor NaN, raises OverflowError or ValueError respectively.\n\n>>> Decimal('3.14').as_integer_ratio()\n(157, 50)\n>>> Decimal('-123e5').as_integer_ratio()\n(-12300000, 1)\n>>> Decimal('0.00').as_integer_ratio()\n(0, 1)"), ("builtins.Decimal.as_tuple", "Represents the number as a triple tuple.\n\nTo show the internals exactly as they are."), @@ -12229,7 +10815,6 @@ pub const DB: &[(&str, &str)] = &[ ("builtins.Dialect.__sizeof__", "Size of object in memory, in bytes."), ("builtins.Dialect.__str__", "Return str(self)."), ("builtins.Dialect.__subclasshook__", "Abstract classes can override this to customize issubclass().\n\nThis is invoked early on by abc.ABCMeta.__subclasscheck__().\nIt should return True, False or NotImplemented. If it returns\nNotImplemented, the normal algorithm is used. Otherwise, it\noverrides the normal algorithm (and the outcome is cached)."), - ("builtins.Dialect.__weakref__", "list of weak references to the object"), ("builtins.Dialog.__delattr__", "Implement delattr(self, name)."), ("builtins.Dialog.__eq__", "Return self==value."), ("builtins.Dialog.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), @@ -12251,28 +10836,6 @@ pub const DB: &[(&str, &str)] = &[ ("builtins.Dialog.__str__", "Return str(self)."), ("builtins.Dialog.__subclasshook__", "Abstract classes can override this to customize issubclass().\n\nThis is invoked early on by abc.ABCMeta.__subclasscheck__().\nIt should return True, False or NotImplemented. If it returns\nNotImplemented, the normal algorithm is used. Otherwise, it\noverrides the normal algorithm (and the outcome is cached)."), ("builtins.Dialog.__weakref__", "list of weak references to the object"), - ("builtins.DictReader.__class_getitem__", "Represent a PEP 585 generic type\n\nFor example, for t = list[int], t.__origin__ is list and t.__args__\nis (int,)."), - ("builtins.DictReader.__delattr__", "Implement delattr(self, name)."), - ("builtins.DictReader.__eq__", "Return self==value."), - ("builtins.DictReader.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.DictReader.__ge__", "Return self>=value."), - ("builtins.DictReader.__getattribute__", "Return getattr(self, name)."), - ("builtins.DictReader.__getstate__", "Helper for pickle."), - ("builtins.DictReader.__gt__", "Return self>value."), - ("builtins.DictReader.__hash__", "Return hash(self)."), - ("builtins.DictReader.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.DictReader.__le__", "Return self<=value."), - ("builtins.DictReader.__lt__", "Return self=value."), - ("builtins.DictWriter.__getattribute__", "Return getattr(self, name)."), - ("builtins.DictWriter.__getstate__", "Helper for pickle."), - ("builtins.DictWriter.__gt__", "Return self>value."), - ("builtins.DictWriter.__hash__", "Return hash(self)."), - ("builtins.DictWriter.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.DictWriter.__le__", "Return self<=value."), - ("builtins.DictWriter.__lt__", "Return self>> text1 = ''' 1. Beautiful is better than ugly.\n... 2. Explicit is better than implicit.\n... 3. Simple is better than complex.\n... 4. Complex is better than complicated.\n... '''.splitlines(keepends=True)\n>>> len(text1)\n4\n>>> text1[0][-1]\n'\\n'\n>>> text2 = ''' 1. Beautiful is better than ugly.\n... 3. Simple is better than complex.\n... 4. Complicated is better than complex.\n... 5. Flat is better than nested.\n... '''.splitlines(keepends=True)\n\nNext we instantiate a Differ object:\n\n>>> d = Differ()\n\nNote that when instantiating a Differ object we may pass functions to\nfilter out line and character 'junk'. See Differ.__init__ for details.\n\nFinally, we compare the two:\n\n>>> result = list(d.compare(text1, text2))\n\n'result' is a list of strings, so let's pretty-print it:\n\n>>> from pprint import pprint as _pprint\n>>> _pprint(result)\n[' 1. Beautiful is better than ugly.\\n',\n '- 2. Explicit is better than implicit.\\n',\n '- 3. Simple is better than complex.\\n',\n '+ 3. Simple is better than complex.\\n',\n '? ++\\n',\n '- 4. Complex is better than complicated.\\n',\n '? ^ ---- ^\\n',\n '+ 4. Complicated is better than complex.\\n',\n '? ++++ ^ ^\\n',\n '+ 5. Flat is better than nested.\\n']\n\nAs a single multi-line string it looks like this:\n\n>>> print(''.join(result), end=\"\")\n 1. Beautiful is better than ugly.\n- 2. Explicit is better than implicit.\n- 3. Simple is better than complex.\n+ 3. Simple is better than complex.\n? ++\n- 4. Complex is better than complicated.\n? ^ ---- ^\n+ 4. Complicated is better than complex.\n? ++++ ^ ^\n+ 5. Flat is better than nested."), - ("builtins.Differ.__delattr__", "Implement delattr(self, name)."), - ("builtins.Differ.__eq__", "Return self==value."), - ("builtins.Differ.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.Differ.__ge__", "Return self>=value."), - ("builtins.Differ.__getattribute__", "Return getattr(self, name)."), - ("builtins.Differ.__getstate__", "Helper for pickle."), - ("builtins.Differ.__gt__", "Return self>value."), - ("builtins.Differ.__hash__", "Return hash(self)."), - ("builtins.Differ.__init__", "Construct a text differencer, with optional filters.\n\nThe two optional keyword parameters are for filter functions:\n\n- `linejunk`: A function that should accept a single string argument,\n and return true iff the string is junk. The module-level function\n `IS_LINE_JUNK` may be used to filter out lines without visible\n characters, except for at most one splat ('#'). It is recommended\n to leave linejunk None; the underlying SequenceMatcher class has\n an adaptive notion of \"noise\" lines that's better than any static\n definition the author has ever been able to craft.\n\n- `charjunk`: A function that should accept a string of length 1. The\n module-level function `IS_CHARACTER_JUNK` may be used to filter out\n whitespace characters (a blank or tab; **note**: bad idea to include\n newline in this!). Use of IS_CHARACTER_JUNK is recommended."), - ("builtins.Differ.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Differ.__le__", "Return self<=value."), - ("builtins.Differ.__lt__", "Return self>> d = Differ()\n>>> results = d._fancy_replace(['abcDefghiJkl\\n'], 0, 1,\n... ['abcdefGhijkl\\n'], 0, 1)\n>>> print(''.join(results), end=\"\")\n- abcDefghiJkl\n? ^ ^ ^\n+ abcdefGhijkl\n? ^ ^ ^"), - ("builtins.Differ._qformat", "Format \"?\" output and deal with tabs.\n\nExample:\n\n>>> d = Differ()\n>>> results = d._qformat('\\tabcDefghiJkl\\n', '\\tabcdefGhijkl\\n',\n... ' ^ ^ ^ ', ' ^ ^ ^ ')\n>>> for line in results: print(repr(line))\n...\n'- \\tabcDefghiJkl\\n'\n'? \\t ^ ^ ^\\n'\n'+ \\tabcdefGhijkl\\n'\n'? \\t ^ ^ ^\\n'"), - ("builtins.Differ.compare", "Compare two sequences of lines; generate the resulting delta.\n\nEach sequence must contain individual single-line strings ending with\nnewlines. Such sequences can be obtained from the `readlines()` method\nof file-like objects. The delta generated also consists of newline-\nterminated strings, ready to be printed as-is via the writelines()\nmethod of a file-like object.\n\nExample:\n\n>>> print(''.join(Differ().compare('one\\ntwo\\nthree\\n'.splitlines(True),\n... 'ore\\ntree\\nemu\\n'.splitlines(True))),\n... end=\"\")\n- one\n? ^\n+ ore\n? ^\n- two\n- three\n? -\n+ tree\n+ emu"), ("builtins.DirEntry.__class_getitem__", "DirEntry is generic over the type of the path (str or bytes)"), ("builtins.DirEntry.__delattr__", "Implement delattr(self, name)."), ("builtins.DirEntry.__eq__", "Return self==value."), @@ -12376,147 +10890,6 @@ pub const DB: &[(&str, &str)] = &[ ("builtins.DirEntry.name", "the entry's base filename, relative to scandir() \"path\" argument"), ("builtins.DirEntry.path", "the entry's full path name; equivalent to\nos.path.join(scandir_path, entry.name)"), ("builtins.DirEntry.stat", "Return stat_result object for the entry; cached per entry."), - ("builtins.Doc.__delattr__", "Implement delattr(self, name)."), - ("builtins.Doc.__eq__", "Return self==value."), - ("builtins.Doc.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.Doc.__ge__", "Return self>=value."), - ("builtins.Doc.__getattribute__", "Return getattr(self, name)."), - ("builtins.Doc.__getstate__", "Helper for pickle."), - ("builtins.Doc.__gt__", "Return self>value."), - ("builtins.Doc.__hash__", "Return hash(self)."), - ("builtins.Doc.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.Doc.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Doc.__le__", "Return self<=value."), - ("builtins.Doc.__lt__", "Return self=value."), - ("builtins.DocTest.__getattribute__", "Return getattr(self, name)."), - ("builtins.DocTest.__getstate__", "Helper for pickle."), - ("builtins.DocTest.__gt__", "Return self>value."), - ("builtins.DocTest.__init__", "Create a new DocTest containing the given examples. The\nDocTest's globals are initialized with a copy of `globs`."), - ("builtins.DocTest.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.DocTest.__le__", "Return self<=value."), - ("builtins.DocTest.__ne__", "Return self!=value."), - ("builtins.DocTest.__new__", "Create and return a new object. See help(type) for accurate signature."), - ("builtins.DocTest.__reduce__", "Helper for pickle."), - ("builtins.DocTest.__reduce_ex__", "Helper for pickle."), - ("builtins.DocTest.__setattr__", "Implement setattr(self, name, value)."), - ("builtins.DocTest.__sizeof__", "Size of object in memory, in bytes."), - ("builtins.DocTest.__str__", "Return str(self)."), - ("builtins.DocTest.__subclasshook__", "Abstract classes can override this to customize issubclass().\n\nThis is invoked early on by abc.ABCMeta.__subclasscheck__().\nIt should return True, False or NotImplemented. If it returns\nNotImplemented, the normal algorithm is used. Otherwise, it\noverrides the normal algorithm (and the outcome is cached)."), - ("builtins.DocTest.__weakref__", "list of weak references to the object"), - ("builtins.DocTestFinder", "A class used to extract the DocTests that are relevant to a given\nobject, from its docstring and the docstrings of its contained\nobjects. Doctests can currently be extracted from the following\nobject types: modules, functions, classes, methods, staticmethods,\nclassmethods, and properties."), - ("builtins.DocTestFinder.__delattr__", "Implement delattr(self, name)."), - ("builtins.DocTestFinder.__eq__", "Return self==value."), - ("builtins.DocTestFinder.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.DocTestFinder.__ge__", "Return self>=value."), - ("builtins.DocTestFinder.__getattribute__", "Return getattr(self, name)."), - ("builtins.DocTestFinder.__getstate__", "Helper for pickle."), - ("builtins.DocTestFinder.__gt__", "Return self>value."), - ("builtins.DocTestFinder.__hash__", "Return hash(self)."), - ("builtins.DocTestFinder.__init__", "Create a new doctest finder.\n\nThe optional argument `parser` specifies a class or\nfunction that should be used to create new DocTest objects (or\nobjects that implement the same interface as DocTest). The\nsignature for this factory function should match the signature\nof the DocTest constructor.\n\nIf the optional argument `recurse` is false, then `find` will\nonly examine the given object, and not any contained objects.\n\nIf the optional argument `exclude_empty` is false, then `find`\nwill include tests for objects with empty docstrings."), - ("builtins.DocTestFinder.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.DocTestFinder.__le__", "Return self<=value."), - ("builtins.DocTestFinder.__lt__", "Return self=value."), - ("builtins.DocTestParser.__getattribute__", "Return getattr(self, name)."), - ("builtins.DocTestParser.__getstate__", "Helper for pickle."), - ("builtins.DocTestParser.__gt__", "Return self>value."), - ("builtins.DocTestParser.__hash__", "Return hash(self)."), - ("builtins.DocTestParser.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.DocTestParser.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.DocTestParser.__le__", "Return self<=value."), - ("builtins.DocTestParser.__lt__", "Return self>> save_colorize = _colorize.COLORIZE\n >>> _colorize.COLORIZE = False\n\n >>> tests = DocTestFinder().find(_TestClass)\n >>> runner = DocTestRunner(verbose=False)\n >>> tests.sort(key = lambda test: test.name)\n >>> for test in tests:\n ... print(test.name, '->', runner.run(test))\n _TestClass -> TestResults(failed=0, attempted=2)\n _TestClass.__init__ -> TestResults(failed=0, attempted=2)\n _TestClass.get -> TestResults(failed=0, attempted=2)\n _TestClass.square -> TestResults(failed=0, attempted=1)\n\nThe `summarize` method prints a summary of all the test cases that\nhave been run by the runner, and returns an aggregated TestResults\ninstance:\n\n >>> runner.summarize(verbose=1)\n 4 items passed all tests:\n 2 tests in _TestClass\n 2 tests in _TestClass.__init__\n 2 tests in _TestClass.get\n 1 test in _TestClass.square\n 7 tests in 4 items.\n 7 passed.\n Test passed.\n TestResults(failed=0, attempted=7)\n\nThe aggregated number of tried examples and failed examples is also\navailable via the `tries`, `failures` and `skips` attributes:\n\n >>> runner.tries\n 7\n >>> runner.failures\n 0\n >>> runner.skips\n 0\n\nThe comparison between expected outputs and actual outputs is done\nby an `OutputChecker`. This comparison may be customized with a\nnumber of option flags; see the documentation for `testmod` for\nmore information. If the option flags are insufficient, then the\ncomparison may also be customized by passing a subclass of\n`OutputChecker` to the constructor.\n\nThe test runner's display output can be controlled in two ways.\nFirst, an output function (`out`) can be passed to\n`TestRunner.run`; this function will be called with strings that\nshould be displayed. It defaults to `sys.stdout.write`. If\ncapturing the output is not sufficient, then the display output\ncan be also customized by subclassing DocTestRunner, and\noverriding the methods `report_start`, `report_success`,\n`report_unexpected_exception`, and `report_failure`.\n\n >>> _colorize.COLORIZE = save_colorize"), - ("builtins.DocTestRunner._DocTestRunner__record_outcome", "Record the fact that the given DocTest (`test`) generated `failures`\nfailures out of `tries` tried examples."), - ("builtins.DocTestRunner._DocTestRunner__run", "Run the examples in `test`. Write the outcome of each example\nwith one of the `DocTestRunner.report_*` methods, using the\nwriter function `out`. `compileflags` is the set of compiler\nflags that should be used to execute examples. Return a TestResults\ninstance. The examples are run in the namespace `test.globs`."), - ("builtins.DocTestRunner.__delattr__", "Implement delattr(self, name)."), - ("builtins.DocTestRunner.__eq__", "Return self==value."), - ("builtins.DocTestRunner.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.DocTestRunner.__ge__", "Return self>=value."), - ("builtins.DocTestRunner.__getattribute__", "Return getattr(self, name)."), - ("builtins.DocTestRunner.__getstate__", "Helper for pickle."), - ("builtins.DocTestRunner.__gt__", "Return self>value."), - ("builtins.DocTestRunner.__hash__", "Return hash(self)."), - ("builtins.DocTestRunner.__init__", "Create a new test runner.\n\nOptional keyword arg `checker` is the `OutputChecker` that\nshould be used to compare the expected outputs and actual\noutputs of doctest examples.\n\nOptional keyword arg 'verbose' prints lots of stuff if true,\nonly failures if false; by default, it's true iff '-v' is in\nsys.argv.\n\nOptional argument `optionflags` can be used to control how the\ntest runner compares expected output to actual output, and how\nit displays failures. See the documentation for `testmod` for\nmore information."), - ("builtins.DocTestRunner.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.DocTestRunner.__le__", "Return self<=value."), - ("builtins.DocTestRunner.__lt__", "Return self=value."), - ("builtins.DynamicClassAttribute.__getattribute__", "Return getattr(self, name)."), - ("builtins.DynamicClassAttribute.__getstate__", "Helper for pickle."), - ("builtins.DynamicClassAttribute.__gt__", "Return self>value."), - ("builtins.DynamicClassAttribute.__hash__", "Return hash(self)."), - ("builtins.DynamicClassAttribute.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.DynamicClassAttribute.__le__", "Return self<=value."), - ("builtins.DynamicClassAttribute.__lt__", "Return self>> class Color(Enum):\n... RED = 1\n... BLUE = 2\n... GREEN = 3\n\nAccess them by:\n\n- attribute access:\n\n >>> Color.RED\n \n\n- value lookup:\n\n >>> Color(1)\n \n\n- name lookup:\n\n >>> Color['RED']\n \n\nEnumerations can be iterated over, and know how many members they have:\n\n>>> len(Color)\n3\n\n>>> list(Color)\n[, , ]\n\nMethods can be added to enumerations, and members can have their own\nattributes -- see the documentation for details."), - ("builtins.Enum.__contains__", "Return True if `value` is in `cls`.\n\n`value` is in `cls` if:\n1) `value` is a member of `cls`, or\n2) `value` is the value of one of the `cls`'s members.\n3) `value` is a pseudo-member (flags)"), - ("builtins.Enum.__getitem__", "Return the member matching `name`."), - ("builtins.Enum.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Enum.__iter__", "Return members in definition order."), - ("builtins.Enum.__len__", "Return the number of members (no aliases)"), - ("builtins.EnvBuilder", "This class exists to allow virtual environment creation to be\ncustomized. The constructor parameters determine the builder's\nbehaviour when called upon to create a virtual environment.\n\nBy default, the builder makes the system (global) site-packages dir\n*un*available to the created environment.\n\nIf invoked using the Python -m option, the default is to use copying\non Windows platforms but symlinks elsewhere. If instantiated some\nother way, the default is to *not* use symlinks.\n\n:param system_site_packages: If True, the system (global) site-packages\n dir is available to created environments.\n:param clear: If True, delete the contents of the environment directory if\n it already exists, before environment creation.\n:param symlinks: If True, attempt to symlink rather than copy files into\n virtual environment.\n:param upgrade: If True, upgrade an existing virtual environment.\n:param with_pip: If True, ensure pip is installed in the virtual\n environment\n:param prompt: Alternative terminal prefix for the environment.\n:param upgrade_deps: Update the base venv modules to the latest on PyPI\n:param scm_ignore_files: Create ignore files for the SCMs specified by the\n iterable."), - ("builtins.EnvBuilder.__delattr__", "Implement delattr(self, name)."), - ("builtins.EnvBuilder.__eq__", "Return self==value."), - ("builtins.EnvBuilder.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.EnvBuilder.__ge__", "Return self>=value."), - ("builtins.EnvBuilder.__getattribute__", "Return getattr(self, name)."), - ("builtins.EnvBuilder.__getstate__", "Helper for pickle."), - ("builtins.EnvBuilder.__gt__", "Return self>value."), - ("builtins.EnvBuilder.__hash__", "Return hash(self)."), - ("builtins.EnvBuilder.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.EnvBuilder.__le__", "Return self<=value."), - ("builtins.EnvBuilder.__lt__", "Return self=value."), - ("builtins.Event.__getattribute__", "Return getattr(self, name)."), - ("builtins.Event.__getstate__", "Helper for pickle."), - ("builtins.Event.__gt__", "Return self>value."), - ("builtins.Event.__hash__", "Return hash(self)."), ("builtins.Event.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.Event.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Event.__le__", "Return self<=value."), - ("builtins.Event.__lt__", "Return self=value."), - ("builtins.Example.__getattribute__", "Return getattr(self, name)."), - ("builtins.Example.__getstate__", "Helper for pickle."), - ("builtins.Example.__gt__", "Return self>value."), - ("builtins.Example.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Example.__le__", "Return self<=value."), - ("builtins.Example.__lt__", "Return self=value."), - ("builtins.Executor.__getattribute__", "Return getattr(self, name)."), - ("builtins.Executor.__getstate__", "Helper for pickle."), - ("builtins.Executor.__gt__", "Return self>value."), - ("builtins.Executor.__hash__", "Return hash(self)."), - ("builtins.Executor.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.Executor.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Executor.__le__", "Return self<=value."), - ("builtins.Executor.__lt__", "Return self=value."), - ("builtins.FTP.__getattribute__", "Return getattr(self, name)."), - ("builtins.FTP.__getstate__", "Helper for pickle."), - ("builtins.FTP.__gt__", "Return self>value."), - ("builtins.FTP.__hash__", "Return hash(self)."), - ("builtins.FTP.__init__", "Initialization method (called by class instantiation).\nInitialize host to localhost, port to standard ftp port.\nOptional arguments are host (for connect()),\nand user, passwd, acct (for login())."), - ("builtins.FTP.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.FTP.__le__", "Return self<=value."), - ("builtins.FTP.__lt__", "Return self (address, port)"), - ("builtins.FTP.makeport", "Create a new socket and send a PORT command for it."), - ("builtins.FTP.mkd", "Make a directory, return its full pathname."), - ("builtins.FTP.mlsd", "List a directory in a standardized format by using MLSD\ncommand (RFC-3659). If path is omitted the current directory\nis assumed. \"facts\" is a list of strings representing the type\nof information desired (e.g. [\"type\", \"size\", \"perm\"]).\n\nReturn a generator object yielding a tuple of two elements\nfor every file found in path.\nFirst element is the file name, the second one is a dictionary\nincluding a variable number of \"facts\" depending on the server\nand whether \"facts\" argument has been provided."), - ("builtins.FTP.nlst", "Return a list of files in a given directory (default the current)."), - ("builtins.FTP.ntransfercmd", "Initiate a transfer over the data connection.\n\nIf the transfer is active, send a port command and the\ntransfer command, and accept the connection. If the server is\npassive, send a pasv command, connect to it, and start the\ntransfer command. Either way, return the socket for the\nconnection and the expected size of the transfer. The\nexpected size may be None if it could not be determined.\n\nOptional 'rest' argument can be a string that is sent as the\nargument to a REST command. This is essentially a server\nmarker used to tell the server to skip over any data up to the\ngiven marker."), - ("builtins.FTP.pwd", "Return current working directory."), - ("builtins.FTP.quit", "Quit, and close the connection."), - ("builtins.FTP.rename", "Rename a file."), - ("builtins.FTP.retrbinary", "Retrieve data in binary mode. A new port is created for you.\n\nArgs:\n cmd: A RETR command.\n callback: A single parameter callable to be called on each\n block of data read.\n blocksize: The maximum number of bytes to read from the\n socket at one time. [default: 8192]\n rest: Passed to transfercmd(). [default: None]\n\nReturns:\n The response code."), - ("builtins.FTP.retrlines", "Retrieve data in line mode. A new port is created for you.\n\nArgs:\n cmd: A RETR, LIST, or NLST command.\n callback: An optional single parameter callable that is called\n for each line with the trailing CRLF stripped.\n [default: print_line()]\n\nReturns:\n The response code."), - ("builtins.FTP.rmd", "Remove a directory."), - ("builtins.FTP.sendcmd", "Send a command and return the response."), - ("builtins.FTP.sendeprt", "Send an EPRT command with the current host and the given port number."), - ("builtins.FTP.sendport", "Send a PORT command with the current host and the given\nport number."), - ("builtins.FTP.set_debuglevel", "Set the debugging level.\nThe required argument level means:\n0: no debugging output (default)\n1: print commands and responses but not body text etc.\n2: also print raw lines read and sent before stripping CR/LF"), - ("builtins.FTP.set_pasv", "Use passive or active mode for data transfers.\nWith a false argument, use the normal PORT mode,\nWith a true argument, use the PASV command."), - ("builtins.FTP.size", "Retrieve the size of a file."), - ("builtins.FTP.storbinary", "Store a file in binary mode. A new port is created for you.\n\nArgs:\n cmd: A STOR command.\n fp: A file-like object with a read(num_bytes) method.\n blocksize: The maximum data size to read from fp and send over\n the connection at once. [default: 8192]\n callback: An optional single parameter callable that is called on\n each block of data after it is sent. [default: None]\n rest: Passed to transfercmd(). [default: None]\n\nReturns:\n The response code."), - ("builtins.FTP.storlines", "Store a file in line mode. A new port is created for you.\n\nArgs:\n cmd: A STOR command.\n fp: A file-like object with a readline() method.\n callback: An optional single parameter callable that is called on\n each line after it is sent. [default: None]\n\nReturns:\n The response code."), - ("builtins.FTP.transfercmd", "Like ntransfercmd() but returns only the socket."), - ("builtins.FTP.voidcmd", "Send a command and expect a response beginning with '2'."), - ("builtins.FTP.voidresp", "Expect a response beginning with '2'."), - ("builtins.Field.__class_getitem__", "Represent a PEP 585 generic type\n\nFor example, for t = list[int], t.__origin__ is list and t.__args__\nis (int,)."), - ("builtins.Field.__delattr__", "Implement delattr(self, name)."), - ("builtins.Field.__eq__", "Return self==value."), - ("builtins.Field.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.Field.__ge__", "Return self>=value."), - ("builtins.Field.__getattribute__", "Return getattr(self, name)."), - ("builtins.Field.__getstate__", "Helper for pickle."), - ("builtins.Field.__gt__", "Return self>value."), - ("builtins.Field.__hash__", "Return hash(self)."), - ("builtins.Field.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Field.__le__", "Return self<=value."), - ("builtins.Field.__lt__", "Return self=value."), - ("builtins.FileFinder.__getattribute__", "Return getattr(self, name)."), - ("builtins.FileFinder.__getstate__", "Helper for pickle."), - ("builtins.FileFinder.__gt__", "Return self>value."), - ("builtins.FileFinder.__hash__", "Return hash(self)."), - ("builtins.FileFinder.__init__", "Initialize with the path to search on and a variable number of\n2-tuples containing the loader and the file suffixes the loader\nrecognizes."), - ("builtins.FileFinder.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.FileFinder.__le__", "Return self<=value."), - ("builtins.FileFinder.__lt__", "Return self=value."), - ("builtins.FileInput.__getattribute__", "Return getattr(self, name)."), - ("builtins.FileInput.__getstate__", "Helper for pickle."), - ("builtins.FileInput.__gt__", "Return self>value."), - ("builtins.FileInput.__hash__", "Return hash(self)."), - ("builtins.FileInput.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.FileInput.__le__", "Return self<=value."), - ("builtins.FileInput.__lt__", "Return self=value."), - ("builtins.FileLoader.__getattribute__", "Return getattr(self, name)."), - ("builtins.FileLoader.__getstate__", "Helper for pickle."), - ("builtins.FileLoader.__gt__", "Return self>value."), - ("builtins.FileLoader.__init__", "Cache the module name and the path to the file found by the\nfinder."), - ("builtins.FileLoader.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.FileLoader.__le__", "Return self<=value."), - ("builtins.FileLoader.__lt__", "Return self=value."), - ("builtins.FileType.__getattribute__", "Return getattr(self, name)."), - ("builtins.FileType.__getstate__", "Helper for pickle."), - ("builtins.FileType.__gt__", "Return self>value."), - ("builtins.FileType.__hash__", "Return hash(self)."), - ("builtins.FileType.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.FileType.__le__", "Return self<=value."), - ("builtins.FileType.__lt__", "Return self=value."), - ("builtins.Filter.__getattribute__", "Return getattr(self, name)."), - ("builtins.Filter.__getstate__", "Helper for pickle."), - ("builtins.Filter.__gt__", "Return self>value."), - ("builtins.Filter.__hash__", "Return hash(self)."), - ("builtins.Filter.__init__", "Initialize a filter.\n\nInitialize with the name of the logger which, together with its\nchildren, will have its events allowed through the filter. If no\nname is specified, allow every event."), - ("builtins.Filter.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Filter.__le__", "Return self<=value."), - ("builtins.Filter.__lt__", "Return self=value."), - ("builtins.Filterer.__getattribute__", "Return getattr(self, name)."), - ("builtins.Filterer.__getstate__", "Helper for pickle."), - ("builtins.Filterer.__gt__", "Return self>value."), - ("builtins.Filterer.__hash__", "Return hash(self)."), - ("builtins.Filterer.__init__", "Initialize the list of filters to be an empty list."), - ("builtins.Filterer.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Filterer.__le__", "Return self<=value."), - ("builtins.Filterer.__lt__", "Return self=value."), - ("builtins.Flags.__getattribute__", "Return getattr(self, name)."), - ("builtins.Flags.__getstate__", "Helper for pickle."), - ("builtins.Flags.__gt__", "Return self>value."), - ("builtins.Flags.__hash__", "Return hash(self)."), - ("builtins.Flags.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Flags.__le__", "Return self<=value."), - ("builtins.Flags.__lt__", "Return self=value."), - ("builtins.ForkingMixIn.__getattribute__", "Return getattr(self, name)."), - ("builtins.ForkingMixIn.__getstate__", "Helper for pickle."), - ("builtins.ForkingMixIn.__gt__", "Return self>value."), - ("builtins.ForkingMixIn.__hash__", "Return hash(self)."), - ("builtins.ForkingMixIn.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.ForkingMixIn.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.ForkingMixIn.__le__", "Return self<=value."), - ("builtins.ForkingMixIn.__lt__", "Return self=value."), - ("builtins.Formatter.__getattribute__", "Return getattr(self, name)."), - ("builtins.Formatter.__getstate__", "Helper for pickle."), - ("builtins.Formatter.__gt__", "Return self>value."), - ("builtins.Formatter.__hash__", "Return hash(self)."), - ("builtins.Formatter.__init__", "Initialize the formatter with specified format strings.\n\nInitialize the formatter either with the specified format string, or a\ndefault as described above. Allow for specialized date formatting with\nthe optional datefmt argument. If datefmt is omitted, you get an\nISO8601-like (or RFC 3339-like) format.\n\nUse a style parameter of '%', '{' or '$' to specify that you want to\nuse one of %-formatting, :meth:`str.format` (``{}``) formatting or\n:class:`string.Template` formatting in your format string.\n\n.. versionchanged:: 3.2\n Added the ``style`` parameter."), - ("builtins.Formatter.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Formatter.__le__", "Return self<=value."), - ("builtins.Formatter.__lt__", "Return self (tm_year,tm_mon,tm_mday,tm_hour,tm_min,\n tm_sec,tm_wday,tm_yday,tm_isdst)\n\nConvert seconds since the Epoch to a time tuple expressing local time.\nWhen 'seconds' is not passed in, convert the current time instead."), - ("builtins.Formatter.format", "Format the specified record as text.\n\nThe record's attribute dictionary is used as the operand to a\nstring formatting operation which yields the returned string.\nBefore formatting the dictionary, a couple of preparatory steps\nare carried out. The message attribute of the record is computed\nusing LogRecord.getMessage(). If the formatting string uses the\ntime (as determined by a call to usesTime(), formatTime() is\ncalled to format the event time. If there is exception information,\nit is formatted using formatException() and appended to the message."), - ("builtins.Formatter.formatException", "Format and return the specified exception information as a string.\n\nThis default implementation just uses\ntraceback.print_exception()"), - ("builtins.Formatter.formatStack", "This method is provided as an extension point for specialized\nformatting of stack information.\n\nThe input data is a string as returned from a call to\n:func:`traceback.print_stack`, but with the last trailing newline\nremoved.\n\nThe base implementation just returns the value passed in."), - ("builtins.Formatter.formatTime", "Return the creation time of the specified LogRecord as formatted text.\n\nThis method should be called from format() by a formatter which\nwants to make use of a formatted time. This method can be overridden\nin formatters to provide for any specific requirement, but the\nbasic behaviour is as follows: if datefmt (a string) is specified,\nit is used with time.strftime() to format the creation time of the\nrecord. Otherwise, an ISO8601-like (or RFC 3339-like) format is used.\nThe resulting string is returned. This function uses a user-configurable\nfunction to convert the creation time to a tuple. By default,\ntime.localtime() is used; to change this for a particular formatter\ninstance, set the 'converter' attribute to a function with the same\nsignature as time.localtime() or time.gmtime(). To change it for all\nformatters, for example if you want all logging times to be shown in GMT,\nset the 'converter' attribute in the Formatter class."), - ("builtins.Formatter.print_instruction_line", "Format instruction details for inclusion in disassembly output."), - ("builtins.Formatter.usesTime", "Check if the format uses the creation time of the record."), - ("builtins.ForwardRef", "Wrapper that holds a forward reference.\n\nConstructor arguments:\n* arg: a string representing the code to be evaluated.\n* module: the module where the forward reference was created.\n Must be a string, not a module object.\n* owner: The owning object (module, class, or function).\n* is_argument: Does nothing, retained for compatibility.\n* is_class: True if the forward reference was created in class scope."), - ("builtins.ForwardRef.__delattr__", "Implement delattr(self, name)."), - ("builtins.ForwardRef.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.ForwardRef.__ge__", "Return self>=value."), - ("builtins.ForwardRef.__getattribute__", "Return getattr(self, name)."), - ("builtins.ForwardRef.__getstate__", "Helper for pickle."), - ("builtins.ForwardRef.__gt__", "Return self>value."), - ("builtins.ForwardRef.__le__", "Return self<=value."), - ("builtins.ForwardRef.__lt__", "Return self= b. Computed by @total_ordering from (not a < b)."), - ("builtins.Frame.__getattribute__", "Return getattr(self, name)."), - ("builtins.Frame.__getstate__", "Helper for pickle."), - ("builtins.Frame.__gt__", "Return a > b. Computed by @total_ordering from (not a < b) and (a != b)."), - ("builtins.Frame.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Frame.__le__", "Return a <= b. Computed by @total_ordering from (a < b) or (a == b)."), - ("builtins.Frame.__ne__", "Return self!=value."), - ("builtins.Frame.__new__", "Create and return a new object. See help(type) for accurate signature."), - ("builtins.Frame.__reduce__", "Helper for pickle."), - ("builtins.Frame.__reduce_ex__", "Helper for pickle."), - ("builtins.Frame.__setattr__", "Implement setattr(self, name, value)."), - ("builtins.Frame.__sizeof__", "Size of object in memory, in bytes."), - ("builtins.Frame.__subclasshook__", "Abstract classes can override this to customize issubclass().\n\nThis is invoked early on by abc.ABCMeta.__subclasscheck__().\nIt should return True, False or NotImplemented. If it returns\nNotImplemented, the normal algorithm is used. Otherwise, it\noverrides the normal algorithm (and the outcome is cached)."), - ("builtins.FrameCallGraphEntry", "FrameCallGraphEntry(frame: frame)"), - ("builtins.FrameCallGraphEntry.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.FrameCallGraphEntry.__ge__", "Return self>=value."), - ("builtins.FrameCallGraphEntry.__getattribute__", "Return getattr(self, name)."), - ("builtins.FrameCallGraphEntry.__gt__", "Return self>value."), - ("builtins.FrameCallGraphEntry.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.FrameCallGraphEntry.__le__", "Return self<=value."), - ("builtins.FrameCallGraphEntry.__lt__", "Return self=value."), - ("builtins.FrameInfo.__getattribute__", "Return getattr(self, name)."), - ("builtins.FrameInfo.__getstate__", "Helper for pickle."), - ("builtins.FrameInfo.__gt__", "Return self>value."), - ("builtins.FrameInfo.__hash__", "Return hash(self)."), - ("builtins.FrameInfo.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.FrameInfo.__le__", "Return self<=value."), - ("builtins.FrameInfo.__lt__", "Return self=value."), - ("builtins.FrameSummary.__getattribute__", "Return getattr(self, name)."), - ("builtins.FrameSummary.__getstate__", "Helper for pickle."), - ("builtins.FrameSummary.__gt__", "Return self>value."), - ("builtins.FrameSummary.__init__", "Construct a FrameSummary.\n\n:param lookup_line: If True, `linecache` is consulted for the source\n code line. Otherwise, the line will be looked up when first needed.\n:param locals: If supplied the frame locals, which will be captured as\n object representations.\n:param line: If provided, use this instead of looking up the line in\n the linecache."), - ("builtins.FrameSummary.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.FrameSummary.__le__", "Return self<=value."), - ("builtins.FrameSummary.__lt__", "Return self=value."), - ("builtins.FrozenImporter.__getattribute__", "Return getattr(self, name)."), - ("builtins.FrozenImporter.__getstate__", "Helper for pickle."), - ("builtins.FrozenImporter.__gt__", "Return self>value."), - ("builtins.FrozenImporter.__hash__", "Return hash(self)."), - ("builtins.FrozenImporter.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.FrozenImporter.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.FrozenImporter.__le__", "Return self<=value."), - ("builtins.FrozenImporter.__lt__", "Return self=value."), - ("builtins.FunctionProfile.__getattribute__", "Return getattr(self, name)."), - ("builtins.FunctionProfile.__getstate__", "Helper for pickle."), - ("builtins.FunctionProfile.__gt__", "Return self>value."), - ("builtins.FunctionProfile.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.FunctionProfile.__le__", "Return self<=value."), - ("builtins.FunctionProfile.__lt__", "Return self=value."), - ("builtins.FutureCallGraph.__getattribute__", "Return getattr(self, name)."), - ("builtins.FutureCallGraph.__gt__", "Return self>value."), - ("builtins.FutureCallGraph.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.FutureCallGraph.__le__", "Return self<=value."), - ("builtins.FutureCallGraph.__lt__", "Return self=value."), - ("builtins.Generator.__getattribute__", "Return getattr(self, name)."), - ("builtins.Generator.__getstate__", "Helper for pickle."), - ("builtins.Generator.__gt__", "Return self>value."), - ("builtins.Generator.__hash__", "Return hash(self)."), - ("builtins.Generator.__init__", "Create the generator for message flattening.\n\noutfp is the output file-like object for writing the message to. It\nmust have a write() method.\n\nOptional mangle_from_ is a flag that, when True (the default if policy\nis not set), escapes From_ lines in the body of the message by putting\na '>' in front of them.\n\nOptional maxheaderlen specifies the longest length for a non-continued\nheader. When a header line is longer (in characters, with tabs\nexpanded to 8 spaces) than maxheaderlen, the header will split as\ndefined in the Header class. Set maxheaderlen to zero to disable\nheader wrapping. The default is 78, as recommended (but not required)\nby RFC 5322 section 2.1.1.\n\nThe policy keyword specifies a policy object that controls a number of\naspects of the generator's operation. If no policy is specified,\nthe policy associated with the Message object passed to the\nflatten method is used."), - ("builtins.Generator.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Generator.__le__", "Return self<=value."), - ("builtins.Generator.__lt__", "Return self=value."), - ("builtins.Handle.__getattribute__", "Return getattr(self, name)."), - ("builtins.Handle.__getstate__", "Helper for pickle."), - ("builtins.Handle.__gt__", "Return self>value."), - ("builtins.Handle.__hash__", "Return hash(self)."), - ("builtins.Handle.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Handle.__le__", "Return self<=value."), - ("builtins.Handle.__lt__", "Return self=value."), - ("builtins.Hashable.__getattribute__", "Return getattr(self, name)."), - ("builtins.Hashable.__getstate__", "Helper for pickle."), - ("builtins.Hashable.__gt__", "Return self>value."), - ("builtins.Hashable.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.Hashable.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Hashable.__le__", "Return self<=value."), - ("builtins.Hashable.__lt__", "Return self=value."), - ("builtins.Header.__getattribute__", "Return getattr(self, name)."), - ("builtins.Header.__getstate__", "Helper for pickle."), - ("builtins.Header.__gt__", "Return self>value."), - ("builtins.Header.__init__", "Create a MIME-compliant header that can contain many character sets.\n\nOptional s is the initial header value. If None, the initial header\nvalue is not set. You can later append to the header with .append()\nmethod calls. s may be a byte string or a Unicode string, but see the\n.append() documentation for semantics.\n\nOptional charset serves two purposes: it has the same meaning as the\ncharset argument to the .append() method. It also sets the default\ncharacter set for all subsequent .append() calls that omit the charset\nargument. If charset is not provided in the constructor, the us-ascii\ncharset is used both as s's initial charset and as the default for\nsubsequent .append() calls.\n\nThe maximum line length can be specified explicitly via maxlinelen. For\nsplitting the first line to a shorter value (to account for the field\nheader which isn't included in s, e.g. 'Subject') pass in the name of\nthe field in header_name. The default maxlinelen is 78 as recommended\nby RFC 2822.\n\ncontinuation_ws must be RFC 2822 compliant folding whitespace (usually\neither a space or a hard tab) which will be prepended to continuation\nlines.\n\nerrors is passed through to the .append() call."), - ("builtins.Header.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Header.__le__", "Return self<=value."), - ("builtins.Header.__lt__", "Return self=value."), - ("builtins.HelpFormatter._Section.__getattribute__", "Return getattr(self, name)."), - ("builtins.HelpFormatter._Section.__getstate__", "Helper for pickle."), - ("builtins.HelpFormatter._Section.__gt__", "Return self>value."), - ("builtins.HelpFormatter._Section.__hash__", "Return hash(self)."), - ("builtins.HelpFormatter._Section.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.HelpFormatter._Section.__le__", "Return self<=value."), - ("builtins.HelpFormatter._Section.__lt__", "Return self=value."), - ("builtins.HelpFormatter.__getattribute__", "Return getattr(self, name)."), - ("builtins.HelpFormatter.__getstate__", "Helper for pickle."), - ("builtins.HelpFormatter.__gt__", "Return self>value."), - ("builtins.HelpFormatter.__hash__", "Return hash(self)."), - ("builtins.HelpFormatter.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.HelpFormatter.__le__", "Return self<=value."), - ("builtins.HelpFormatter.__lt__", "Return self=value."), - ("builtins.Helper.__getattribute__", "Return getattr(self, name)."), - ("builtins.Helper.__getstate__", "Helper for pickle."), - ("builtins.Helper.__gt__", "Return self>value."), - ("builtins.Helper.__hash__", "Return hash(self)."), - ("builtins.Helper.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Helper.__le__", "Return self<=value."), - ("builtins.Helper.__lt__", "Return self=value."), - ("builtins.HtmlDiff.__getattribute__", "Return getattr(self, name)."), - ("builtins.HtmlDiff.__getstate__", "Helper for pickle."), - ("builtins.HtmlDiff.__gt__", "Return self>value."), - ("builtins.HtmlDiff.__hash__", "Return hash(self)."), - ("builtins.HtmlDiff.__init__", "HtmlDiff instance initializer\n\nArguments:\ntabsize -- tab stop spacing, defaults to 8.\nwrapcolumn -- column number where lines are broken and wrapped,\n defaults to None where lines are not wrapped.\nlinejunk,charjunk -- keyword arguments passed into ndiff() (used by\n HtmlDiff() to generate the side by side HTML differences). See\n ndiff() documentation for argument default values and descriptions."), - ("builtins.HtmlDiff.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.HtmlDiff.__le__", "Return self<=value."), - ("builtins.HtmlDiff.__lt__", "Return self.error(\"\").\nIMAP4 server errors raise .abort(\"\"),\nwhich is a sub-class of 'error'. Mailbox status changes\nfrom READ-WRITE to READ-ONLY raise the exception class\n.readonly(\"\"), which is a sub-class of 'abort'.\n\n\"error\" exceptions imply a program error.\n\"abort\" exceptions imply the connection should be reset, and\n the command re-tried.\n\"readonly\" exceptions imply the command should be re-tried.\n\nNote: to use this module, you must read the RFCs pertaining to the\nIMAP4 protocol, as the semantics of the arguments to each IMAP4\ncommand are left to the invoker, not to mention the results. Also,\nmost IMAP servers implement a sub-set of the commands available here."), - ("builtins.IMAP4._CRAM_MD5_AUTH", "Authobject to use with CRAM-MD5 authentication."), - ("builtins.IMAP4.__delattr__", "Implement delattr(self, name)."), - ("builtins.IMAP4.__eq__", "Return self==value."), - ("builtins.IMAP4.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.IMAP4.__ge__", "Return self>=value."), - ("builtins.IMAP4.__getattribute__", "Return getattr(self, name)."), - ("builtins.IMAP4.__getstate__", "Helper for pickle."), - ("builtins.IMAP4.__gt__", "Return self>value."), - ("builtins.IMAP4.__hash__", "Return hash(self)."), - ("builtins.IMAP4.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.IMAP4.__le__", "Return self<=value."), - ("builtins.IMAP4.__lt__", "Return self=value."), - ("builtins.IMAP4._responsetimeout.__getattribute__", "Return getattr(self, name)."), - ("builtins.IMAP4._responsetimeout.__getstate__", "Helper for pickle."), - ("builtins.IMAP4._responsetimeout.__gt__", "Return self>value."), - ("builtins.IMAP4._responsetimeout.__hash__", "Return hash(self)."), - ("builtins.IMAP4._responsetimeout.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.IMAP4._responsetimeout.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.IMAP4._responsetimeout.__le__", "Return self<=value."), - ("builtins.IMAP4._responsetimeout.__lt__", "Return self=value."), - ("builtins.IMAP4.abort.__getattribute__", "Return getattr(self, name)."), - ("builtins.IMAP4.abort.__getstate__", "Helper for pickle."), - ("builtins.IMAP4.abort.__gt__", "Return self>value."), - ("builtins.IMAP4.abort.__hash__", "Return hash(self)."), - ("builtins.IMAP4.abort.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.IMAP4.abort.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.IMAP4.abort.__le__", "Return self<=value."), - ("builtins.IMAP4.abort.__lt__", "Return self.append(mailbox, flags, date_time, message)\n\n All args except 'message' can be None."), - ("builtins.IMAP4.authenticate", "Authenticate command - requires response processing.\n\n'mechanism' specifies which authentication mechanism is to\nbe used - it must appear in .capabilities in the\nform AUTH=.\n\n'authobject' must be a callable object:\n\n data = authobject(response)\n\nIt will be called to process server continuation responses; the\nresponse argument it is passed will be a bytes. It should return bytes\ndata that will be base64 encoded and sent to the server. It should\nreturn None if the client abort response '*' should be sent instead."), - ("builtins.IMAP4.capability", "(typ, [data]) = .capability()\nFetch capabilities list from server."), - ("builtins.IMAP4.check", "Checkpoint mailbox on server.\n\n(typ, [data]) = .check()"), - ("builtins.IMAP4.close", "Close currently selected mailbox.\n\nDeleted messages are removed from writable mailbox.\nThis is the recommended command before 'LOGOUT'.\n\n(typ, [data]) = .close()"), - ("builtins.IMAP4.copy", "Copy 'message_set' messages onto end of 'new_mailbox'.\n\n(typ, [data]) = .copy(message_set, new_mailbox)"), - ("builtins.IMAP4.create", "Create new mailbox.\n\n(typ, [data]) = .create(mailbox)"), - ("builtins.IMAP4.delete", "Delete old mailbox.\n\n(typ, [data]) = .delete(mailbox)"), - ("builtins.IMAP4.deleteacl", "Delete the ACLs (remove any rights) set for who on mailbox.\n\n(typ, [data]) = .deleteacl(mailbox, who)"), - ("builtins.IMAP4.enable", "Send an RFC5161 enable string to the server.\n\n(typ, [data]) = .enable(capability)"), - ("builtins.IMAP4.error.__delattr__", "Implement delattr(self, name)."), - ("builtins.IMAP4.error.__eq__", "Return self==value."), - ("builtins.IMAP4.error.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.IMAP4.error.__ge__", "Return self>=value."), - ("builtins.IMAP4.error.__getattribute__", "Return getattr(self, name)."), - ("builtins.IMAP4.error.__getstate__", "Helper for pickle."), - ("builtins.IMAP4.error.__gt__", "Return self>value."), - ("builtins.IMAP4.error.__hash__", "Return hash(self)."), - ("builtins.IMAP4.error.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.IMAP4.error.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.IMAP4.error.__le__", "Return self<=value."), - ("builtins.IMAP4.error.__lt__", "Return self.expunge()\n\n'data' is list of 'EXPUNGE'd message numbers in order received."), - ("builtins.IMAP4.fetch", "Fetch (parts of) messages.\n\n(typ, [data, ...]) = .fetch(message_set, message_parts)\n\n'message_parts' should be a string of selected parts\nenclosed in parentheses, eg: \"(UID BODY[TEXT])\".\n\n'data' are tuples of message part envelope and data."), - ("builtins.IMAP4.getacl", "Get the ACLs for a mailbox.\n\n(typ, [data]) = .getacl(mailbox)"), - ("builtins.IMAP4.getannotation", "(typ, [data]) = .getannotation(mailbox, entry, attribute)\nRetrieve ANNOTATIONs."), - ("builtins.IMAP4.getquota", "Get the quota root's resource usage and limits.\n\nPart of the IMAP4 QUOTA extension defined in rfc2087.\n\n(typ, [data]) = .getquota(root)"), - ("builtins.IMAP4.getquotaroot", "Get the list of quota roots for the named mailbox.\n\n(typ, [[QUOTAROOT responses...], [QUOTA responses]]) = .getquotaroot(mailbox)"), - ("builtins.IMAP4.idle", "Return an iterable IDLE context manager producing untagged responses.\nIf the argument is not None, limit iteration to 'duration' seconds.\n\nwith M.idle(duration=29 * 60) as idler:\n for typ, data in idler:\n print(typ, data)\n\nNote: 'duration' requires a socket connection (not IMAP4_stream)."), - ("builtins.IMAP4.list", "List mailbox names in directory matching pattern.\n\n(typ, [data]) = .list(directory='', pattern='*')\n\n'data' is list of LIST responses."), - ("builtins.IMAP4.login", "Identify client using plaintext password.\n\n(typ, [data]) = .login(user, password)\n\nNB: 'password' will be quoted."), - ("builtins.IMAP4.login_cram_md5", "Force use of CRAM-MD5 authentication.\n\n(typ, [data]) = .login_cram_md5(user, password)"), - ("builtins.IMAP4.logout", "Shutdown connection to server.\n\n(typ, [data]) = .logout()\n\nReturns server 'BYE' response."), - ("builtins.IMAP4.lsub", "List 'subscribed' mailbox names in directory matching pattern.\n\n(typ, [data, ...]) = .lsub(directory='', pattern='*')\n\n'data' are tuples of message part envelope and data."), - ("builtins.IMAP4.myrights", "Show my ACLs for a mailbox (i.e. the rights that I have on mailbox).\n\n(typ, [data]) = .myrights(mailbox)"), - ("builtins.IMAP4.namespace", "Returns IMAP namespaces ala rfc2342\n\n(typ, [data, ...]) = .namespace()"), - ("builtins.IMAP4.noop", "Send NOOP command.\n\n(typ, [data]) = .noop()"), - ("builtins.IMAP4.open", "Setup connection to remote server on \"host:port\"\n (default: localhost:standard IMAP4 port).\nThis connection will be used by the routines:\n read, readline, send, shutdown."), - ("builtins.IMAP4.partial", "Fetch truncated part of a message.\n\n(typ, [data, ...]) = .partial(message_num, message_part, start, length)\n\n'data' is tuple of message part envelope and data."), - ("builtins.IMAP4.proxyauth", "Assume authentication as \"user\".\n\nAllows an authorised administrator to proxy into any user's\nmailbox.\n\n(typ, [data]) = .proxyauth(user)"), - ("builtins.IMAP4.read", "Read 'size' bytes from remote."), - ("builtins.IMAP4.readline", "Read line from remote."), - ("builtins.IMAP4.readonly.__delattr__", "Implement delattr(self, name)."), - ("builtins.IMAP4.readonly.__eq__", "Return self==value."), - ("builtins.IMAP4.readonly.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.IMAP4.readonly.__ge__", "Return self>=value."), - ("builtins.IMAP4.readonly.__getattribute__", "Return getattr(self, name)."), - ("builtins.IMAP4.readonly.__getstate__", "Helper for pickle."), - ("builtins.IMAP4.readonly.__gt__", "Return self>value."), - ("builtins.IMAP4.readonly.__hash__", "Return hash(self)."), - ("builtins.IMAP4.readonly.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.IMAP4.readonly.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.IMAP4.readonly.__le__", "Return self<=value."), - ("builtins.IMAP4.readonly.__lt__", "Return self.recent()\n\n'data' is None if no new messages,\nelse list of RECENT responses, most recent last."), - ("builtins.IMAP4.rename", "Rename old mailbox name to new.\n\n(typ, [data]) = .rename(oldmailbox, newmailbox)"), - ("builtins.IMAP4.response", "Return data for response 'code' if received, or None.\n\nOld value for response 'code' is cleared.\n\n(code, [data]) = .response(code)"), - ("builtins.IMAP4.search", "Search mailbox for matching messages.\n\n(typ, [data]) = .search(charset, criterion, ...)\n\n'data' is space separated list of matching message numbers.\nIf UTF8 is enabled, charset MUST be None."), - ("builtins.IMAP4.select", "Select a mailbox.\n\nFlush all untagged responses.\n\n(typ, [data]) = .select(mailbox='INBOX', readonly=False)\n\n'data' is count of messages in mailbox ('EXISTS' response).\n\nMandated responses are ('FLAGS', 'EXISTS', 'RECENT', 'UIDVALIDITY'), so\nother responses should be obtained via .response('FLAGS') etc."), - ("builtins.IMAP4.send", "Send data to remote."), - ("builtins.IMAP4.setacl", "Set a mailbox acl.\n\n(typ, [data]) = .setacl(mailbox, who, what)"), - ("builtins.IMAP4.setannotation", "(typ, [data]) = .setannotation(mailbox[, entry, attribute]+)\nSet ANNOTATIONs."), - ("builtins.IMAP4.setquota", "Set the quota root's resource limits.\n\n(typ, [data]) = .setquota(root, limits)"), - ("builtins.IMAP4.shutdown", "Close I/O established in \"open\"."), - ("builtins.IMAP4.socket", "Return socket instance used to connect to IMAP4 server.\n\nsocket = .socket()"), - ("builtins.IMAP4.sort", "IMAP4rev1 extension SORT command.\n\n(typ, [data]) = .sort(sort_criteria, charset, search_criteria, ...)"), - ("builtins.IMAP4.status", "Request named status conditions for mailbox.\n\n(typ, [data]) = .status(mailbox, names)"), - ("builtins.IMAP4.store", "Alters flag dispositions for messages in mailbox.\n\n(typ, [data]) = .store(message_set, command, flags)"), - ("builtins.IMAP4.subscribe", "Subscribe to new mailbox.\n\n(typ, [data]) = .subscribe(mailbox)"), - ("builtins.IMAP4.thread", "IMAPrev1 extension THREAD command.\n\n(type, [data]) = .thread(threading_algorithm, charset, search_criteria, ...)"), - ("builtins.IMAP4.uid", "Execute \"command arg ...\" with messages identified by UID,\n rather than message number.\n\n(typ, [data]) = .uid(command, arg1, arg2, ...)\n\nReturns response appropriate to 'command'."), - ("builtins.IMAP4.unselect", "Free server's resources associated with the selected mailbox\nand returns the server to the authenticated state.\nThis command performs the same actions as CLOSE, except\nthat no messages are permanently removed from the currently\nselected mailbox.\n\n(typ, [data]) = .unselect()"), - ("builtins.IMAP4.unsubscribe", "Unsubscribe from old mailbox.\n\n(typ, [data]) = .unsubscribe(mailbox)"), - ("builtins.IMAP4.xatom", "Allow simple extension commands\n notified by server in CAPABILITY response.\n\nAssumes command is legal in current state.\n\n(typ, [data]) = .xatom(name, arg, ...)\n\nReturns response appropriate to extension command 'name'."), - ("builtins.IOBase", "The abstract base class for all I/O classes.\n\nThis class provides dummy implementations for many methods that\nderived classes can override selectively; the default implementations\nrepresent a file that cannot be read, written or seeked.\n\nEven though IOBase does not declare read or write because\ntheir signatures will vary, implementations and clients should\nconsider those methods part of the interface. Also, implementations\nmay raise UnsupportedOperation when operations they do not support are\ncalled.\n\nThe basic type used for binary data read from or written to a file is\nbytes. Other bytes-like objects are accepted as method arguments too.\nText I/O classes work with str data.\n\nNote that calling any method (even inquiries) on a closed stream is\nundefined. Implementations may raise OSError in this case.\n\nIOBase (and its subclasses) support the iterator protocol, meaning\nthat an IOBase object can be iterated over yielding the lines in a\nstream.\n\nIOBase also supports the :keyword:`with` statement. In this example,\nfp is closed after the suite of the with statement is complete:\n\nwith open('spam.txt', 'r') as fp:\n fp.write('Spam and eggs!')"), - ("builtins.IOBase.__del__", "Destructor. Calls close()."), - ("builtins.IOBase.__delattr__", "Implement delattr(self, name)."), - ("builtins.IOBase.__enter__", "Context management protocol. Returns self (an instance of IOBase)."), - ("builtins.IOBase.__eq__", "Return self==value."), - ("builtins.IOBase.__exit__", "Context management protocol. Calls close()"), - ("builtins.IOBase.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.IOBase.__ge__", "Return self>=value."), - ("builtins.IOBase.__getattribute__", "Return getattr(self, name)."), - ("builtins.IOBase.__getstate__", "Helper for pickle."), - ("builtins.IOBase.__gt__", "Return self>value."), - ("builtins.IOBase.__hash__", "Return hash(self)."), - ("builtins.IOBase.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.IOBase.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.IOBase.__le__", "Return self<=value."), - ("builtins.IOBase.__lt__", "Return self=value."), - ("builtins.Idler.__getattribute__", "Return getattr(self, name)."), - ("builtins.Idler.__getstate__", "Helper for pickle."), - ("builtins.Idler.__gt__", "Return self>value."), - ("builtins.Idler.__hash__", "Return hash(self)."), - ("builtins.Idler.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Idler.__le__", "Return self<=value."), - ("builtins.Idler.__lt__", "Return self=value."), - ("builtins.IncrementalDecoder.__getattribute__", "Return getattr(self, name)."), - ("builtins.IncrementalDecoder.__getstate__", "Helper for pickle."), - ("builtins.IncrementalDecoder.__gt__", "Return self>value."), - ("builtins.IncrementalDecoder.__hash__", "Return hash(self)."), - ("builtins.IncrementalDecoder.__init__", "Create an IncrementalDecoder instance.\n\nThe IncrementalDecoder may use different error handling schemes by\nproviding the errors keyword argument. See the module docstring\nfor a list of possible values."), - ("builtins.IncrementalDecoder.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.IncrementalDecoder.__le__", "Return self<=value."), - ("builtins.IncrementalDecoder.__lt__", "Return self=value."), - ("builtins.IncrementalEncoder.__getattribute__", "Return getattr(self, name)."), - ("builtins.IncrementalEncoder.__getstate__", "Helper for pickle."), - ("builtins.IncrementalEncoder.__gt__", "Return self>value."), - ("builtins.IncrementalEncoder.__hash__", "Return hash(self)."), - ("builtins.IncrementalEncoder.__init__", "Creates an IncrementalEncoder instance.\n\nThe IncrementalEncoder may use different error handling schemes by\nproviding the errors keyword argument. See the module docstring\nfor a list of possible values."), - ("builtins.IncrementalEncoder.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.IncrementalEncoder.__le__", "Return self<=value."), - ("builtins.IncrementalEncoder.__lt__", "Return self=value."), - ("builtins.InitVar.__getattribute__", "Return getattr(self, name)."), - ("builtins.InitVar.__getstate__", "Helper for pickle."), - ("builtins.InitVar.__gt__", "Return self>value."), - ("builtins.InitVar.__hash__", "Return hash(self)."), - ("builtins.InitVar.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.InitVar.__le__", "Return self<=value."), - ("builtins.InitVar.__lt__", "Return self=value."), - ("builtins.InitializedState.__getattribute__", "Return getattr(self, name)."), - ("builtins.InitializedState.__gt__", "Return self>value."), - ("builtins.InitializedState.__hash__", "Return hash(self)."), - ("builtins.InitializedState.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.InitializedState.__le__", "Return self<=value."), - ("builtins.InitializedState.__lt__", "Return self=value."), - ("builtins.InteractiveInterpreter.__getattribute__", "Return getattr(self, name)."), - ("builtins.InteractiveInterpreter.__getstate__", "Helper for pickle."), - ("builtins.InteractiveInterpreter.__gt__", "Return self>value."), - ("builtins.InteractiveInterpreter.__hash__", "Return hash(self)."), - ("builtins.InteractiveInterpreter.__init__", "Constructor.\n\nThe optional 'locals' argument specifies a mapping to use as the\nnamespace in which code will be executed; it defaults to a newly\ncreated dictionary with key \"__name__\" set to \"__console__\" and\nkey \"__doc__\" set to None."), - ("builtins.InteractiveInterpreter.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.InteractiveInterpreter.__le__", "Return self<=value."), - ("builtins.InteractiveInterpreter.__lt__", "Return self\" when reading from a string).\n\nThe output is written by self.write(), below."), - ("builtins.InteractiveInterpreter.showtraceback", "Display the exception that just occurred.\n\nWe remove the first stack item because it is our own code.\n\nThe output is written by self.write(), below."), - ("builtins.InteractiveInterpreter.write", "Write a string.\n\nThe base implementation writes to sys.stderr; a subclass may\nreplace this with a different implementation."), ("builtins.Interpolation", "Dummy interpolation that passes the value through with no changes."), ("builtins.Interpolation.__class_getitem__", "Interpolations are generic over the types of their values"), ("builtins.Interpolation.__delattr__", "Implement delattr(self, name)."), @@ -14475,7 +11713,6 @@ pub const DB: &[(&str, &str)] = &[ ("builtins.Interpolation.__sizeof__", "Size of object in memory, in bytes."), ("builtins.Interpolation.__str__", "Return str(self)."), ("builtins.Interpolation.__subclasshook__", "Abstract classes can override this to customize issubclass().\n\nThis is invoked early on by abc.ABCMeta.__subclasscheck__().\nIt should return True, False or NotImplemented. If it returns\nNotImplemented, the normal algorithm is used. Otherwise, it\noverrides the normal algorithm (and the outcome is cached)."), - ("builtins.Interpolation.__weakref__", "list of weak references to the object"), ("builtins.Interpolation.conversion", "Conversion"), ("builtins.Interpolation.expression", "Expression"), ("builtins.Interpolation.format_spec", "Format specifier"), @@ -14559,78 +11796,6 @@ pub const DB: &[(&str, &str)] = &[ ("builtins.IsADirectoryError.strerror", "exception strerror"), ("builtins.IsADirectoryError.winerror", "Win32 exception code"), ("builtins.IsADirectoryError.with_traceback", "Set self.__traceback__ to tb and return self."), - ("builtins.Iterable.__class_getitem__", "Represent a PEP 585 generic type\n\nFor example, for t = list[int], t.__origin__ is list and t.__args__\nis (int,)."), - ("builtins.Iterable.__delattr__", "Implement delattr(self, name)."), - ("builtins.Iterable.__eq__", "Return self==value."), - ("builtins.Iterable.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.Iterable.__ge__", "Return self>=value."), - ("builtins.Iterable.__getattribute__", "Return getattr(self, name)."), - ("builtins.Iterable.__getstate__", "Helper for pickle."), - ("builtins.Iterable.__gt__", "Return self>value."), - ("builtins.Iterable.__hash__", "Return hash(self)."), - ("builtins.Iterable.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.Iterable.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Iterable.__le__", "Return self<=value."), - ("builtins.Iterable.__lt__", "Return self decoder\n\nPerforms the following translations in decoding by default:\n\n+---------------+-------------------+\n| JSON | Python |\n+===============+===================+\n| object | dict |\n+---------------+-------------------+\n| array | list |\n+---------------+-------------------+\n| string | str |\n+---------------+-------------------+\n| number (int) | int |\n+---------------+-------------------+\n| number (real) | float |\n+---------------+-------------------+\n| true | True |\n+---------------+-------------------+\n| false | False |\n+---------------+-------------------+\n| null | None |\n+---------------+-------------------+\n\nIt also understands ``NaN``, ``Infinity``, and ``-Infinity`` as\ntheir corresponding ``float`` values, which is outside the JSON spec."), - ("builtins.JSONDecoder.__delattr__", "Implement delattr(self, name)."), - ("builtins.JSONDecoder.__eq__", "Return self==value."), - ("builtins.JSONDecoder.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.JSONDecoder.__ge__", "Return self>=value."), - ("builtins.JSONDecoder.__getattribute__", "Return getattr(self, name)."), - ("builtins.JSONDecoder.__getstate__", "Helper for pickle."), - ("builtins.JSONDecoder.__gt__", "Return self>value."), - ("builtins.JSONDecoder.__hash__", "Return hash(self)."), - ("builtins.JSONDecoder.__init__", "``object_hook``, if specified, will be called with the result\nof every JSON object decoded and its return value will be used in\nplace of the given ``dict``. This can be used to provide custom\ndeserializations (e.g. to support JSON-RPC class hinting).\n\n``object_pairs_hook``, if specified will be called with the result\nof every JSON object decoded with an ordered list of pairs. The\nreturn value of ``object_pairs_hook`` will be used instead of the\n``dict``. This feature can be used to implement custom decoders.\nIf ``object_hook`` is also defined, the ``object_pairs_hook`` takes\npriority.\n\n``parse_float``, if specified, will be called with the string\nof every JSON float to be decoded. By default this is equivalent to\nfloat(num_str). This can be used to use another datatype or parser\nfor JSON floats (e.g. decimal.Decimal).\n\n``parse_int``, if specified, will be called with the string\nof every JSON int to be decoded. By default this is equivalent to\nint(num_str). This can be used to use another datatype or parser\nfor JSON integers (e.g. float).\n\n``parse_constant``, if specified, will be called with one of the\nfollowing strings: -Infinity, Infinity, NaN.\nThis can be used to raise an exception if invalid JSON numbers\nare encountered.\n\nIf ``strict`` is false (true is the default), then control\ncharacters will be allowed inside strings. Control characters in\nthis context are those with character codes in the 0-31 range,\nincluding ``'\\t'`` (tab), ``'\\n'``, ``'\\r'`` and ``'\\0'``."), - ("builtins.JSONDecoder.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.JSONDecoder.__le__", "Return self<=value."), - ("builtins.JSONDecoder.__lt__", "Return self encoder for Python data structures.\n\nSupports the following objects and types by default:\n\n+-------------------+---------------+\n| Python | JSON |\n+===================+===============+\n| dict | object |\n+-------------------+---------------+\n| list, tuple | array |\n+-------------------+---------------+\n| str | string |\n+-------------------+---------------+\n| int, float | number |\n+-------------------+---------------+\n| True | true |\n+-------------------+---------------+\n| False | false |\n+-------------------+---------------+\n| None | null |\n+-------------------+---------------+\n\nTo extend this to recognize other objects, subclass and implement a\n``.default()`` method with another method that returns a serializable\nobject for ``o`` if possible, otherwise it should call the superclass\nimplementation (to raise ``TypeError``)."), - ("builtins.JSONEncoder.__delattr__", "Implement delattr(self, name)."), - ("builtins.JSONEncoder.__eq__", "Return self==value."), - ("builtins.JSONEncoder.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.JSONEncoder.__ge__", "Return self>=value."), - ("builtins.JSONEncoder.__getattribute__", "Return getattr(self, name)."), - ("builtins.JSONEncoder.__getstate__", "Helper for pickle."), - ("builtins.JSONEncoder.__gt__", "Return self>value."), - ("builtins.JSONEncoder.__hash__", "Return hash(self)."), - ("builtins.JSONEncoder.__init__", "Constructor for JSONEncoder, with sensible defaults.\n\nIf skipkeys is false, then it is a TypeError to attempt\nencoding of keys that are not str, int, float, bool or None.\nIf skipkeys is True, such items are simply skipped.\n\nIf ensure_ascii is true, the output is guaranteed to be str objects\nwith all incoming non-ASCII and non-printable characters escaped.\nIf ensure_ascii is false, the output can contain non-ASCII and\nnon-printable characters.\n\nIf check_circular is true, then lists, dicts, and custom encoded\nobjects will be checked for circular references during encoding to\nprevent an infinite recursion (which would cause an RecursionError).\nOtherwise, no such check takes place.\n\nIf allow_nan is true, then NaN, Infinity, and -Infinity will be\nencoded as such. This behavior is not JSON specification compliant,\nbut is consistent with most JavaScript based encoders and decoders.\nOtherwise, it will be a ValueError to encode such floats.\n\nIf sort_keys is true, then the output of dictionaries will be\nsorted by key; this is useful for regression tests to ensure\nthat JSON serializations can be compared on a day-to-day basis.\n\nIf indent is a non-negative integer, then JSON array\nelements and object members will be pretty-printed with that\nindent level. An indent level of 0 will only insert newlines.\nNone is the most compact representation.\n\nIf specified, separators should be an (item_separator,\nkey_separator) tuple. The default is (', ', ': ') if *indent* is\n``None`` and (',', ': ') otherwise. To get the most compact JSON\nrepresentation, you should specify (',', ':') to eliminate\nwhitespace.\n\nIf specified, default is a function that gets called for objects\nthat can't otherwise be serialized. It should return a JSON\nencodable version of the object or raise a ``TypeError``."), - ("builtins.JSONEncoder.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.JSONEncoder.__le__", "Return self<=value."), - ("builtins.JSONEncoder.__lt__", "Return self>> from json.encoder import JSONEncoder\n>>> JSONEncoder().encode({\"foo\": [\"bar\", \"baz\"]})\n'{\"foo\": [\"bar\", \"baz\"]}'"), - ("builtins.JSONEncoder.iterencode", "Encode the given object and yield each string\nrepresentation as available.\n\nFor example::\n\n for chunk in JSONEncoder().iterencode(bigobject):\n mysocket.write(chunk)"), ("builtins.KeyError", "Mapping key not found."), ("builtins.KeyError.__delattr__", "Implement delattr(self, name)."), ("builtins.KeyError.__eq__", "Return self==value."), @@ -14721,7 +11886,6 @@ pub const DB: &[(&str, &str)] = &[ ("builtins.LZMACompressor.__sizeof__", "Size of object in memory, in bytes."), ("builtins.LZMACompressor.__str__", "Return str(self)."), ("builtins.LZMACompressor.__subclasshook__", "Abstract classes can override this to customize issubclass().\n\nThis is invoked early on by abc.ABCMeta.__subclasscheck__().\nIt should return True, False or NotImplemented. If it returns\nNotImplemented, the normal algorithm is used. Otherwise, it\noverrides the normal algorithm (and the outcome is cached)."), - ("builtins.LZMACompressor.__weakref__", "list of weak references to the object"), ("builtins.LZMACompressor.compress", "Provide data to the compressor object.\n\nReturns a chunk of compressed data if possible, or b'' otherwise.\n\nWhen you have finished providing data to the compressor, call the\nflush() method to finish the compression process."), ("builtins.LZMACompressor.flush", "Finish the compression process.\n\nReturns the compressed data left in internal buffers.\n\nThe compressor object may not be used after this method is called."), ("builtins.LZMADecompressor", "Create a decompressor object for decompressing data incrementally.\n\n format\n Specifies the container format of the input stream. If this is\n FORMAT_AUTO (the default), the decompressor will automatically detect\n whether the input is FORMAT_XZ or FORMAT_ALONE. Streams created with\n FORMAT_RAW cannot be autodetected.\n memlimit\n Limit the amount of memory used by the decompressor. This will cause\n decompression to fail if the input cannot be decompressed within the\n given limit.\n filters\n A custom filter chain. This argument is required for FORMAT_RAW, and\n not accepted with any other format. When provided, this should be a\n sequence of dicts, each indicating the ID and options for a single\n filter.\n\nFor one-shot decompression, use the decompress() function instead."), @@ -14746,164 +11910,11 @@ pub const DB: &[(&str, &str)] = &[ ("builtins.LZMADecompressor.__sizeof__", "Size of object in memory, in bytes."), ("builtins.LZMADecompressor.__str__", "Return str(self)."), ("builtins.LZMADecompressor.__subclasshook__", "Abstract classes can override this to customize issubclass().\n\nThis is invoked early on by abc.ABCMeta.__subclasscheck__().\nIt should return True, False or NotImplemented. If it returns\nNotImplemented, the normal algorithm is used. Otherwise, it\noverrides the normal algorithm (and the outcome is cached)."), - ("builtins.LZMADecompressor.__weakref__", "list of weak references to the object"), ("builtins.LZMADecompressor.check", "ID of the integrity check used by the input stream."), ("builtins.LZMADecompressor.decompress", "Decompress *data*, returning uncompressed data as bytes.\n\nIf *max_length* is nonnegative, returns at most *max_length* bytes\nof decompressed data. If this limit is reached and further output\ncan be produced, *self.needs_input* will be set to ``False``. In\nthis case, the next call to *decompress()* may provide *data* as b''\nto obtain more of the output.\n\nIf all of the input data was decompressed and returned (either\nbecause this was less than *max_length* bytes, or because\n*max_length* was negative), *self.needs_input* will be set to True.\n\nAttempting to decompress data after the end of stream is reached\nraises an EOFError. Any data found after the end of the stream is\nignored and saved in the unused_data attribute."), ("builtins.LZMADecompressor.eof", "True if the end-of-stream marker has been reached."), ("builtins.LZMADecompressor.needs_input", "True if more input is needed before more decompressed data can be produced."), ("builtins.LZMADecompressor.unused_data", "Data found after the end of the compressed stream."), - ("builtins.LibraryLoader.__class_getitem__", "Represent a PEP 585 generic type\n\nFor example, for t = list[int], t.__origin__ is list and t.__args__\nis (int,)."), - ("builtins.LibraryLoader.__delattr__", "Implement delattr(self, name)."), - ("builtins.LibraryLoader.__eq__", "Return self==value."), - ("builtins.LibraryLoader.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.LibraryLoader.__ge__", "Return self>=value."), - ("builtins.LibraryLoader.__getattribute__", "Return getattr(self, name)."), - ("builtins.LibraryLoader.__getstate__", "Helper for pickle."), - ("builtins.LibraryLoader.__gt__", "Return self>value."), - ("builtins.LibraryLoader.__hash__", "Return hash(self)."), - ("builtins.LibraryLoader.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.LibraryLoader.__le__", "Return self<=value."), - ("builtins.LibraryLoader.__lt__", "Return self=value."), - ("builtins.Loader.__getattribute__", "Return getattr(self, name)."), - ("builtins.Loader.__getstate__", "Helper for pickle."), - ("builtins.Loader.__gt__", "Return self>value."), - ("builtins.Loader.__hash__", "Return hash(self)."), - ("builtins.Loader.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.Loader.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Loader.__le__", "Return self<=value."), - ("builtins.Loader.__lt__", "Return self=value."), - ("builtins.LocaleTime.__getattribute__", "Return getattr(self, name)."), - ("builtins.LocaleTime.__getstate__", "Helper for pickle."), - ("builtins.LocaleTime.__gt__", "Return self>value."), - ("builtins.LocaleTime.__hash__", "Return hash(self)."), - ("builtins.LocaleTime.__init__", "Set all attributes.\n\nOrder of methods called matters for dependency reasons.\n\nThe locale language is set at the offset and then checked again before\nexiting. This is to make sure that the attributes were not set with a\nmix of information from more than one locale. This would most likely\nhappen when using threads where one thread calls a locale-dependent\nfunction while another thread changes the locale while the function in\nthe other thread is still running. Proper coding would call for\nlocks to prevent changing the locale while locale-dependent code is\nrunning. The check here is done in case someone does not think about\ndoing this.\n\nOnly other possible issue is if someone changed the timezone and did\nnot call tz.tzset . That is an issue for the programmer, though,\nsince changing the timezone is worthless without that call."), - ("builtins.LocaleTime.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.LocaleTime.__le__", "Return self<=value."), - ("builtins.LocaleTime.__lt__", "Return self=value."), - ("builtins.LogRecord.__getattribute__", "Return getattr(self, name)."), - ("builtins.LogRecord.__getstate__", "Helper for pickle."), - ("builtins.LogRecord.__gt__", "Return self>value."), - ("builtins.LogRecord.__hash__", "Return hash(self)."), - ("builtins.LogRecord.__init__", "Initialize a logging record with interesting information."), - ("builtins.LogRecord.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.LogRecord.__le__", "Return self<=value."), - ("builtins.LogRecord.__lt__", "Return self=value."), - ("builtins.Logcat.__getattribute__", "Return getattr(self, name)."), - ("builtins.Logcat.__getstate__", "Helper for pickle."), - ("builtins.Logcat.__gt__", "Return self>value."), - ("builtins.Logcat.__hash__", "Return hash(self)."), - ("builtins.Logcat.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Logcat.__le__", "Return self<=value."), - ("builtins.Logcat.__lt__", "Return self=value."), - ("builtins.LoggerAdapter.__getattribute__", "Return getattr(self, name)."), - ("builtins.LoggerAdapter.__getstate__", "Helper for pickle."), - ("builtins.LoggerAdapter.__gt__", "Return self>value."), - ("builtins.LoggerAdapter.__hash__", "Return hash(self)."), - ("builtins.LoggerAdapter.__init__", "Initialize the adapter with a logger and an optional dict-like object\nwhich provides contextual information. This constructor signature\nallows easy stacking of LoggerAdapters, if so desired.\n\nYou can effectively pass keyword arguments as shown in the\nfollowing example:\n\nadapter = LoggerAdapter(someLogger, dict(p1=v1, p2=\"v2\"))\n\nBy default, LoggerAdapter objects will drop the \"extra\" argument\npassed on the individual log calls to use its own instead.\n\nInitializing it with merge_extra=True will instead merge both\nmaps when logging, the individual call extra taking precedence\nover the LoggerAdapter instance extra\n\n.. versionchanged:: 3.13\n The *merge_extra* argument was added."), - ("builtins.LoggerAdapter.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.LoggerAdapter.__le__", "Return self<=value."), - ("builtins.LoggerAdapter.__lt__", "Return self=value."), - ("builtins.Mailbox.__getattribute__", "Return getattr(self, name)."), - ("builtins.Mailbox.__getitem__", "Return the keyed message; raise KeyError if it doesn't exist."), - ("builtins.Mailbox.__getstate__", "Helper for pickle."), - ("builtins.Mailbox.__gt__", "Return self>value."), - ("builtins.Mailbox.__hash__", "Return hash(self)."), - ("builtins.Mailbox.__init__", "Initialize a Mailbox instance."), - ("builtins.Mailbox.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Mailbox.__le__", "Return self<=value."), - ("builtins.Mailbox.__len__", "Return a count of messages in the mailbox."), - ("builtins.Mailbox.__lt__", "Return self=value."), - ("builtins.Manager.__getattribute__", "Return getattr(self, name)."), - ("builtins.Manager.__getstate__", "Helper for pickle."), - ("builtins.Manager.__gt__", "Return self>value."), - ("builtins.Manager.__hash__", "Return hash(self)."), - ("builtins.Manager.__init__", "Initialize the manager with the root node of the logger hierarchy."), - ("builtins.Manager.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Manager.__le__", "Return self<=value."), - ("builtins.Manager.__lt__", "Return self=value."), - ("builtins.Message.__getattribute__", "Return getattr(self, name)."), - ("builtins.Message.__getitem__", "Get a header value.\n\nReturn None if the header is missing instead of raising an exception.\n\nNote that if the header appeared multiple times, exactly which\noccurrence gets returned is undefined. Use get_all() to get all\nthe values matching a header field name."), - ("builtins.Message.__getstate__", "Helper for pickle."), - ("builtins.Message.__gt__", "Return self>value."), - ("builtins.Message.__hash__", "Return hash(self)."), - ("builtins.Message.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Message.__le__", "Return self<=value."), - ("builtins.Message.__len__", "Return the total number of headers, including duplicates."), - ("builtins.Message.__lt__", "Return self=value."), - ("builtins.MimeTypes.__getattribute__", "Return getattr(self, name)."), - ("builtins.MimeTypes.__getstate__", "Helper for pickle."), - ("builtins.MimeTypes.__gt__", "Return self>value."), - ("builtins.MimeTypes.__hash__", "Return hash(self)."), - ("builtins.MimeTypes.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.MimeTypes.__le__", "Return self<=value."), - ("builtins.MimeTypes.__lt__", "Return self=value."), - ("builtins.Module.__getattribute__", "Return getattr(self, name)."), - ("builtins.Module.__getstate__", "Helper for pickle."), - ("builtins.Module.__gt__", "Return self>value."), - ("builtins.Module.__hash__", "Return hash(self)."), - ("builtins.Module.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Module.__le__", "Return self<=value."), - ("builtins.Module.__lt__", "Return self=value."), - ("builtins.ModuleFinder.__getattribute__", "Return getattr(self, name)."), - ("builtins.ModuleFinder.__getstate__", "Helper for pickle."), - ("builtins.ModuleFinder.__gt__", "Return self>value."), - ("builtins.ModuleFinder.__hash__", "Return hash(self)."), - ("builtins.ModuleFinder.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.ModuleFinder.__le__", "Return self<=value."), - ("builtins.ModuleFinder.__lt__", "Return self=value."), - ("builtins.ModuleScanner.__getattribute__", "Return getattr(self, name)."), - ("builtins.ModuleScanner.__getstate__", "Helper for pickle."), - ("builtins.ModuleScanner.__gt__", "Return self>value."), - ("builtins.ModuleScanner.__hash__", "Return hash(self)."), - ("builtins.ModuleScanner.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.ModuleScanner.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.ModuleScanner.__le__", "Return self<=value."), - ("builtins.ModuleScanner.__lt__", "Return self=value."), - ("builtins.ModuleSpec.__getattribute__", "Return getattr(self, name)."), - ("builtins.ModuleSpec.__getstate__", "Helper for pickle."), - ("builtins.ModuleSpec.__gt__", "Return self>value."), - ("builtins.ModuleSpec.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.ModuleSpec.__le__", "Return self<=value."), - ("builtins.ModuleSpec.__lt__", "Return self=value."), - ("builtins.NamedTuple.__getattribute__", "Return getattr(self, name)."), - ("builtins.NamedTuple.__getstate__", "Helper for pickle."), - ("builtins.NamedTuple.__gt__", "Return self>value."), - ("builtins.NamedTuple.__hash__", "Return hash(self)."), - ("builtins.NamedTuple.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.NamedTuple.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.NamedTuple.__le__", "Return self<=value."), - ("builtins.NamedTuple.__lt__", "Return self=value."), - ("builtins.NamespaceLoader.__getattribute__", "Return getattr(self, name)."), - ("builtins.NamespaceLoader.__getstate__", "Helper for pickle."), - ("builtins.NamespaceLoader.__gt__", "Return self>value."), - ("builtins.NamespaceLoader.__hash__", "Return hash(self)."), - ("builtins.NamespaceLoader.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.NamespaceLoader.__le__", "Return self<=value."), - ("builtins.NamespaceLoader.__lt__", "Return self=value."), - ("builtins.NestedDict.__getattribute__", "Return getattr(self, name)."), - ("builtins.NestedDict.__getstate__", "Helper for pickle."), - ("builtins.NestedDict.__gt__", "Return self>value."), - ("builtins.NestedDict.__hash__", "Return hash(self)."), - ("builtins.NestedDict.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.NestedDict.__le__", "Return self<=value."), - ("builtins.NestedDict.__lt__", "Return self str:\n ...\n\n UserId('user') # Fails type check\n\n name_by_id(42) # Fails type check\n name_by_id(UserId(42)) # OK\n\n num = UserId(5) + 1 # type: int"), - ("builtins.NewType.__delattr__", "Implement delattr(self, name)."), - ("builtins.NewType.__eq__", "Return self==value."), - ("builtins.NewType.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.NewType.__ge__", "Return self>=value."), - ("builtins.NewType.__getattribute__", "Return getattr(self, name)."), - ("builtins.NewType.__getstate__", "Helper for pickle."), - ("builtins.NewType.__gt__", "Return self>value."), - ("builtins.NewType.__hash__", "Return hash(self)."), - ("builtins.NewType.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.NewType.__le__", "Return self<=value."), - ("builtins.NewType.__lt__", "Return self=value."), - ("builtins.NodeVisitor.__getattribute__", "Return getattr(self, name)."), - ("builtins.NodeVisitor.__getstate__", "Helper for pickle."), - ("builtins.NodeVisitor.__gt__", "Return self>value."), - ("builtins.NodeVisitor.__hash__", "Return hash(self)."), - ("builtins.NodeVisitor.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.NodeVisitor.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.NodeVisitor.__le__", "Return self<=value."), - ("builtins.NodeVisitor.__lt__", "Return self=value."), - ("builtins.NormalDist.__getattribute__", "Return getattr(self, name)."), - ("builtins.NormalDist.__gt__", "Return self>value."), - ("builtins.NormalDist.__hash__", "NormalDist objects hash equal if their mu and sigma are both equal."), - ("builtins.NormalDist.__init__", "NormalDist where mu is the mean and sigma is the standard deviation."), - ("builtins.NormalDist.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.NormalDist.__le__", "Return self<=value."), - ("builtins.NormalDist.__lt__", "Return self>> N1 = NormalDist(2.4, 1.6)\n >>> N2 = NormalDist(3.2, 2.0)\n >>> N1.overlap(N2)\n 0.8035050657330205"), - ("builtins.NormalDist.pdf", "Probability density function. P(x <= X < x+dx) / dx"), - ("builtins.NormalDist.quantiles", "Divide into *n* continuous intervals with equal probability.\n\nReturns a list of (n - 1) cut points separating the intervals.\n\nSet *n* to 4 for quartiles (the default). Set *n* to 10 for deciles.\nSet *n* to 100 for percentiles which gives the 99 cuts points that\nseparate the normal distribution in to 100 equal sized groups."), - ("builtins.NormalDist.samples", "Generate *n* samples for a given mean and standard deviation."), - ("builtins.NormalDist.stdev", "Standard deviation of the normal distribution."), - ("builtins.NormalDist.variance", "Square of the standard deviation."), - ("builtins.NormalDist.zscore", "Compute the Standard Score. (x - mean) / stdev\n\nDescribes *x* in terms of the number of standard deviations\nabove or below the mean of the normal distribution."), ("builtins.NotADirectoryError", "Operation only works on directories."), ("builtins.NotADirectoryError.__delattr__", "Implement delattr(self, name)."), ("builtins.NotADirectoryError.__eq__", "Return self==value."), @@ -15918,48 +12518,6 @@ pub const DB: &[(&str, &str)] = &[ ("builtins.NotImplementedType.__sizeof__", "Size of object in memory, in bytes."), ("builtins.NotImplementedType.__str__", "Return str(self)."), ("builtins.NotImplementedType.__subclasshook__", "Abstract classes can override this to customize issubclass().\n\nThis is invoked early on by abc.ABCMeta.__subclasscheck__().\nIt should return True, False or NotImplemented. If it returns\nNotImplemented, the normal algorithm is used. Otherwise, it\noverrides the normal algorithm (and the outcome is cached)."), - ("builtins.NullTranslations.__delattr__", "Implement delattr(self, name)."), - ("builtins.NullTranslations.__eq__", "Return self==value."), - ("builtins.NullTranslations.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.NullTranslations.__ge__", "Return self>=value."), - ("builtins.NullTranslations.__getattribute__", "Return getattr(self, name)."), - ("builtins.NullTranslations.__getstate__", "Helper for pickle."), - ("builtins.NullTranslations.__gt__", "Return self>value."), - ("builtins.NullTranslations.__hash__", "Return hash(self)."), - ("builtins.NullTranslations.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.NullTranslations.__le__", "Return self<=value."), - ("builtins.NullTranslations.__lt__", "Return self=value."), - ("builtins.Number.__getattribute__", "Return getattr(self, name)."), - ("builtins.Number.__getstate__", "Helper for pickle."), - ("builtins.Number.__gt__", "Return self>value."), - ("builtins.Number.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.Number.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Number.__le__", "Return self<=value."), - ("builtins.Number.__lt__", "Return self=value."), - ("builtins.OpcodeInfo.__getattribute__", "Return getattr(self, name)."), - ("builtins.OpcodeInfo.__getstate__", "Helper for pickle."), - ("builtins.OpcodeInfo.__gt__", "Return self>value."), - ("builtins.OpcodeInfo.__hash__", "Return hash(self)."), - ("builtins.OpcodeInfo.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.OpcodeInfo.__le__", "Return self<=value."), - ("builtins.OpcodeInfo.__lt__", "Return self=value."), - ("builtins.Option.__getattribute__", "Return getattr(self, name)."), - ("builtins.Option.__getstate__", "Helper for pickle."), - ("builtins.Option.__gt__", "Return self>value."), - ("builtins.Option.__hash__", "Return hash(self)."), - ("builtins.Option.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Option.__le__", "Return self<=value."), - ("builtins.Option.__lt__", "Return self=value."), - ("builtins.OptionContainer.__getattribute__", "Return getattr(self, name)."), - ("builtins.OptionContainer.__getstate__", "Helper for pickle."), - ("builtins.OptionContainer.__gt__", "Return self>value."), - ("builtins.OptionContainer.__hash__", "Return hash(self)."), - ("builtins.OptionContainer.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.OptionContainer.__le__", "Return self<=value."), - ("builtins.OptionContainer.__lt__", "Return self=value."), - ("builtins.Output.__getattribute__", "Return getattr(self, name)."), - ("builtins.Output.__getstate__", "Helper for pickle."), - ("builtins.Output.__gt__", "Return self>value."), - ("builtins.Output.__hash__", "Return hash(self)."), - ("builtins.Output.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Output.__le__", "Return self<=value."), - ("builtins.Output.__lt__", "Return self=value."), - ("builtins.OutputChecker.__getattribute__", "Return getattr(self, name)."), - ("builtins.OutputChecker.__getstate__", "Helper for pickle."), - ("builtins.OutputChecker.__gt__", "Return self>value."), - ("builtins.OutputChecker.__hash__", "Return hash(self)."), - ("builtins.OutputChecker.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.OutputChecker.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.OutputChecker.__le__", "Return self<=value."), - ("builtins.OutputChecker.__lt__", "Return self=value."), - ("builtins.POP3.__getattribute__", "Return getattr(self, name)."), - ("builtins.POP3.__getstate__", "Helper for pickle."), - ("builtins.POP3.__gt__", "Return self>value."), - ("builtins.POP3.__hash__", "Return hash(self)."), - ("builtins.POP3.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.POP3.__le__", "Return self<=value."), - ("builtins.POP3.__lt__", "Return self>> c=poplib.POP3('localhost')\n>>> c.capa()\n{'IMPLEMENTATION': ['Cyrus', 'POP3', 'server', 'v2.2.12'],\n 'TOP': [], 'LOGIN-DELAY': ['0'], 'AUTH-RESP-CODE': [],\n 'EXPIRE': ['NEVER'], 'USER': [], 'STLS': [], 'PIPELINING': [],\n 'UIDL': [], 'RESP-CODES': []}\n>>>\n\nReally, according to RFC 2449, the cyrus folks should avoid\nhaving the implementation split into multiple arguments..."), - ("builtins.POP3.close", "Close the connection without assuming anything about it."), - ("builtins.POP3.dele", "Delete message number 'which'.\n\nResult is 'response'."), - ("builtins.POP3.list", "Request listing, return result.\n\nResult without a message number argument is in form\n['response', ['mesg_num octets', ...], octets].\n\nResult when a message number argument is given is a\nsingle response: the \"scan listing\" for that message."), - ("builtins.POP3.noop", "Does nothing.\n\nOne supposes the response indicates the server is alive."), - ("builtins.POP3.pass_", "Send password, return response\n\n(response includes message count, mailbox size).\n\nNB: mailbox is locked by server from here to 'quit()'"), - ("builtins.POP3.quit", "Signoff: commit changes on server, unlock mailbox, close connection."), - ("builtins.POP3.retr", "Retrieve whole message number 'which'.\n\nResult is in form ['response', ['line', ...], octets]."), - ("builtins.POP3.rpop", "Send RPOP command to access the mailbox with an alternate user."), - ("builtins.POP3.rset", "Unmark all messages marked for deletion."), - ("builtins.POP3.stat", "Get mailbox status.\n\nResult is tuple of 2 ints (message count, mailbox size)"), - ("builtins.POP3.stls", "Start a TLS session on the active connection as specified in RFC 2595.\n\ncontext - a ssl.SSLContext"), - ("builtins.POP3.top", "Retrieve message header of message number 'which'\nand first 'howmuch' lines of message body.\n\nResult is in form ['response', ['line', ...], octets]."), - ("builtins.POP3.uidl", "Return message digest (unique id) list.\n\nIf 'which', result contains unique id for that message\nin the form 'response mesgnum uid', otherwise result is\nthe list ['response', ['mesgnum uid', ...], octets]"), - ("builtins.POP3.user", "Send user name, return response\n\n(should indicate password required)."), - ("builtins.POP3.utf8", "Try to enter UTF-8 mode (see RFC 6856). Returns server response."), ("builtins.Pack", "Geometry manager Pack.\n\nBase class to use the methods pack_* in every widget."), ("builtins.Pack.__delattr__", "Implement delattr(self, name)."), ("builtins.Pack.__eq__", "Return self==value."), @@ -16305,121 +12713,6 @@ pub const DB: &[(&str, &str)] = &[ ("builtins.ParamSpecKwargs.__sizeof__", "Size of object in memory, in bytes."), ("builtins.ParamSpecKwargs.__str__", "Return str(self)."), ("builtins.ParamSpecKwargs.__subclasshook__", "Abstract classes can override this to customize issubclass().\n\nThis is invoked early on by abc.ABCMeta.__subclasscheck__().\nIt should return True, False or NotImplemented. If it returns\nNotImplemented, the normal algorithm is used. Otherwise, it\noverrides the normal algorithm (and the outcome is cached)."), - ("builtins.Parameter", "Represents a parameter in a function signature.\n\nHas the following public attributes:\n\n* name : str\n The name of the parameter as a string.\n* default : object\n The default value for the parameter if specified. If the\n parameter has no default value, this attribute is set to\n `Parameter.empty`.\n* annotation\n The annotation for the parameter if specified. If the\n parameter has no annotation, this attribute is set to\n `Parameter.empty`.\n* kind\n Describes how argument values are bound to the parameter.\n Possible values: `Parameter.POSITIONAL_ONLY`,\n `Parameter.POSITIONAL_OR_KEYWORD`, `Parameter.VAR_POSITIONAL`,\n `Parameter.KEYWORD_ONLY`, `Parameter.VAR_KEYWORD`.\n Every value has a `description` attribute describing meaning."), - ("builtins.Parameter.__delattr__", "Implement delattr(self, name)."), - ("builtins.Parameter.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.Parameter.__ge__", "Return self>=value."), - ("builtins.Parameter.__getattribute__", "Return getattr(self, name)."), - ("builtins.Parameter.__getstate__", "Helper for pickle."), - ("builtins.Parameter.__gt__", "Return self>value."), - ("builtins.Parameter.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Parameter.__le__", "Return self<=value."), - ("builtins.Parameter.__lt__", "Return self=value."), - ("builtins.Parameter.empty.__getattribute__", "Return getattr(self, name)."), - ("builtins.Parameter.empty.__getstate__", "Helper for pickle."), - ("builtins.Parameter.empty.__gt__", "Return self>value."), - ("builtins.Parameter.empty.__hash__", "Return hash(self)."), - ("builtins.Parameter.empty.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.Parameter.empty.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Parameter.empty.__le__", "Return self<=value."), - ("builtins.Parameter.empty.__lt__", "Return self=value."), - ("builtins.ParserBase.__getattribute__", "Return getattr(self, name)."), - ("builtins.ParserBase.__getstate__", "Helper for pickle."), - ("builtins.ParserBase.__gt__", "Return self>value."), - ("builtins.ParserBase.__hash__", "Return hash(self)."), - ("builtins.ParserBase.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.ParserBase.__le__", "Return self<=value."), - ("builtins.ParserBase.__lt__", "Return self>> data = io.BytesIO()\n>>> zf = ZipFile(data, 'w')\n>>> zf.writestr('a.txt', 'content of a')\n>>> zf.writestr('b/c.txt', 'content of c')\n>>> zf.writestr('b/d/e.txt', 'content of e')\n>>> zf.filename = 'mem/abcde.zip'\n\nPath accepts the zipfile object itself or a filename\n\n>>> path = Path(zf)\n\nFrom there, several path operations are available.\n\nDirectory iteration (including the zip file itself):\n\n>>> a, b = path.iterdir()\n>>> a\nPath('mem/abcde.zip', 'a.txt')\n>>> b\nPath('mem/abcde.zip', 'b/')\n\nname property:\n\n>>> b.name\n'b'\n\njoin with divide operator:\n\n>>> c = b / 'c.txt'\n>>> c\nPath('mem/abcde.zip', 'b/c.txt')\n>>> c.name\n'c.txt'\n\nRead text:\n\n>>> c.read_text(encoding='utf-8')\n'content of c'\n\nexistence:\n\n>>> c.exists()\nTrue\n>>> (b / 'missing.txt').exists()\nFalse\n\nCoercion to string:\n\n>>> import os\n>>> str(c).replace(os.sep, posixpath.sep)\n'mem/abcde.zip/b/c.txt'\n\nAt the root, ``name``, ``filename``, and ``parent``\nresolve to the zipfile.\n\n>>> str(path)\n'mem/abcde.zip/'\n>>> path.name\n'abcde.zip'\n>>> path.filename == pathlib.Path('mem/abcde.zip')\nTrue\n>>> str(path.parent)\n'mem'\n\nIf the zipfile has no filename, such attributes are not\nvalid and accessing them will raise an Exception.\n\n>>> zf.filename = None\n>>> path.name\nTraceback (most recent call last):\n...\nTypeError: ...\n\n>>> path.filename\nTraceback (most recent call last):\n...\nTypeError: ...\n\n>>> path.parent\nTraceback (most recent call last):\n...\nTypeError: ...\n\n# workaround python/cpython#106763\n>>> pass"), - ("builtins.Path.__delattr__", "Implement delattr(self, name)."), - ("builtins.Path.__eq__", ">>> Path(zipfile.ZipFile(io.BytesIO(), 'w')) == 'foo'\nFalse"), - ("builtins.Path.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.Path.__ge__", "Return self>=value."), - ("builtins.Path.__getattribute__", "Return getattr(self, name)."), - ("builtins.Path.__getstate__", "Helper for pickle."), - ("builtins.Path.__gt__", "Return self>value."), - ("builtins.Path.__init__", "Construct a Path from a ZipFile or filename.\n\nNote: When the source is an existing ZipFile object,\nits type (__class__) will be mutated to a\nspecialized type. If the caller wishes to retain the\noriginal type, the caller should either create a\nseparate ZipFile object or pass a filename."), - ("builtins.Path.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Path.__le__", "Return self<=value."), - ("builtins.Path.__lt__", "Return self=value."), - ("builtins.PathFinder.__getattribute__", "Return getattr(self, name)."), - ("builtins.PathFinder.__getstate__", "Helper for pickle."), - ("builtins.PathFinder.__gt__", "Return self>value."), - ("builtins.PathFinder.__hash__", "Return hash(self)."), - ("builtins.PathFinder.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.PathFinder.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.PathFinder.__le__", "Return self<=value."), - ("builtins.PathFinder.__lt__", "Return self=value."), - ("builtins.PercentStyle.__getattribute__", "Return getattr(self, name)."), - ("builtins.PercentStyle.__getstate__", "Helper for pickle."), - ("builtins.PercentStyle.__gt__", "Return self>value."), - ("builtins.PercentStyle.__hash__", "Return hash(self)."), - ("builtins.PercentStyle.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.PercentStyle.__le__", "Return self<=value."), - ("builtins.PercentStyle.__lt__", "Return self=value."), - ("builtins.PlaceHolder.__getattribute__", "Return getattr(self, name)."), - ("builtins.PlaceHolder.__getstate__", "Helper for pickle."), - ("builtins.PlaceHolder.__gt__", "Return self>value."), - ("builtins.PlaceHolder.__hash__", "Return hash(self)."), - ("builtins.PlaceHolder.__init__", "Initialize with the specified logger being a child of this placeholder."), - ("builtins.PlaceHolder.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.PlaceHolder.__le__", "Return self<=value."), - ("builtins.PlaceHolder.__lt__", "Return self=value."), - ("builtins.Popen.__getattribute__", "Return getattr(self, name)."), - ("builtins.Popen.__getstate__", "Helper for pickle."), - ("builtins.Popen.__gt__", "Return self>value."), - ("builtins.Popen.__hash__", "Return hash(self)."), - ("builtins.Popen.__init__", "Create new Popen instance."), - ("builtins.Popen.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Popen.__le__", "Return self<=value."), - ("builtins.Popen.__lt__", "Return self=value."), - ("builtins.PrettyPrinter.__getattribute__", "Return getattr(self, name)."), - ("builtins.PrettyPrinter.__getstate__", "Helper for pickle."), - ("builtins.PrettyPrinter.__gt__", "Return self>value."), - ("builtins.PrettyPrinter.__hash__", "Return hash(self)."), - ("builtins.PrettyPrinter.__init__", "Handle pretty printing operations onto a stream using a set of\nconfigured parameters.\n\nindent\n Number of spaces to indent for each level of nesting.\n\nwidth\n Attempted maximum number of columns in the output.\n\ndepth\n The maximum depth to print out nested structures.\n\nstream\n The desired output stream. If omitted (or false), the standard\n output stream available at construction will be used.\n\ncompact\n If true, several items will be combined in one line.\n\nsort_dicts\n If true, dict keys are sorted.\n\nunderscore_numbers\n If true, digit groups are separated with underscores."), - ("builtins.PrettyPrinter.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.PrettyPrinter.__le__", "Return self<=value."), - ("builtins.PrettyPrinter.__lt__", "Return self=value."), - ("builtins.Process.__getattribute__", "Return getattr(self, name)."), - ("builtins.Process.__getstate__", "Helper for pickle."), - ("builtins.Process.__gt__", "Return self>value."), - ("builtins.Process.__hash__", "Return hash(self)."), - ("builtins.Process.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Process.__le__", "Return self<=value."), - ("builtins.Process.__lt__", "Return self=value."), - ("builtins.Profile.__getattribute__", "Return getattr(self, name)."), - ("builtins.Profile.__getstate__", "Helper for pickle."), - ("builtins.Profile.__gt__", "Return self>value."), - ("builtins.Profile.__hash__", "Return hash(self)."), - ("builtins.Profile.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Profile.__le__", "Return self<=value."), - ("builtins.Profile.__lt__", "Return self=value."), - ("builtins.Profile.fake_code.__getattribute__", "Return getattr(self, name)."), - ("builtins.Profile.fake_code.__getstate__", "Helper for pickle."), - ("builtins.Profile.fake_code.__gt__", "Return self>value."), - ("builtins.Profile.fake_code.__hash__", "Return hash(self)."), - ("builtins.Profile.fake_code.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Profile.fake_code.__le__", "Return self<=value."), - ("builtins.Profile.fake_code.__lt__", "Return self=value."), - ("builtins.Profile.fake_frame.__getattribute__", "Return getattr(self, name)."), - ("builtins.Profile.fake_frame.__getstate__", "Helper for pickle."), - ("builtins.Profile.fake_frame.__gt__", "Return self>value."), - ("builtins.Profile.fake_frame.__hash__", "Return hash(self)."), - ("builtins.Profile.fake_frame.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Profile.fake_frame.__le__", "Return self<=value."), - ("builtins.Profile.fake_frame.__lt__", "Return self=value."), - ("builtins.Queue.__getattribute__", "Return getattr(self, name)."), - ("builtins.Queue.__getstate__", "Helper for pickle."), - ("builtins.Queue.__gt__", "Return self>value."), - ("builtins.Queue.__hash__", "Return hash(self)."), - ("builtins.Queue.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Queue.__le__", "Return self<=value."), - ("builtins.Queue.__lt__", "Return self= n\nas a direct substitute, but be aware that either approach risks a race\ncondition where a queue can shrink before the result of full() or\nqsize() can be used."), - ("builtins.Queue.get", "Remove and return an item from the queue.\n\nIf optional args 'block' is true and 'timeout' is None (the default),\nblock if necessary until an item is available. If 'timeout' is\na non-negative number, it blocks at most 'timeout' seconds and raises\nthe Empty exception if no item was available within that time.\nOtherwise ('block' is false), return an item if one is immediately\navailable, else raise the Empty exception ('timeout' is ignored\nin that case).\n\nRaises ShutDown if the queue has been shut down and is empty,\nor if the queue has been shut down immediately."), - ("builtins.Queue.get_nowait", "Remove and return an item from the queue without blocking.\n\nOnly get an item if one is immediately available. Otherwise\nraise the Empty exception."), - ("builtins.Queue.join", "Blocks until all items in the Queue have been gotten and processed.\n\nThe count of unfinished tasks goes up whenever an item is added to the\nqueue. The count goes down whenever a consumer thread calls task_done()\nto indicate the item was retrieved and all work on it is complete.\n\nWhen the count of unfinished tasks drops to zero, join() unblocks."), - ("builtins.Queue.put", "Put an item into the queue.\n\nIf optional args 'block' is true and 'timeout' is None (the default),\nblock if necessary until a free slot is available. If 'timeout' is\na non-negative number, it blocks at most 'timeout' seconds and raises\nthe Full exception if no free slot was available within that time.\nOtherwise ('block' is false), put an item on the queue if a free slot\nis immediately available, else raise the Full exception ('timeout'\nis ignored in that case).\n\nRaises ShutDown if the queue has been shut down."), - ("builtins.Queue.put_nowait", "Put an item into the queue without blocking.\n\nOnly enqueue the item if a free slot is immediately available.\nOtherwise raise the Full exception."), - ("builtins.Queue.qsize", "Return the approximate size of the queue (not reliable!)."), - ("builtins.Queue.shutdown", "Shut-down the queue, making queue gets and puts raise ShutDown.\n\nBy default, gets will only raise once the queue is empty. Set\n'immediate' to True to make gets raise immediately instead.\n\nAll blocked callers of put() and get() will be unblocked.\n\nIf 'immediate', the queue is drained and unfinished tasks\nis reduced by the number of drained tasks. If unfinished tasks\nis reduced to zero, callers of Queue.join are unblocked."), - ("builtins.Queue.task_done", "Indicate that a formerly enqueued task is complete.\n\nUsed by Queue consumer threads. For each get() used to fetch a task,\na subsequent call to task_done() tells the queue that the processing\non the task is complete.\n\nIf a join() is currently blocking, it will resume when all items\nhave been processed (meaning that a task_done() call was received\nfor every item that had been put() into the queue).\n\nRaises a ValueError if called more times than there were items\nplaced in the queue."), - ("builtins.Quitter.__delattr__", "Implement delattr(self, name)."), - ("builtins.Quitter.__eq__", "Return self==value."), - ("builtins.Quitter.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.Quitter.__ge__", "Return self>=value."), - ("builtins.Quitter.__getattribute__", "Return getattr(self, name)."), - ("builtins.Quitter.__getstate__", "Helper for pickle."), - ("builtins.Quitter.__gt__", "Return self>value."), - ("builtins.Quitter.__hash__", "Return hash(self)."), - ("builtins.Quitter.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Quitter.__le__", "Return self<=value."), - ("builtins.Quitter.__lt__", "Return self x in the interval [0, 1)."), ("builtins.Random.seed", "seed([n]) -> None.\n\nDefaults to use urandom and falls back to a combination\nof the current time and the process identifier."), ("builtins.Random.setstate", "setstate(state) -> None. Restores generator state."), - ("builtins.Reader", "Protocol for simple I/O reader instances.\n\nThis protocol only supports blocking I/O."), - ("builtins.Reader.__class_getitem__", "Represent a PEP 585 generic type\n\nFor example, for t = list[int], t.__origin__ is list and t.__args__\nis (int,)."), - ("builtins.Reader.__delattr__", "Implement delattr(self, name)."), - ("builtins.Reader.__eq__", "Return self==value."), - ("builtins.Reader.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.Reader.__ge__", "Return self>=value."), - ("builtins.Reader.__getattribute__", "Return getattr(self, name)."), - ("builtins.Reader.__getstate__", "Helper for pickle."), - ("builtins.Reader.__gt__", "Return self>value."), - ("builtins.Reader.__hash__", "Return hash(self)."), - ("builtins.Reader.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.Reader.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Reader.__le__", "Return self<=value."), - ("builtins.Reader.__lt__", "Return self=value."), - ("builtins.Repr.__getattribute__", "Return getattr(self, name)."), - ("builtins.Repr.__getstate__", "Helper for pickle."), - ("builtins.Repr.__gt__", "Return self>value."), - ("builtins.Repr.__hash__", "Return hash(self)."), - ("builtins.Repr.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Repr.__le__", "Return self<=value."), - ("builtins.Repr.__lt__", "Return self=value."), - ("builtins.ResourceReader.__getattribute__", "Return getattr(self, name)."), - ("builtins.ResourceReader.__getstate__", "Helper for pickle."), - ("builtins.ResourceReader.__gt__", "Return self>value."), - ("builtins.ResourceReader.__hash__", "Return hash(self)."), - ("builtins.ResourceReader.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.ResourceReader.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.ResourceReader.__le__", "Return self<=value."), - ("builtins.ResourceReader.__lt__", "Return self=value."), - ("builtins.Runner.__getattribute__", "Return getattr(self, name)."), - ("builtins.Runner.__getstate__", "Helper for pickle."), - ("builtins.Runner.__gt__", "Return self>value."), - ("builtins.Runner.__hash__", "Return hash(self)."), - ("builtins.Runner.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Runner.__le__", "Return self<=value."), - ("builtins.Runner.__lt__", "Return self=value."), - ("builtins.SMTP.__getattribute__", "Return getattr(self, name)."), - ("builtins.SMTP.__getstate__", "Helper for pickle."), - ("builtins.SMTP.__gt__", "Return self>value."), - ("builtins.SMTP.__hash__", "Return hash(self)."), - ("builtins.SMTP.__init__", "Initialize a new instance.\n\nIf specified, `host` is the name of the remote host to which to\nconnect. If specified, `port` specifies the port to which to connect.\nBy default, smtplib.SMTP_PORT is used. If a host is specified the\nconnect method is called, and if it returns anything other than a\nsuccess code an SMTPConnectError is raised. If specified,\n`local_hostname` is used as the FQDN of the local host in the HELO/EHLO\ncommand. Otherwise, the local hostname is found using\nsocket.getfqdn(). The `source_address` parameter takes a 2-tuple (host,\nport) for the socket to bind to as its source address before\nconnecting. If the host is '' and port is 0, the OS default behavior\nwill be used."), - ("builtins.SMTP.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.SMTP.__le__", "Return self<=value."), - ("builtins.SMTP.__lt__", "Return self"), - ("builtins.SMTP.putcmd", "Send a command to the server."), - ("builtins.SMTP.quit", "Terminate the SMTP session."), - ("builtins.SMTP.rcpt", "SMTP 'rcpt' command -- indicates 1 recipient for this mail."), - ("builtins.SMTP.rset", "SMTP 'rset' command -- resets session."), - ("builtins.SMTP.send", "Send 's' to the server."), - ("builtins.SMTP.send_message", "Converts message to a bytestring and passes it to sendmail.\n\nThe arguments are as for sendmail, except that msg is an\nemail.message.Message object. If from_addr is None or to_addrs is\nNone, these arguments are taken from the headers of the Message as\ndescribed in RFC 5322 (a ValueError is raised if there is more than\none set of 'Resent-' headers). Regardless of the values of from_addr and\nto_addr, any Bcc field (or Resent-Bcc field, when the Message is a\nresent) of the Message object won't be transmitted. The Message\nobject is then serialized using email.generator.BytesGenerator and\nsendmail is called to transmit the message. If the sender or any of\nthe recipient addresses contain non-ASCII and the server advertises the\nSMTPUTF8 capability, the policy is cloned with utf8 set to True for the\nserialization, and SMTPUTF8 and BODY=8BITMIME are asserted on the send.\nIf the server does not support SMTPUTF8, an SMTPNotSupported error is\nraised. Otherwise the generator is called without modifying the\npolicy."), - ("builtins.SMTP.sendmail", "This command performs an entire mail transaction.\n\nThe arguments are:\n - from_addr : The address sending this mail.\n - to_addrs : A list of addresses to send this mail to. A bare\n string will be treated as a list with 1 address.\n - msg : The message to send.\n - mail_options : List of ESMTP options (such as 8bitmime) for the\n mail command.\n - rcpt_options : List of ESMTP options (such as DSN commands) for\n all the rcpt commands.\n\nmsg may be a string containing characters in the ASCII range, or a byte\nstring. A string is encoded to bytes using the ascii codec, and lone\n\\r and \\n characters are converted to \\r\\n characters.\n\nIf there has been no previous EHLO or HELO command this session, this\nmethod tries ESMTP EHLO first. If the server does ESMTP, message size\nand each of the specified options will be passed to it. If EHLO\nfails, HELO will be tried and ESMTP options suppressed.\n\nThis method will return normally if the mail is accepted for at least\none recipient. It returns a dictionary, with one entry for each\nrecipient that was refused. Each entry contains a tuple of the SMTP\nerror code and the accompanying error message sent by the server.\n\nThis method may raise the following exceptions:\n\n SMTPHeloError The server didn't reply properly to\n the helo greeting.\n SMTPRecipientsRefused The server rejected ALL recipients\n (no mail was sent).\n SMTPSenderRefused The server didn't accept the from_addr.\n SMTPDataError The server replied with an unexpected\n error code (other than a refusal of\n a recipient).\n SMTPNotSupportedError The mail_options parameter includes 'SMTPUTF8'\n but the SMTPUTF8 extension is not supported by\n the server.\n\nNote: the connection will be open even after an exception is raised.\n\nExample:\n\n >>> import smtplib\n >>> s=smtplib.SMTP(\"localhost\")\n >>> tolist=[\"one@one.org\",\"two@two.org\",\"three@three.org\",\"four@four.org\"]\n >>> msg = '''\\\n ... From: Me@my.org\n ... Subject: testin'...\n ...\n ... This is a test '''\n >>> s.sendmail(\"me@my.org\",tolist,msg)\n { \"three@three.org\" : ( 550 ,\"User unknown\" ) }\n >>> s.quit()\n\nIn the above example, the message was accepted for delivery to three\nof the four addresses, and one was rejected, with the error code\n550. If all addresses are accepted, then the method will return an\nempty dictionary."), - ("builtins.SMTP.set_debuglevel", "Set the debug output level.\n\nA non-false value results in debug messages for connection and for all\nmessages sent to and received from the server."), - ("builtins.SMTP.starttls", "Puts the connection to the SMTP server into TLS mode.\n\nIf there has been no previous EHLO or HELO command this session, this\nmethod tries ESMTP EHLO first.\n\nIf the server supports TLS, this will encrypt the rest of the SMTP\nsession. If you provide the context parameter,\nthe identity of the SMTP server and client can be checked. This,\nhowever, depends on whether the socket module really checks the\ncertificates.\n\nThis method may raise the following exceptions:\n\n SMTPHeloError The server didn't reply properly to\n the helo greeting."), - ("builtins.SMTP.verify", "SMTP 'verify' command -- checks for address validity."), - ("builtins.SMTP.vrfy", "SMTP 'verify' command -- checks for address validity."), ("builtins.SRE_Scanner.__delattr__", "Implement delattr(self, name)."), ("builtins.SRE_Scanner.__eq__", "Return self==value."), ("builtins.SRE_Scanner.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), @@ -17746,48 +13607,6 @@ pub const DB: &[(&str, &str)] = &[ ("builtins.SRE_Template.__sizeof__", "Size of object in memory, in bytes."), ("builtins.SRE_Template.__str__", "Return str(self)."), ("builtins.SRE_Template.__subclasshook__", "Abstract classes can override this to customize issubclass().\n\nThis is invoked early on by abc.ABCMeta.__subclasscheck__().\nIt should return True, False or NotImplemented. If it returns\nNotImplemented, the normal algorithm is used. Otherwise, it\noverrides the normal algorithm (and the outcome is cached)."), - ("builtins.SSLObject", "This class implements an interface on top of a low-level SSL object as\nimplemented by OpenSSL. This object captures the state of an SSL connection\nbut does not provide any network IO itself. IO needs to be performed\nthrough separate \"BIO\" objects which are OpenSSL's IO abstraction layer.\n\nThis class does not have a public constructor. Instances are returned by\n``SSLContext.wrap_bio``. This class is typically used by framework authors\nthat want to implement asynchronous IO for SSL through memory buffers.\n\nWhen compared to ``SSLSocket``, this object lacks the following features:\n\n * Any form of network IO, including methods such as ``recv`` and ``send``.\n * The ``do_handshake_on_connect`` and ``suppress_ragged_eofs`` machinery."), - ("builtins.SSLObject.__delattr__", "Implement delattr(self, name)."), - ("builtins.SSLObject.__eq__", "Return self==value."), - ("builtins.SSLObject.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.SSLObject.__ge__", "Return self>=value."), - ("builtins.SSLObject.__getattribute__", "Return getattr(self, name)."), - ("builtins.SSLObject.__getstate__", "Helper for pickle."), - ("builtins.SSLObject.__gt__", "Return self>value."), - ("builtins.SSLObject.__hash__", "Return hash(self)."), - ("builtins.SSLObject.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.SSLObject.__le__", "Return self<=value."), - ("builtins.SSLObject.__lt__", "Return self=value."), - ("builtins.Semaphore.__getattribute__", "Return getattr(self, name)."), - ("builtins.Semaphore.__getstate__", "Helper for pickle."), - ("builtins.Semaphore.__gt__", "Return self>value."), - ("builtins.Semaphore.__hash__", "Return hash(self)."), - ("builtins.Semaphore.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Semaphore.__le__", "Return self<=value."), - ("builtins.Semaphore.__lt__", "Return self\" lines in HTML files). That may be\nbecause this is the only method of the 3 that has a *concept* of\n\"junk\" .\n\nExample, comparing two strings, and considering blanks to be \"junk\":\n\n>>> s = SequenceMatcher(lambda x: x == \" \",\n... \"private Thread currentThread;\",\n... \"private volatile Thread currentThread;\")\n>>>\n\n.ratio() returns a float in [0, 1], measuring the \"similarity\" of the\nsequences. As a rule of thumb, a .ratio() value over 0.6 means the\nsequences are close matches:\n\n>>> print(round(s.ratio(), 2))\n0.87\n>>>\n\nIf you're only interested in where the sequences match,\n.get_matching_blocks() is handy:\n\n>>> for block in s.get_matching_blocks():\n... print(\"a[%d] and b[%d] match for %d elements\" % block)\na[0] and b[0] match for 8 elements\na[8] and b[17] match for 21 elements\na[29] and b[38] match for 0 elements\n\nNote that the last tuple returned by .get_matching_blocks() is always a\ndummy, (len(a), len(b), 0), and this is the only case in which the last\ntuple element (number of elements matched) is 0.\n\nIf you want to know how to change the first sequence into the second,\nuse .get_opcodes():\n\n>>> for opcode in s.get_opcodes():\n... print(\"%6s a[%d:%d] b[%d:%d]\" % opcode)\n equal a[0:8] b[0:8]\ninsert a[8:8] b[8:17]\n equal a[8:29] b[17:38]\n\nSee the Differ class for a fancy human-friendly file differencer, which\nuses SequenceMatcher both to compare sequences of lines, and to compare\nsequences of characters within similar (near-matching) lines.\n\nSee also function get_close_matches() in this module, which shows how\nsimple code building on SequenceMatcher can be used to do useful work.\n\nTiming: Basic R-O is cubic time worst case and quadratic time expected\ncase. SequenceMatcher is quadratic time for the worst case and has\nexpected-case behavior dependent in a complicated way on how many\nelements the sequences have in common; best case time is linear."), - ("builtins.SequenceMatcher.__class_getitem__", "Represent a PEP 585 generic type\n\nFor example, for t = list[int], t.__origin__ is list and t.__args__\nis (int,)."), - ("builtins.SequenceMatcher.__delattr__", "Implement delattr(self, name)."), - ("builtins.SequenceMatcher.__eq__", "Return self==value."), - ("builtins.SequenceMatcher.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.SequenceMatcher.__ge__", "Return self>=value."), - ("builtins.SequenceMatcher.__getattribute__", "Return getattr(self, name)."), - ("builtins.SequenceMatcher.__getstate__", "Helper for pickle."), - ("builtins.SequenceMatcher.__gt__", "Return self>value."), - ("builtins.SequenceMatcher.__hash__", "Return hash(self)."), - ("builtins.SequenceMatcher.__init__", "Construct a SequenceMatcher.\n\nOptional arg isjunk is None (the default), or a one-argument\nfunction that takes a sequence element and returns true iff the\nelement is junk. None is equivalent to passing \"lambda x: 0\", i.e.\nno elements are considered to be junk. For example, pass\n lambda x: x in \" \\t\"\nif you're comparing lines as sequences of characters, and don't\nwant to synch up on blanks or hard tabs.\n\nOptional arg a is the first of two sequences to be compared. By\ndefault, an empty string. The elements of a must be hashable. See\nalso .set_seqs() and .set_seq1().\n\nOptional arg b is the second of two sequences to be compared. By\ndefault, an empty string. The elements of b must be hashable. See\nalso .set_seqs() and .set_seq2().\n\nOptional arg autojunk should be set to False to disable the\n\"automatic junk heuristic\" that treats popular elements as junk\n(see module documentation for more information)."), - ("builtins.SequenceMatcher.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.SequenceMatcher.__le__", "Return self<=value."), - ("builtins.SequenceMatcher.__lt__", "Return self= k'\n i <= i'\n and if i == i', j <= j'\n\nIn other words, of all maximal matching blocks, return one that\nstarts earliest in a, and of all those maximal matching blocks that\nstart earliest in a, return the one that starts earliest in b.\n\n>>> s = SequenceMatcher(None, \" abcd\", \"abcd abcd\")\n>>> s.find_longest_match(0, 5, 0, 9)\nMatch(a=0, b=4, size=5)\n\nIf isjunk is defined, first the longest matching block is\ndetermined as above, but with the additional restriction that no\njunk element appears in the block. Then that block is extended as\nfar as possible by matching (only) junk elements on both sides. So\nthe resulting block never matches on junk except as identical junk\nhappens to be adjacent to an \"interesting\" match.\n\nHere's the same example as before, but considering blanks to be\njunk. That prevents \" abcd\" from matching the \" abcd\" at the tail\nend of the second sequence directly. Instead only the \"abcd\" can\nmatch, and matches the leftmost \"abcd\" in the second sequence:\n\n>>> s = SequenceMatcher(lambda x: x==\" \", \" abcd\", \"abcd abcd\")\n>>> s.find_longest_match(0, 5, 0, 9)\nMatch(a=1, b=0, size=4)\n\nIf no blocks match, return (alo, blo, 0).\n\n>>> s = SequenceMatcher(None, \"ab\", \"c\")\n>>> s.find_longest_match(0, 2, 0, 1)\nMatch(a=0, b=0, size=0)"), - ("builtins.SequenceMatcher.get_grouped_opcodes", "Isolate change clusters by eliminating ranges with no changes.\n\nReturn a generator of groups with up to n lines of context.\nEach group is in the same format as returned by get_opcodes().\n\n>>> from pprint import pprint\n>>> a = list(map(str, range(1,40)))\n>>> b = a[:]\n>>> b[8:8] = ['i'] # Make an insertion\n>>> b[20] += 'x' # Make a replacement\n>>> b[23:28] = [] # Make a deletion\n>>> b[30] += 'y' # Make another replacement\n>>> pprint(list(SequenceMatcher(None,a,b).get_grouped_opcodes()))\n[[('equal', 5, 8, 5, 8), ('insert', 8, 8, 8, 9), ('equal', 8, 11, 9, 12)],\n [('equal', 16, 19, 17, 20),\n ('replace', 19, 20, 20, 21),\n ('equal', 20, 22, 21, 23),\n ('delete', 22, 27, 23, 23),\n ('equal', 27, 30, 23, 26)],\n [('equal', 31, 34, 27, 30),\n ('replace', 34, 35, 30, 31),\n ('equal', 35, 38, 31, 34)]]"), - ("builtins.SequenceMatcher.get_matching_blocks", "Return list of triples describing matching subsequences.\n\nEach triple is of the form (i, j, n), and means that\na[i:i+n] == b[j:j+n]. The triples are monotonically increasing in\ni and in j. New in Python 2.5, it's also guaranteed that if\n(i, j, n) and (i', j', n') are adjacent triples in the list, and\nthe second is not the last triple in the list, then i+n != i' or\nj+n != j'. IOW, adjacent triples never describe adjacent equal\nblocks.\n\nThe last triple is a dummy, (len(a), len(b), 0), and is the only\ntriple with n==0.\n\n>>> s = SequenceMatcher(None, \"abxcd\", \"abcd\")\n>>> list(s.get_matching_blocks())\n[Match(a=0, b=0, size=2), Match(a=3, b=2, size=2), Match(a=5, b=4, size=0)]"), - ("builtins.SequenceMatcher.get_opcodes", "Return list of 5-tuples describing how to turn a into b.\n\nEach tuple is of the form (tag, i1, i2, j1, j2). The first tuple\nhas i1 == j1 == 0, and remaining tuples have i1 == the i2 from the\ntuple preceding it, and likewise for j1 == the previous j2.\n\nThe tags are strings, with these meanings:\n\n'replace': a[i1:i2] should be replaced by b[j1:j2]\n'delete': a[i1:i2] should be deleted.\n Note that j1==j2 in this case.\n'insert': b[j1:j2] should be inserted at a[i1:i1].\n Note that i1==i2 in this case.\n'equal': a[i1:i2] == b[j1:j2]\n\n>>> a = \"qabxcd\"\n>>> b = \"abycdf\"\n>>> s = SequenceMatcher(None, a, b)\n>>> for tag, i1, i2, j1, j2 in s.get_opcodes():\n... print((\"%7s a[%d:%d] (%s) b[%d:%d] (%s)\" %\n... (tag, i1, i2, a[i1:i2], j1, j2, b[j1:j2])))\n delete a[0:1] (q) b[0:0] ()\n equal a[1:3] (ab) b[0:2] (ab)\nreplace a[3:4] (x) b[2:3] (y)\n equal a[4:6] (cd) b[3:5] (cd)\n insert a[6:6] () b[5:6] (f)"), - ("builtins.SequenceMatcher.quick_ratio", "Return an upper bound on ratio() relatively quickly.\n\nThis isn't defined beyond that it is an upper bound on .ratio(), and\nis faster to compute."), - ("builtins.SequenceMatcher.ratio", "Return a measure of the sequences' similarity (float in [0,1]).\n\nWhere T is the total number of elements in both sequences, and\nM is the number of matches, this is 2.0*M / T.\nNote that this is 1 if the sequences are identical, and 0 if\nthey have nothing in common.\n\n.ratio() is expensive to compute if you haven't already computed\n.get_matching_blocks() or .get_opcodes(), in which case you may\nwant to try .quick_ratio() or .real_quick_ratio() first to get an\nupper bound.\n\n>>> s = SequenceMatcher(None, \"abcd\", \"bcde\")\n>>> s.ratio()\n0.75\n>>> s.quick_ratio()\n0.75\n>>> s.real_quick_ratio()\n1.0"), - ("builtins.SequenceMatcher.real_quick_ratio", "Return an upper bound on ratio() very quickly.\n\nThis isn't defined beyond that it is an upper bound on .ratio(), and\nis faster to compute than either .ratio() or .quick_ratio()."), - ("builtins.SequenceMatcher.set_seq1", "Set the first sequence to be compared.\n\nThe second sequence to be compared is not changed.\n\n>>> s = SequenceMatcher(None, \"abcd\", \"bcde\")\n>>> s.ratio()\n0.75\n>>> s.set_seq1(\"bcde\")\n>>> s.ratio()\n1.0\n>>>\n\nSequenceMatcher computes and caches detailed information about the\nsecond sequence, so if you want to compare one sequence S against\nmany sequences, use .set_seq2(S) once and call .set_seq1(x)\nrepeatedly for each of the other sequences.\n\nSee also set_seqs() and set_seq2()."), - ("builtins.SequenceMatcher.set_seq2", "Set the second sequence to be compared.\n\nThe first sequence to be compared is not changed.\n\n>>> s = SequenceMatcher(None, \"abcd\", \"bcde\")\n>>> s.ratio()\n0.75\n>>> s.set_seq2(\"abcd\")\n>>> s.ratio()\n1.0\n>>>\n\nSequenceMatcher computes and caches detailed information about the\nsecond sequence, so if you want to compare one sequence S against\nmany sequences, use .set_seq2(S) once and call .set_seq1(x)\nrepeatedly for each of the other sequences.\n\nSee also set_seqs() and set_seq1()."), - ("builtins.SequenceMatcher.set_seqs", "Set the two sequences to be compared.\n\n>>> s = SequenceMatcher()\n>>> s.set_seqs(\"abcd\", \"bcde\")\n>>> s.ratio()\n0.75"), ("builtins.Shape", "Data structure modeling shapes.\n\nattribute _type is one of \"polygon\", \"image\", \"compound\"\nattribute _data is - depending on _type a poygon-tuple,\nan image or a list constructed using the addcomponent method."), ("builtins.Shape.__delattr__", "Implement delattr(self, name)."), ("builtins.Shape.__eq__", "Return self==value."), @@ -18029,113 +13789,6 @@ pub const DB: &[(&str, &str)] = &[ ("builtins.SignalDictMixin.__sizeof__", "Size of object in memory, in bytes."), ("builtins.SignalDictMixin.__str__", "Return str(self)."), ("builtins.SignalDictMixin.__subclasshook__", "Abstract classes can override this to customize issubclass().\n\nThis is invoked early on by abc.ABCMeta.__subclasscheck__().\nIt should return True, False or NotImplemented. If it returns\nNotImplemented, the normal algorithm is used. Otherwise, it\noverrides the normal algorithm (and the outcome is cached)."), - ("builtins.Signature", "A Signature object represents the overall signature of a function.\nIt stores a Parameter object for each parameter accepted by the\nfunction, as well as information specific to the function itself.\n\nA Signature object has the following public attributes and methods:\n\n* parameters : OrderedDict\n An ordered mapping of parameters' names to the corresponding\n Parameter objects (keyword-only arguments are in the same order\n as listed in `code.co_varnames`).\n* return_annotation : object\n The annotation for the return type of the function if specified.\n If the function has no annotation for its return type, this\n attribute is set to `Signature.empty`.\n* bind(*args, **kwargs) -> BoundArguments\n Creates a mapping from positional and keyword arguments to\n parameters.\n* bind_partial(*args, **kwargs) -> BoundArguments\n Creates a partial mapping from positional and keyword arguments\n to parameters (simulating 'functools.partial' behavior.)"), - ("builtins.Signature.__delattr__", "Implement delattr(self, name)."), - ("builtins.Signature.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.Signature.__ge__", "Return self>=value."), - ("builtins.Signature.__getattribute__", "Return getattr(self, name)."), - ("builtins.Signature.__getstate__", "Helper for pickle."), - ("builtins.Signature.__gt__", "Return self>value."), - ("builtins.Signature.__init__", "Constructs Signature from the given list of Parameter\nobjects and 'return_annotation'. All arguments are optional."), - ("builtins.Signature.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Signature.__le__", "Return self<=value."), - ("builtins.Signature.__lt__", "Return self=value."), - ("builtins.Signature._bound_arguments_cls.__getattribute__", "Return getattr(self, name)."), - ("builtins.Signature._bound_arguments_cls.__gt__", "Return self>value."), - ("builtins.Signature._bound_arguments_cls.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Signature._bound_arguments_cls.__le__", "Return self<=value."), - ("builtins.Signature._bound_arguments_cls.__lt__", "Return self=value."), - ("builtins.Signature._parameter_cls.__getattribute__", "Return getattr(self, name)."), - ("builtins.Signature._parameter_cls.__getstate__", "Helper for pickle."), - ("builtins.Signature._parameter_cls.__gt__", "Return self>value."), - ("builtins.Signature._parameter_cls.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Signature._parameter_cls.__le__", "Return self<=value."), - ("builtins.Signature._parameter_cls.__lt__", "Return self=value."), - ("builtins.Signature._parameter_cls.empty.__getattribute__", "Return getattr(self, name)."), - ("builtins.Signature._parameter_cls.empty.__getstate__", "Helper for pickle."), - ("builtins.Signature._parameter_cls.empty.__gt__", "Return self>value."), - ("builtins.Signature._parameter_cls.empty.__hash__", "Return hash(self)."), - ("builtins.Signature._parameter_cls.empty.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.Signature._parameter_cls.empty.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Signature._parameter_cls.empty.__le__", "Return self<=value."), - ("builtins.Signature._parameter_cls.empty.__lt__", "Return self=value."), - ("builtins.Signature.empty.__getattribute__", "Return getattr(self, name)."), - ("builtins.Signature.empty.__getstate__", "Helper for pickle."), - ("builtins.Signature.empty.__gt__", "Return self>value."), - ("builtins.Signature.empty.__hash__", "Return hash(self)."), - ("builtins.Signature.empty.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.Signature.empty.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Signature.empty.__le__", "Return self<=value."), - ("builtins.Signature.empty.__lt__", "Return self=value."), - ("builtins.Sized.__getattribute__", "Return getattr(self, name)."), - ("builtins.Sized.__getstate__", "Helper for pickle."), - ("builtins.Sized.__gt__", "Return self>value."), - ("builtins.Sized.__hash__", "Return hash(self)."), - ("builtins.Sized.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.Sized.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Sized.__le__", "Return self<=value."), - ("builtins.Sized.__lt__", "Return self=value."), - ("builtins.Snapshot.__getattribute__", "Return getattr(self, name)."), - ("builtins.Snapshot.__getstate__", "Helper for pickle."), - ("builtins.Snapshot.__gt__", "Return self>value."), - ("builtins.Snapshot.__hash__", "Return hash(self)."), - ("builtins.Snapshot.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Snapshot.__le__", "Return self<=value."), - ("builtins.Snapshot.__lt__", "Return self=value."), - ("builtins.Sniffer.__getattribute__", "Return getattr(self, name)."), - ("builtins.Sniffer.__getstate__", "Helper for pickle."), - ("builtins.Sniffer.__gt__", "Return self>value."), - ("builtins.Sniffer.__hash__", "Return hash(self)."), - ("builtins.Sniffer.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Sniffer.__le__", "Return self<=value."), - ("builtins.Sniffer.__lt__", "Return self=value."), - ("builtins.StackObject.__getattribute__", "Return getattr(self, name)."), - ("builtins.StackObject.__getstate__", "Helper for pickle."), - ("builtins.StackObject.__gt__", "Return self>value."), - ("builtins.StackObject.__hash__", "Return hash(self)."), - ("builtins.StackObject.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.StackObject.__le__", "Return self<=value."), - ("builtins.StackObject.__lt__", "Return self=value."), - ("builtins.State.__getattribute__", "Return getattr(self, name)."), - ("builtins.State.__getstate__", "Helper for pickle."), - ("builtins.State.__gt__", "Return self>value."), - ("builtins.State.__hash__", "Return hash(self)."), - ("builtins.State.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.State.__le__", "Return self<=value."), - ("builtins.State.__lt__", "Return self=value."), - ("builtins.Statistic.__getattribute__", "Return getattr(self, name)."), - ("builtins.Statistic.__getstate__", "Helper for pickle."), - ("builtins.Statistic.__gt__", "Return self>value."), - ("builtins.Statistic.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Statistic.__le__", "Return self<=value."), - ("builtins.Statistic.__lt__", "Return self=value."), - ("builtins.StatisticDiff.__getattribute__", "Return getattr(self, name)."), - ("builtins.StatisticDiff.__getstate__", "Helper for pickle."), - ("builtins.StatisticDiff.__gt__", "Return self>value."), - ("builtins.StatisticDiff.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.StatisticDiff.__le__", "Return self<=value."), - ("builtins.StatisticDiff.__lt__", "Return self=value."), - ("builtins.Stats.__getattribute__", "Return getattr(self, name)."), - ("builtins.Stats.__getstate__", "Helper for pickle."), - ("builtins.Stats.__gt__", "Return self>value."), - ("builtins.Stats.__hash__", "Return hash(self)."), - ("builtins.Stats.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Stats.__le__", "Return self<=value."), - ("builtins.Stats.__lt__", "Return self=value."), - ("builtins.StatsProfile.__getattribute__", "Return getattr(self, name)."), - ("builtins.StatsProfile.__getstate__", "Helper for pickle."), - ("builtins.StatsProfile.__gt__", "Return self>value."), - ("builtins.StatsProfile.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.StatsProfile.__le__", "Return self<=value."), - ("builtins.StatsProfile.__lt__", "Return self=value."), - ("builtins.StreamReader.__getattribute__", "Return getattr(self, name)."), - ("builtins.StreamReader.__getstate__", "Helper for pickle."), - ("builtins.StreamReader.__gt__", "Return self>value."), - ("builtins.StreamReader.__hash__", "Return hash(self)."), - ("builtins.StreamReader.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.StreamReader.__le__", "Return self<=value."), - ("builtins.StreamReader.__lt__", "Return self=value."), - ("builtins.StreamReaderWriter.__getattr__", "Inherit all other methods from the underlying stream."), - ("builtins.StreamReaderWriter.__getattribute__", "Return getattr(self, name)."), - ("builtins.StreamReaderWriter.__getstate__", "Helper for pickle."), - ("builtins.StreamReaderWriter.__gt__", "Return self>value."), - ("builtins.StreamReaderWriter.__hash__", "Return hash(self)."), - ("builtins.StreamReaderWriter.__init__", "Creates a StreamReaderWriter instance.\n\nstream must be a Stream-like object.\n\nReader, Writer must be factory functions or classes\nproviding the StreamReader, StreamWriter interface resp.\n\nError handling is done in the same way as defined for the\nStreamWriter/Readers."), - ("builtins.StreamReaderWriter.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.StreamReaderWriter.__le__", "Return self<=value."), - ("builtins.StreamReaderWriter.__lt__", "Return self=value."), - ("builtins.StreamRecoder.__getattr__", "Inherit all other methods from the underlying stream."), - ("builtins.StreamRecoder.__getattribute__", "Return getattr(self, name)."), - ("builtins.StreamRecoder.__getstate__", "Helper for pickle."), - ("builtins.StreamRecoder.__gt__", "Return self>value."), - ("builtins.StreamRecoder.__hash__", "Return hash(self)."), - ("builtins.StreamRecoder.__init__", "Creates a StreamRecoder instance which implements a two-way\nconversion: encode and decode work on the frontend (the\ndata visible to .read() and .write()) while Reader and Writer\nwork on the backend (the data in stream).\n\nYou can use these objects to do transparent\ntranscodings from e.g. latin-1 to utf-8 and back.\n\nstream must be a file-like object.\n\nencode and decode must adhere to the Codec interface; Reader and\nWriter must be factory functions or classes providing the\nStreamReader and StreamWriter interfaces resp.\n\nError handling is done in the same way as defined for the\nStreamWriter/Readers."), - ("builtins.StreamRecoder.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.StreamRecoder.__le__", "Return self<=value."), - ("builtins.StreamRecoder.__lt__", "Return self=value."), - ("builtins.StreamWriter.__getattribute__", "Return getattr(self, name)."), - ("builtins.StreamWriter.__getstate__", "Helper for pickle."), - ("builtins.StreamWriter.__gt__", "Return self>value."), - ("builtins.StreamWriter.__hash__", "Return hash(self)."), - ("builtins.StreamWriter.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.StreamWriter.__le__", "Return self<=value."), - ("builtins.StreamWriter.__lt__", "Return self compiled struct object"), ("builtins.Struct.__delattr__", "Implement delattr(self, name)."), ("builtins.Struct.__eq__", "Return self==value."), @@ -18635,116 +14000,6 @@ pub const DB: &[(&str, &str)] = &[ ("builtins.StructUnionLayout.__str__", "Return str(self)."), ("builtins.StructUnionLayout.__subclasshook__", "Abstract classes can override this to customize issubclass().\n\nThis is invoked early on by abc.ABCMeta.__subclasscheck__().\nIt should return True, False or NotImplemented. If it returns\nNotImplemented, the normal algorithm is used. Otherwise, it\noverrides the normal algorithm (and the outcome is cached)."), ("builtins.StructUnionLayout.__weakref__", "list of weak references to the object"), - ("builtins.SubPattern.__delattr__", "Implement delattr(self, name)."), - ("builtins.SubPattern.__eq__", "Return self==value."), - ("builtins.SubPattern.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.SubPattern.__ge__", "Return self>=value."), - ("builtins.SubPattern.__getattribute__", "Return getattr(self, name)."), - ("builtins.SubPattern.__getstate__", "Helper for pickle."), - ("builtins.SubPattern.__gt__", "Return self>value."), - ("builtins.SubPattern.__hash__", "Return hash(self)."), - ("builtins.SubPattern.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.SubPattern.__le__", "Return self<=value."), - ("builtins.SubPattern.__lt__", "Return self=value."), - ("builtins.Symbol.__getattribute__", "Return getattr(self, name)."), - ("builtins.Symbol.__getstate__", "Helper for pickle."), - ("builtins.Symbol.__gt__", "Return self>value."), - ("builtins.Symbol.__hash__", "Return hash(self)."), - ("builtins.Symbol.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Symbol.__le__", "Return self<=value."), - ("builtins.Symbol.__lt__", "Return self=value."), - ("builtins.SymbolTable.__getattribute__", "Return getattr(self, name)."), - ("builtins.SymbolTable.__getstate__", "Helper for pickle."), - ("builtins.SymbolTable.__gt__", "Return self>value."), - ("builtins.SymbolTable.__hash__", "Return hash(self)."), - ("builtins.SymbolTable.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.SymbolTable.__le__", "Return self<=value."), - ("builtins.SymbolTable.__lt__", "Return self=value."), - ("builtins.SymbolTableFactory.__getattribute__", "Return getattr(self, name)."), - ("builtins.SymbolTableFactory.__getstate__", "Helper for pickle."), - ("builtins.SymbolTableFactory.__gt__", "Return self>value."), - ("builtins.SymbolTableFactory.__hash__", "Return hash(self)."), - ("builtins.SymbolTableFactory.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.SymbolTableFactory.__le__", "Return self<=value."), - ("builtins.SymbolTableFactory.__lt__", "Return self=value."), - ("builtins.TarFile.__getattribute__", "Return getattr(self, name)."), - ("builtins.TarFile.__getstate__", "Helper for pickle."), - ("builtins.TarFile.__gt__", "Return self>value."), - ("builtins.TarFile.__hash__", "Return hash(self)."), - ("builtins.TarFile.__init__", "Open an (uncompressed) tar archive 'name'. 'mode' is either 'r' to\nread from an existing archive, 'a' to append data to an existing\nfile or 'w' to create a new file overwriting an existing one. 'mode'\ndefaults to 'r'.\nIf 'fileobj' is given, it is used for reading or writing data. If it\ncan be determined, 'mode' is overridden by 'fileobj's mode.\n'fileobj' is not closed, when TarFile is closed."), - ("builtins.TarFile.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.TarFile.__iter__", "Provide an iterator object."), - ("builtins.TarFile.__le__", "Return self<=value."), - ("builtins.TarFile.__lt__", "Return self=value."), - ("builtins.TarFile.fileobject.__getattribute__", "Return getattr(self, name)."), - ("builtins.TarFile.fileobject.__gt__", "Return self>value."), - ("builtins.TarFile.fileobject.__hash__", "Return hash(self)."), - ("builtins.TarFile.fileobject.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.TarFile.fileobject.__iter__", "Implement iter(self)."), - ("builtins.TarFile.fileobject.__le__", "Return self<=value."), - ("builtins.TarFile.fileobject.__lt__", "Return self=value."), - ("builtins.TarFile.tarinfo.__getattribute__", "Return getattr(self, name)."), - ("builtins.TarFile.tarinfo.__getstate__", "Helper for pickle."), - ("builtins.TarFile.tarinfo.__gt__", "Return self>value."), - ("builtins.TarFile.tarinfo.__hash__", "Return hash(self)."), - ("builtins.TarFile.tarinfo.__init__", "Construct a TarInfo object. name is the optional name\nof the member."), - ("builtins.TarFile.tarinfo.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.TarFile.tarinfo.__le__", "Return self<=value."), - ("builtins.TarFile.tarinfo.__lt__", "Return self 1024."), - ("builtins.TarFile.tarinfo._create_gnu_long_header", "Return a GNUTYPE_LONGNAME or GNUTYPE_LONGLINK sequence\nfor name."), - ("builtins.TarFile.tarinfo._create_header", "Return a header block. info is a dictionary with file\ninformation, format must be one of the *_FORMAT constants."), - ("builtins.TarFile.tarinfo._create_pax_generic_header", "Return a POSIX.1-2008 extended or global header sequence\nthat contains a list of keyword, value pairs. The values\nmust be strings."), - ("builtins.TarFile.tarinfo._create_payload", "Return the string payload filled with zero bytes\nup to the next 512 byte border."), - ("builtins.TarFile.tarinfo._decode_pax_field", "Decode a single field from a pax record."), ("builtins.TarFile.tarinfo._frombuf", "Construct a TarInfo object from a 512 byte bytes object.\n\nIf ``dircheck`` is set to ``True`` then ``AREGTYPE`` headers will\nbe normalized to ``DIRTYPE`` if the name ends in a trailing slash.\n``dircheck`` must be set to ``False`` if this function is called\non a follow-up header such as ``GNUTYPE_LONGNAME``."), ("builtins.TarFile.tarinfo._fromtarfile", "See dircheck documentation in _frombuf()."), - ("builtins.TarFile.tarinfo._posix_split_name", "Split a name longer than 100 chars into a prefix\nand a name part."), - ("builtins.TarFile.tarinfo._proc_builtin", "Process a builtin type or an unknown type which\nwill be treated as a regular file."), - ("builtins.TarFile.tarinfo._proc_gnulong", "Process the blocks that hold a GNU longname\nor longlink member."), - ("builtins.TarFile.tarinfo._proc_gnusparse_00", "Process a GNU tar extended sparse header, version 0.0."), - ("builtins.TarFile.tarinfo._proc_gnusparse_01", "Process a GNU tar extended sparse header, version 0.1."), - ("builtins.TarFile.tarinfo._proc_gnusparse_10", "Process a GNU tar extended sparse header, version 1.0."), - ("builtins.TarFile.tarinfo._proc_member", "Choose the right processing method depending on\nthe type and call it."), - ("builtins.TarFile.tarinfo._proc_pax", "Process an extended or global header as described in\nPOSIX.1-2008."), - ("builtins.TarFile.tarinfo._proc_sparse", "Process a GNU sparse header plus extra headers."), - ("builtins.TarFile.tarinfo.create_gnu_header", "Return the object as a GNU header block sequence."), - ("builtins.TarFile.tarinfo.create_pax_global_header", "Return the object as a pax global header block sequence."), - ("builtins.TarFile.tarinfo.create_pax_header", "Return the object as a ustar header block. If it cannot be\nrepresented this way, prepend a pax extended header sequence\nwith supplement information."), - ("builtins.TarFile.tarinfo.create_ustar_header", "Return the object as a ustar header block."), - ("builtins.TarFile.tarinfo.frombuf", "Construct a TarInfo object from a 512 byte bytes object.\n\nTo support the old v7 tar format AREGTYPE headers are\ntransformed to DIRTYPE headers if their name ends in '/'."), - ("builtins.TarFile.tarinfo.fromtarfile", "Return the next TarInfo object from TarFile object\ntarfile."), - ("builtins.TarFile.tarinfo.get_info", "Return the TarInfo's attributes as a dictionary."), - ("builtins.TarFile.tarinfo.isblk", "Return True if it is a block device."), - ("builtins.TarFile.tarinfo.ischr", "Return True if it is a character device."), - ("builtins.TarFile.tarinfo.isdev", "Return True if it is one of character device, block device or FIFO."), - ("builtins.TarFile.tarinfo.isdir", "Return True if it is a directory."), - ("builtins.TarFile.tarinfo.isfifo", "Return True if it is a FIFO."), - ("builtins.TarFile.tarinfo.isfile", "Return True if the Tarinfo object is a regular file."), - ("builtins.TarFile.tarinfo.islnk", "Return True if it is a hard link."), - ("builtins.TarFile.tarinfo.isreg", "Return True if the Tarinfo object is a regular file."), - ("builtins.TarFile.tarinfo.issym", "Return True if it is a symbolic link."), - ("builtins.TarFile.tarinfo.linkpath", "In pax headers, \"linkname\" is called \"linkpath\"."), - ("builtins.TarFile.tarinfo.path", "In pax headers, \"name\" is called \"path\"."), - ("builtins.TarFile.tarinfo.replace", "Return a deep copy of self with the given attributes replaced."), - ("builtins.TarFile.tarinfo.tobuf", "Return a tar header as a string of 512 byte blocks."), - ("builtins.TarFile.taropen", "Open uncompressed tar archive name for reading or writing."), - ("builtins.TarFile.utime", "Set modification time of targetpath according to tarinfo."), - ("builtins.TarFile.xzopen", "Open lzma compressed tar archive name for reading or writing.\nAppending is not allowed."), - ("builtins.TarFile.zstopen", "Open zstd compressed tar archive name for reading or writing.\nAppending is not allowed."), - ("builtins.TarInfo", "Informational class which holds the details about an\narchive member given by a tar header block.\nTarInfo objects are returned by TarFile.getmember(),\nTarFile.getmembers() and TarFile.gettarinfo() and are\nusually created internally."), - ("builtins.TarInfo.__delattr__", "Implement delattr(self, name)."), - ("builtins.TarInfo.__eq__", "Return self==value."), - ("builtins.TarInfo.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.TarInfo.__ge__", "Return self>=value."), - ("builtins.TarInfo.__getattribute__", "Return getattr(self, name)."), - ("builtins.TarInfo.__getstate__", "Helper for pickle."), - ("builtins.TarInfo.__gt__", "Return self>value."), - ("builtins.TarInfo.__hash__", "Return hash(self)."), - ("builtins.TarInfo.__init__", "Construct a TarInfo object. name is the optional name\nof the member."), - ("builtins.TarInfo.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.TarInfo.__le__", "Return self<=value."), - ("builtins.TarInfo.__lt__", "Return self 1024."), - ("builtins.TarInfo._create_gnu_long_header", "Return a GNUTYPE_LONGNAME or GNUTYPE_LONGLINK sequence\nfor name."), - ("builtins.TarInfo._create_header", "Return a header block. info is a dictionary with file\ninformation, format must be one of the *_FORMAT constants."), - ("builtins.TarInfo._create_pax_generic_header", "Return a POSIX.1-2008 extended or global header sequence\nthat contains a list of keyword, value pairs. The values\nmust be strings."), - ("builtins.TarInfo._create_payload", "Return the string payload filled with zero bytes\nup to the next 512 byte border."), - ("builtins.TarInfo._decode_pax_field", "Decode a single field from a pax record."), ("builtins.TarInfo._frombuf", "Construct a TarInfo object from a 512 byte bytes object.\n\nIf ``dircheck`` is set to ``True`` then ``AREGTYPE`` headers will\nbe normalized to ``DIRTYPE`` if the name ends in a trailing slash.\n``dircheck`` must be set to ``False`` if this function is called\non a follow-up header such as ``GNUTYPE_LONGNAME``."), ("builtins.TarInfo._fromtarfile", "See dircheck documentation in _frombuf()."), - ("builtins.TarInfo._posix_split_name", "Split a name longer than 100 chars into a prefix\nand a name part."), - ("builtins.TarInfo._proc_builtin", "Process a builtin type or an unknown type which\nwill be treated as a regular file."), - ("builtins.TarInfo._proc_gnulong", "Process the blocks that hold a GNU longname\nor longlink member."), - ("builtins.TarInfo._proc_gnusparse_00", "Process a GNU tar extended sparse header, version 0.0."), - ("builtins.TarInfo._proc_gnusparse_01", "Process a GNU tar extended sparse header, version 0.1."), - ("builtins.TarInfo._proc_gnusparse_10", "Process a GNU tar extended sparse header, version 1.0."), - ("builtins.TarInfo._proc_member", "Choose the right processing method depending on\nthe type and call it."), - ("builtins.TarInfo._proc_pax", "Process an extended or global header as described in\nPOSIX.1-2008."), - ("builtins.TarInfo._proc_sparse", "Process a GNU sparse header plus extra headers."), - ("builtins.TarInfo.create_gnu_header", "Return the object as a GNU header block sequence."), - ("builtins.TarInfo.create_pax_global_header", "Return the object as a pax global header block sequence."), - ("builtins.TarInfo.create_pax_header", "Return the object as a ustar header block. If it cannot be\nrepresented this way, prepend a pax extended header sequence\nwith supplement information."), - ("builtins.TarInfo.create_ustar_header", "Return the object as a ustar header block."), - ("builtins.TarInfo.frombuf", "Construct a TarInfo object from a 512 byte bytes object.\n\nTo support the old v7 tar format AREGTYPE headers are\ntransformed to DIRTYPE headers if their name ends in '/'."), - ("builtins.TarInfo.fromtarfile", "Return the next TarInfo object from TarFile object\ntarfile."), - ("builtins.TarInfo.get_info", "Return the TarInfo's attributes as a dictionary."), - ("builtins.TarInfo.isblk", "Return True if it is a block device."), - ("builtins.TarInfo.ischr", "Return True if it is a character device."), - ("builtins.TarInfo.isdev", "Return True if it is one of character device, block device or FIFO."), - ("builtins.TarInfo.isdir", "Return True if it is a directory."), - ("builtins.TarInfo.isfifo", "Return True if it is a FIFO."), - ("builtins.TarInfo.isfile", "Return True if the Tarinfo object is a regular file."), - ("builtins.TarInfo.islnk", "Return True if it is a hard link."), - ("builtins.TarInfo.isreg", "Return True if the Tarinfo object is a regular file."), - ("builtins.TarInfo.issym", "Return True if it is a symbolic link."), - ("builtins.TarInfo.linkpath", "In pax headers, \"linkname\" is called \"linkpath\"."), - ("builtins.TarInfo.path", "In pax headers, \"name\" is called \"path\"."), - ("builtins.TarInfo.replace", "Return a deep copy of self with the given attributes replaced."), - ("builtins.TarInfo.tobuf", "Return a tar header as a string of 512 byte blocks."), - ("builtins.TaskGroup", "Asynchronous context manager for managing groups of tasks.\n\nExample use:\n\n async with asyncio.TaskGroup() as group:\n task1 = group.create_task(some_coroutine(...))\n task2 = group.create_task(other_coroutine(...))\n print(\"Both tasks have completed now.\")\n\nAll tasks are awaited when the context manager exits.\n\nAny exceptions other than `asyncio.CancelledError` raised within\na task will cancel all remaining tasks and wait for them to exit.\nThe exceptions are then combined and raised as an `ExceptionGroup`."), - ("builtins.TaskGroup.__delattr__", "Implement delattr(self, name)."), - ("builtins.TaskGroup.__eq__", "Return self==value."), - ("builtins.TaskGroup.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.TaskGroup.__ge__", "Return self>=value."), - ("builtins.TaskGroup.__getattribute__", "Return getattr(self, name)."), - ("builtins.TaskGroup.__getstate__", "Helper for pickle."), - ("builtins.TaskGroup.__gt__", "Return self>value."), - ("builtins.TaskGroup.__hash__", "Return hash(self)."), - ("builtins.TaskGroup.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.TaskGroup.__le__", "Return self<=value."), - ("builtins.TaskGroup.__lt__", "Return self=value."), - ("builtins.TemporaryDirectory.__getattribute__", "Return getattr(self, name)."), - ("builtins.TemporaryDirectory.__getstate__", "Helper for pickle."), - ("builtins.TemporaryDirectory.__gt__", "Return self>value."), - ("builtins.TemporaryDirectory.__hash__", "Return hash(self)."), - ("builtins.TemporaryDirectory.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.TemporaryDirectory.__le__", "Return self<=value."), - ("builtins.TemporaryDirectory.__lt__", "Return self=value."), - ("builtins.TestCase.__getattribute__", "Return getattr(self, name)."), - ("builtins.TestCase.__getstate__", "Helper for pickle."), - ("builtins.TestCase.__gt__", "Return self>value."), - ("builtins.TestCase.__init__", "Create an instance of the class that will use the named test\nmethod when executed. Raises a ValueError if the instance does\nnot have a method with the specified name."), - ("builtins.TestCase.__le__", "Return self<=value."), - ("builtins.TestCase.__lt__", "Return self b), but with a nicer default message."), - ("builtins.TestCase.assertGreaterEqual", "Just like self.assertTrue(a >= b), but with a nicer default message."), - ("builtins.TestCase.assertIn", "Just like self.assertTrue(a in b), but with a nicer default message."), - ("builtins.TestCase.assertIs", "Just like self.assertTrue(a is b), but with a nicer default message."), - ("builtins.TestCase.assertIsInstance", "Same as self.assertTrue(isinstance(obj, cls)), with a nicer\ndefault message."), - ("builtins.TestCase.assertIsNone", "Same as self.assertTrue(obj is None), with a nicer default message."), - ("builtins.TestCase.assertIsNot", "Just like self.assertTrue(a is not b), but with a nicer default message."), - ("builtins.TestCase.assertIsNotNone", "Included for symmetry with assertIsNone."), - ("builtins.TestCase.assertLess", "Just like self.assertTrue(a < b), but with a nicer default message."), - ("builtins.TestCase.assertLessEqual", "Just like self.assertTrue(a <= b), but with a nicer default message."), - ("builtins.TestCase.assertListEqual", "A list-specific equality assertion.\n\nArgs:\n list1: The first list to compare.\n list2: The second list to compare.\n msg: Optional message to use on failure instead of a list of\n differences."), - ("builtins.TestCase.assertLogs", "Fail unless a log message of level *level* or higher is emitted\non *logger_name* or its children. If omitted, *level* defaults to\nINFO and *logger* defaults to the root logger.\n\nThis method must be used as a context manager, and will yield\na recording object with two attributes: `output` and `records`.\nAt the end of the context manager, the `output` attribute will\nbe a list of the matching formatted log messages and the\n`records` attribute will be a list of the corresponding LogRecord\nobjects.\n\nExample::\n\n with self.assertLogs('foo', level='INFO') as cm:\n logging.getLogger('foo').info('first message')\n logging.getLogger('foo.bar').error('second message')\n self.assertEqual(cm.output, ['INFO:foo:first message',\n 'ERROR:foo.bar:second message'])"), - ("builtins.TestCase.assertMultiLineEqual", "Assert that two multi-line strings are equal."), - ("builtins.TestCase.assertNoLogs", "Fail unless no log messages of level *level* or higher are emitted\non *logger_name* or its children.\n\nThis method must be used as a context manager."), - ("builtins.TestCase.assertNotAlmostEqual", "Fail if the two objects are equal as determined by their\ndifference rounded to the given number of decimal places\n(default 7) and comparing to zero, or by comparing that the\ndifference between the two objects is less than the given delta.\n\nNote that decimal places (from zero) are usually not the same\nas significant digits (measured from the most significant digit).\n\nObjects that are equal automatically fail."), - ("builtins.TestCase.assertNotEqual", "Fail if the two objects are equal as determined by the '!='\noperator."), - ("builtins.TestCase.assertNotIn", "Just like self.assertTrue(a not in b), but with a nicer default message."), - ("builtins.TestCase.assertNotIsInstance", "Included for symmetry with assertIsInstance."), - ("builtins.TestCase.assertNotRegex", "Fail the test if the text matches the regular expression."), - ("builtins.TestCase.assertRaises", "Fail unless an exception of class expected_exception is raised\nby the callable when invoked with specified positional and\nkeyword arguments. If a different type of exception is\nraised, it will not be caught, and the test case will be\ndeemed to have suffered an error, exactly as for an\nunexpected exception.\n\nIf called with the callable and arguments omitted, will return a\ncontext object used like this::\n\n with self.assertRaises(SomeException):\n do_something()\n\nAn optional keyword argument 'msg' can be provided when assertRaises\nis used as a context object.\n\nThe context manager keeps a reference to the exception as\nthe 'exception' attribute. This allows you to inspect the\nexception after the assertion::\n\n with self.assertRaises(SomeException) as cm:\n do_something()\n the_exception = cm.exception\n self.assertEqual(the_exception.error_code, 3)"), - ("builtins.TestCase.assertRaisesRegex", "Asserts that the message in a raised exception matches a regex.\n\nArgs:\n expected_exception: Exception class expected to be raised.\n expected_regex: Regex (re.Pattern object or string) expected\n to be found in error message.\n args: Function to be called and extra positional args.\n kwargs: Extra kwargs.\n msg: Optional message used in case of failure. Can only be used\n when assertRaisesRegex is used as a context manager."), - ("builtins.TestCase.assertRegex", "Fail the test unless the text matches the regular expression."), - ("builtins.TestCase.assertSequenceEqual", "An equality assertion for ordered sequences (like lists and tuples).\n\nFor the purposes of this function, a valid ordered sequence type is one\nwhich can be indexed, has a length, and has an equality operator.\n\nArgs:\n seq1: The first sequence to compare.\n seq2: The second sequence to compare.\n seq_type: The expected datatype of the sequences, or None if no\n datatype should be enforced.\n msg: Optional message to use on failure instead of a list of\n differences."), - ("builtins.TestCase.assertSetEqual", "A set-specific equality assertion.\n\nArgs:\n set1: The first set to compare.\n set2: The second set to compare.\n msg: Optional message to use on failure instead of a list of\n differences.\n\nassertSetEqual uses ducktyping to support different types of sets, and\nis optimized for sets specifically (parameters must support a\ndifference method)."), - ("builtins.TestCase.assertTrue", "Check that the expression is true."), - ("builtins.TestCase.assertTupleEqual", "A tuple-specific equality assertion.\n\nArgs:\n tuple1: The first tuple to compare.\n tuple2: The second tuple to compare.\n msg: Optional message to use on failure instead of a list of\n differences."), - ("builtins.TestCase.assertWarns", "Fail unless a warning of class warnClass is triggered\nby the callable when invoked with specified positional and\nkeyword arguments. If a different type of warning is\ntriggered, it will not be handled: depending on the other\nwarning filtering rules in effect, it might be silenced, printed\nout, or raised as an exception.\n\nIf called with the callable and arguments omitted, will return a\ncontext object used like this::\n\n with self.assertWarns(SomeWarning):\n do_something()\n\nAn optional keyword argument 'msg' can be provided when assertWarns\nis used as a context object.\n\nThe context manager keeps a reference to the first matching\nwarning as the 'warning' attribute; similarly, the 'filename'\nand 'lineno' attributes give you information about the line\nof Python code from which the warning was triggered.\nThis allows you to inspect the warning after the assertion::\n\n with self.assertWarns(SomeWarning) as cm:\n do_something()\n the_warning = cm.warning\n self.assertEqual(the_warning.some_attribute, 147)"), - ("builtins.TestCase.assertWarnsRegex", "Asserts that the message in a triggered warning matches a regexp.\nBasic functioning is similar to assertWarns() with the addition\nthat only warnings whose messages also match the regular expression\nare considered successful matches.\n\nArgs:\n expected_warning: Warning class expected to be triggered.\n expected_regex: Regex (re.Pattern object or string) expected\n to be found in error message.\n args: Function to be called and extra positional args.\n kwargs: Extra kwargs.\n msg: Optional message used in case of failure. Can only be used\n when assertWarnsRegex is used as a context manager."), - ("builtins.TestCase.debug", "Run the test without collecting errors in a TestResult"), - ("builtins.TestCase.doClassCleanups", "Execute all class cleanup functions. Normally called for you after\ntearDownClass."), - ("builtins.TestCase.doCleanups", "Execute all cleanup functions. Normally called for you after\ntearDown."), - ("builtins.TestCase.enterClassContext", "Same as enterContext, but class-wide."), - ("builtins.TestCase.enterContext", "Enters the supplied context manager.\n\nIf successful, also adds its __exit__ method as a cleanup\nfunction and returns the result of the __enter__ method."), - ("builtins.TestCase.fail", "Fail immediately, with the given message."), - ("builtins.TestCase.failureException", "Assertion failed."), - ("builtins.TestCase.failureException.__delattr__", "Implement delattr(self, name)."), - ("builtins.TestCase.failureException.__eq__", "Return self==value."), - ("builtins.TestCase.failureException.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.TestCase.failureException.__ge__", "Return self>=value."), - ("builtins.TestCase.failureException.__getattribute__", "Return getattr(self, name)."), - ("builtins.TestCase.failureException.__getstate__", "Helper for pickle."), - ("builtins.TestCase.failureException.__gt__", "Return self>value."), - ("builtins.TestCase.failureException.__hash__", "Return hash(self)."), - ("builtins.TestCase.failureException.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.TestCase.failureException.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.TestCase.failureException.__le__", "Return self<=value."), - ("builtins.TestCase.failureException.__lt__", "Return self=value."), - ("builtins.TestLoader.__getattribute__", "Return getattr(self, name)."), - ("builtins.TestLoader.__getstate__", "Helper for pickle."), - ("builtins.TestLoader.__gt__", "Return self>value."), - ("builtins.TestLoader.__hash__", "Return hash(self)."), - ("builtins.TestLoader.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.TestLoader.__le__", "Return self<=value."), - ("builtins.TestLoader.__lt__", "Return self y"), - ("builtins.TestLoader.suiteClass", "A test suite is a composite test consisting of a number of TestCases.\n\nFor use, create an instance of TestSuite, then add test case instances.\nWhen all tests have been added, the suite can be passed to a test\nrunner, such as TextTestRunner. It will run the individual test cases\nin the order in which they were added, aggregating the results. When\nsubclassing, do not forget to call the base class constructor."), - ("builtins.TestLoader.suiteClass.__delattr__", "Implement delattr(self, name)."), - ("builtins.TestLoader.suiteClass.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.TestLoader.suiteClass.__ge__", "Return self>=value."), - ("builtins.TestLoader.suiteClass.__getattribute__", "Return getattr(self, name)."), - ("builtins.TestLoader.suiteClass.__getstate__", "Helper for pickle."), - ("builtins.TestLoader.suiteClass.__gt__", "Return self>value."), - ("builtins.TestLoader.suiteClass.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.TestLoader.suiteClass.__le__", "Return self<=value."), - ("builtins.TestLoader.suiteClass.__lt__", "Return self=value."), - ("builtins.TestProgram.__getattribute__", "Return getattr(self, name)."), - ("builtins.TestProgram.__getstate__", "Helper for pickle."), - ("builtins.TestProgram.__gt__", "Return self>value."), - ("builtins.TestProgram.__hash__", "Return hash(self)."), - ("builtins.TestProgram.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.TestProgram.__le__", "Return self<=value."), - ("builtins.TestProgram.__lt__", "Return self=value."), - ("builtins.TestResult.__getattribute__", "Return getattr(self, name)."), - ("builtins.TestResult.__getstate__", "Helper for pickle."), - ("builtins.TestResult.__gt__", "Return self>value."), - ("builtins.TestResult.__hash__", "Return hash(self)."), - ("builtins.TestResult.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.TestResult.__le__", "Return self<=value."), - ("builtins.TestResult.__lt__", "Return self=value."), - ("builtins.TextTestRunner.__getattribute__", "Return getattr(self, name)."), - ("builtins.TextTestRunner.__getstate__", "Helper for pickle."), - ("builtins.TextTestRunner.__gt__", "Return self>value."), - ("builtins.TextTestRunner.__hash__", "Return hash(self)."), - ("builtins.TextTestRunner.__init__", "Construct a TextTestRunner.\n\nSubclasses should accept **kwargs to ensure compatibility as the\ninterface changes."), - ("builtins.TextTestRunner.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.TextTestRunner.__le__", "Return self<=value."), - ("builtins.TextTestRunner.__lt__", "Return self=value."), - ("builtins.TextTestRunner.resultclass.__getattribute__", "Return getattr(self, name)."), - ("builtins.TextTestRunner.resultclass.__getstate__", "Helper for pickle."), - ("builtins.TextTestRunner.resultclass.__gt__", "Return self>value."), - ("builtins.TextTestRunner.resultclass.__hash__", "Return hash(self)."), - ("builtins.TextTestRunner.resultclass.__init__", "Construct a TextTestResult. Subclasses should accept **kwargs\nto ensure compatibility as the interface changes."), - ("builtins.TextTestRunner.resultclass.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.TextTestRunner.resultclass.__le__", "Return self<=value."), - ("builtins.TextTestRunner.resultclass.__lt__", "Return self=value."), - ("builtins.TextWrapper.__getattribute__", "Return getattr(self, name)."), - ("builtins.TextWrapper.__getstate__", "Helper for pickle."), - ("builtins.TextWrapper.__gt__", "Return self>value."), - ("builtins.TextWrapper.__hash__", "Return hash(self)."), - ("builtins.TextWrapper.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.TextWrapper.__le__", "Return self<=value."), - ("builtins.TextWrapper.__lt__", "Return self string\n\nMunge whitespace in text: expand tabs and convert all other\nwhitespace characters to spaces. Eg. \" foo\\tbar\\n\\nbaz\"\nbecomes \" foo bar baz\"."), - ("builtins.TextWrapper._split", "_split(text : string) -> [string]\n\nSplit the text to wrap into indivisible chunks. Chunks are\nnot quite the same as words; see _wrap_chunks() for full\ndetails. As an example, the text\n Look, goof-ball -- use the -b option!\nbreaks into the following chunks:\n 'Look,', ' ', 'goof-', 'ball', ' ', '--', ' ',\n 'use', ' ', 'the', ' ', '-b', ' ', 'option!'\nif break_on_hyphens is True, or in:\n 'Look,', ' ', 'goof-ball', ' ', '--', ' ',\n 'use', ' ', 'the', ' ', '-b', ' ', option!'\notherwise."), - ("builtins.TextWrapper._wrap_chunks", "_wrap_chunks(chunks : [string]) -> [string]\n\nWrap a sequence of text chunks and return a list of lines of\nlength 'self.width' or less. (If 'break_long_words' is false,\nsome lines may be longer than this.) Chunks correspond roughly\nto words and the whitespace between them: each chunk is\nindivisible (modulo 'break_long_words'), but a line break can\ncome between any two chunks. Chunks should not have internal\nwhitespace; ie. a chunk is either all whitespace or a \"word\".\nWhitespace chunks will be removed from the beginning and end of\nlines, but apart from that whitespace is preserved."), - ("builtins.TextWrapper.fill", "fill(text : string) -> string\n\nReformat the single paragraph in 'text' to fit in lines of no\nmore than 'self.width' columns, and return a new string\ncontaining the entire wrapped paragraph."), - ("builtins.TextWrapper.wrap", "wrap(text : string) -> [string]\n\nReformat the single paragraph in 'text' so it fits in lines of\nno more than 'self.width' columns, and return a list of wrapped\nlines. Tabs in 'text' are expanded with string.expandtabs(),\nand all other whitespace characters (including newline) are\nconverted to space."), - ("builtins.Theme", "A suite of themes for all sections of Python.\n\nWhen adding a new one, remember to also modify `copy_with` and `no_colors`\nbelow."), - ("builtins.Theme.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.Theme.__ge__", "Return self>=value."), - ("builtins.Theme.__getattribute__", "Return getattr(self, name)."), - ("builtins.Theme.__getstate__", "Helper for pickle."), - ("builtins.Theme.__gt__", "Return self>value."), - ("builtins.Theme.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Theme.__le__", "Return self<=value."), - ("builtins.Theme.__lt__", "Return self=value."), - ("builtins.Thread.__getattribute__", "Return getattr(self, name)."), - ("builtins.Thread.__getstate__", "Helper for pickle."), - ("builtins.Thread.__gt__", "Return self>value."), - ("builtins.Thread.__hash__", "Return hash(self)."), - ("builtins.Thread.__init__", "This constructor should always be called with keyword arguments. Arguments are:\n\n*group* should be None; reserved for future extension when a ThreadGroup\nclass is implemented.\n\n*target* is the callable object to be invoked by the run()\nmethod. Defaults to None, meaning nothing is called.\n\n*name* is the thread name. By default, a unique name is constructed of\nthe form \"Thread-N\" where N is a small decimal number.\n\n*args* is a list or tuple of arguments for the target invocation. Defaults to ().\n\n*kwargs* is a dictionary of keyword arguments for the target\ninvocation. Defaults to {}.\n\n*context* is the contextvars.Context value to use for the thread.\nThe default value is None, which means to check\nsys.flags.thread_inherit_context. If that flag is true, use a copy\nof the context of the caller. If false, use an empty context. To\nexplicitly start with an empty context, pass a new instance of\ncontextvars.Context(). To explicitly start with a copy of the current\ncontext, pass the value from contextvars.copy_context().\n\nIf a subclass overrides the constructor, it must make sure to invoke\nthe base class constructor (Thread.__init__()) before doing anything\nelse to the thread."), - ("builtins.Thread.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Thread.__le__", "Return self<=value."), - ("builtins.Thread.__lt__", "Return self=value."), - ("builtins.ThreadingMixIn.__getattribute__", "Return getattr(self, name)."), - ("builtins.ThreadingMixIn.__getstate__", "Helper for pickle."), - ("builtins.ThreadingMixIn.__gt__", "Return self>value."), - ("builtins.ThreadingMixIn.__hash__", "Return hash(self)."), - ("builtins.ThreadingMixIn.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.ThreadingMixIn.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.ThreadingMixIn.__le__", "Return self<=value."), - ("builtins.ThreadingMixIn.__lt__", "Return self=value."), - ("builtins.Timeout.__getattribute__", "Return getattr(self, name)."), - ("builtins.Timeout.__getstate__", "Helper for pickle."), - ("builtins.Timeout.__gt__", "Return self>value."), - ("builtins.Timeout.__hash__", "Return hash(self)."), - ("builtins.Timeout.__init__", "Schedule a timeout that will trigger at a given loop time.\n\n- If `when` is `None`, the timeout will never trigger.\n- If `when < loop.time()`, the timeout will trigger on the next\n iteration of the event loop."), - ("builtins.Timeout.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Timeout.__le__", "Return self<=value."), - ("builtins.Timeout.__lt__", "Return self=value."), - ("builtins.Timer.__getattribute__", "Return getattr(self, name)."), - ("builtins.Timer.__getstate__", "Helper for pickle."), - ("builtins.Timer.__gt__", "Return self>value."), - ("builtins.Timer.__hash__", "Return hash(self)."), - ("builtins.Timer.__init__", "Constructor. See class doc string."), - ("builtins.Timer.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Timer.__le__", "Return self<=value."), - ("builtins.Timer.__lt__", "Return self= 0.2.\n\nCalls the timeit method with increasing numbers from the sequence\n1, 2, 5, 10, 20, 50, ... until the time taken is at least 0.2\nsecond. Returns (number, time_taken).\n\nIf *callback* is given and is not None, it will be called after\neach trial with two arguments: ``callback(number, time_taken)``."), - ("builtins.Timer.print_exc", "Helper to print a traceback from the timed code.\n\nTypical use:\n\n t = Timer(...) # outside the try/except\n try:\n t.timeit(...) # or t.repeat(...)\n except:\n t.print_exc()\n\nThe advantage over the standard traceback is that source lines\nin the compiled template will be displayed.\n\nThe optional file argument directs where the traceback is\nsent; it defaults to sys.stderr."), - ("builtins.Timer.repeat", "Call timeit() a few times.\n\nThis is a convenience function that calls the timeit()\nrepeatedly, returning a list of results. The first argument\nspecifies how many times to call timeit(), defaulting to 5;\nthe second argument specifies the timer argument, defaulting\nto one million.\n\nNote: it's tempting to calculate mean and standard deviation\nfrom the result vector and report these. However, this is not\nvery useful. In a typical case, the lowest value gives a\nlower bound for how fast your machine can run the given code\nsnippet; higher values in the result vector are typically not\ncaused by variability in Python's speed, but by other\nprocesses interfering with your timing accuracy. So the min()\nof the result is probably the only number you should be\ninterested in. After that, you should look at the entire\nvector and apply common sense rather than statistics."), - ("builtins.Timer.timeit", "Time 'number' executions of the main statement.\n\nTo be precise, this executes the setup statement once, and\nthen returns the time it takes to execute the main statement\na number of times, as float seconds if using the default timer. The\nargument is the number of times through the loop, defaulting\nto one million. The main statement, the setup statement and\nthe timer function to be used are passed to the constructor."), ("builtins.Token.__class_getitem__", "Tokens are generic over the same type as the ContextVar which created them."), ("builtins.Token.__delattr__", "Implement delattr(self, name)."), ("builtins.Token.__enter__", "Enter into Token context manager."), @@ -19821,27 +14411,6 @@ pub const DB: &[(&str, &str)] = &[ ("builtins.Token.__sizeof__", "Size of object in memory, in bytes."), ("builtins.Token.__str__", "Return str(self)."), ("builtins.Token.__subclasshook__", "Abstract classes can override this to customize issubclass().\n\nThis is invoked early on by abc.ABCMeta.__subclasscheck__().\nIt should return True, False or NotImplemented. If it returns\nNotImplemented, the normal algorithm is used. Otherwise, it\noverrides the normal algorithm (and the outcome is cached)."), - ("builtins.Tokenizer.__delattr__", "Implement delattr(self, name)."), - ("builtins.Tokenizer.__eq__", "Return self==value."), - ("builtins.Tokenizer.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.Tokenizer.__ge__", "Return self>=value."), - ("builtins.Tokenizer.__getattribute__", "Return getattr(self, name)."), - ("builtins.Tokenizer.__getstate__", "Helper for pickle."), - ("builtins.Tokenizer.__gt__", "Return self>value."), - ("builtins.Tokenizer.__hash__", "Return hash(self)."), - ("builtins.Tokenizer.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Tokenizer.__le__", "Return self<=value."), - ("builtins.Tokenizer.__lt__", "Return self=value."), - ("builtins.TopologicalSorter.__getattribute__", "Return getattr(self, name)."), - ("builtins.TopologicalSorter.__getstate__", "Helper for pickle."), - ("builtins.TopologicalSorter.__gt__", "Return self>value."), - ("builtins.TopologicalSorter.__hash__", "Return hash(self)."), - ("builtins.TopologicalSorter.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.TopologicalSorter.__le__", "Return self<=value."), - ("builtins.TopologicalSorter.__lt__", "Return self=value."), - ("builtins.Trace.__getattribute__", "Return getattr(self, name)."), - ("builtins.Trace.__getstate__", "Helper for pickle."), - ("builtins.Trace.__gt__", "Return self>value."), - ("builtins.Trace.__hash__", "Return hash(self)."), - ("builtins.Trace.__init__", "@param count true iff it should count number of times each\n line is executed\n@param trace true iff it should print out each line that is\n being counted\n@param countfuncs true iff it should just output a list of\n (filename, modulename, funcname,) for functions\n that were called at least once; This overrides\n 'count' and 'trace'\n@param ignoremods a list of the names of modules to ignore\n@param ignoredirs a list of the names of directories to ignore\n all of the (recursive) contents of\n@param infile file from which to read stored counts to be\n added into the results\n@param outfile file in which to write the results\n@param timing true iff timing information be displayed"), - ("builtins.Trace.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Trace.__le__", "Return self<=value."), - ("builtins.Trace.__lt__", "Return self=value."), - ("builtins.TracebackException.__getattribute__", "Return getattr(self, name)."), - ("builtins.TracebackException.__getstate__", "Helper for pickle."), - ("builtins.TracebackException.__gt__", "Return self>value."), - ("builtins.TracebackException.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.TracebackException.__le__", "Return self<=value."), - ("builtins.TracebackException.__lt__", "Return self>> Translator('xyz')\nTraceback (most recent call last):\n...\nAssertionError: Invalid separators\n\n>>> Translator('')\nTraceback (most recent call last):\n...\nAssertionError: Invalid separators"), - ("builtins.Translator.__delattr__", "Implement delattr(self, name)."), - ("builtins.Translator.__eq__", "Return self==value."), - ("builtins.Translator.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.Translator.__ge__", "Return self>=value."), - ("builtins.Translator.__getattribute__", "Return getattr(self, name)."), - ("builtins.Translator.__getstate__", "Helper for pickle."), - ("builtins.Translator.__gt__", "Return self>value."), - ("builtins.Translator.__hash__", "Return hash(self)."), - ("builtins.Translator.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Translator.__le__", "Return self<=value."), - ("builtins.Translator.__lt__", "Return self>> Translator().translate('**foo')\nTraceback (most recent call last):\n...\nValueError: ** must appear alone in a path segment"), - ("builtins.Translator.star_not_empty", "Ensure that * will not match an empty segment."), - ("builtins.Translator.translate", "Given a glob pattern, produce a regex that matches it."), - ("builtins.Translator.translate_core", "Given a glob pattern, produce a regex that matches it.\n\n>>> t = Translator()\n>>> t.translate_core('*.txt').replace('\\\\\\\\', '')\n'[^/]*\\\\.txt'\n>>> t.translate_core('a?txt')\n'a[^/]txt'\n>>> t.translate_core('**/*').replace('\\\\\\\\', '')\n'.*/[^/][^/]*'"), - ("builtins.TransportSocket", "A socket-like wrapper for exposing real transport sockets.\n\nThese objects can be safely returned by APIs like\n`transport.get_extra_info('socket')`. All potentially disruptive\noperations (like \"socket.close()\") are banned."), - ("builtins.TransportSocket.__delattr__", "Implement delattr(self, name)."), - ("builtins.TransportSocket.__eq__", "Return self==value."), - ("builtins.TransportSocket.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.TransportSocket.__ge__", "Return self>=value."), - ("builtins.TransportSocket.__getattribute__", "Return getattr(self, name)."), - ("builtins.TransportSocket.__gt__", "Return self>value."), - ("builtins.TransportSocket.__hash__", "Return hash(self)."), - ("builtins.TransportSocket.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.TransportSocket.__le__", "Return self<=value."), - ("builtins.TransportSocket.__lt__", "Return self=value."), - ("builtins.TupleComp.__getattribute__", "Return getattr(self, name)."), - ("builtins.TupleComp.__getstate__", "Helper for pickle."), - ("builtins.TupleComp.__gt__", "Return self>value."), - ("builtins.TupleComp.__hash__", "Return hash(self)."), - ("builtins.TupleComp.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.TupleComp.__le__", "Return self<=value."), - ("builtins.TupleComp.__lt__", "Return self=value."), - ("builtins.TypedDict.__getattribute__", "Return getattr(self, name)."), - ("builtins.TypedDict.__getstate__", "Helper for pickle."), - ("builtins.TypedDict.__gt__", "Return self>value."), - ("builtins.TypedDict.__hash__", "Return hash(self)."), - ("builtins.TypedDict.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.TypedDict.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.TypedDict.__le__", "Return self<=value."), - ("builtins.TypedDict.__lt__", "Return self=value."), - ("builtins.UID.__getattribute__", "Return getattr(self, name)."), - ("builtins.UID.__getstate__", "Helper for pickle."), - ("builtins.UID.__gt__", "Return self>value."), - ("builtins.UID.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.UID.__le__", "Return self<=value."), - ("builtins.UID.__lt__", "Return self=value."), - ("builtins.Untokenizer.__getattribute__", "Return getattr(self, name)."), - ("builtins.Untokenizer.__getstate__", "Helper for pickle."), - ("builtins.Untokenizer.__gt__", "Return self>value."), - ("builtins.Untokenizer.__hash__", "Return hash(self)."), - ("builtins.Untokenizer.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Untokenizer.__le__", "Return self<=value."), - ("builtins.Untokenizer.__lt__", "Return self=value."), - ("builtins.Values.__getattribute__", "Return getattr(self, name)."), - ("builtins.Values.__getstate__", "Helper for pickle."), - ("builtins.Values.__gt__", "Return self>value."), - ("builtins.Values.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Values.__le__", "Return self<=value."), - ("builtins.Values.__lt__", "Return self=value."), - ("builtins.WarningMessage.__getattribute__", "Return getattr(self, name)."), - ("builtins.WarningMessage.__getstate__", "Helper for pickle."), - ("builtins.WarningMessage.__gt__", "Return self>value."), - ("builtins.WarningMessage.__hash__", "Return hash(self)."), - ("builtins.WarningMessage.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.WarningMessage.__le__", "Return self<=value."), - ("builtins.WarningMessage.__lt__", "Return self=value."), - ("builtins.Wave_read.__getattribute__", "Return getattr(self, name)."), - ("builtins.Wave_read.__getstate__", "Helper for pickle."), - ("builtins.Wave_read.__gt__", "Return self>value."), - ("builtins.Wave_read.__hash__", "Return hash(self)."), - ("builtins.Wave_read.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Wave_read.__le__", "Return self<=value."), - ("builtins.Wave_read.__lt__", "Return self=value."), - ("builtins.Wave_write.__getattribute__", "Return getattr(self, name)."), - ("builtins.Wave_write.__getstate__", "Helper for pickle."), - ("builtins.Wave_write.__gt__", "Return self>value."), - ("builtins.Wave_write.__hash__", "Return hash(self)."), - ("builtins.Wave_write.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Wave_write.__le__", "Return self<=value."), - ("builtins.Wave_write.__lt__", "Return self=value."), - ("builtins.Whitespace.__getattribute__", "Return getattr(self, name)."), - ("builtins.Whitespace.__getstate__", "Helper for pickle."), - ("builtins.Whitespace.__gt__", "Return self>value."), - ("builtins.Whitespace.__hash__", "Return hash(self)."), - ("builtins.Whitespace.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Whitespace.__le__", "Return self<=value."), - ("builtins.Whitespace.__lt__", "Return self=value."), - ("builtins.WindowsRegistryFinder.__getattribute__", "Return getattr(self, name)."), - ("builtins.WindowsRegistryFinder.__getstate__", "Helper for pickle."), - ("builtins.WindowsRegistryFinder.__gt__", "Return self>value."), - ("builtins.WindowsRegistryFinder.__hash__", "Return hash(self)."), - ("builtins.WindowsRegistryFinder.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.WindowsRegistryFinder.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.WindowsRegistryFinder.__le__", "Return self<=value."), - ("builtins.WindowsRegistryFinder.__lt__", "Return self=value."), - ("builtins.Writer.__getattribute__", "Return getattr(self, name)."), - ("builtins.Writer.__getstate__", "Helper for pickle."), - ("builtins.Writer.__gt__", "Return self>value."), - ("builtins.Writer.__hash__", "Return hash(self)."), - ("builtins.Writer.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.Writer.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.Writer.__le__", "Return self<=value."), - ("builtins.Writer.__lt__", "Return self=value."), - ("builtins.ZipFile.__getattribute__", "Return getattr(self, name)."), - ("builtins.ZipFile.__getstate__", "Helper for pickle."), - ("builtins.ZipFile.__gt__", "Return self>value."), - ("builtins.ZipFile.__hash__", "Return hash(self)."), - ("builtins.ZipFile.__init__", "Open the ZIP file with mode read 'r', write 'w', exclusive create\n'x', or append 'a'."), - ("builtins.ZipFile.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.ZipFile.__le__", "Return self<=value."), - ("builtins.ZipFile.__lt__", "Return self=value."), - ("builtins.ZipInfo.__getattribute__", "Return getattr(self, name)."), - ("builtins.ZipInfo.__getstate__", "Helper for pickle."), - ("builtins.ZipInfo.__gt__", "Return self>value."), - ("builtins.ZipInfo.__hash__", "Return hash(self)."), - ("builtins.ZipInfo.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.ZipInfo.__le__", "Return self<=value."), - ("builtins.ZipInfo.__lt__", "Return self=value."), - ("builtins._AbstractEventLoopPolicy.__getattribute__", "Return getattr(self, name)."), - ("builtins._AbstractEventLoopPolicy.__getstate__", "Helper for pickle."), - ("builtins._AbstractEventLoopPolicy.__gt__", "Return self>value."), - ("builtins._AbstractEventLoopPolicy.__hash__", "Return hash(self)."), - ("builtins._AbstractEventLoopPolicy.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._AbstractEventLoopPolicy.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._AbstractEventLoopPolicy.__le__", "Return self<=value."), - ("builtins._AbstractEventLoopPolicy.__lt__", "Return self=value."), - ("builtins._AcquireFutures.__getattribute__", "Return getattr(self, name)."), - ("builtins._AcquireFutures.__getstate__", "Helper for pickle."), - ("builtins._AcquireFutures.__gt__", "Return self>value."), - ("builtins._AcquireFutures.__hash__", "Return hash(self)."), - ("builtins._AcquireFutures.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._AcquireFutures.__le__", "Return self<=value."), - ("builtins._AcquireFutures.__lt__", "Return self=value."), - ("builtins._ActionsContainer.__getattribute__", "Return getattr(self, name)."), - ("builtins._ActionsContainer.__getstate__", "Helper for pickle."), - ("builtins._ActionsContainer.__gt__", "Return self>value."), - ("builtins._ActionsContainer.__hash__", "Return hash(self)."), - ("builtins._ActionsContainer.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._ActionsContainer.__le__", "Return self<=value."), - ("builtins._ActionsContainer.__lt__", "Return self=value."), - ("builtins._AsCompletedIterator.__getattribute__", "Return getattr(self, name)."), - ("builtins._AsCompletedIterator.__getstate__", "Helper for pickle."), - ("builtins._AsCompletedIterator.__gt__", "Return self>value."), - ("builtins._AsCompletedIterator.__hash__", "Return hash(self)."), - ("builtins._AsCompletedIterator.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._AsCompletedIterator.__le__", "Return self<=value."), - ("builtins._AsCompletedIterator.__lt__", "Return self=value."), - ("builtins._AttributeHolder.__getattribute__", "Return getattr(self, name)."), - ("builtins._AttributeHolder.__getstate__", "Helper for pickle."), - ("builtins._AttributeHolder.__gt__", "Return self>value."), - ("builtins._AttributeHolder.__hash__", "Return hash(self)."), - ("builtins._AttributeHolder.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._AttributeHolder.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._AttributeHolder.__le__", "Return self<=value."), - ("builtins._AttributeHolder.__lt__", "Return self=value."), - ("builtins._Authenticator.__getattribute__", "Return getattr(self, name)."), - ("builtins._Authenticator.__getstate__", "Helper for pickle."), - ("builtins._Authenticator.__gt__", "Return self>value."), - ("builtins._Authenticator.__hash__", "Return hash(self)."), - ("builtins._Authenticator.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._Authenticator.__le__", "Return self<=value."), - ("builtins._Authenticator.__lt__", "Return self=value."), - ("builtins._BaseConstants.__getattribute__", "Return getattr(self, name)."), - ("builtins._BaseConstants.__getstate__", "Helper for pickle."), - ("builtins._BaseConstants.__gt__", "Return self>value."), - ("builtins._BaseConstants.__hash__", "Return hash(self)."), - ("builtins._BaseConstants.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._BaseConstants.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._BaseConstants.__le__", "Return self<=value."), - ("builtins._BaseConstants.__lt__", "Return self=value."), - ("builtins._BaseExitStack.__getattribute__", "Return getattr(self, name)."), - ("builtins._BaseExitStack.__getstate__", "Helper for pickle."), - ("builtins._BaseExitStack.__gt__", "Return self>value."), - ("builtins._BaseExitStack.__hash__", "Return hash(self)."), - ("builtins._BaseExitStack.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._BaseExitStack.__le__", "Return self<=value."), - ("builtins._BaseExitStack.__lt__", "Return self=value."), - ("builtins._BaseTestCaseContext.__getattribute__", "Return getattr(self, name)."), - ("builtins._BaseTestCaseContext.__getstate__", "Helper for pickle."), - ("builtins._BaseTestCaseContext.__gt__", "Return self>value."), - ("builtins._BaseTestCaseContext.__hash__", "Return hash(self)."), - ("builtins._BaseTestCaseContext.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._BaseTestCaseContext.__le__", "Return self<=value."), - ("builtins._BaseTestCaseContext.__lt__", "Return self=value."), - ("builtins._BaseV4.__getattribute__", "Return getattr(self, name)."), - ("builtins._BaseV4.__getstate__", "Helper for pickle."), - ("builtins._BaseV4.__gt__", "Return self>value."), - ("builtins._BaseV4.__hash__", "Return hash(self)."), - ("builtins._BaseV4.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._BaseV4.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._BaseV4.__le__", "Return self<=value."), - ("builtins._BaseV4.__lt__", "Return self=value."), - ("builtins._BaseV6.__getattribute__", "Return getattr(self, name)."), - ("builtins._BaseV6.__getstate__", "Helper for pickle."), - ("builtins._BaseV6.__gt__", "Return self>value."), - ("builtins._BaseV6.__hash__", "Return hash(self)."), - ("builtins._BaseV6.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._BaseV6.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._BaseV6.__le__", "Return self<=value."), - ("builtins._BaseV6.__lt__", "Return self=value."), - ("builtins._BinaryPlistParser.__getattribute__", "Return getattr(self, name)."), - ("builtins._BinaryPlistParser.__getstate__", "Helper for pickle."), - ("builtins._BinaryPlistParser.__gt__", "Return self>value."), - ("builtins._BinaryPlistParser.__hash__", "Return hash(self)."), - ("builtins._BinaryPlistParser.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._BinaryPlistParser.__le__", "Return self<=value."), - ("builtins._BinaryPlistParser.__lt__", "Return self=value."), - ("builtins._BinaryPlistWriter.__getattribute__", "Return getattr(self, name)."), - ("builtins._BinaryPlistWriter.__getstate__", "Helper for pickle."), - ("builtins._BinaryPlistWriter.__gt__", "Return self>value."), - ("builtins._BinaryPlistWriter.__hash__", "Return hash(self)."), - ("builtins._BinaryPlistWriter.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._BinaryPlistWriter.__le__", "Return self<=value."), - ("builtins._BinaryPlistWriter.__lt__", "Return self=value."), - ("builtins._BlockingOnManager.__getattribute__", "Return getattr(self, name)."), - ("builtins._BlockingOnManager.__getstate__", "Helper for pickle."), - ("builtins._BlockingOnManager.__gt__", "Return self>value."), - ("builtins._BlockingOnManager.__hash__", "Return hash(self)."), - ("builtins._BlockingOnManager.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._BlockingOnManager.__le__", "Return self<=value."), - ("builtins._BlockingOnManager.__lt__", "Return self=value."), - ("builtins._C.__getattribute__", "Return getattr(self, name)."), - ("builtins._C.__getstate__", "Helper for pickle."), - ("builtins._C.__gt__", "Return self>value."), - ("builtins._C.__hash__", "Return hash(self)."), - ("builtins._C.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._C.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._C.__le__", "Return self<=value."), - ("builtins._C.__lt__", "Return self=value."), - ("builtins._Chunk.__getattribute__", "Return getattr(self, name)."), - ("builtins._Chunk.__getstate__", "Helper for pickle."), - ("builtins._Chunk.__gt__", "Return self>value."), - ("builtins._Chunk.__hash__", "Return hash(self)."), - ("builtins._Chunk.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._Chunk.__le__", "Return self<=value."), - ("builtins._Chunk.__lt__", "Return self=value."), - ("builtins._CommentSpec.__getattribute__", "Return getattr(self, name)."), - ("builtins._CommentSpec.__getstate__", "Helper for pickle."), - ("builtins._CommentSpec.__gt__", "Return self>value."), - ("builtins._CommentSpec.__hash__", "Return hash(self)."), - ("builtins._CommentSpec.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._CommentSpec.__le__", "Return self<=value."), - ("builtins._CommentSpec.__lt__", "Return self=value."), - ("builtins._Context.__getattribute__", "Return getattr(self, name)."), - ("builtins._Context.__getstate__", "Helper for pickle."), - ("builtins._Context.__gt__", "Return self>value."), - ("builtins._Context.__hash__", "Return hash(self)."), - ("builtins._Context.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._Context.__le__", "Return self<=value."), - ("builtins._Context.__lt__", "Return self=value."), - ("builtins._ContextManager.__getattribute__", "Return getattr(self, name)."), - ("builtins._ContextManager.__getstate__", "Helper for pickle."), - ("builtins._ContextManager.__gt__", "Return self>value."), - ("builtins._ContextManager.__hash__", "Return hash(self)."), - ("builtins._ContextManager.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._ContextManager.__le__", "Return self<=value."), - ("builtins._ContextManager.__lt__", "Return self=value."), - ("builtins._ContextManagerMixin.__getattribute__", "Return getattr(self, name)."), - ("builtins._ContextManagerMixin.__getstate__", "Helper for pickle."), - ("builtins._ContextManagerMixin.__gt__", "Return self>value."), - ("builtins._ContextManagerMixin.__hash__", "Return hash(self)."), - ("builtins._ContextManagerMixin.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._ContextManagerMixin.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._ContextManagerMixin.__le__", "Return self<=value."), - ("builtins._ContextManagerMixin.__lt__", "Return self=value."), - ("builtins._DataclassParams.__getattribute__", "Return getattr(self, name)."), - ("builtins._DataclassParams.__getstate__", "Helper for pickle."), - ("builtins._DataclassParams.__gt__", "Return self>value."), - ("builtins._DataclassParams.__hash__", "Return hash(self)."), - ("builtins._DataclassParams.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._DataclassParams.__le__", "Return self<=value."), - ("builtins._DataclassParams.__lt__", "Return self=value."), - ("builtins._DebugResult.__getattribute__", "Return getattr(self, name)."), - ("builtins._DebugResult.__getstate__", "Helper for pickle."), - ("builtins._DebugResult.__gt__", "Return self>value."), - ("builtins._DebugResult.__hash__", "Return hash(self)."), - ("builtins._DebugResult.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._DebugResult.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._DebugResult.__le__", "Return self<=value."), - ("builtins._DebugResult.__lt__", "Return self=value."), - ("builtins._DeleteDummyThreadOnDel.__getattribute__", "Return getattr(self, name)."), - ("builtins._DeleteDummyThreadOnDel.__getstate__", "Helper for pickle."), - ("builtins._DeleteDummyThreadOnDel.__gt__", "Return self>value."), - ("builtins._DeleteDummyThreadOnDel.__hash__", "Return hash(self)."), - ("builtins._DeleteDummyThreadOnDel.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._DeleteDummyThreadOnDel.__le__", "Return self<=value."), - ("builtins._DeleteDummyThreadOnDel.__lt__", "Return self=value."), - ("builtins._DumbXMLWriter.__getattribute__", "Return getattr(self, name)."), - ("builtins._DumbXMLWriter.__getstate__", "Helper for pickle."), - ("builtins._DumbXMLWriter.__gt__", "Return self>value."), - ("builtins._DumbXMLWriter.__hash__", "Return hash(self)."), - ("builtins._DumbXMLWriter.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._DumbXMLWriter.__le__", "Return self<=value."), - ("builtins._DumbXMLWriter.__lt__", "Return self=value."), - ("builtins._DummyModuleLock.__getattribute__", "Return getattr(self, name)."), - ("builtins._DummyModuleLock.__getstate__", "Helper for pickle."), - ("builtins._DummyModuleLock.__gt__", "Return self>value."), - ("builtins._DummyModuleLock.__hash__", "Return hash(self)."), - ("builtins._DummyModuleLock.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._DummyModuleLock.__le__", "Return self<=value."), - ("builtins._DummyModuleLock.__lt__", "Return self=value."), - ("builtins._ErrorHolder.__getattribute__", "Return getattr(self, name)."), - ("builtins._ErrorHolder.__getstate__", "Helper for pickle."), - ("builtins._ErrorHolder.__gt__", "Return self>value."), - ("builtins._ErrorHolder.__hash__", "Return hash(self)."), - ("builtins._ErrorHolder.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._ErrorHolder.__le__", "Return self<=value."), - ("builtins._ErrorHolder.__lt__", "Return self=value."), - ("builtins._Example.__getattribute__", "Return getattr(self, name)."), - ("builtins._Example.__getstate__", "Helper for pickle."), - ("builtins._Example.__gt__", "Return self>value."), - ("builtins._Example.__hash__", "Return hash(self)."), - ("builtins._Example.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._Example.__le__", "Return self<=value."), - ("builtins._Example.__lt__", "Return self=value."), - ("builtins._ExceptionPrintContext.__getattribute__", "Return getattr(self, name)."), - ("builtins._ExceptionPrintContext.__getstate__", "Helper for pickle."), - ("builtins._ExceptionPrintContext.__gt__", "Return self>value."), - ("builtins._ExceptionPrintContext.__hash__", "Return hash(self)."), - ("builtins._ExceptionPrintContext.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._ExceptionPrintContext.__le__", "Return self<=value."), - ("builtins._ExceptionPrintContext.__lt__", "Return self=value."), - ("builtins._ExecutableTarget.__getattribute__", "Return getattr(self, name)."), - ("builtins._ExecutableTarget.__getstate__", "Helper for pickle."), - ("builtins._ExecutableTarget.__gt__", "Return self>value."), - ("builtins._ExecutableTarget.__hash__", "Return hash(self)."), - ("builtins._ExecutableTarget.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._ExecutableTarget.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._ExecutableTarget.__le__", "Return self<=value."), - ("builtins._ExecutableTarget.__lt__", "Return self=value."), - ("builtins._FIELD_BASE.__getattribute__", "Return getattr(self, name)."), - ("builtins._FIELD_BASE.__getstate__", "Helper for pickle."), - ("builtins._FIELD_BASE.__gt__", "Return self>value."), - ("builtins._FIELD_BASE.__hash__", "Return hash(self)."), - ("builtins._FIELD_BASE.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._FIELD_BASE.__le__", "Return self<=value."), - ("builtins._FIELD_BASE.__lt__", "Return self=value."), - ("builtins._Feature.__getattribute__", "Return getattr(self, name)."), - ("builtins._Feature.__getstate__", "Helper for pickle."), - ("builtins._Feature.__gt__", "Return self>value."), - ("builtins._Feature.__hash__", "Return hash(self)."), - ("builtins._Feature.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._Feature.__le__", "Return self<=value."), - ("builtins._Feature.__lt__", "Return self=value."), - ("builtins._FileInFile.__getattribute__", "Return getattr(self, name)."), - ("builtins._FileInFile.__getstate__", "Helper for pickle."), - ("builtins._FileInFile.__gt__", "Return self>value."), - ("builtins._FileInFile.__hash__", "Return hash(self)."), - ("builtins._FileInFile.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._FileInFile.__le__", "Return self<=value."), - ("builtins._FileInFile.__lt__", "Return self=value."), - ("builtins._Final.__getattribute__", "Return getattr(self, name)."), - ("builtins._Final.__getstate__", "Helper for pickle."), - ("builtins._Final.__gt__", "Return self>value."), - ("builtins._Final.__hash__", "Return hash(self)."), - ("builtins._Final.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._Final.__le__", "Return self<=value."), - ("builtins._Final.__lt__", "Return self=value."), - ("builtins._Framer.__getattribute__", "Return getattr(self, name)."), - ("builtins._Framer.__getstate__", "Helper for pickle."), - ("builtins._Framer.__gt__", "Return self>value."), - ("builtins._Framer.__hash__", "Return hash(self)."), - ("builtins._Framer.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._Framer.__le__", "Return self<=value."), - ("builtins._Framer.__lt__", "Return self=value."), - ("builtins._FuncBuilder.__getattribute__", "Return getattr(self, name)."), - ("builtins._FuncBuilder.__getstate__", "Helper for pickle."), - ("builtins._FuncBuilder.__gt__", "Return self>value."), - ("builtins._FuncBuilder.__hash__", "Return hash(self)."), - ("builtins._FuncBuilder.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._FuncBuilder.__le__", "Return self<=value."), - ("builtins._FuncBuilder.__lt__", "Return self=value."), - ("builtins._GeneratorContextManagerBase.__getattribute__", "Return getattr(self, name)."), - ("builtins._GeneratorContextManagerBase.__getstate__", "Helper for pickle."), - ("builtins._GeneratorContextManagerBase.__gt__", "Return self>value."), - ("builtins._GeneratorContextManagerBase.__hash__", "Return hash(self)."), - ("builtins._GeneratorContextManagerBase.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._GeneratorContextManagerBase.__le__", "Return self<=value."), - ("builtins._GeneratorContextManagerBase.__lt__", "Return self=value."), - ("builtins._GeneratorWrapper.__getattribute__", "Return getattr(self, name)."), - ("builtins._GeneratorWrapper.__getstate__", "Helper for pickle."), - ("builtins._GeneratorWrapper.__gt__", "Return self>value."), - ("builtins._GeneratorWrapper.__hash__", "Return hash(self)."), - ("builtins._GeneratorWrapper.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._GeneratorWrapper.__le__", "Return self<=value."), - ("builtins._GeneratorWrapper.__lt__", "Return self=value."), - ("builtins._GlobberBase.__getattribute__", "Return getattr(self, name)."), - ("builtins._GlobberBase.__getstate__", "Helper for pickle."), - ("builtins._GlobberBase.__gt__", "Return self>value."), - ("builtins._GlobberBase.__hash__", "Return hash(self)."), - ("builtins._GlobberBase.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._GlobberBase.__le__", "Return self<=value."), - ("builtins._GlobberBase.__lt__", "Return self=value."), - ("builtins._HAS_DEFAULT_FACTORY_CLASS.__getattribute__", "Return getattr(self, name)."), - ("builtins._HAS_DEFAULT_FACTORY_CLASS.__getstate__", "Helper for pickle."), - ("builtins._HAS_DEFAULT_FACTORY_CLASS.__gt__", "Return self>value."), - ("builtins._HAS_DEFAULT_FACTORY_CLASS.__hash__", "Return hash(self)."), - ("builtins._HAS_DEFAULT_FACTORY_CLASS.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._HAS_DEFAULT_FACTORY_CLASS.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._HAS_DEFAULT_FACTORY_CLASS.__le__", "Return self<=value."), - ("builtins._HAS_DEFAULT_FACTORY_CLASS.__lt__", "Return self=value."), - ("builtins._Helper.__getattribute__", "Return getattr(self, name)."), - ("builtins._Helper.__getstate__", "Helper for pickle."), - ("builtins._Helper.__gt__", "Return self>value."), - ("builtins._Helper.__hash__", "Return hash(self)."), - ("builtins._Helper.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._Helper.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._Helper.__le__", "Return self<=value."), - ("builtins._Helper.__lt__", "Return self=value."), - ("builtins._IPAddressBase.__getattribute__", "Return getattr(self, name)."), - ("builtins._IPAddressBase.__getstate__", "Helper for pickle."), - ("builtins._IPAddressBase.__gt__", "Return self>value."), - ("builtins._IPAddressBase.__hash__", "Return hash(self)."), - ("builtins._IPAddressBase.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._IPAddressBase.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._IPAddressBase.__le__", "Return self<=value."), - ("builtins._IPAddressBase.__lt__", "Return self>> ipaddress.ip_address(\"127.0.0.1\").reverse_pointer\n'1.0.0.127.in-addr.arpa'\n>>> ipaddress.ip_address(\"2001:db8::1\").reverse_pointer\n'1.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.8.b.d.0.1.0.0.2.ip6.arpa'"), - ("builtins._IPv4Constants.__delattr__", "Implement delattr(self, name)."), - ("builtins._IPv4Constants.__eq__", "Return self==value."), - ("builtins._IPv4Constants.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins._IPv4Constants.__ge__", "Return self>=value."), - ("builtins._IPv4Constants.__getattribute__", "Return getattr(self, name)."), - ("builtins._IPv4Constants.__getstate__", "Helper for pickle."), - ("builtins._IPv4Constants.__gt__", "Return self>value."), - ("builtins._IPv4Constants.__hash__", "Return hash(self)."), - ("builtins._IPv4Constants.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._IPv4Constants.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._IPv4Constants.__le__", "Return self<=value."), - ("builtins._IPv4Constants.__lt__", "Return self=value."), - ("builtins._IPv6Constants.__getattribute__", "Return getattr(self, name)."), - ("builtins._IPv6Constants.__getstate__", "Helper for pickle."), - ("builtins._IPv6Constants.__gt__", "Return self>value."), - ("builtins._IPv6Constants.__hash__", "Return hash(self)."), - ("builtins._IPv6Constants.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._IPv6Constants.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._IPv6Constants.__le__", "Return self<=value."), - ("builtins._IPv6Constants.__lt__", "Return self=value."), - ("builtins._Ignore.__getattribute__", "Return getattr(self, name)."), - ("builtins._Ignore.__getstate__", "Helper for pickle."), - ("builtins._Ignore.__gt__", "Return self>value."), - ("builtins._Ignore.__hash__", "Return hash(self)."), - ("builtins._Ignore.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._Ignore.__le__", "Return self<=value."), - ("builtins._Ignore.__lt__", "Return self=value."), - ("builtins._ImportLockContext.__getattribute__", "Return getattr(self, name)."), - ("builtins._ImportLockContext.__getstate__", "Helper for pickle."), - ("builtins._ImportLockContext.__gt__", "Return self>value."), - ("builtins._ImportLockContext.__hash__", "Return hash(self)."), - ("builtins._ImportLockContext.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._ImportLockContext.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._ImportLockContext.__le__", "Return self<=value."), - ("builtins._ImportLockContext.__lt__", "Return self=value."), - ("builtins._Info.__getattribute__", "Return getattr(self, name)."), - ("builtins._Info.__getstate__", "Helper for pickle."), - ("builtins._Info.__gt__", "Return self>value."), - ("builtins._Info.__hash__", "Return hash(self)."), - ("builtins._Info.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._Info.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._Info.__le__", "Return self<=value."), - ("builtins._Info.__lt__", "Return self=value."), - ("builtins._InterruptHandler.__getattribute__", "Return getattr(self, name)."), - ("builtins._InterruptHandler.__getstate__", "Helper for pickle."), - ("builtins._InterruptHandler.__gt__", "Return self>value."), - ("builtins._InterruptHandler.__hash__", "Return hash(self)."), - ("builtins._InterruptHandler.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._InterruptHandler.__le__", "Return self<=value."), - ("builtins._InterruptHandler.__lt__", "Return self=value."), - ("builtins._KW_ONLY_TYPE.__getattribute__", "Return getattr(self, name)."), - ("builtins._KW_ONLY_TYPE.__getstate__", "Helper for pickle."), - ("builtins._KW_ONLY_TYPE.__gt__", "Return self>value."), - ("builtins._KW_ONLY_TYPE.__hash__", "Return hash(self)."), - ("builtins._KW_ONLY_TYPE.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._KW_ONLY_TYPE.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._KW_ONLY_TYPE.__le__", "Return self<=value."), - ("builtins._KW_ONLY_TYPE.__lt__", "Return self=value."), - ("builtins._LazyAnnotationLib.__getattribute__", "Return getattr(self, name)."), - ("builtins._LazyAnnotationLib.__getstate__", "Helper for pickle."), - ("builtins._LazyAnnotationLib.__gt__", "Return self>value."), - ("builtins._LazyAnnotationLib.__hash__", "Return hash(self)."), - ("builtins._LazyAnnotationLib.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._LazyAnnotationLib.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._LazyAnnotationLib.__le__", "Return self<=value."), - ("builtins._LazyAnnotationLib.__lt__", "Return self=value."), - ("builtins._Link.__getattribute__", "Return getattr(self, name)."), - ("builtins._Link.__getstate__", "Helper for pickle."), - ("builtins._Link.__gt__", "Return self>value."), - ("builtins._Link.__hash__", "Return hash(self)."), - ("builtins._Link.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._Link.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._Link.__le__", "Return self<=value."), - ("builtins._Link.__lt__", "Return self=value."), - ("builtins._LoaderBasics.__getattribute__", "Return getattr(self, name)."), - ("builtins._LoaderBasics.__getstate__", "Helper for pickle."), - ("builtins._LoaderBasics.__gt__", "Return self>value."), - ("builtins._LoaderBasics.__hash__", "Return hash(self)."), - ("builtins._LoaderBasics.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._LoaderBasics.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._LoaderBasics.__le__", "Return self<=value."), - ("builtins._LoaderBasics.__lt__", "Return self=value."), - ("builtins._Lock.__getattribute__", "Return getattr(self, name)."), - ("builtins._Lock.__getstate__", "Helper for pickle."), - ("builtins._Lock.__gt__", "Return self>value."), - ("builtins._Lock.__hash__", "Return hash(self)."), - ("builtins._Lock.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._Lock.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._Lock.__le__", "Return self<=value."), - ("builtins._Lock.__lt__", "Return self=value."), - ("builtins._Log10Memoize.__getattribute__", "Return getattr(self, name)."), - ("builtins._Log10Memoize.__getstate__", "Helper for pickle."), - ("builtins._Log10Memoize.__gt__", "Return self>value."), - ("builtins._Log10Memoize.__hash__", "Return hash(self)."), - ("builtins._Log10Memoize.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._Log10Memoize.__le__", "Return self<=value."), - ("builtins._Log10Memoize.__lt__", "Return self= 0, return floor(10**p)*log(10).\n\nFor example, self.getdigits(3) returns 2302."), - ("builtins._LoopBoundMixin.__delattr__", "Implement delattr(self, name)."), - ("builtins._LoopBoundMixin.__eq__", "Return self==value."), - ("builtins._LoopBoundMixin.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins._LoopBoundMixin.__ge__", "Return self>=value."), - ("builtins._LoopBoundMixin.__getattribute__", "Return getattr(self, name)."), - ("builtins._LoopBoundMixin.__getstate__", "Helper for pickle."), - ("builtins._LoopBoundMixin.__gt__", "Return self>value."), - ("builtins._LoopBoundMixin.__hash__", "Return hash(self)."), - ("builtins._LoopBoundMixin.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._LoopBoundMixin.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._LoopBoundMixin.__le__", "Return self<=value."), - ("builtins._LoopBoundMixin.__lt__", "Return self=value."), - ("builtins._LowLevelFile.__getattribute__", "Return getattr(self, name)."), - ("builtins._LowLevelFile.__getstate__", "Helper for pickle."), - ("builtins._LowLevelFile.__gt__", "Return self>value."), - ("builtins._LowLevelFile.__hash__", "Return hash(self)."), - ("builtins._LowLevelFile.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._LowLevelFile.__le__", "Return self<=value."), - ("builtins._LowLevelFile.__lt__", "Return self=value."), - ("builtins._MISSING_TYPE.__getattribute__", "Return getattr(self, name)."), - ("builtins._MISSING_TYPE.__getstate__", "Helper for pickle."), - ("builtins._MISSING_TYPE.__gt__", "Return self>value."), - ("builtins._MISSING_TYPE.__hash__", "Return hash(self)."), - ("builtins._MISSING_TYPE.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._MISSING_TYPE.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._MISSING_TYPE.__le__", "Return self<=value."), - ("builtins._MISSING_TYPE.__lt__", "Return self=value."), - ("builtins._ModifiedArgv0.__getattribute__", "Return getattr(self, name)."), - ("builtins._ModifiedArgv0.__getstate__", "Helper for pickle."), - ("builtins._ModifiedArgv0.__gt__", "Return self>value."), - ("builtins._ModifiedArgv0.__hash__", "Return hash(self)."), - ("builtins._ModifiedArgv0.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._ModifiedArgv0.__le__", "Return self<=value."), - ("builtins._ModifiedArgv0.__lt__", "Return self=value."), - ("builtins._ModuleLock.__getattribute__", "Return getattr(self, name)."), - ("builtins._ModuleLock.__getstate__", "Helper for pickle."), - ("builtins._ModuleLock.__gt__", "Return self>value."), - ("builtins._ModuleLock.__hash__", "Return hash(self)."), - ("builtins._ModuleLock.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._ModuleLock.__le__", "Return self<=value."), - ("builtins._ModuleLock.__lt__", "Return self=value."), - ("builtins._ModuleLockManager.__getattribute__", "Return getattr(self, name)."), - ("builtins._ModuleLockManager.__getstate__", "Helper for pickle."), - ("builtins._ModuleLockManager.__gt__", "Return self>value."), - ("builtins._ModuleLockManager.__hash__", "Return hash(self)."), - ("builtins._ModuleLockManager.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._ModuleLockManager.__le__", "Return self<=value."), - ("builtins._ModuleLockManager.__lt__", "Return self=value."), - ("builtins._MonitoringTracer.__getattribute__", "Return getattr(self, name)."), - ("builtins._MonitoringTracer.__getstate__", "Helper for pickle."), - ("builtins._MonitoringTracer.__gt__", "Return self>value."), - ("builtins._MonitoringTracer.__hash__", "Return hash(self)."), - ("builtins._MonitoringTracer.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._MonitoringTracer.__le__", "Return self<=value."), - ("builtins._MonitoringTracer.__lt__", "Return self=value."), - ("builtins._NamespacePath.__getattribute__", "Return getattr(self, name)."), - ("builtins._NamespacePath.__getstate__", "Helper for pickle."), - ("builtins._NamespacePath.__gt__", "Return self>value."), - ("builtins._NamespacePath.__hash__", "Return hash(self)."), - ("builtins._NamespacePath.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._NamespacePath.__le__", "Return self<=value."), - ("builtins._NamespacePath.__lt__", "Return self=value."), - ("builtins._NetlocResultMixinBase.__getattribute__", "Return getattr(self, name)."), - ("builtins._NetlocResultMixinBase.__getstate__", "Helper for pickle."), - ("builtins._NetlocResultMixinBase.__gt__", "Return self>value."), - ("builtins._NetlocResultMixinBase.__hash__", "Return hash(self)."), - ("builtins._NetlocResultMixinBase.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._NetlocResultMixinBase.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._NetlocResultMixinBase.__le__", "Return self<=value."), - ("builtins._NetlocResultMixinBase.__lt__", "Return self=value."), - ("builtins._NoThreads.__getattribute__", "Return getattr(self, name)."), - ("builtins._NoThreads.__getstate__", "Helper for pickle."), - ("builtins._NoThreads.__gt__", "Return self>value."), - ("builtins._NoThreads.__hash__", "Return hash(self)."), - ("builtins._NoThreads.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._NoThreads.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._NoThreads.__le__", "Return self<=value."), - ("builtins._NoThreads.__lt__", "Return self=value."), - ("builtins._NodeInfo.__getattribute__", "Return getattr(self, name)."), - ("builtins._NodeInfo.__getstate__", "Helper for pickle."), - ("builtins._NodeInfo.__gt__", "Return self>value."), - ("builtins._NodeInfo.__hash__", "Return hash(self)."), - ("builtins._NodeInfo.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._NodeInfo.__le__", "Return self<=value."), - ("builtins._NodeInfo.__lt__", "Return self=value."), - ("builtins._NotIterable.__getattribute__", "Return getattr(self, name)."), - ("builtins._NotIterable.__getstate__", "Helper for pickle."), - ("builtins._NotIterable.__gt__", "Return self>value."), - ("builtins._NotIterable.__hash__", "Return hash(self)."), - ("builtins._NotIterable.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._NotIterable.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._NotIterable.__le__", "Return self<=value."), - ("builtins._NotIterable.__lt__", "Return self=value."), - ("builtins._Object.__getattribute__", "Return getattr(self, name)."), - ("builtins._Object.__getstate__", "Helper for pickle."), - ("builtins._Object.__gt__", "Return self>value."), - ("builtins._Object.__hash__", "Return hash(self)."), - ("builtins._Object.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._Object.__le__", "Return self<=value."), - ("builtins._Object.__lt__", "Return self=value."), - ("builtins._Outcome.__getattribute__", "Return getattr(self, name)."), - ("builtins._Outcome.__getstate__", "Helper for pickle."), - ("builtins._Outcome.__gt__", "Return self>value."), - ("builtins._Outcome.__hash__", "Return hash(self)."), - ("builtins._Outcome.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._Outcome.__le__", "Return self<=value."), - ("builtins._Outcome.__lt__", "Return self=value."), - ("builtins._PaddedFile.__getattribute__", "Return getattr(self, name)."), - ("builtins._PaddedFile.__getstate__", "Helper for pickle."), - ("builtins._PaddedFile.__gt__", "Return self>value."), - ("builtins._PaddedFile.__hash__", "Return hash(self)."), - ("builtins._PaddedFile.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._PaddedFile.__le__", "Return self<=value."), - ("builtins._PaddedFile.__lt__", "Return self=value."), - ("builtins._PathInfoBase.__getattribute__", "Return getattr(self, name)."), - ("builtins._PathInfoBase.__getstate__", "Helper for pickle."), - ("builtins._PathInfoBase.__gt__", "Return self>value."), - ("builtins._PathInfoBase.__hash__", "Return hash(self)."), - ("builtins._PathInfoBase.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._PathInfoBase.__le__", "Return self<=value."), - ("builtins._PathInfoBase.__lt__", "Return self=value."), - ("builtins._PdbClient.__getattribute__", "Return getattr(self, name)."), - ("builtins._PdbClient.__getstate__", "Helper for pickle."), - ("builtins._PdbClient.__gt__", "Return self>value."), - ("builtins._PdbClient.__hash__", "Return hash(self)."), - ("builtins._PdbClient.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._PdbClient.__le__", "Return self<=value."), - ("builtins._PdbClient.__lt__", "Return self=value."), - ("builtins._Pickler.__getattribute__", "Return getattr(self, name)."), - ("builtins._Pickler.__getstate__", "Helper for pickle."), - ("builtins._Pickler.__gt__", "Return self>value."), - ("builtins._Pickler.__hash__", "Return hash(self)."), - ("builtins._Pickler.__init__", "This takes a binary file for writing a pickle data stream.\n\nThe optional *protocol* argument tells the pickler to use the\ngiven protocol; supported protocols are 0, 1, 2, 3, 4 and 5.\nThe default protocol is 5. It was introduced in Python 3.8, and\nis incompatible with previous versions.\n\nSpecifying a negative protocol version selects the highest\nprotocol version supported. The higher the protocol used, the\nmore recent the version of Python needed to read the pickle\nproduced.\n\nThe *file* argument must have a write() method that accepts a\nsingle bytes argument. It can thus be a file object opened for\nbinary writing, an io.BytesIO instance, or any other custom\nobject that meets this interface.\n\nIf *fix_imports* is True and *protocol* is less than 3, pickle\nwill try to map the new Python 3 names to the old module names\nused in Python 2, so that the pickle data stream is readable\nwith Python 2.\n\nIf *buffer_callback* is None (the default), buffer views are\nserialized into *file* as part of the pickle stream.\n\nIf *buffer_callback* is not None, then it can be called any number\nof times with a buffer view. If the callback returns a false value\n(such as None), the given buffer is out-of-band; otherwise the\nbuffer is serialized in-band, i.e. inside the pickle stream.\n\nIt is an error if *buffer_callback* is not None and *protocol*\nis None or smaller than 5."), - ("builtins._Pickler.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._Pickler.__le__", "Return self<=value."), - ("builtins._Pickler.__lt__", "Return self=value."), - ("builtins._PidfdChildWatcher.__getattribute__", "Return getattr(self, name)."), - ("builtins._PidfdChildWatcher.__getstate__", "Helper for pickle."), - ("builtins._PidfdChildWatcher.__gt__", "Return self>value."), - ("builtins._PidfdChildWatcher.__hash__", "Return hash(self)."), - ("builtins._PidfdChildWatcher.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._PidfdChildWatcher.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._PidfdChildWatcher.__le__", "Return self<=value."), - ("builtins._PidfdChildWatcher.__lt__", "Return self=value."), - ("builtins._PlistParser.__getattribute__", "Return getattr(self, name)."), - ("builtins._PlistParser.__getstate__", "Helper for pickle."), - ("builtins._PlistParser.__gt__", "Return self>value."), - ("builtins._PlistParser.__hash__", "Return hash(self)."), - ("builtins._PlistParser.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._PlistParser.__le__", "Return self<=value."), - ("builtins._PlistParser.__lt__", "Return self=value."), - ("builtins._PointerTypeCache.__getattribute__", "Return getattr(self, name)."), - ("builtins._PointerTypeCache.__getstate__", "Helper for pickle."), - ("builtins._PointerTypeCache.__gt__", "Return self>value."), - ("builtins._PointerTypeCache.__hash__", "Return hash(self)."), - ("builtins._PointerTypeCache.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._PointerTypeCache.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._PointerTypeCache.__le__", "Return self<=value."), - ("builtins._PointerTypeCache.__lt__", "Return self)\n\nThe repr of an instance can be used to reconstruct the object\nif and only if the repr of the values can be used to reconstruct\nthose values."), - ("builtins._PolicyBase.__add__", "Non-default values from right operand override those from left.\n\nThe object returned is a new instance of the subclass."), - ("builtins._PolicyBase.__delattr__", "Implement delattr(self, name)."), - ("builtins._PolicyBase.__eq__", "Return self==value."), - ("builtins._PolicyBase.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins._PolicyBase.__ge__", "Return self>=value."), - ("builtins._PolicyBase.__getattribute__", "Return getattr(self, name)."), - ("builtins._PolicyBase.__getstate__", "Helper for pickle."), - ("builtins._PolicyBase.__gt__", "Return self>value."), - ("builtins._PolicyBase.__hash__", "Return hash(self)."), - ("builtins._PolicyBase.__init__", "Create new Policy, possibly overriding some defaults.\n\nSee class docstring for a list of overridable attributes."), - ("builtins._PolicyBase.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._PolicyBase.__le__", "Return self<=value."), - ("builtins._PolicyBase.__lt__", "Return self=value."), - ("builtins._Printer.__getattribute__", "Return getattr(self, name)."), - ("builtins._Printer.__getstate__", "Helper for pickle."), - ("builtins._Printer.__gt__", "Return self>value."), - ("builtins._Printer.__hash__", "Return hash(self)."), - ("builtins._Printer.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._Printer.__le__", "Return self<=value."), - ("builtins._Printer.__lt__", "Return self=value."), - ("builtins._Processor.__getattribute__", "Return getattr(self, name)."), - ("builtins._Processor.__getstate__", "Helper for pickle."), - ("builtins._Processor.__gt__", "Return self>value."), - ("builtins._Processor.__hash__", "Return hash(self)."), - ("builtins._Processor.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._Processor.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._Processor.__le__", "Return self<=value."), - ("builtins._Processor.__lt__", "Return self=value."), - ("builtins._ProxyFile.__getattribute__", "Return getattr(self, name)."), - ("builtins._ProxyFile.__getstate__", "Helper for pickle."), - ("builtins._ProxyFile.__gt__", "Return self>value."), - ("builtins._ProxyFile.__hash__", "Return hash(self)."), - ("builtins._ProxyFile.__init__", "Initialize a _ProxyFile."), - ("builtins._ProxyFile.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._ProxyFile.__iter__", "Iterate over lines."), - ("builtins._ProxyFile.__le__", "Return self<=value."), - ("builtins._ProxyFile.__lt__", "Return self=value."), - ("builtins._PySimpleQueue.__getattribute__", "Return getattr(self, name)."), - ("builtins._PySimpleQueue.__getstate__", "Helper for pickle."), - ("builtins._PySimpleQueue.__gt__", "Return self>value."), - ("builtins._PySimpleQueue.__hash__", "Return hash(self)."), - ("builtins._PySimpleQueue.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._PySimpleQueue.__le__", "Return self<=value."), - ("builtins._PySimpleQueue.__lt__", "Return self=value."), - ("builtins._RLock.__getattribute__", "Return getattr(self, name)."), - ("builtins._RLock.__getstate__", "Helper for pickle."), - ("builtins._RLock.__gt__", "Return self>value."), - ("builtins._RLock.__hash__", "Return hash(self)."), - ("builtins._RLock.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._RLock.__le__", "Return self<=value."), - ("builtins._RLock.__lt__", "Return self=value."), - ("builtins._RandomNameSequence.__getattribute__", "Return getattr(self, name)."), - ("builtins._RandomNameSequence.__getstate__", "Helper for pickle."), - ("builtins._RandomNameSequence.__gt__", "Return self>value."), - ("builtins._RandomNameSequence.__hash__", "Return hash(self)."), - ("builtins._RandomNameSequence.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._RandomNameSequence.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._RandomNameSequence.__le__", "Return self<=value."), - ("builtins._RandomNameSequence.__lt__", "Return self=value."), - ("builtins._ReadState.__getattribute__", "Return getattr(self, name)."), - ("builtins._ReadState.__getstate__", "Helper for pickle."), - ("builtins._ReadState.__gt__", "Return self>value."), - ("builtins._ReadState.__hash__", "Return hash(self)."), - ("builtins._ReadState.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._ReadState.__le__", "Return self<=value."), - ("builtins._ReadState.__lt__", "Return self=value."), - ("builtins._ResultMixinBytes.__getattribute__", "Return getattr(self, name)."), - ("builtins._ResultMixinBytes.__getstate__", "Helper for pickle."), - ("builtins._ResultMixinBytes.__gt__", "Return self>value."), - ("builtins._ResultMixinBytes.__hash__", "Return hash(self)."), - ("builtins._ResultMixinBytes.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._ResultMixinBytes.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._ResultMixinBytes.__le__", "Return self<=value."), - ("builtins._ResultMixinBytes.__lt__", "Return self=value."), - ("builtins._ResultMixinStr.__getattribute__", "Return getattr(self, name)."), - ("builtins._ResultMixinStr.__getstate__", "Helper for pickle."), - ("builtins._ResultMixinStr.__gt__", "Return self>value."), - ("builtins._ResultMixinStr.__hash__", "Return hash(self)."), - ("builtins._ResultMixinStr.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._ResultMixinStr.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._ResultMixinStr.__le__", "Return self<=value."), - ("builtins._ResultMixinStr.__lt__", "Return self=value."), - ("builtins._Section.__getattribute__", "Return getattr(self, name)."), - ("builtins._Section.__getstate__", "Helper for pickle."), - ("builtins._Section.__gt__", "Return self>value."), - ("builtins._Section.__hash__", "Return hash(self)."), - ("builtins._Section.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._Section.__le__", "Return self<=value."), - ("builtins._Section.__lt__", "Return self=value."), - ("builtins._SelectorContext.__getattribute__", "Return getattr(self, name)."), - ("builtins._SelectorContext.__getstate__", "Helper for pickle."), - ("builtins._SelectorContext.__gt__", "Return self>value."), - ("builtins._SelectorContext.__hash__", "Return hash(self)."), - ("builtins._SelectorContext.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._SelectorContext.__le__", "Return self<=value."), - ("builtins._SelectorContext.__lt__", "Return self=value."), - ("builtins._Sentinel.__getattribute__", "Return getattr(self, name)."), - ("builtins._Sentinel.__getstate__", "Helper for pickle."), - ("builtins._Sentinel.__gt__", "Return self>value."), - ("builtins._Sentinel.__hash__", "Return hash(self)."), - ("builtins._Sentinel.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._Sentinel.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._Sentinel.__le__", "Return self<=value."), - ("builtins._Sentinel.__lt__", "Return self=value."), - ("builtins._SharedFile.__getattribute__", "Return getattr(self, name)."), - ("builtins._SharedFile.__getstate__", "Helper for pickle."), - ("builtins._SharedFile.__gt__", "Return self>value."), - ("builtins._SharedFile.__hash__", "Return hash(self)."), - ("builtins._SharedFile.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._SharedFile.__le__", "Return self<=value."), - ("builtins._SharedFile.__lt__", "Return self=value."), - ("builtins._Stream.__getattribute__", "Return getattr(self, name)."), - ("builtins._Stream.__getstate__", "Helper for pickle."), - ("builtins._Stream.__gt__", "Return self>value."), - ("builtins._Stream.__hash__", "Return hash(self)."), - ("builtins._Stream.__init__", "Construct a _Stream object."), - ("builtins._Stream.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._Stream.__le__", "Return self<=value."), - ("builtins._Stream.__lt__", "Return self=value."), - ("builtins._StreamProxy.__getattribute__", "Return getattr(self, name)."), - ("builtins._StreamProxy.__getstate__", "Helper for pickle."), - ("builtins._StreamProxy.__gt__", "Return self>value."), - ("builtins._StreamProxy.__hash__", "Return hash(self)."), - ("builtins._StreamProxy.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._StreamProxy.__le__", "Return self<=value."), - ("builtins._StreamProxy.__lt__", "Return self=value."), - ("builtins._TZifHeader.__getattribute__", "Return getattr(self, name)."), - ("builtins._TZifHeader.__getstate__", "Helper for pickle."), - ("builtins._TZifHeader.__gt__", "Return self>value."), - ("builtins._TZifHeader.__hash__", "Return hash(self)."), - ("builtins._TZifHeader.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._TZifHeader.__le__", "Return self<=value."), - ("builtins._TZifHeader.__lt__", "Return self=value."), - ("builtins._Tellable.__getattribute__", "Return getattr(self, name)."), - ("builtins._Tellable.__getstate__", "Helper for pickle."), - ("builtins._Tellable.__gt__", "Return self>value."), - ("builtins._Tellable.__hash__", "Return hash(self)."), - ("builtins._Tellable.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._Tellable.__le__", "Return self<=value."), - ("builtins._Tellable.__lt__", "Return self=value."), - ("builtins._TempModule.__getattribute__", "Return getattr(self, name)."), - ("builtins._TempModule.__getstate__", "Helper for pickle."), - ("builtins._TempModule.__gt__", "Return self>value."), - ("builtins._TempModule.__hash__", "Return hash(self)."), - ("builtins._TempModule.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._TempModule.__le__", "Return self<=value."), - ("builtins._TempModule.__lt__", "Return self=value."), - ("builtins._TemplatePattern.__getattribute__", "Return getattr(self, name)."), - ("builtins._TemplatePattern.__getstate__", "Helper for pickle."), - ("builtins._TemplatePattern.__gt__", "Return self>value."), - ("builtins._TemplatePattern.__hash__", "Return hash(self)."), - ("builtins._TemplatePattern.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._TemplatePattern.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._TemplatePattern.__le__", "Return self<=value."), - ("builtins._TemplatePattern.__lt__", "Return self=value."), - ("builtins._TemporaryFileCloser.__getattribute__", "Return getattr(self, name)."), - ("builtins._TemporaryFileCloser.__getstate__", "Helper for pickle."), - ("builtins._TemporaryFileCloser.__gt__", "Return self>value."), - ("builtins._TemporaryFileCloser.__hash__", "Return hash(self)."), - ("builtins._TemporaryFileCloser.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._TemporaryFileCloser.__le__", "Return self<=value."), - ("builtins._TemporaryFileCloser.__lt__", "Return self=value."), - ("builtins._TemporaryFileWrapper.__getattribute__", "Return getattr(self, name)."), - ("builtins._TemporaryFileWrapper.__getstate__", "Helper for pickle."), - ("builtins._TemporaryFileWrapper.__gt__", "Return self>value."), - ("builtins._TemporaryFileWrapper.__hash__", "Return hash(self)."), - ("builtins._TemporaryFileWrapper.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._TemporaryFileWrapper.__le__", "Return self<=value."), - ("builtins._TemporaryFileWrapper.__lt__", "Return self>> _TestClass(13).get() + _TestClass(-12).get()\n1\n>>> hex(_TestClass(13).square().get())\n'0xa9'"), - ("builtins._TestClass.__delattr__", "Implement delattr(self, name)."), - ("builtins._TestClass.__eq__", "Return self==value."), - ("builtins._TestClass.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins._TestClass.__ge__", "Return self>=value."), - ("builtins._TestClass.__getattribute__", "Return getattr(self, name)."), - ("builtins._TestClass.__getstate__", "Helper for pickle."), - ("builtins._TestClass.__gt__", "Return self>value."), - ("builtins._TestClass.__hash__", "Return hash(self)."), - ("builtins._TestClass.__init__", "val -> _TestClass object with associated value val.\n\n>>> t = _TestClass(123)\n>>> print(t.get())\n123"), - ("builtins._TestClass.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._TestClass.__le__", "Return self<=value."), - ("builtins._TestClass.__lt__", "Return self return TestClass's associated value.\n\n>>> x = _TestClass(-42)\n>>> print(x.get())\n-42"), - ("builtins._TestClass.square", "square() -> square TestClass's associated value\n\n>>> _TestClass(13).square().get()\n169"), ("builtins._ThreadHandle.__delattr__", "Implement delattr(self, name)."), ("builtins._ThreadHandle.__eq__", "Return self==value."), ("builtins._ThreadHandle.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), @@ -23616,28 +15518,6 @@ pub const DB: &[(&str, &str)] = &[ ("builtins._ThreadHandle.__sizeof__", "Size of object in memory, in bytes."), ("builtins._ThreadHandle.__str__", "Return str(self)."), ("builtins._ThreadHandle.__subclasshook__", "Abstract classes can override this to customize issubclass().\n\nThis is invoked early on by abc.ABCMeta.__subclasscheck__().\nIt should return True, False or NotImplemented. If it returns\nNotImplemented, the normal algorithm is used. Otherwise, it\noverrides the normal algorithm (and the outcome is cached)."), - ("builtins._ThreadedChildWatcher", "Threaded child watcher implementation.\n\nThe watcher uses a thread per process\nfor waiting for the process finish.\n\nIt doesn't require subscription on POSIX signal\nbut a thread creation is not free.\n\nThe watcher has O(1) complexity, its performance doesn't depend\non amount of spawn processes."), - ("builtins._ThreadedChildWatcher.__delattr__", "Implement delattr(self, name)."), - ("builtins._ThreadedChildWatcher.__eq__", "Return self==value."), - ("builtins._ThreadedChildWatcher.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins._ThreadedChildWatcher.__ge__", "Return self>=value."), - ("builtins._ThreadedChildWatcher.__getattribute__", "Return getattr(self, name)."), - ("builtins._ThreadedChildWatcher.__getstate__", "Helper for pickle."), - ("builtins._ThreadedChildWatcher.__gt__", "Return self>value."), - ("builtins._ThreadedChildWatcher.__hash__", "Return hash(self)."), - ("builtins._ThreadedChildWatcher.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._ThreadedChildWatcher.__le__", "Return self<=value."), - ("builtins._ThreadedChildWatcher.__lt__", "Return self=value."), - ("builtins._TypingEllipsis.__getattribute__", "Return getattr(self, name)."), - ("builtins._TypingEllipsis.__getstate__", "Helper for pickle."), - ("builtins._TypingEllipsis.__gt__", "Return self>value."), - ("builtins._TypingEllipsis.__hash__", "Return hash(self)."), - ("builtins._TypingEllipsis.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._TypingEllipsis.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._TypingEllipsis.__le__", "Return self<=value."), - ("builtins._TypingEllipsis.__lt__", "Return self=value."), - ("builtins._Unframer.__getattribute__", "Return getattr(self, name)."), - ("builtins._Unframer.__getstate__", "Helper for pickle."), - ("builtins._Unframer.__gt__", "Return self>value."), - ("builtins._Unframer.__hash__", "Return hash(self)."), - ("builtins._Unframer.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._Unframer.__le__", "Return self<=value."), - ("builtins._Unframer.__lt__", "Return self=value."), - ("builtins._UnionGenericAlias.__getattribute__", "Return getattr(self, name)."), - ("builtins._UnionGenericAlias.__getstate__", "Helper for pickle."), - ("builtins._UnionGenericAlias.__gt__", "Return self>value."), - ("builtins._UnionGenericAlias.__hash__", "Return hash(self)."), - ("builtins._UnionGenericAlias.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._UnionGenericAlias.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._UnionGenericAlias.__le__", "Return self<=value."), - ("builtins._UnionGenericAlias.__lt__", "Return self=value."), - ("builtins._Unknown.__getattribute__", "Return getattr(self, name)."), - ("builtins._Unknown.__getstate__", "Helper for pickle."), - ("builtins._Unknown.__gt__", "Return self>value."), - ("builtins._Unknown.__hash__", "Return hash(self)."), - ("builtins._Unknown.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._Unknown.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._Unknown.__le__", "Return self<=value."), - ("builtins._Unknown.__lt__", "Return self=value."), - ("builtins._UnnamedSection.__getattribute__", "Return getattr(self, name)."), - ("builtins._UnnamedSection.__getstate__", "Helper for pickle."), - ("builtins._UnnamedSection.__gt__", "Return self>value."), - ("builtins._UnnamedSection.__hash__", "Return hash(self)."), - ("builtins._UnnamedSection.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._UnnamedSection.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._UnnamedSection.__le__", "Return self<=value."), - ("builtins._UnnamedSection.__lt__", "Return self=value."), - ("builtins._Unpickler.__getattribute__", "Return getattr(self, name)."), - ("builtins._Unpickler.__getstate__", "Helper for pickle."), - ("builtins._Unpickler.__gt__", "Return self>value."), - ("builtins._Unpickler.__hash__", "Return hash(self)."), - ("builtins._Unpickler.__init__", "This takes a binary file for reading a pickle data stream.\n\nThe protocol version of the pickle is detected automatically, so\nno proto argument is needed.\n\nThe argument *file* must have two methods, a read() method that\ntakes an integer argument, and a readline() method that requires\nno arguments. Both methods should return bytes. Thus *file*\ncan be a binary file object opened for reading, an io.BytesIO\nobject, or any other custom object that meets this interface.\n\nThe file-like object must have two methods, a read() method\nthat takes an integer argument, and a readline() method that\nrequires no arguments. Both methods should return bytes.\nThus file-like object can be a binary file object opened for\nreading, a BytesIO object, or any other custom object that\nmeets this interface.\n\nIf *buffers* is not None, it should be an iterable of buffer-enabled\nobjects that is consumed each time the pickle stream references\nan out-of-band buffer view. Such buffers have been given in order\nto the *buffer_callback* of a Pickler object.\n\nIf *buffers* is None (the default), then the buffers are taken\nfrom the pickle stream, assuming they are serialized there.\nIt is an error for *buffers* to be None if the pickle stream\nwas produced with a non-None *buffer_callback*.\n\nOther optional arguments are *fix_imports*, *encoding* and\n*errors*, which are used to control compatibility support for\npickle stream generated by Python 2. If *fix_imports* is True,\npickle will try to map the old Python 2 names to the new names\nused in Python 3. The *encoding* and *errors* tell pickle how\nto decode 8-bit string instances pickled by Python 2; these\ndefault to 'ASCII' and 'strict', respectively. *encoding* can be\n'bytes' to read these 8-bit string instances as bytes objects."), - ("builtins._Unpickler.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._Unpickler.__le__", "Return self<=value."), - ("builtins._Unpickler.__lt__", "Return self=value."), - ("builtins._Utils.__getattribute__", "Return getattr(self, name)."), - ("builtins._Utils.__getstate__", "Helper for pickle."), - ("builtins._Utils.__gt__", "Return self>value."), - ("builtins._Utils.__hash__", "Return hash(self)."), - ("builtins._Utils.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._Utils.__le__", "Return self<=value."), - ("builtins._Utils.__lt__", "Return self=value."), - ("builtins._ValueFormatter.__getattribute__", "Return getattr(self, name)."), - ("builtins._ValueFormatter.__getstate__", "Helper for pickle."), - ("builtins._ValueFormatter.__gt__", "Return self>value."), - ("builtins._ValueFormatter.__hash__", "Return hash(self)."), - ("builtins._ValueFormatter.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._ValueFormatter.__le__", "Return self<=value."), - ("builtins._ValueFormatter.__lt__", "Return self=value."), - ("builtins._Waiter.__getattribute__", "Return getattr(self, name)."), - ("builtins._Waiter.__getstate__", "Helper for pickle."), - ("builtins._Waiter.__gt__", "Return self>value."), - ("builtins._Waiter.__hash__", "Return hash(self)."), - ("builtins._Waiter.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._Waiter.__le__", "Return self<=value."), - ("builtins._Waiter.__lt__", "Return self=value."), - ("builtins._WeakValueDictionary.__getattribute__", "Return getattr(self, name)."), - ("builtins._WeakValueDictionary.__getstate__", "Helper for pickle."), - ("builtins._WeakValueDictionary.__gt__", "Return self>value."), - ("builtins._WeakValueDictionary.__hash__", "Return hash(self)."), - ("builtins._WeakValueDictionary.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._WeakValueDictionary.__le__", "Return self<=value."), - ("builtins._WeakValueDictionary.__lt__", "Return self=value."), - ("builtins._WorkRep.__getattribute__", "Return getattr(self, name)."), - ("builtins._WorkRep.__getstate__", "Helper for pickle."), - ("builtins._WorkRep.__gt__", "Return self>value."), - ("builtins._WorkRep.__hash__", "Return hash(self)."), - ("builtins._WorkRep.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._WorkRep.__le__", "Return self<=value."), - ("builtins._WorkRep.__lt__", "Return self=value."), - ("builtins._WritelnDecorator.__getattribute__", "Return getattr(self, name)."), - ("builtins._WritelnDecorator.__getstate__", "Helper for pickle."), - ("builtins._WritelnDecorator.__gt__", "Return self>value."), - ("builtins._WritelnDecorator.__hash__", "Return hash(self)."), - ("builtins._WritelnDecorator.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._WritelnDecorator.__le__", "Return self<=value."), - ("builtins._WritelnDecorator.__lt__", "Return self=value."), - ("builtins._auto_null.__getattribute__", "Return getattr(self, name)."), - ("builtins._auto_null.__getstate__", "Helper for pickle."), - ("builtins._auto_null.__gt__", "Return self>value."), - ("builtins._auto_null.__hash__", "Return hash(self)."), - ("builtins._auto_null.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._auto_null.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._auto_null.__le__", "Return self<=value."), - ("builtins._auto_null.__lt__", "Return self=value."), - ("builtins._del_safe.__getattribute__", "Return getattr(self, name)."), - ("builtins._del_safe.__getstate__", "Helper for pickle."), - ("builtins._del_safe.__gt__", "Return self>value."), - ("builtins._del_safe.__hash__", "Return hash(self)."), - ("builtins._del_safe.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._del_safe.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._del_safe.__le__", "Return self<=value."), - ("builtins._del_safe.__lt__", "Return self=value."), - ("builtins._empty.__getattribute__", "Return getattr(self, name)."), - ("builtins._empty.__getstate__", "Helper for pickle."), - ("builtins._empty.__gt__", "Return self>value."), - ("builtins._empty.__hash__", "Return hash(self)."), - ("builtins._empty.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._empty.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._empty.__le__", "Return self<=value."), - ("builtins._empty.__lt__", "Return self=value."), - ("builtins._incompatible_extension_module_restrictions.__getattribute__", "Return getattr(self, name)."), - ("builtins._incompatible_extension_module_restrictions.__getstate__", "Helper for pickle."), - ("builtins._incompatible_extension_module_restrictions.__gt__", "Return self>value."), - ("builtins._incompatible_extension_module_restrictions.__hash__", "Return hash(self)."), - ("builtins._incompatible_extension_module_restrictions.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._incompatible_extension_module_restrictions.__le__", "Return self<=value."), - ("builtins._incompatible_extension_module_restrictions.__lt__", "Return self=value."), - ("builtins._localimpl.__getattribute__", "Return getattr(self, name)."), - ("builtins._localimpl.__getstate__", "Helper for pickle."), - ("builtins._localimpl.__gt__", "Return self>value."), - ("builtins._localimpl.__hash__", "Return hash(self)."), - ("builtins._localimpl.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._localimpl.__le__", "Return self<=value."), - ("builtins._localimpl.__lt__", "Return self=value."), - ("builtins._localized_day.__getattribute__", "Return getattr(self, name)."), - ("builtins._localized_day.__getstate__", "Helper for pickle."), - ("builtins._localized_day.__gt__", "Return self>value."), - ("builtins._localized_day.__hash__", "Return hash(self)."), - ("builtins._localized_day.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._localized_day.__le__", "Return self<=value."), - ("builtins._localized_day.__lt__", "Return self=value."), - ("builtins._localized_month.__getattribute__", "Return getattr(self, name)."), - ("builtins._localized_month.__getstate__", "Helper for pickle."), - ("builtins._localized_month.__gt__", "Return self>value."), - ("builtins._localized_month.__hash__", "Return hash(self)."), - ("builtins._localized_month.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._localized_month.__le__", "Return self<=value."), - ("builtins._localized_month.__lt__", "Return self=value."), - ("builtins._netrclex.__getattribute__", "Return getattr(self, name)."), - ("builtins._netrclex.__getstate__", "Helper for pickle."), - ("builtins._netrclex.__gt__", "Return self>value."), - ("builtins._netrclex.__hash__", "Return hash(self)."), - ("builtins._netrclex.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._netrclex.__le__", "Return self<=value."), - ("builtins._netrclex.__lt__", "Return self=value."), - ("builtins._not_given.__getattribute__", "Return getattr(self, name)."), - ("builtins._not_given.__getstate__", "Helper for pickle."), - ("builtins._not_given.__gt__", "Return self>value."), - ("builtins._not_given.__hash__", "Return hash(self)."), - ("builtins._not_given.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._not_given.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._not_given.__le__", "Return self<=value."), - ("builtins._not_given.__lt__", "Return self=value."), - ("builtins._proto_member.__getattribute__", "Return getattr(self, name)."), - ("builtins._proto_member.__getstate__", "Helper for pickle."), - ("builtins._proto_member.__gt__", "Return self>value."), - ("builtins._proto_member.__hash__", "Return hash(self)."), - ("builtins._proto_member.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._proto_member.__le__", "Return self<=value."), - ("builtins._proto_member.__lt__", "Return self=value."), - ("builtins._safe_key.__getattribute__", "Return getattr(self, name)."), - ("builtins._safe_key.__getstate__", "Helper for pickle."), - ("builtins._safe_key.__gt__", "Return self>value."), - ("builtins._safe_key.__hash__", "Return hash(self)."), - ("builtins._safe_key.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._safe_key.__le__", "Return self<=value."), - ("builtins._safe_key.__ne__", "Return self!=value."), - ("builtins._safe_key.__new__", "Create and return a new object. See help(type) for accurate signature."), - ("builtins._safe_key.__reduce__", "Helper for pickle."), - ("builtins._safe_key.__reduce_ex__", "Helper for pickle."), - ("builtins._safe_key.__repr__", "Return repr(self)."), - ("builtins._safe_key.__setattr__", "Implement setattr(self, name, value)."), - ("builtins._safe_key.__sizeof__", "Size of object in memory, in bytes."), - ("builtins._safe_key.__str__", "Return str(self)."), - ("builtins._safe_key.__subclasshook__", "Abstract classes can override this to customize issubclass().\n\nThis is invoked early on by abc.ABCMeta.__subclasscheck__().\nIt should return True, False or NotImplemented. If it returns\nNotImplemented, the normal algorithm is used. Otherwise, it\noverrides the normal algorithm (and the outcome is cached)."), ("builtins._setit", "Internal class. It wraps the command in the widget OptionMenu."), ("builtins._setit.__delattr__", "Implement delattr(self, name)."), ("builtins._setit.__eq__", "Return self==value."), @@ -24438,47 +15818,6 @@ pub const DB: &[(&str, &str)] = &[ ("builtins._setit.__str__", "Return str(self)."), ("builtins._setit.__subclasshook__", "Abstract classes can override this to customize issubclass().\n\nThis is invoked early on by abc.ABCMeta.__subclasscheck__().\nIt should return True, False or NotImplemented. If it returns\nNotImplemented, the normal algorithm is used. Otherwise, it\noverrides the normal algorithm (and the outcome is cached)."), ("builtins._setit.__weakref__", "list of weak references to the object"), - ("builtins._singledispatchmethod_get.__delattr__", "Implement delattr(self, name)."), - ("builtins._singledispatchmethod_get.__eq__", "Return self==value."), - ("builtins._singledispatchmethod_get.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins._singledispatchmethod_get.__ge__", "Return self>=value."), - ("builtins._singledispatchmethod_get.__getattribute__", "Return getattr(self, name)."), - ("builtins._singledispatchmethod_get.__getstate__", "Helper for pickle."), - ("builtins._singledispatchmethod_get.__gt__", "Return self>value."), - ("builtins._singledispatchmethod_get.__hash__", "Return hash(self)."), - ("builtins._singledispatchmethod_get.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._singledispatchmethod_get.__le__", "Return self<=value."), - ("builtins._singledispatchmethod_get.__lt__", "Return self=value."), - ("builtins._swapped_meta.__getattribute__", "Return getattr(self, name)."), - ("builtins._swapped_meta.__getstate__", "Helper for pickle."), - ("builtins._swapped_meta.__gt__", "Return self>value."), - ("builtins._swapped_meta.__hash__", "Return hash(self)."), - ("builtins._swapped_meta.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._swapped_meta.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._swapped_meta.__le__", "Return self<=value."), - ("builtins._swapped_meta.__lt__", "Return self=value."), - ("builtins._void.__getattribute__", "Return getattr(self, name)."), - ("builtins._void.__getstate__", "Helper for pickle."), - ("builtins._void.__gt__", "Return self>value."), - ("builtins._void.__hash__", "Return hash(self)."), - ("builtins._void.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins._void.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._void.__le__", "Return self<=value."), - ("builtins._void.__lt__", "Return self=value."), - ("builtins._wrap_close.__getattribute__", "Return getattr(self, name)."), - ("builtins._wrap_close.__getstate__", "Helper for pickle."), - ("builtins._wrap_close.__gt__", "Return self>value."), - ("builtins._wrap_close.__hash__", "Return hash(self)."), - ("builtins._wrap_close.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins._wrap_close.__le__", "Return self<=value."), - ("builtins._wrap_close.__lt__", "Return self=value."), - ("builtins.auto.__getattribute__", "Return getattr(self, name)."), - ("builtins.auto.__getstate__", "Helper for pickle."), - ("builtins.auto.__gt__", "Return self>value."), - ("builtins.auto.__hash__", "Return hash(self)."), - ("builtins.auto.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.auto.__le__", "Return self<=value."), - ("builtins.auto.__lt__", "Return self>> for batch in batched('ABCDEFG', 3):\n ... print(batch)\n ...\n ('A', 'B', 'C')\n ('D', 'E', 'F')\n ('G',)\n\nIf \"strict\" is True, raises a ValueError if the final batch is shorter\nthan n."), ("builtins.batched.__delattr__", "Implement delattr(self, name)."), ("builtins.batched.__eq__", "Return self==value."), @@ -25265,28 +16539,6 @@ pub const DB: &[(&str, &str)] = &[ ("builtins.bytes_iterator.__sizeof__", "Size of object in memory, in bytes."), ("builtins.bytes_iterator.__str__", "Return str(self)."), ("builtins.bytes_iterator.__subclasshook__", "Abstract classes can override this to customize issubclass().\n\nThis is invoked early on by abc.ABCMeta.__subclasscheck__().\nIt should return True, False or NotImplemented. If it returns\nNotImplemented, the normal algorithm is used. Otherwise, it\noverrides the normal algorithm (and the outcome is cached)."), - ("builtins.cached_property.__class_getitem__", "Represent a PEP 585 generic type\n\nFor example, for t = list[int], t.__origin__ is list and t.__args__\nis (int,)."), - ("builtins.cached_property.__delattr__", "Implement delattr(self, name)."), - ("builtins.cached_property.__eq__", "Return self==value."), - ("builtins.cached_property.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.cached_property.__ge__", "Return self>=value."), - ("builtins.cached_property.__getattribute__", "Return getattr(self, name)."), - ("builtins.cached_property.__getstate__", "Helper for pickle."), - ("builtins.cached_property.__gt__", "Return self>value."), - ("builtins.cached_property.__hash__", "Return hash(self)."), - ("builtins.cached_property.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.cached_property.__le__", "Return self<=value."), - ("builtins.cached_property.__lt__", "Return self=value."), - ("builtins.catch_warnings.__getattribute__", "Return getattr(self, name)."), - ("builtins.catch_warnings.__getstate__", "Helper for pickle."), - ("builtins.catch_warnings.__gt__", "Return self>value."), - ("builtins.catch_warnings.__hash__", "Return hash(self)."), - ("builtins.catch_warnings.__init__", "Specify whether to record warnings and if an alternative module\nshould be used other than sys.modules['warnings']."), - ("builtins.catch_warnings.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.catch_warnings.__le__", "Return self<=value."), - ("builtins.catch_warnings.__lt__", "Return self int: ...\n @overload\n def g(x: str) -> int: ...\n\nThe warning specified by *category* will be emitted at runtime\non use of deprecated objects. For functions, that happens on calls;\nfor classes, on instantiation and on creation of subclasses.\nIf the *category* is ``None``, no warning is emitted at runtime.\nThe *stacklevel* determines where the\nwarning is emitted. If it is ``1`` (the default), the warning\nis emitted at the direct caller of the deprecated object; if it\nis higher, it is emitted further up the stack.\nStatic type checker behavior is not affected by the *category*\nand *stacklevel* arguments.\n\nThe deprecation message passed to the decorator is saved in the\n``__deprecated__`` attribute on the decorated object.\nIf applied to an overload, the decorator\nmust be after the ``@overload`` decorator for the attribute to\nexist on the overload as returned by ``get_overloads()``.\n\nSee PEP 702 for details."), - ("builtins.deprecated.__delattr__", "Implement delattr(self, name)."), - ("builtins.deprecated.__eq__", "Return self==value."), - ("builtins.deprecated.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.deprecated.__ge__", "Return self>=value."), - ("builtins.deprecated.__getattribute__", "Return getattr(self, name)."), - ("builtins.deprecated.__getstate__", "Helper for pickle."), - ("builtins.deprecated.__gt__", "Return self>value."), - ("builtins.deprecated.__hash__", "Return hash(self)."), - ("builtins.deprecated.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.deprecated.__le__", "Return self<=value."), - ("builtins.deprecated.__lt__", "Return self=value."), - ("builtins.different_locale.__getattribute__", "Return getattr(self, name)."), - ("builtins.different_locale.__getstate__", "Helper for pickle."), - ("builtins.different_locale.__gt__", "Return self>value."), - ("builtins.different_locale.__hash__", "Return hash(self)."), - ("builtins.different_locale.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.different_locale.__le__", "Return self<=value."), - ("builtins.different_locale.__lt__", "Return self list of strings\n\nIf called without an argument, return the names in the current scope.\nElse, return an alphabetized list of names comprising (some of) the\nattributes of the given object, and of attributes reachable from it.\nIf the object supplies a method named __dir__, it will be used;\notherwise the default dir() logic is used and returns:\n for a module object: the module's attributes.\n for a class object: its attributes, and recursively the attributes\n of its bases.\n for any other object: its attributes, its class's attributes, and\n recursively the attributes of its class's base classes."), - ("builtins.dircmp", "A class that manages the comparison of 2 directories.\n\ndircmp(a, b, ignore=None, hide=None, *, shallow=True)\n A and B are directories.\n IGNORE is a list of names to ignore,\n defaults to DEFAULT_IGNORES.\n HIDE is a list of names to hide,\n defaults to [os.curdir, os.pardir].\n SHALLOW specifies whether to just check the stat signature (do not read\n the files).\n defaults to True.\n\nHigh level usage:\n x = dircmp(dir1, dir2)\n x.report() -> prints a report on the differences between dir1 and dir2\n or\n x.report_partial_closure() -> prints report on differences between dir1\n and dir2, and reports on common immediate subdirectories.\n x.report_full_closure() -> like report_partial_closure,\n but fully recursive.\n\nAttributes:\n left_list, right_list: The files in dir1 and dir2,\n filtered by hide and ignore.\n common: a list of names in both dir1 and dir2.\n left_only, right_only: names only in dir1, dir2.\n common_dirs: subdirectories in both dir1 and dir2.\n common_files: files in both dir1 and dir2.\n common_funny: names in both dir1 and dir2 where the type differs between\n dir1 and dir2, or the name is not stat-able.\n same_files: list of identical files.\n diff_files: list of filenames which differ.\n funny_files: list of files which could not be compared.\n subdirs: a dictionary of dircmp instances (or MyDirCmp instances if this\n object is of type MyDirCmp, a subclass of dircmp), keyed by names\n in common_dirs."), - ("builtins.dircmp.__class_getitem__", "Represent a PEP 585 generic type\n\nFor example, for t = list[int], t.__origin__ is list and t.__args__\nis (int,)."), - ("builtins.dircmp.__delattr__", "Implement delattr(self, name)."), - ("builtins.dircmp.__eq__", "Return self==value."), - ("builtins.dircmp.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.dircmp.__ge__", "Return self>=value."), - ("builtins.dircmp.__getattribute__", "Return getattr(self, name)."), - ("builtins.dircmp.__getstate__", "Helper for pickle."), - ("builtins.dircmp.__gt__", "Return self>value."), - ("builtins.dircmp.__hash__", "Return hash(self)."), - ("builtins.dircmp.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.dircmp.__le__", "Return self<=value."), - ("builtins.dircmp.__lt__", "Return self=value."), - ("builtins.fake_code.__getattribute__", "Return getattr(self, name)."), - ("builtins.fake_code.__getstate__", "Helper for pickle."), - ("builtins.fake_code.__gt__", "Return self>value."), - ("builtins.fake_code.__hash__", "Return hash(self)."), - ("builtins.fake_code.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.fake_code.__le__", "Return self<=value."), - ("builtins.fake_code.__lt__", "Return self=value."), - ("builtins.fake_frame.__getattribute__", "Return getattr(self, name)."), - ("builtins.fake_frame.__getstate__", "Helper for pickle."), - ("builtins.fake_frame.__gt__", "Return self>value."), - ("builtins.fake_frame.__hash__", "Return hash(self)."), - ("builtins.fake_frame.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.fake_frame.__le__", "Return self<=value."), - ("builtins.fake_frame.__lt__", "Return self=value."), - ("builtins.finalize._Info.__getattribute__", "Return getattr(self, name)."), - ("builtins.finalize._Info.__getstate__", "Helper for pickle."), - ("builtins.finalize._Info.__gt__", "Return self>value."), - ("builtins.finalize._Info.__hash__", "Return hash(self)."), - ("builtins.finalize._Info.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.finalize._Info.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.finalize._Info.__le__", "Return self<=value."), - ("builtins.finalize._Info.__lt__", "Return self=value."), - ("builtins.finalize.__getattribute__", "Return getattr(self, name)."), - ("builtins.finalize.__getstate__", "Helper for pickle."), - ("builtins.finalize.__gt__", "Return self>value."), - ("builtins.finalize.__hash__", "Return hash(self)."), - ("builtins.finalize.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.finalize.__le__", "Return self<=value."), - ("builtins.finalize.__lt__", "Return self=value."), - ("builtins.local.__getstate__", "Helper for pickle."), - ("builtins.local.__gt__", "Return self>value."), - ("builtins.local.__hash__", "Return hash(self)."), - ("builtins.local.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.local.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.local.__le__", "Return self<=value."), - ("builtins.local.__lt__", "Return self=value."), - ("builtins.member.__getattribute__", "Return getattr(self, name)."), - ("builtins.member.__getstate__", "Helper for pickle."), - ("builtins.member.__gt__", "Return self>value."), - ("builtins.member.__hash__", "Return hash(self)."), - ("builtins.member.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.member.__le__", "Return self<=value."), - ("builtins.member.__lt__", "Return self=value."), - ("builtins.netrc.__getattribute__", "Return getattr(self, name)."), - ("builtins.netrc.__getstate__", "Helper for pickle."), - ("builtins.netrc.__gt__", "Return self>value."), - ("builtins.netrc.__hash__", "Return hash(self)."), - ("builtins.netrc.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.netrc.__le__", "Return self<=value."), - ("builtins.netrc.__lt__", "Return self=value."), - ("builtins.nonmember.__getattribute__", "Return getattr(self, name)."), - ("builtins.nonmember.__getstate__", "Helper for pickle."), - ("builtins.nonmember.__gt__", "Return self>value."), - ("builtins.nonmember.__hash__", "Return hash(self)."), - ("builtins.nonmember.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.nonmember.__le__", "Return self<=value."), - ("builtins.nonmember.__lt__", "Return self=value."), - ("builtins.partialmethod.__getattribute__", "Return getattr(self, name)."), - ("builtins.partialmethod.__getstate__", "Helper for pickle."), - ("builtins.partialmethod.__gt__", "Return self>value."), - ("builtins.partialmethod.__hash__", "Return hash(self)."), - ("builtins.partialmethod.__init__", "Initialize self. See help(type(self)) for accurate signature."), - ("builtins.partialmethod.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.partialmethod.__le__", "Return self<=value."), - ("builtins.partialmethod.__lt__", "Return self (0,1), (0,2), (1,0), (1,2), (2,0), (2,1)"), ("builtins.permutations.__delattr__", "Implement delattr(self, name)."), ("builtins.permutations.__eq__", "Return self==value."), @@ -28140,34 +19109,6 @@ pub const DB: &[(&str, &str)] = &[ ("builtins.reversed.__str__", "Return str(self)."), ("builtins.reversed.__subclasshook__", "Abstract classes can override this to customize issubclass().\n\nThis is invoked early on by abc.ABCMeta.__subclasscheck__().\nIt should return True, False or NotImplemented. If it returns\nNotImplemented, the normal algorithm is used. Otherwise, it\noverrides the normal algorithm (and the outcome is cached)."), ("builtins.round", "Round a number to a given precision in decimal digits.\n\nThe return value is an integer if ndigits is omitted or None.\nOtherwise the return value has the same type as the number. ndigits\nmay be negative."), - ("builtins.scheduler.__delattr__", "Implement delattr(self, name)."), - ("builtins.scheduler.__eq__", "Return self==value."), - ("builtins.scheduler.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.scheduler.__ge__", "Return self>=value."), - ("builtins.scheduler.__getattribute__", "Return getattr(self, name)."), - ("builtins.scheduler.__getstate__", "Helper for pickle."), - ("builtins.scheduler.__gt__", "Return self>value."), - ("builtins.scheduler.__hash__", "Return hash(self)."), - ("builtins.scheduler.__init__", "Initialize a new instance, passing the time and delay\nfunctions"), - ("builtins.scheduler.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.scheduler.__le__", "Return self<=value."), - ("builtins.scheduler.__lt__", "Return self=value."), - ("builtins.shlex.__getattribute__", "Return getattr(self, name)."), - ("builtins.shlex.__getstate__", "Helper for pickle."), - ("builtins.shlex.__gt__", "Return self>value."), - ("builtins.shlex.__hash__", "Return hash(self)."), - ("builtins.shlex.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.shlex.__le__", "Return self<=value."), - ("builtins.shlex.__lt__", "Return self=value."), - ("builtins.singledispatchmethod.__getattribute__", "Return getattr(self, name)."), - ("builtins.singledispatchmethod.__getstate__", "Helper for pickle."), - ("builtins.singledispatchmethod.__gt__", "Return self>value."), - ("builtins.singledispatchmethod.__hash__", "Return hash(self)."), - ("builtins.singledispatchmethod.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.singledispatchmethod.__le__", "Return self<=value."), - ("builtins.singledispatchmethod.__lt__", "Return self func\n\nRegisters a new implementation for the given *cls* on a *generic_method*."), ("builtins.slice", "slice(stop)\nslice(start, stop[, step])\n\nCreate a slice object.\n\nThis is used for extended slicing (e.g. a[0:10:2])."), ("builtins.slice.__delattr__", "Implement delattr(self, name)."), ("builtins.slice.__eq__", "Return self==value."), @@ -28854,18 +19745,12 @@ pub const DB: &[(&str, &str)] = &[ ("builtins.time.__sizeof__", "Size of object in memory, in bytes."), ("builtins.time.__str__", "Return the time formatted according to ISO.\n\nThe full format is 'HH:MM:SS.mmmmmm+zz:zz'. By default, the fractional\npart is omitted if self.microsecond == 0.\n\nThe optional argument timespec specifies the number of additional\nterms of the time to include. Valid options are 'auto', 'hours',\n'minutes', 'seconds', 'milliseconds' and 'microseconds'."), ("builtins.time.__subclasshook__", "Abstract classes can override this to customize issubclass().\n\nThis is invoked early on by abc.ABCMeta.__subclasscheck__().\nIt should return True, False or NotImplemented. If it returns\nNotImplemented, the normal algorithm is used. Otherwise, it\noverrides the normal algorithm (and the outcome is cached)."), - ("builtins.time._tzstr", "Return formatted timezone offset (+xx:xx) or an empty string."), ("builtins.time.dst", "Return 0 if DST is not in effect, or the DST offset (as timedelta\npositive eastward) if DST is in effect.\n\nThis is purely informational; the DST offset has already been added to\nthe UTC offset returned by utcoffset() if applicable, so there's no\nneed to consult dst() unless you're interested in displaying the DST\ninfo."), ("builtins.time.fromisoformat", "Construct a time from a string in one of the ISO 8601 formats."), - ("builtins.time.hour", "hour (0-23)"), ("builtins.time.isoformat", "Return the time formatted according to ISO.\n\nThe full format is 'HH:MM:SS.mmmmmm+zz:zz'. By default, the fractional\npart is omitted if self.microsecond == 0.\n\nThe optional argument timespec specifies the number of additional\nterms of the time to include. Valid options are 'auto', 'hours',\n'minutes', 'seconds', 'milliseconds' and 'microseconds'."), - ("builtins.time.microsecond", "microsecond (0-999999)"), - ("builtins.time.minute", "minute (0-59)"), ("builtins.time.replace", "Return a new time with new values for the specified fields."), - ("builtins.time.second", "second (0-59)"), ("builtins.time.strftime", "Format using strftime(). The date part of the timestamp passed\nto underlying strftime should not be used."), ("builtins.time.strptime", "string, format -> new time parsed from a string (like time.strptime())."), - ("builtins.time.tzinfo", "timezone info object"), ("builtins.time.tzname", "Return the timezone name.\n\nNote that the name is 100% informational -- there's no requirement that\nit mean anything in particular. For example, \"GMT\", \"UTC\", \"-500\",\n\"-5:00\", \"EDT\", \"US/Eastern\", \"America/New York\" are all valid replies."), ("builtins.time.utcoffset", "Return the timezone offset as timedelta, positive east of UTC\n(negative west of UTC)."), ("builtins.timedelta", "Represent the difference between two datetime objects.\n\nSupported operators:\n\n- add, subtract timedelta\n- unary plus, minus, abs\n- compare to timedelta\n- multiply, divide by int\n\nIn addition, datetime supports subtraction of two datetime objects\nreturning a timedelta, and addition or subtraction of a datetime\nand a timedelta giving a datetime.\n\nRepresentation: (days, seconds, microseconds)."), @@ -29184,28 +20069,6 @@ pub const DB: &[(&str, &str)] = &[ ("builtins.values.__str__", "Return str(self)."), ("builtins.values.__subclasshook__", "Abstract classes can override this to customize issubclass().\n\nThis is invoked early on by abc.ABCMeta.__subclasscheck__().\nIt should return True, False or NotImplemented. If it returns\nNotImplemented, the normal algorithm is used. Otherwise, it\noverrides the normal algorithm (and the outcome is cached)."), ("builtins.vars", "vars([object]) -> dictionary\n\nWithout arguments, equivalent to locals().\nWith an argument, equivalent to object.__dict__."), - ("builtins.verify", "Check an enumeration for various constraints. (see EnumCheck)"), - ("builtins.verify.__delattr__", "Implement delattr(self, name)."), - ("builtins.verify.__eq__", "Return self==value."), - ("builtins.verify.__format__", "Default object formatter.\n\nReturn str(self) if format_spec is empty. Raise TypeError otherwise."), - ("builtins.verify.__ge__", "Return self>=value."), - ("builtins.verify.__getattribute__", "Return getattr(self, name)."), - ("builtins.verify.__getstate__", "Helper for pickle."), - ("builtins.verify.__gt__", "Return self>value."), - ("builtins.verify.__hash__", "Return hash(self)."), - ("builtins.verify.__init_subclass__", "This method is called when a class is subclassed.\n\nThe default implementation does nothing. It may be\noverridden to extend subclasses."), - ("builtins.verify.__le__", "Return self<=value."), - ("builtins.verify.__lt__", "Return self Date: Sun, 27 Sep 2026 00:31:17 +0900 Subject: [PATCH 2/2] Store database docstrings xz-compressed behind an optional doc feature - rustpython-doc's build script compresses all database docstrings into one xz blob with an offset index; identical texts share one offset. - Macros emit blob references for database docs; vm decompresses the blob on first access. - New `doc` cargo feature (default on) in rustpython, rustpython-vm and rustpython-stdlib. Without it the blob and xz are not linked and database-backed __doc__ is None; __text_signature__ is unaffected. - Native types without a docstring get __doc__ = None in their dict. - Workflows that build with --no-default-features enable `doc` where tests or releases need docstrings. Assisted-by: Claude:claude-opus-5-5 Assisted-by: Grok:grok-4.7 --- .github/workflows/ci.yaml | 6 +- .github/workflows/cron-ci.yaml | 4 +- .github/workflows/release.yml | 4 +- .github/workflows/update-caches.yml | 2 +- Cargo.lock | 5 + Cargo.toml | 5 +- crates/capi/src/descrobject.rs | 7 +- crates/capi/src/methodobject.rs | 8 +- crates/derive-impl/src/class_docs.rs | 58 ++++++++-- crates/derive-impl/src/pyclass.rs | 109 ++++++++++++------- crates/derive-impl/src/pymodule.rs | 49 ++++----- crates/derive-impl/src/pystructseq.rs | 23 ++-- crates/derive-impl/src/util.rs | 56 +++++++--- crates/doc/Cargo.toml | 6 + crates/doc/build.rs | 145 +++++++++++++++++++++++++ crates/doc/src/lib.rs | 82 +++++++++----- crates/stdlib/Cargo.toml | 3 +- crates/vm/Cargo.toml | 5 +- crates/vm/src/builtins/builtin_func.rs | 6 +- crates/vm/src/builtins/descriptor.rs | 31 +++--- crates/vm/src/builtins/getset.rs | 17 +-- crates/vm/src/builtins/type.rs | 25 +++-- crates/vm/src/class.rs | 117 +++++++++++++------- crates/vm/src/codecs.rs | 4 + crates/vm/src/function/doctext.rs | 94 ++++++++++++++++ crates/vm/src/function/method.rs | 51 ++++++++- crates/vm/src/function/mod.rs | 4 +- crates/vm/src/function/signature.rs | 21 +++- crates/vm/src/macros.rs | 1 + crates/vm/src/stdlib/_ast/python.rs | 6 +- crates/vm/src/stdlib/posix.rs | 2 +- crates/vm/src/stdlib/sys.rs | 2 +- crates/vm/src/types/slot.rs | 6 +- crates/vm/src/types/structseq.rs | 2 +- crates/vm/src/vm/context.rs | 18 +-- crates/vm/src/vm/mod.rs | 6 +- crates/vm/src/vm/vm_new.rs | 18 ++- crates/wasm/Cargo.toml | 7 +- 38 files changed, 760 insertions(+), 255 deletions(-) create mode 100644 crates/doc/build.rs create mode 100644 crates/vm/src/function/doctext.rs diff --git a/.github/workflows/ci.yaml b/.github/workflows/ci.yaml index 81021c5b7e2..8945600eef8 100644 --- a/.github/workflows/ci.yaml +++ b/.github/workflows/ci.yaml @@ -19,8 +19,8 @@ concurrency: cancel-in-progress: true env: - CARGO_ARGS: --no-default-features --features stdlib,importlib,stdio,encodings,sqlite,ssl-rustls-aws-lc,host_env - CARGO_ARGS_NO_SSL: --no-default-features --features stdlib,importlib,stdio,encodings,sqlite,host_env + CARGO_ARGS: --no-default-features --features stdlib,importlib,stdio,encodings,sqlite,ssl-rustls-aws-lc,host_env,doc + CARGO_ARGS_NO_SSL: --no-default-features --features stdlib,importlib,stdio,encodings,sqlite,host_env,doc # Crates excluded from workspace builds: # - rustpython_wasm: requires wasm target # - rustpython-venvlauncher: Windows-only @@ -1052,7 +1052,7 @@ jobs: - name: build rustpython if: env.RUN_WASM_WASI == 'true' - run: cargo build --locked --profile wasm-release --target wasm32-wasip1 --no-default-features --features freeze-stdlib,stdlib,stdio,importlib,host_env --verbose + run: cargo build --locked --profile wasm-release --target wasm32-wasip1 --no-default-features --features freeze-stdlib,stdlib,stdio,importlib,host_env,doc --verbose - name: run snippets if: env.RUN_WASM_WASI == 'true' run: | diff --git a/.github/workflows/cron-ci.yaml b/.github/workflows/cron-ci.yaml index f513e757e54..eb352dc5f6c 100644 --- a/.github/workflows/cron-ci.yaml +++ b/.github/workflows/cron-ci.yaml @@ -14,7 +14,7 @@ on: - .github/workflows/cron-ci.yaml env: - CARGO_ARGS: --no-default-features --features stdlib,importlib,stdio,encodings,ssl-rustls-aws-lc,jit,host_env + CARGO_ARGS: --no-default-features --features stdlib,importlib,stdio,encodings,ssl-rustls-aws-lc,jit,host_env,doc jobs: # codecov collects code coverage data from the rust tests, python snippets and python test suite. @@ -42,7 +42,7 @@ jobs: - run: sudo apt-get update && sudo apt-get -y install lcov - name: Run cargo-llvm-cov with Rust tests. - run: cargo llvm-cov --no-report --workspace --exclude rustpython_wasm --exclude rustpython-venvlauncher --exclude rustpython-capi --verbose --no-default-features --features stdlib,importlib,stdio,encodings,ssl-rustls-aws-lc,jit,host_env + run: cargo llvm-cov --no-report --workspace --exclude rustpython_wasm --exclude rustpython-venvlauncher --exclude rustpython-capi --verbose --no-default-features --features stdlib,importlib,stdio,encodings,ssl-rustls-aws-lc,jit,host_env,doc - name: Run cargo-llvm-cov with Python snippets. run: python scripts/cargo-llvm-cov.py diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 6fa03af2373..9291f9f3754 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -75,7 +75,7 @@ jobs: libtool: true - name: Build RustPython - run: cargo build --release --target=${{ matrix.target }} --verbose --no-default-features --features stdlib,stdio,importlib,encodings,sqlite,host_env,ssl-rustls-aws-lc,threading,jit + run: cargo build --release --target=${{ matrix.target }} --verbose --no-default-features --features stdlib,stdio,importlib,encodings,sqlite,host_env,ssl-rustls-aws-lc,threading,jit,doc - name: Rename Binary run: cp target/${{ matrix.target }}/release/rustpython target/rustpython-release-${{ runner.os }}-${{ matrix.target }} @@ -107,7 +107,7 @@ jobs: targets: wasm32-wasip1 - name: Build RustPython - run: cargo build --target wasm32-wasip1 --no-default-features --features freeze-stdlib,stdlib --release + run: cargo build --target wasm32-wasip1 --no-default-features --features freeze-stdlib,stdlib,doc --release - name: Rename Binary run: cp target/wasm32-wasip1/release/rustpython.wasm target/rustpython-release-wasm32-wasip1.wasm diff --git a/.github/workflows/update-caches.yml b/.github/workflows/update-caches.yml index 59ff6006fc8..ae4e3edb509 100644 --- a/.github/workflows/update-caches.yml +++ b/.github/workflows/update-caches.yml @@ -20,7 +20,7 @@ env: CARGO_PROFILE_DEV_DEBUG: 0 CARGO_PROFILE_RELEASE_DEBUG: 0 # Keep feature list in sync with CI's release build in .github/workflows/ci.yaml. - CARGO_ARGS: --workspace --no-default-features --features stdlib,importlib,stdio,encodings,sqlite,ssl-rustls-aws-lc,host_env,threading,jit --exclude rustpython_wasm --exclude rustpython-venvlauncher + CARGO_ARGS: --workspace --no-default-features --features stdlib,importlib,stdio,encodings,sqlite,ssl-rustls-aws-lc,host_env,threading,jit,doc --exclude rustpython_wasm --exclude rustpython-venvlauncher jobs: build-caches: diff --git a/Cargo.lock b/Cargo.lock index ad7516f882f..344a14cfd0f 100644 --- a/Cargo.lock +++ b/Cargo.lock @@ -3858,6 +3858,9 @@ dependencies = [ [[package]] name = "rustpython-doc" version = "0.6.0" +dependencies = [ + "xz", +] [[package]] name = "rustpython-host_env" @@ -4140,6 +4143,7 @@ dependencies = [ "rustpython-compiler", "rustpython-compiler-core", "rustpython-derive", + "rustpython-doc", "rustpython-host_env", "rustpython-jit", "rustpython-literal", @@ -4157,6 +4161,7 @@ dependencies = [ "thiserror", "wasm-bindgen", "widestring", + "xz", ] [[package]] diff --git a/Cargo.toml b/Cargo.toml index a4fff779fb9..9f746a5ab9d 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -11,7 +11,8 @@ license.workspace = true [features] capi = ["dep:rustpython-capi", "threading"] -default = ["threading", "stdlib", "stdio", "importlib", "ssl-rustls-aws-lc", "host_env", "mimalloc"] +default = ["threading", "stdlib", "stdio", "importlib", "ssl-rustls-aws-lc", "host_env", "mimalloc", "doc"] +doc = ["rustpython-vm/doc", "rustpython-stdlib?/doc"] mimalloc = ["dep:mimalloc"] host_env = ["rustpython-vm/host_env", "rustpython-stdlib?/host_env"] importlib = ["rustpython-vm/importlib"] @@ -39,7 +40,7 @@ winresource = "0.1" rustpython-capi = { workspace = true, optional = true } rustpython-compiler = { workspace = true } rustpython-pylib = { workspace = true, optional = true } -rustpython-stdlib = { workspace = true, optional = true, features = ["compiler"] } +rustpython-stdlib = { workspace = true, optional = true, default-features = false, features = ["compiler"] } rustpython-vm = { workspace = true, features = ["compiler", "gc"] } log = { workspace = true } diff --git a/crates/capi/src/descrobject.rs b/crates/capi/src/descrobject.rs index 60cbe492c83..5c7001554df 100644 --- a/crates/capi/src/descrobject.rs +++ b/crates/capi/src/descrobject.rs @@ -9,7 +9,7 @@ use rustpython_vm::builtins::{ PyMappingProxy, PyMemberDescriptor, PyType, }; use rustpython_vm::common::lock::PyRwLock; -use rustpython_vm::function::PySetterValue; +use rustpython_vm::function::{ItemDoc, PySetterValue}; use rustpython_vm::{Py, PyObjectRef, PyPayload, PyRef, PyResult, VirtualMachine}; #[repr(C)] @@ -134,7 +134,10 @@ impl PyMemberDef { flags &= !PY_RELATIVE_OFFSET; } - let doc = unsafe { self.doc.try_as_str_opt(vm) }?.map(str::to_owned); + let doc = unsafe { self.doc.try_as_str_opt(vm) }?.map_or(ItemDoc::NONE, |doc| { + let text: &'static str = Box::leak(doc.to_owned().into_boxed_str()); + ItemDoc::static_text(text) + }); let descriptor = PyMemberDescriptor { common: PyDescriptorOwned { diff --git a/crates/capi/src/methodobject.rs b/crates/capi/src/methodobject.rs index 7376e412f1d..ac3620a6763 100644 --- a/crates/capi/src/methodobject.rs +++ b/crates/capi/src/methodobject.rs @@ -4,7 +4,7 @@ use crate::object::define_py_check; use crate::pystate::with_vm; use crate::util::{CStrExt, FfiPtrExt}; use core::ffi::{c_char, c_int}; -use rustpython_vm::function::{FuncArgs, HeapMethodDef, PosArgs, PyMethodFlags}; +use rustpython_vm::function::{FuncArgs, HeapMethodDef, ItemDoc, PosArgs, PyMethodFlags}; use rustpython_vm::{AsObject, PyObjectRef, PyRef, PyResult, VirtualMachine}; define_py_check!(fn PyCFunction_Check, types.builtin_function_or_method_type); @@ -49,6 +49,12 @@ pub(crate) fn build_method_def( let name = unsafe { ml.ml_name.try_as_str(vm) }?; let doc = unsafe { ml.ml_doc.try_as_str_opt(vm) }?; + let doc = doc + .filter(|doc| !doc.is_empty()) + .map_or(ItemDoc::NONE, |doc| { + let text: &'static str = Box::leak(doc.to_owned().into_boxed_str()); + ItemDoc::static_text(text) + }); let flags = PyMethodFlags::from_bits(ml.ml_flags as u32) .ok_or_else(|| vm.new_system_error("PyMethodDef contains unknown flags"))?; diff --git a/crates/derive-impl/src/class_docs.rs b/crates/derive-impl/src/class_docs.rs index 44d65a1d523..324dfea9ca0 100644 --- a/crates/derive-impl/src/class_docs.rs +++ b/crates/derive-impl/src/class_docs.rs @@ -4,6 +4,7 @@ use alloc::collections::BTreeSet; use proc_macro2::TokenStream; use quote::quote; +use rustpython_doc::DocRef; /// Modules `get_qualified` consults for `module`. fn module_aliases(module: &str) -> Vec { @@ -26,20 +27,50 @@ fn module_aliases(module: &str) -> Vec { aliases } +pub(crate) fn item_doc_tokens(doc: Option, rust_doc: Option) -> TokenStream { + if let Some(doc) = doc.filter(|doc| doc.len != 0) { + let offset = doc.offset; + let len = doc.len; + quote! { + { + #[cfg(feature = "doc")] + { + ::rustpython_vm::function::ItemDoc { + text: None, + offset: #offset, + len: #len, + } + } + #[cfg(not(feature = "doc"))] + { + ::rustpython_vm::function::ItemDoc::NONE + } + } + } + } else if let Some(rust_doc) = rust_doc { + quote!(::rustpython_vm::function::ItemDoc::static_text(#rust_doc)) + } else { + quote!(::rustpython_vm::function::ItemDoc::NONE) + } +} + /// `get_attr`, then `class_attr_doc` when that entry is missing or empty. -/// An explicit empty entry with no fallback is `Some("")`. -fn resolved_attr_doc(module_name: Option<&str>, class: &str, attr: &str) -> Option<&'static str> { +/// An explicit empty entry with no fallback is `Some` with `len == 0`. +fn resolved_attr_doc(module_name: Option<&str>, class: &str, attr: &str) -> Option { let module_key = module_name.unwrap_or("builtins"); let exact = rustpython_doc::get_attr(module_key, class, attr); let qualified = rustpython_doc::class_attr_doc(module_name, class, attr); match exact { - Some(doc) if !doc.is_empty() => Some(doc), - Some(_) => qualified.or(Some("")), + Some(doc) if doc.len != 0 => Some(doc), + Some(_) => qualified.or(Some(DocRef { offset: 0, len: 0 })), None => qualified, } } -pub(crate) fn attr_docs_tokens(module_name: Option<&str>, class: &str) -> TokenStream { +pub(crate) fn attr_docs_tokens( + module_name: Option<&str>, + class: &str, +) -> (TokenStream, TokenStream) { let module_key = module_name.unwrap_or("builtins"); let mut names = BTreeSet::new(); for module in module_aliases(module_key) { @@ -53,9 +84,16 @@ pub(crate) fn attr_docs_tokens(module_name: Option<&str>, class: &str) -> TokenS } } } - let entries = names.into_iter().filter_map(|attr| { - let doc = resolved_attr_doc(module_name, class, attr)?; - Some(quote! { (#attr, #doc) }) - }); - quote! { &[#(#entries),*] } + let mut spans = Vec::new(); + let mut name_lits = Vec::new(); + for attr in names { + let Some(doc) = resolved_attr_doc(module_name, class, attr) else { + continue; + }; + name_lits.push(quote!(#attr)); + let offset = if doc.len == 0 { u32::MAX } else { doc.offset }; + let len = doc.len; + spans.push(quote! { (#attr, #offset, #len) }); + } + (quote! { &[#(#spans),*] }, quote! { &[#(#name_lits),*] }) } diff --git a/crates/derive-impl/src/pyclass.rs b/crates/derive-impl/src/pyclass.rs index 6b21a03ced4..bf745f97304 100644 --- a/crates/derive-impl/src/pyclass.rs +++ b/crates/derive-impl/src/pyclass.rs @@ -242,7 +242,7 @@ pub(crate) fn impl_pyclass_impl(attr: PunctuatedNestedMeta, item: Item) -> Resul impl ::rustpython_vm::class::PyClassImpl for #payload_ty { const TP_FLAGS: ::rustpython_vm::types::PyTypeFlags = #flags; - const INTERNAL_DOC: Option<&'static str> = #internal_doc; + const INTERNAL_DOC: ::rustpython_vm::function::ItemDoc = #internal_doc; fn impl_extend_class( ctx: &'static ::rustpython_vm::Context, @@ -426,26 +426,36 @@ fn class_def_ty(self_ty: Option<&syn::Type>) -> Option { Some(quote!(#ty)) } -/// Const `Option<&'static str>`. A non-empty Rust doc is the docstring. +/// Const `ItemDoc`. A non-empty Rust doc is the docstring. /// The attribute table is used only when there is no Rust doc. Generic impls /// cannot name `Self` from a nested const, so without a Rust doc they store none. fn attr_doc_expr(self_ty: Option<&syn::Type>, attr: &str, rust_doc: Option) -> TokenStream { if let Some(doc) = rust_doc.filter(|doc| !doc.is_empty()) { - return quote!(Some(#doc)); + return quote!(::rustpython_vm::function::ItemDoc::static_text(#doc)); } let Some(ty) = class_def_ty(self_ty) else { - return quote!(None); + return quote!(::rustpython_vm::function::ItemDoc::NONE); }; quote! { { - const FOUND: Option<&str> = ::rustpython_vm::class::attr_doc( - <#ty as ::rustpython_vm::class::PyClassDef>::ATTR_DOCS, - #attr, - ); - if let Some(doc) = FOUND { - if doc.is_empty() { None } else { Some(doc) } - } else { - None + #[cfg(feature = "doc")] + { + const FOUND: Option<(u32, u32)> = ::rustpython_vm::class::attr_doc( + <#ty as ::rustpython_vm::class::PyClassDef>::ATTR_DOCS, + #attr, + ); + match FOUND { + Some((offset, len)) if len != 0 => ::rustpython_vm::function::ItemDoc { + text: None, + offset, + len, + }, + _ => ::rustpython_vm::function::ItemDoc::NONE, + } + } + #[cfg(not(feature = "doc"))] + { + ::rustpython_vm::function::ItemDoc::NONE } } } @@ -496,17 +506,14 @@ fn generate_class_def( ) -> Result { let attrs = extras.attrs; let module_key = module_name.unwrap_or("builtins"); - let attr_docs = crate::class_docs::attr_docs_tokens(module_name, name); - let doc = attrs.doc().filter(|doc| !doc.is_empty()).or_else(|| { - rustpython_doc::get_qualified(module_key, name, None, true) - .filter(|doc| !doc.is_empty()) - .map(str::to_owned) - }); - let doc = if let Some(doc) = doc { - quote!(Some(#doc)) + let (attr_docs, attr_names) = crate::class_docs::attr_docs_tokens(module_name, name); + let rust_doc = attrs.doc().filter(|doc| !doc.is_empty()); + let db_doc = if rust_doc.is_some() { + None } else { - quote!(None) + rustpython_doc::get_qualified(module_key, name, None, true) }; + let doc = crate::class_docs::item_doc_tokens(db_doc, rust_doc); let module_class_name = if let Some(module_name) = module_name { format!("{module_name}.{name}") } else { @@ -616,8 +623,11 @@ fn generate_class_def( const NAME: &'static str = #name; const MODULE_NAME: Option<&'static str> = #module_name; const TP_NAME: &'static str = #module_class_name; - const DOC: Option<&'static str> = #doc; - const ATTR_DOCS: &'static [(&'static str, &'static str)] = #attr_docs; + const DOC: ::rustpython_vm::function::ItemDoc = #doc; + #[cfg(feature = "doc")] + const ATTR_DOCS: &'static [(&'static str, u32, u32)] = #attr_docs; + #[cfg(not(feature = "doc"))] + const ATTR_DOCS: &'static [&'static str] = #attr_names; const BASICSIZE: usize = #basicsize; const UNHASHABLE: bool = #unhashable; const MEMBERS: &'static [::rustpython_vm::builtins::descriptor::PyMemberSpec] = #members; @@ -1588,12 +1598,12 @@ impl ToTokens for GetSetNursery { quote_spanned! { getter.span() => #( #cfgs )* { - const DOC: Option<&str> = #doc; + const DOC: ::rustpython_vm::function::ItemDoc = #doc; let mut getset = ::rustpython_vm::builtins::PyGetSet::new(#name, class, ctx) .with_get(Self::#getter) #setter; - if let Some(doc) = DOC { - getset = getset.with_doc(doc); + if DOC.text.is_some() || DOC.len != 0 { + getset = getset.with_doc(DOC); } class.set_str_attr( #name, @@ -2216,7 +2226,7 @@ fn build_member( (offset_expr, quote!(), kind_tokens) }; let doc = if meta.suppress_doc()? { - quote!(None) + quote!(::rustpython_vm::function::ItemDoc::NONE) } else { attr_doc_expr(Some(class_ty), &name, rust_doc) }; @@ -2522,7 +2532,7 @@ fn class_internal_doc( { const CHOSEN: Option<&'static [::rustpython_vm::function::Param]> = #chosen; if CHOSEN.is_none() { - None + ::rustpython_vm::function::ItemDoc::NONE } else { const ARGS: &[::rustpython_vm::function::SigArg] = &[ ::rustpython_vm::function::SigArg { @@ -2530,20 +2540,37 @@ fn class_internal_doc( params: CHOSEN, }, ]; - const DOC: &str = match <#payload as ::rustpython_vm::class::PyClassDef>::DOC { - Some(doc) => doc, - None => "", - }; + const BASE: ::rustpython_vm::function::ItemDoc = + <#payload as ::rustpython_vm::class::PyClassDef>::DOC; const NAME: &str = <#payload as ::rustpython_vm::class::PyClassDef>::NAME; - const N: usize = - ::rustpython_vm::function::internal_doc_len(NAME, ARGS, DOC); - const B: [u8; N] = - ::rustpython_vm::function::internal_doc_bytes::(NAME, ARGS, DOC); - const S: &str = match ::core::str::from_utf8(&B) { - Ok(s) => s, - Err(_) => panic!(), - }; - Some(S) + if BASE.len != 0 { + const N: usize = ::rustpython_vm::function::signature_prefix_len(NAME, ARGS); + const B: [u8; N] = + ::rustpython_vm::function::signature_prefix_bytes::(NAME, ARGS); + const PREFIX: &str = match ::core::str::from_utf8(&B) { + Ok(s) => s, + Err(_) => panic!(), + }; + ::rustpython_vm::function::ItemDoc { + text: Some(PREFIX), + offset: BASE.offset, + len: BASE.len, + } + } else { + const BODY: &str = match BASE.text { + Some(text) => text, + None => "", + }; + const N: usize = + ::rustpython_vm::function::internal_doc_len(NAME, ARGS, BODY); + const B: [u8; N] = + ::rustpython_vm::function::internal_doc_bytes::(NAME, ARGS, BODY); + const FULL: &str = match ::core::str::from_utf8(&B) { + Ok(s) => s, + Err(_) => panic!(), + }; + ::rustpython_vm::function::ItemDoc::static_text(FULL) + } } } } diff --git a/crates/derive-impl/src/pymodule.rs b/crates/derive-impl/src/pymodule.rs index c38fd6f7995..6a402e89e1f 100644 --- a/crates/derive-impl/src/pymodule.rs +++ b/crates/derive-impl/src/pymodule.rs @@ -255,16 +255,13 @@ pub(crate) fn impl_pymodule(args: PyModuleArgs, module_item: Item) -> Result Result = #doc; + pub(crate) const DOC: ::rustpython_vm::function::ItemDoc = #doc; }, parse_quote! { pub(crate) fn module_def( @@ -281,7 +278,7 @@ pub(crate) fn impl_pymodule(args: PyModuleArgs, module_item: Item) -> Result Option { +fn unique_submodule_func_doc(name: &str) -> Option { let suffix = format!(".{name}"); let mut found = None; for (key, doc) in rustpython_doc::DB { @@ -671,9 +668,9 @@ fn unique_submodule_func_doc(name: &str) -> Option { if found.is_some() { return None; } - found = Some((*doc).to_owned()); + found = Some(*doc); } - found.filter(|doc| !doc.is_empty()) + found.filter(|doc| doc.len != 0) } impl ModuleItem for FunctionItem { @@ -713,22 +710,18 @@ impl ModuleItem for FunctionItem { let docs = py_names .iter() .map(|py_name| { - let doc = rust_doc.clone().or_else(|| { - rustpython_doc::get_qualified(module, py_name, None, false) - .filter(|doc| !doc.is_empty()) - .map(str::to_owned) - .or_else(|| { - if args.context.is_sub { - unique_submodule_func_doc(py_name) - } else { - None - } - }) - }); - let doc = match doc { - Some(doc) => quote!(Some(#doc)), - None => quote!(None), + let db_doc = if rust_doc.is_some() { + None + } else { + rustpython_doc::get_qualified(module, py_name, None, false).or_else(|| { + if args.context.is_sub { + unique_submodule_func_doc(py_name) + } else { + None + } + }) }; + let doc = crate::class_docs::item_doc_tokens(db_doc, rust_doc.clone()); internal_doc_tokens(func.sig(), py_name, None, doc, None, Some("$module")) }) .collect(); diff --git a/crates/derive-impl/src/pystructseq.rs b/crates/derive-impl/src/pystructseq.rs index 56f2998d58b..08b5da311ff 100644 --- a/crates/derive-impl/src/pystructseq.rs +++ b/crates/derive-impl/src/pystructseq.rs @@ -530,17 +530,11 @@ pub(crate) fn impl_pystruct_sequence( rustpython_doc::get(&format!("posix.{class_name}")) .or_else(|| rustpython_doc::get(&format!("nt.{class_name}"))) }); - let db_doc = db_doc.filter(|doc| !doc.is_empty()).map(str::to_owned); - let doc = struct_item - .attrs - .doc() - .filter(|doc| !doc.is_empty()) - .or(db_doc); - let doc = match doc { - Some(doc) => quote!(Some(#doc)), - None => quote!(None), - }; - let attr_docs = crate::class_docs::attr_docs_tokens(module_name.as_deref(), &class_name); + let rust_doc = struct_item.attrs.doc().filter(|doc| !doc.is_empty()); + let db = if rust_doc.is_some() { None } else { db_doc }; + let doc = crate::class_docs::item_doc_tokens(db, rust_doc); + let (attr_docs, attr_names) = + crate::class_docs::attr_docs_tokens(module_name.as_deref(), &class_name); let output = quote! { // The Python type struct - newtype wrapping PyTuple @@ -553,8 +547,11 @@ pub(crate) fn impl_pystruct_sequence( const NAME: &'static str = #class_name; const MODULE_NAME: Option<&'static str> = #module_name_tokens; const TP_NAME: &'static str = #module_class_name; - const DOC: Option<&'static str> = #doc; - const ATTR_DOCS: &'static [(&'static str, &'static str)] = #attr_docs; + const DOC: ::rustpython_vm::function::ItemDoc = #doc; + #[cfg(feature = "doc")] + const ATTR_DOCS: &'static [(&'static str, u32, u32)] = #attr_docs; + #[cfg(not(feature = "doc"))] + const ATTR_DOCS: &'static [&'static str] = #attr_names; const BASICSIZE: usize = 0; const UNHASHABLE: bool = false; diff --git a/crates/derive-impl/src/util.rs b/crates/derive-impl/src/util.rs index 557106ba0bc..3b520166bab 100644 --- a/crates/derive-impl/src/util.rs +++ b/crates/derive-impl/src/util.rs @@ -865,12 +865,10 @@ fn args_const(pieces: &[SigPiece]) -> TokenStream { } } -/// Expression of type `Option<&'static str>`: the internal doc, or the plain -/// doc when the arguments cannot form a signature. -/// `doc` is a const `Option<&'static str>` already chosen by the caller -/// (a Rust doc comment wins over the stored docstring). An empty string is -/// no docstring. The text is composed into the internal doc so -/// `__text_signature__` stays on the signature half. +/// Expression of type `ItemDoc`. +/// `doc` is a const `ItemDoc` already chosen by the caller (a Rust doc comment +/// wins over the stored docstring). A database id keeps only the signature +/// prefix as static text. A Rust docstring is composed into one literal. pub(crate) fn internal_doc_tokens( sig: &Signature, py_name: &str, @@ -883,23 +881,51 @@ pub(crate) fn internal_doc_tokens( quote! { { #args_const - const DOC_OPT: Option<&str> = #doc; + const BASE: ::rustpython_vm::function::ItemDoc = #doc; if !::rustpython_vm::function::has_signature(ARGS) { - if let Some(doc) = DOC_OPT { - if doc.is_empty() { None } else { Some(doc) } + if BASE.len == 0 { + match BASE.text { + Some(text) if !text.is_empty() => { + ::rustpython_vm::function::ItemDoc::static_text(text) + } + _ => ::rustpython_vm::function::ItemDoc::NONE, + } } else { - None + BASE + } + } else if BASE.len != 0 { + const N: usize = ::rustpython_vm::function::signature_prefix_len(#py_name, ARGS); + const B: [u8; N] = + ::rustpython_vm::function::signature_prefix_bytes::(#py_name, ARGS); + const PREFIX: &str = match ::core::str::from_utf8(&B) { + Ok(s) => s, + Err(_) => panic!(), + }; + #[cfg(feature = "doc")] + { + ::rustpython_vm::function::ItemDoc { + text: Some(PREFIX), + offset: BASE.offset, + len: BASE.len, + } + } + #[cfg(not(feature = "doc"))] + { + ::rustpython_vm::function::ItemDoc::static_text(PREFIX) } } else { - const DOC: &str = if let Some(doc) = DOC_OPT { doc } else { "" }; - const N: usize = ::rustpython_vm::function::internal_doc_len(#py_name, ARGS, DOC); + const BODY: &str = match BASE.text { + Some(text) => text, + None => "", + }; + const N: usize = ::rustpython_vm::function::internal_doc_len(#py_name, ARGS, BODY); const B: [u8; N] = - ::rustpython_vm::function::internal_doc_bytes::(#py_name, ARGS, DOC); - const S: &str = match ::core::str::from_utf8(&B) { + ::rustpython_vm::function::internal_doc_bytes::(#py_name, ARGS, BODY); + const FULL: &str = match ::core::str::from_utf8(&B) { Ok(s) => s, Err(_) => panic!(), }; - Some(S) + ::rustpython_vm::function::ItemDoc::static_text(FULL) } } } diff --git a/crates/doc/Cargo.toml b/crates/doc/Cargo.toml index 978a1161436..72b23e827e0 100644 --- a/crates/doc/Cargo.toml +++ b/crates/doc/Cargo.toml @@ -11,5 +11,11 @@ license-file = "LICENSE" [lib] doctest = false # Crashes when true +[build-dependencies] +xz = { workspace = true } + +[dev-dependencies] +xz = { workspace = true } + [lints] workspace = true diff --git a/crates/doc/build.rs b/crates/doc/build.rs new file mode 100644 index 00000000000..4cc90a85802 --- /dev/null +++ b/crates/doc/build.rs @@ -0,0 +1,145 @@ +extern crate alloc; + +use alloc::collections::BTreeMap; +use std::env; +use std::fs; +use std::path::PathBuf; + +fn main() { + println!("cargo:rerun-if-changed=src/data.inc.rs"); + let src = fs::read_to_string("src/data.inc.rs").expect("read data.inc.rs"); + let entries = parse_db(&src); + let mut text = String::new(); + let mut seen: BTreeMap<&str, (u32, u32)> = BTreeMap::new(); + let mut spans = Vec::with_capacity(entries.len()); + for (key, doc) in &entries { + let span = if doc.is_empty() { + (0, 0) + } else if let Some(span) = seen.get(doc.as_str()) { + *span + } else { + let offset = u32::try_from(text.len()).expect("doc offset"); + text.push_str(doc); + let len = u32::try_from(doc.len()).expect("doc len"); + seen.insert(doc.as_str(), (offset, len)); + (offset, len) + }; + spans.push((key.as_str(), span)); + } + let mut index = String::from( + "#[derive(Clone, Copy, Debug)]\n\ + pub struct DocRef {\n\ + \x20 pub offset: u32,\n\ + \x20 pub len: u32,\n\ + }\n\ + \n\ + pub static DB: &[(&str, DocRef)] = &[\n", + ); + for (key, (offset, len)) in spans { + index.push_str(" ("); + index.push_str(&rust_string(key)); + index.push_str(", DocRef { offset: "); + index.push_str(&offset.to_string()); + index.push_str(", len: "); + index.push_str(&len.to_string()); + index.push_str(" }),\n"); + } + index.push_str("];\n"); + let blob = xz::encode_all(text.as_bytes(), 9).expect("xz encode"); + let out = PathBuf::from(env::var("OUT_DIR").expect("OUT_DIR")); + fs::write(out.join("docs.xz"), blob).expect("write blob"); + fs::write(out.join("index.rs"), index).expect("write index"); +} + +fn rust_string(s: &str) -> String { + let mut out = String::from("\""); + for c in s.chars() { + match c { + '\\' => out.push_str("\\\\"), + '"' => out.push_str("\\\""), + '\n' => out.push_str("\\n"), + '\r' => out.push_str("\\r"), + '\t' => out.push_str("\\t"), + c if (c as u32) < 0x20 => out.push_str(&format!("\\u{{{:x}}}", c as u32)), + c => out.push(c), + } + } + out.push('"'); + out +} + +fn parse_db(src: &str) -> Vec<(String, String)> { + let mut entries = Vec::new(); + for line in src.lines() { + let line = line.trim(); + if !line.starts_with('(') { + continue; + } + let rest = &line[1..]; + let (key, rest) = parse_rust_string(rest).expect("doc key"); + let rest = rest + .trim_start() + .strip_prefix(',') + .expect("comma") + .trim_start(); + let (doc, rest) = parse_rust_string(rest).expect("doc text"); + let rest = rest.trim_start(); + assert!(rest.starts_with(')'), "{rest}"); + entries.push((key, doc)); + } + assert!(!entries.is_empty()); + entries +} + +fn parse_rust_string(input: &str) -> Option<(String, &str)> { + let bytes = input.as_bytes(); + if bytes.first() != Some(&b'"') { + return None; + } + let mut i = 1; + let mut out = Vec::new(); + while i < bytes.len() { + match bytes[i] { + b'\\' => { + i += 1; + match *bytes.get(i)? { + b'n' => out.push(b'\n'), + b'r' => out.push(b'\r'), + b't' => out.push(b'\t'), + b'\\' => out.push(b'\\'), + b'"' => out.push(b'"'), + b'\'' => out.push(b'\''), + b'0' => out.push(0), + b'x' => { + let hex = core::str::from_utf8(bytes.get(i + 1..i + 3)?).ok()?; + out.push(u8::from_str_radix(hex, 16).ok()?); + i += 2; + } + b'u' => { + if bytes.get(i + 1) != Some(&b'{') { + return None; + } + let start = i + 2; + let end = bytes[start..].iter().position(|b| *b == b'}')? + start; + let hex = core::str::from_utf8(&bytes[start..end]).ok()?; + let code = u32::from_str_radix(hex, 16).ok()?; + let ch = char::from_u32(code)?; + out.extend_from_slice(ch.encode_utf8(&mut [0; 4]).as_bytes()); + i = end; + } + _ => return None, + } + i += 1; + } + b'"' => { + let text = String::from_utf8(out).ok()?; + return Some((text, &input[i + 1..])); + } + byte => { + out.push(byte); + i += 1; + } + } + } + None +} diff --git a/crates/doc/src/lib.rs b/crates/doc/src/lib.rs index dbaed1e9b33..41feb4605f0 100644 --- a/crates/doc/src/lib.rs +++ b/crates/doc/src/lib.rs @@ -1,6 +1,8 @@ #![no_std] -include!("./data.inc.rs"); +include!(concat!(env!("OUT_DIR"), "/index.rs")); + +pub static BLOB: &[u8] = include_bytes!(concat!(env!("OUT_DIR"), "/docs.xz")); const fn cmp_bytes(left: &[u8], right: &[u8]) -> i8 { let n = if left.len() < right.len() { @@ -105,7 +107,7 @@ const fn find_composed( class: &[u8], attr: &[u8], has_attr: bool, -) -> Option<&'static str> { +) -> Option { let mut lo = 0; let mut hi = DB.len(); while lo < hi { @@ -142,9 +144,9 @@ const fn strip_underscore(module: &str) -> Option<&str> { } } -const fn nonempty(doc: Option<&str>) -> Option<&str> { +const fn nonempty(doc: Option) -> Option { match doc { - Some(doc) if !doc.is_empty() => Some(doc), + Some(doc) if doc.len != 0 => Some(doc), _ => None, } } @@ -154,7 +156,7 @@ const fn find_named( module: &str, class: &str, attr: Option<&str>, -) -> Option<&'static str> { +) -> Option { match attr { Some(attr) => find_composed( prefix, @@ -167,10 +169,10 @@ const fn find_named( } } -/// Docstring for an exact `module.class.attr` or `module.name` key. +/// Location of an exact `module.class.attr` or `module.name` key in the blob. /// `attr == None` looks up `module.class`. #[must_use] -pub const fn get(key: &str) -> Option<&'static str> { +pub const fn get(key: &str) -> Option { let key = key.as_bytes(); let mut lo = 0; let mut hi = DB.len(); @@ -188,9 +190,9 @@ pub const fn get(key: &str) -> Option<&'static str> { None } -/// Docstring for `module.class.attr` without building the key string. +/// Location of `module.class.attr` without building the key string. #[must_use] -pub const fn get_attr(module: &str, class: &str, attr: &str) -> Option<&'static str> { +pub const fn get_attr(module: &str, class: &str, attr: &str) -> Option { find_composed( b"", module.as_bytes(), @@ -201,14 +203,14 @@ pub const fn get_attr(module: &str, class: &str, attr: &str) -> Option<&'static } /// `module.class` or `module.class.attr`, with the same module aliases the -/// builtin types are stored under. +/// builtin types are stored under. Empty entries are skipped. #[must_use] pub const fn get_qualified( module: &str, class: &str, attr: Option<&str>, allow_builtins: bool, -) -> Option<&'static str> { +) -> Option { if let Some(doc) = nonempty(find_named(b"", module, class, attr)) { return Some(doc); } @@ -237,9 +239,9 @@ pub const fn get_qualified( None } -/// Docstring for a class attribute. `module == None` means `builtins`. +/// Location of a class attribute doc. `module == None` means `builtins`. #[must_use] -pub const fn class_attr_doc(module: Option<&str>, class: &str, attr: &str) -> Option<&'static str> { +pub const fn class_attr_doc(module: Option<&str>, class: &str, attr: &str) -> Option { let module = match module { Some(module) => module, None => "builtins", @@ -247,39 +249,67 @@ pub const fn class_attr_doc(module: Option<&str>, class: &str, attr: &str) -> Op get_qualified(module, class, Some(attr), true) } +#[cfg(test)] +extern crate alloc; + +#[cfg(test)] +pub mod plain { + include!("data.inc.rs"); +} + #[cfg(test)] mod test { - use super::{DB, class_attr_doc, get, get_attr}; + use super::{BLOB, DB, class_attr_doc, get, get_attr}; + use crate::plain; + + fn text() -> alloc::string::String { + let bytes = xz::decode_all(BLOB).unwrap(); + alloc::string::String::from_utf8(bytes).unwrap() + } #[test] - fn db_sorted_unique() { + fn db_sorted_unique_and_roundtrip() { assert!(!DB.is_empty()); - let mut i = 1; + assert_eq!(DB.len(), plain::DB.len()); + let text = text(); + let mut i = 0; while i < DB.len() { - assert!(DB[i - 1].0 < DB[i].0, "{}", DB[i].0); + if i > 0 { + assert!(DB[i - 1].0 < DB[i].0, "{}", DB[i].0); + } + assert_eq!(DB[i].0, plain::DB[i].0); + let doc = &DB[i].1; + let start = doc.offset as usize; + let end = start + doc.len as usize; + assert_eq!(&text[start..end], plain::DB[i].1); i += 1; } } #[test] fn get_hits_ends_and_middle() { - assert_eq!(get(DB[0].0), Some(DB[0].1)); - assert_eq!(get(DB[DB.len() / 2].0), Some(DB[DB.len() / 2].1)); - assert_eq!(get(DB[DB.len() - 1].0), Some(DB[DB.len() - 1].1)); - assert_eq!(get("no.such.key"), None); + assert_eq!(get(DB[0].0).unwrap().offset, DB[0].1.offset); + assert_eq!(get(DB[DB.len() / 2].0).unwrap().len, DB[DB.len() / 2].1.len); + assert_eq!( + get(DB[DB.len() - 1].0).unwrap().offset, + DB[DB.len() - 1].1.offset + ); + assert!(get("no.such.key").is_none()); } #[test] fn get_attr_and_alias() { let doc = get_attr("builtins", "int", "__add__").unwrap(); - assert_eq!(doc, get("builtins.int.__add__").unwrap()); + assert_eq!(doc.offset, get("builtins.int.__add__").unwrap().offset); assert_eq!( - super::get_qualified("os", "stat_result", None, true), - get("posix.stat_result") + super::get_qualified("os", "stat_result", None, true) + .unwrap() + .offset, + get("posix.stat_result").unwrap().offset ); assert_eq!( - class_attr_doc(None, "int", "__add__"), - get_attr("builtins", "int", "__add__") + class_attr_doc(None, "int", "__add__").unwrap().offset, + get_attr("builtins", "int", "__add__").unwrap().offset ); } } diff --git a/crates/stdlib/Cargo.toml b/crates/stdlib/Cargo.toml index 3e459f71e43..ee5a9a5b712 100644 --- a/crates/stdlib/Cargo.toml +++ b/crates/stdlib/Cargo.toml @@ -11,7 +11,8 @@ license.workspace = true # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html [features] -default = ["compiler", "host_env"] +default = ["compiler", "host_env", "doc"] +doc = ["rustpython-vm/doc"] host_env = ["rustpython-vm/host_env"] compiler = ["rustpython-vm/compiler"] threading = ["rustpython-common/threading", "rustpython-vm/threading"] diff --git a/crates/vm/Cargo.toml b/crates/vm/Cargo.toml index e7814a226ca..d834ffefbdf 100644 --- a/crates/vm/Cargo.toml +++ b/crates/vm/Cargo.toml @@ -10,7 +10,8 @@ repository.workspace = true license.workspace = true [features] -default = ["compiler", "wasmbind", "gc", "host_env", "stdio"] +default = ["compiler", "wasmbind", "gc", "host_env", "stdio", "doc"] +doc = ["dep:rustpython-doc", "dep:xz"] host_env = [] stdio = [] importlib = [] @@ -33,6 +34,7 @@ wasmbind = ["rustpython-common/wasm_js", "jiff/js", "wasm-bindgen"] rustpython-compiler = { workspace = true, optional = true } rustpython-codegen = { workspace = true, optional = true } rustpython-common = { workspace = true } +rustpython-doc = { workspace = true, optional = true } rustpython-derive = { workspace = true } rustpython-host_env = { workspace = true } rustpython-jit = { workspace = true, optional = true } @@ -71,6 +73,7 @@ rapidhash = { workspace = true } scopeguard = { workspace = true } serde = { workspace = true, optional = true } static_assertions = { workspace = true } +xz = { workspace = true, optional = true } strum = { workspace = true } strum_macros = { workspace = true } thiserror = { workspace = true } diff --git a/crates/vm/src/builtins/builtin_func.rs b/crates/vm/src/builtins/builtin_func.rs index 27d12d876a4..91ddf64c477 100644 --- a/crates/vm/src/builtins/builtin_func.rs +++ b/crates/vm/src/builtins/builtin_func.rs @@ -184,8 +184,7 @@ impl PyNativeFunction { // meth_get__doc__ in CPython #[pygetset] fn __doc__(zelf: NativeFunctionOrMethod) -> Option<&'static str> { - let doc = zelf.0.value.doc?; - type_::get_doc_from_internal_doc(zelf.0.value.name, doc) + type_::rendered_item_doc(zelf.0.value.name, zelf.0.value.item_doc()) } // meth_get__self__ in CPython @@ -221,8 +220,7 @@ impl PyNativeFunction { #[pygetset] fn __text_signature__(zelf: NativeFunctionOrMethod) -> Option<&'static str> { let doc = zelf.0.value.doc?; - let signature = type_::get_text_signature_from_internal_doc(zelf.0.value.name, doc)?; - Some(signature) + type_::get_text_signature_from_internal_doc(zelf.0.value.name, doc) } } diff --git a/crates/vm/src/builtins/descriptor.rs b/crates/vm/src/builtins/descriptor.rs index a523d3c5732..bb260cc600a 100644 --- a/crates/vm/src/builtins/descriptor.rs +++ b/crates/vm/src/builtins/descriptor.rs @@ -5,7 +5,9 @@ use crate::{ class::PyClassImpl, common::hash::PyHash, convert::{ToPyObject, ToPyResult}, - function::{Callee, FuncArgs, PyMethodDef, PyMethodFlags, PySetterValue, PySsize}, + function::{ + Callee, FuncArgs, ItemDoc, PyMethodDef, PyMethodFlags, PySetterValue, PySsize, plain_doc, + }, protocol::{PyNumberBinaryFunc, PyNumberTernaryFunc, PyNumberUnaryFunc}, types::{ Callable, Comparable, DelFunc, DescrGetFunc, DescrSetFunc, GenericMethod, GetDescriptor, @@ -138,8 +140,7 @@ impl PyMethodDescriptor { #[pygetset] fn __doc__(&self) -> Option<&'static str> { - let doc = self.method.doc?; - type_::get_doc_from_internal_doc(self.method.name, doc) + type_::rendered_item_doc(self.method.name, self.method.item_doc()) } #[pygetset] @@ -287,8 +288,7 @@ impl PyClassMethodDescriptor { #[pygetset] fn __doc__(&self) -> Option<&'static str> { - let doc = self.method.doc?; - type_::get_doc_from_internal_doc(self.method.name, doc) + type_::rendered_item_doc(self.method.name, self.method.item_doc()) } #[pygetset] @@ -453,7 +453,7 @@ pub struct PyMemberDef { pub kind: MemberKind, pub offset: isize, pub flags: i32, - pub doc: Option, + pub doc: ItemDoc, } impl PyMemberDef { @@ -485,7 +485,7 @@ pub struct PyMemberSpec { pub kind: MemberKind, pub offset: isize, pub flags: i32, - pub doc: Option<&'static str>, + pub doc: ItemDoc, } impl PyMemberSpec { @@ -497,7 +497,7 @@ impl PyMemberSpec { kind: MemberKind::Object, offset: 0, flags: 0, - doc: None, + doc: ItemDoc::NONE, }; let mut out = [EMPTY; N]; let mut index = 0; @@ -604,8 +604,8 @@ fn calculate_qualname(descr: &PyDescriptorOwned, vm: &VirtualMachine) -> PyResul #[pyclass(with(GetDescriptor, Representable), flags(DISALLOW_INSTANTIATION))] impl PyMemberDescriptor { #[pygetset] - fn __doc__(&self) -> Option { - self.member.doc.to_owned() + fn __doc__(&self) -> Option<&'static str> { + plain_doc(self.member.doc) } #[pygetset] @@ -1373,7 +1373,8 @@ pub(crate) struct PyWrapper { /// Slot text, including the text signature. pub doc: Option<&'static str>, /// Plain docstring for this slot when the table has one. - pub plain_doc: Option<&'static str>, + pub plain_off: u32, + pub plain_len: u32, } impl PyPayload for PyWrapper { @@ -1435,8 +1436,8 @@ impl PyWrapper { #[pygetset] fn __doc__(&self) -> Option<&'static str> { - if let Some(doc) = self.plain_doc { - return Some(doc); + if self.plain_len != 0 { + return crate::function::db_doc(self.plain_off, self.plain_len); } let doc = self.doc?; type_::get_doc_from_internal_doc(self.name.as_str(), doc) @@ -1520,8 +1521,8 @@ impl PyMethodWrapper { #[pygetset] fn __doc__(&self) -> Option<&'static str> { - if let Some(doc) = self.wrapper.plain_doc { - return Some(doc); + if self.wrapper.plain_len != 0 { + return crate::function::db_doc(self.wrapper.plain_off, self.wrapper.plain_len); } let doc = self.wrapper.doc?; type_::get_doc_from_internal_doc(self.wrapper.name.as_str(), doc) diff --git a/crates/vm/src/builtins/getset.rs b/crates/vm/src/builtins/getset.rs index effdeabd40b..8c8dc96f5b4 100644 --- a/crates/vm/src/builtins/getset.rs +++ b/crates/vm/src/builtins/getset.rs @@ -4,7 +4,10 @@ use super::PyType; use crate::{ AsObject, Context, Py, PyObject, PyObjectRef, PyPayload, PyRef, PyResult, VirtualMachine, class::PyClassImpl, - function::{IntoPyGetterFunc, IntoPySetterFunc, PyGetterFunc, PySetterFunc, PySetterValue}, + function::{ + IntoPyGetterFunc, IntoPySetterFunc, ItemDoc, PyGetterFunc, PySetterFunc, PySetterValue, + plain_doc, + }, object::{Traverse, TraverseFn}, types::{GetDescriptor, Representable}, }; @@ -19,7 +22,7 @@ pub struct PyGetSet { class: PyRef, getter: Option, setter: Option, - doc: Option, + doc: ItemDoc, } impl core::fmt::Debug for PyGetSet { @@ -87,13 +90,13 @@ impl PyGetSet { class: class.to_owned(), getter: None, setter: None, - doc: None, + doc: ItemDoc::NONE, } } #[must_use] - pub fn with_doc(mut self, doc: impl Into) -> Self { - self.doc = Some(doc.into()); + pub fn with_doc(mut self, doc: ItemDoc) -> Self { + self.doc = doc; self } @@ -145,8 +148,8 @@ impl PyGetSet { } #[pygetset] - fn __doc__(&self) -> Option { - self.doc.clone() + fn __doc__(&self) -> Option<&'static str> { + plain_doc(self.doc) } } diff --git a/crates/vm/src/builtins/type.rs b/crates/vm/src/builtins/type.rs index 2d6b7c9e7bc..4330e711097 100644 --- a/crates/vm/src/builtins/type.rs +++ b/crates/vm/src/builtins/type.rs @@ -19,7 +19,10 @@ use crate::{ borrow::BorrowedValue, lock::{PyRwLock, PyRwLockReadGuard}, }, - function::{ArgumentError, FromArgs, FuncArgs, KwArgs, Param, PyMethodDef, PySetterValue}, + function::{ + ArgumentError, FromArgs, FuncArgs, ItemDoc, KwArgs, Param, PyMethodDef, PySetterValue, + db_doc, + }, object::{Traverse, TraverseFn}, protocol::{PyIterReturn, PyNumberMethods}, types::{ @@ -2362,8 +2365,8 @@ impl PyType { #[pygetset] fn __text_signature__(&self, vm: &VirtualMachine) -> Option { let name = self.name(); - if let Some(doc) = self.slots.doc - && let Some(signature) = get_text_signature_from_internal_doc(&name, doc) + if let Some(text) = self.slots.doc.text + && let Some(signature) = get_text_signature_from_internal_doc(&name, text) { return Some(signature.to_string()); } @@ -2813,7 +2816,7 @@ impl Constructor for PyType { kind: MemberKind::ObjectEx, offset: crate::object::slot_member_offset(offset), flags: 0, - doc: None, + doc: ItemDoc::NONE, }; let attr_name = vm.ctx.intern_str(mangled_name.as_str()); let member_descriptor: PyRef = @@ -2983,6 +2986,14 @@ pub(crate) fn get_doc_from_internal_doc<'a>(name: &str, internal_doc: &'a str) - (!doc.is_empty()).then_some(doc) } +pub(crate) fn rendered_item_doc(name: &str, doc: ItemDoc) -> Option<&'static str> { + if doc.len != 0 { + return db_doc(doc.offset, doc.len); + } + doc.text + .and_then(|text| get_doc_from_internal_doc(name, text)) +} + impl Initializer for PyType { type Args = FuncArgs; @@ -3075,11 +3086,11 @@ impl Py { fn __doc__(&self, vm: &VirtualMachine) -> PyResult { // Similar to CPython's type_get_doc // For non-heap types (static types), check if there's an internal doc + let internal_doc = self.slots.doc; if !self.slots.flags.has_feature(PyTypeFlags::HEAPTYPE) - && let Some(internal_doc) = self.slots.doc + && (internal_doc.text.is_some() || internal_doc.len != 0) { - // Process internal doc, removing signature if present - let doc_str = get_doc_from_internal_doc(&self.name(), internal_doc); + let doc_str = rendered_item_doc(&self.name(), internal_doc); return Ok(doc_str.map_or_else(|| vm.ctx.none(), |doc| vm.ctx.new_str(doc).into())); } diff --git a/crates/vm/src/class.rs b/crates/vm/src/class.rs index c3a3cc51324..1bbcda24728 100644 --- a/crates/vm/src/class.rs +++ b/crates/vm/src/class.rs @@ -3,9 +3,9 @@ use crate::{ AsObject, PyPayload, builtins::{PyBaseObject, PyType, PyTypeRef, descriptor::PyWrapper}, - function::PyMethodDef, + function::{ItemDoc, PyMethodDef, plain_doc}, object::Py, - types::{PyTypeFlags, PyTypeSlots, SLOT_DEFS, SLOT_DEFS_COUNT, fn_addr, hash_not_implemented}, + types::{PyTypeFlags, PyTypeSlots, SLOT_DEFS, fn_addr, hash_not_implemented}, vm::Context, }; use rustpython_common::static_cell; @@ -15,9 +15,33 @@ use rustpython_common::static_cell; /// Iterates SLOT_DEFS and creates a PyWrapper for each slot that: /// 1. Has a function set in the type's slots /// 2. Doesn't already have an attribute in the type's dict -pub fn add_operators(class: &'static Py, ctx: &Context) { - for (index, def) in SLOT_DEFS.iter().enumerate() { - let plain_doc = T::SLOT_DOCS[index]; +#[cfg(feature = "doc")] +pub fn add_operators(class: &'static Py, ctx: &Context, attr_docs: &[(&str, u32, u32)]) { + add_operators_inner(class, ctx, |name| match attr_doc(attr_docs, name) { + Some((offset, len)) if len != 0 => (offset, len), + _ => (0, 0), + }) +} + +#[cfg(not(feature = "doc"))] +pub fn add_operators(class: &'static Py, ctx: &Context, attr_docs: &[&str]) { + add_operators_inner(class, ctx, |name| { + if attr_name_present(attr_docs, name) { + // Present in the database: do not fall back to the slot text. + (0, 1) + } else { + (0, 0) + } + }) +} + +fn add_operators_inner( + class: &'static Py, + ctx: &Context, + mut plain_span: impl FnMut(&str) -> (u32, u32), +) { + for def in SLOT_DEFS { + let (plain_off, plain_len) = plain_span(def.name); // Skip __new__ - it has special handling if def.name == "__new__" { continue; @@ -57,7 +81,8 @@ pub fn add_operators(class: &'static Py, ctx: &Context) name: attr_name, wrapped: slot_func, doc: Some(def.doc), - plain_doc, + plain_off, + plain_len, }; class.set_attr(attr_name, wrapper.into_ref(ctx).into()); } @@ -134,9 +159,14 @@ pub trait PyClassDef { const NAME: &'static str; const MODULE_NAME: Option<&'static str>; const TP_NAME: &'static str; - const DOC: Option<&'static str> = None; - /// Attribute name → doc, sorted by name. `""` is an explicit empty doc. - const ATTR_DOCS: &'static [(&'static str, &'static str)] = &[]; + const DOC: ItemDoc = ItemDoc::NONE; + /// Attribute name → database span, sorted by name. + /// `(u32::MAX, 0)` is an explicit empty doc. + #[cfg(feature = "doc")] + const ATTR_DOCS: &'static [(&'static str, u32, u32)] = &[]; + /// Names that have a database doc, sorted. The text is not in this build. + #[cfg(not(feature = "doc"))] + const ATTR_DOCS: &'static [&'static str] = &[]; const BASICSIZE: usize; const ITEMSIZE: usize = 0; const UNHASHABLE: bool = false; @@ -173,16 +203,35 @@ const fn cmp_str(left: &str, right: &str) -> i8 { } } +#[must_use] +pub const fn attr_name_present(table: &[&str], name: &str) -> bool { + let mut lo = 0; + let mut hi = table.len(); + while lo < hi { + let mid = (lo + hi) / 2; + let ord = cmp_str(table[mid], name); + if ord == 0 { + return true; + } else if ord < 0 { + lo = mid + 1; + } else { + hi = mid; + } + } + false +} + /// Doc for `name` in a sorted attribute-doc table. #[must_use] -pub const fn attr_doc<'a>(table: &'a [(&'a str, &'a str)], name: &str) -> Option<&'a str> { +#[inline(never)] +pub const fn attr_doc(table: &[(&str, u32, u32)], name: &str) -> Option<(u32, u32)> { let mut lo = 0; let mut hi = table.len(); while lo < hi { let mid = (lo + hi) / 2; let ord = cmp_str(table[mid].0, name); if ord == 0 { - return Some(table[mid].1); + return Some((table[mid].1, table[mid].2)); } else if ord < 0 { lo = mid + 1; } else { @@ -195,23 +244,8 @@ pub const fn attr_doc<'a>(table: &'a [(&'a str, &'a str)], name: &str) -> Option pub trait PyClassImpl: PyClassDef { const TP_FLAGS: PyTypeFlags = PyTypeFlags::DEFAULT; - /// Plain docstring for each [`SLOT_DEFS`] entry, resolved while this impl - /// is compiled. `None` keeps the slotdef text. - const SLOT_DOCS: [Option<&'static str>; SLOT_DEFS_COUNT] = { - let mut docs = [None; SLOT_DEFS_COUNT]; - let mut i = 0; - while i < SLOT_DEFS_COUNT { - docs[i] = match attr_doc(Self::ATTR_DOCS, SLOT_DEFS[i].name) { - Some(doc) if !doc.is_empty() => Some(doc), - _ => None, - }; - i += 1; - } - docs - }; - - /// `Name(sig)\n--\n\ndoc` when the constructor arguments form a signature. - const INTERNAL_DOC: Option<&'static str> = None; + /// Signature-bearing class doc. [`ItemDoc::NONE`] when the constructor has no signature. + const INTERNAL_DOC: ItemDoc = ItemDoc::NONE; const METHOD_DEFS: &'static [PyMethodDef]; @@ -261,13 +295,13 @@ pub trait PyClassImpl: PyClassDef { Self::impl_extend_class(ctx, class); - if let Some(doc) = Self::DOC { - // Only set __doc__ if it doesn't already exist (e.g., as a member descriptor) - // This matches CPython's behavior in type_dict_set_doc - let doc_attr_name = identifier!(ctx, __doc__); - if class.attributes().get(doc_attr_name).is_none() { - class.set_attr(doc_attr_name, ctx.new_str(doc).into()); - } + // Only set __doc__ if it doesn't already exist (e.g., as a member descriptor) + // This matches CPython's behavior in type_dict_set_doc + let doc_attr_name = identifier!(ctx, __doc__); + if class.attributes().get(doc_attr_name).is_none() { + let doc = + plain_doc(Self::DOC).map_or_else(|| ctx.none(), |doc| ctx.new_str(doc).into()); + class.set_attr(doc_attr_name, doc); } if let Some(module_name) = Self::MODULE_NAME { @@ -301,7 +335,7 @@ pub trait PyClassImpl: PyClassDef { } // Add slot wrappers using SLOT_DEFS array - add_operators::(class, ctx); + add_operators(class, ctx, Self::ATTR_DOCS); // Same walk as init_slots: a slot such as tp_init is copied only from // a base that defines it, so a static grandchild must see that base @@ -346,10 +380,13 @@ pub trait PyClassImpl: PyClassDef { name: Self::TP_NAME, basicsize: Self::BASICSIZE, itemsize: Self::ITEMSIZE, - doc: if let Some(doc) = Self::INTERNAL_DOC { - Some(doc) - } else { - Self::DOC + doc: { + let internal = Self::INTERNAL_DOC; + if internal.text.is_some() || internal.len != 0 { + internal + } else { + Self::DOC + } }, methods: Self::METHOD_DEFS, ..Default::default() diff --git a/crates/vm/src/codecs.rs b/crates/vm/src/codecs.rs index 5fba990feea..6d5be4035f5 100644 --- a/crates/vm/src/codecs.rs +++ b/crates/vm/src/codecs.rs @@ -174,6 +174,10 @@ impl CodecsRegistry { name: $name, func: crate::function::static_func($func), flags: crate::function::PyMethodFlags::O, + #[cfg(feature = "doc")] + doc_off: 0, + #[cfg(feature = "doc")] + doc_len: 0, doc: Some(concat!($name, "($self, object, /)\n--\n\n")), } }; diff --git a/crates/vm/src/function/doctext.rs b/crates/vm/src/function/doctext.rs new file mode 100644 index 00000000000..366ada65bd1 --- /dev/null +++ b/crates/vm/src/function/doctext.rs @@ -0,0 +1,94 @@ +//! A docstring is a static literal, a span of the compressed blob, or both. +//! `len == 0` means there is no database body. `offset == u32::MAX` is an +//! explicit empty entry. + +#[cfg(feature = "doc")] +use std::sync::OnceLock; + +/// Static text plus an optional span of the compressed doc blob. +/// +/// `text` is a plain docstring, a full `name(sig)\n--\n\nbody` literal, or only +/// the signature prefix when `len` is the database body. +#[derive(Clone, Copy, Debug)] +pub struct ItemDoc { + pub text: Option<&'static str>, + pub offset: u32, + pub len: u32, +} + +impl ItemDoc { + pub const NONE: Self = Self { + text: None, + offset: 0, + len: 0, + }; + + #[must_use] + pub const fn static_text(text: &'static str) -> Self { + Self { + text: Some(text), + offset: 0, + len: 0, + } + } + + #[must_use] + pub const fn is_db(self) -> bool { + self.len != 0 + } +} + +impl Default for ItemDoc { + fn default() -> Self { + Self::NONE + } +} + +#[inline(never)] +#[must_use] +pub fn db_doc(offset: u32, len: u32) -> Option<&'static str> { + if len == 0 { + return None; + } + db_slice(offset, len) +} + +#[inline(never)] +#[must_use] +pub fn plain_doc(doc: ItemDoc) -> Option<&'static str> { + if doc.len != 0 { + return db_doc(doc.offset, doc.len); + } + doc.text.filter(|text| !text.is_empty()) +} + +#[cfg(feature = "doc")] +#[inline(never)] +fn db_slice(offset: u32, len: u32) -> Option<&'static str> { + let text = docs(); + let start = offset as usize; + let end = start.checked_add(len as usize)?; + text.get(start..end) +} + +#[cfg(not(feature = "doc"))] +fn db_slice(_offset: u32, _len: u32) -> Option<&'static str> { + None +} + +#[cfg(feature = "doc")] +#[inline(never)] +fn docs() -> &'static str { + static TEXT: OnceLock> = OnceLock::new(); + TEXT.get_or_init(|| { + let bytes = match xz::decode_all(rustpython_doc::BLOB) { + Ok(bytes) => bytes, + Err(_) => panic!("doc blob"), + }; + match String::from_utf8(bytes) { + Ok(text) => text.into_boxed_str(), + Err(_) => panic!("doc blob"), + } + }) + .as_ref() +} diff --git a/crates/vm/src/function/method.rs b/crates/vm/src/function/method.rs index b5a46241f30..8c57c74c0f2 100644 --- a/crates/vm/src/function/method.rs +++ b/crates/vm/src/function/method.rs @@ -59,6 +59,10 @@ macro_rules! define_methods { name: $name, func: $crate::function::static_func($func), flags: $crate::function::PyMethodFlags::$flags, + #[cfg(feature = "doc")] + doc_off: 0, + #[cfg(feature = "doc")] + doc_len: 0, doc: None, }),+ ] }; @@ -69,22 +73,47 @@ pub struct PyMethodDef { pub name: &'static str, // TODO: interned pub func: &'static dyn PyNativeFn, pub flags: PyMethodFlags, - pub doc: Option<&'static str>, // TODO: interned + /// Database body span. Absent when the `doc` feature is off. + #[cfg(feature = "doc")] + pub doc_off: u32, + #[cfg(feature = "doc")] + pub doc_len: u32, + /// Plain doc, full internal doc, or signature prefix when `doc_len` is set. + pub doc: Option<&'static str>, } impl PyMethodDef { + #[must_use] + pub fn item_doc(&self) -> super::ItemDoc { + super::ItemDoc { + text: self.doc, + #[cfg(feature = "doc")] + offset: self.doc_off, + #[cfg(feature = "doc")] + len: self.doc_len, + #[cfg(not(feature = "doc"))] + offset: 0, + #[cfg(not(feature = "doc"))] + len: 0, + } + } + #[inline] pub const fn new_const( name: &'static str, func: impl IntoPyNativeFn, flags: PyMethodFlags, - doc: Option<&'static str>, + doc: super::ItemDoc, ) -> Self { Self { name, func: super::static_func(func), flags, - doc, + #[cfg(feature = "doc")] + doc_off: doc.offset, + #[cfg(feature = "doc")] + doc_len: doc.len, + doc: doc.text, } } @@ -93,13 +122,17 @@ impl PyMethodDef { name: &'static str, func: impl PyNativeFn, flags: PyMethodFlags, - doc: Option<&'static str>, + doc: super::ItemDoc, ) -> Self { Self { name, func: super::static_raw_func(func), flags, - doc, + #[cfg(feature = "doc")] + doc_off: doc.offset, + #[cfg(feature = "doc")] + doc_len: doc.len, + doc: doc.text, } } @@ -237,6 +270,10 @@ impl PyMethodDef { name: "", func: &|_, _, _| unreachable!(), flags: PyMethodFlags::empty(), + #[cfg(feature = "doc")] + doc_off: 0, + #[cfg(feature = "doc")] + doc_len: 0, doc: None, }; let mut all_methods = [NULL_METHOD; SUM_LEN]; @@ -261,6 +298,10 @@ impl PyMethodDef { name: self.name, func: self.func, flags: self.flags, + #[cfg(feature = "doc")] + doc_off: self.doc_off, + #[cfg(feature = "doc")] + doc_len: self.doc_len, doc: self.doc, } } diff --git a/crates/vm/src/function/mod.rs b/crates/vm/src/function/mod.rs index 341f992fffe..0fcbffc96bb 100644 --- a/crates/vm/src/function/mod.rs +++ b/crates/vm/src/function/mod.rs @@ -2,6 +2,7 @@ mod argument; mod arithmetic; mod buffer; mod builtin; +mod doctext; mod either; mod fspath; mod getargs; @@ -24,6 +25,7 @@ pub use buffer::{ ArgAsciiBuffer, ArgBytesLike, ArgContiguousBytesLike, ArgMemoryBuffer, ArgStrOrBytesLike, }; pub use builtin::{IntoPyNativeFn, PyNativeFn, static_func, static_raw_func}; +pub use doctext::{ItemDoc, db_doc, plain_doc}; pub use either::Either; pub use fspath::FsPath; pub(crate) use getargs::ArgSpec; @@ -36,7 +38,7 @@ pub use number::{ pub use protocol::{ArgCallable, ArgIterable, ArgMapping, ArgSequence}; pub use signature::{ DefaultRepr, Param, ParamKind, SigArg, choose_class_params, has_signature, internal_doc_bytes, - internal_doc_len, real_signature, + internal_doc_len, real_signature, signature_prefix_bytes, signature_prefix_len, }; pub use time::TimeoutSeconds; diff --git a/crates/vm/src/function/signature.rs b/crates/vm/src/function/signature.rs index a0788ca0d27..3dfae3ae9df 100644 --- a/crates/vm/src/function/signature.rs +++ b/crates/vm/src/function/signature.rs @@ -211,6 +211,19 @@ pub const fn has_signature(args: &[SigArg]) -> bool { true } +#[must_use] +pub const fn signature_prefix_len(name: &str, args: &[SigArg]) -> usize { + write_signature_prefix(&mut [], name, args) +} + +#[must_use] +pub const fn signature_prefix_bytes(name: &str, args: &[SigArg]) -> [u8; N] { + let mut buf = [0u8; N]; + let written = write_signature_prefix(&mut buf, name, args); + assert!(written == N); + buf +} + #[must_use] pub const fn internal_doc_len(name: &str, args: &[SigArg], doc: &str) -> usize { write_internal_doc(&mut [], name, args, doc) @@ -232,7 +245,7 @@ struct St { star_emitted: bool, } -const fn write_internal_doc(buf: &mut [u8], name: &str, args: &[SigArg], doc: &str) -> usize { +const fn write_signature_prefix(buf: &mut [u8], name: &str, args: &[SigArg]) -> usize { let mut n = put_str(buf, 0, name); n = put_byte(buf, n, b'('); let st = write_args( @@ -246,7 +259,11 @@ const fn write_internal_doc(buf: &mut [u8], name: &str, args: &[SigArg], doc: &s }, args, ); - n = put_str(buf, st.n, ")\n--\n\n"); + put_str(buf, st.n, ")\n--\n\n") +} + +const fn write_internal_doc(buf: &mut [u8], name: &str, args: &[SigArg], doc: &str) -> usize { + let n = write_signature_prefix(buf, name, args); put_str(buf, n, doc) } diff --git a/crates/vm/src/macros.rs b/crates/vm/src/macros.rs index 17ece048f6e..84360b9dc9f 100644 --- a/crates/vm/src/macros.rs +++ b/crates/vm/src/macros.rs @@ -231,6 +231,7 @@ macro_rules! named_function { stringify!($func), [<$module _ $func>], ::rustpython_vm::function::PyMethodFlags::empty(), + ::rustpython_vm::function::ItemDoc::NONE, ) .to_function() .with_module(ctx.intern_str(stringify!($module)).into()) diff --git a/crates/vm/src/stdlib/_ast/python.rs b/crates/vm/src/stdlib/_ast/python.rs index 1cac419755d..77213510373 100644 --- a/crates/vm/src/stdlib/_ast/python.rs +++ b/crates/vm/src/stdlib/_ast/python.rs @@ -42,7 +42,7 @@ pub(crate) mod _ast { ast_deepcopy(&zelf, &memo, vm) }, PyMethodFlags::METHOD, - None, + crate::function::ItemDoc::NONE, ); class.set_str_attr( @@ -569,7 +569,7 @@ This will become an error in Python 3.15.", ast_reduce(&zelf, vm) }, PyMethodFlags::METHOD, - Some("__reduce__($self, /)\n--\n\n"), + crate::function::ItemDoc::static_text("__reduce__($self, /)\n--\n\n"), ); const AST_REPLACE: PyMethodDef = PyMethodDef::new_const( "__replace__", @@ -577,7 +577,7 @@ This will become an error in Python 3.15.", ast_replace(&zelf, args, vm) }, PyMethodFlags::METHOD, - Some( + crate::function::ItemDoc::static_text( "__replace__($self, /, **fields)\n--\n\nReturn a copy of the AST node with new values for the specified fields.", ), ); diff --git a/crates/vm/src/stdlib/posix.rs b/crates/vm/src/stdlib/posix.rs index cc1e665ee5d..69c32f3a903 100644 --- a/crates/vm/src/stdlib/posix.rs +++ b/crates/vm/src/stdlib/posix.rs @@ -2904,7 +2904,7 @@ mod posix_sched { vm.new_tuple((zelf.class().to_owned(), (zelf.as_slice()[0].clone(),))) }, crate::function::PyMethodFlags::METHOD, - None, + crate::function::ItemDoc::NONE, ); class.set_attr( ctx.intern_str("__reduce__"), diff --git a/crates/vm/src/stdlib/sys.rs b/crates/vm/src/stdlib/sys.rs index 1660ca7503b..116b2e91ace 100644 --- a/crates/vm/src/stdlib/sys.rs +++ b/crates/vm/src/stdlib/sys.rs @@ -1934,7 +1934,7 @@ pub(crate) fn init_module(vm: &VirtualMachine, module: &Py, builtins: let jit_module = jit_def.create_module(vm).unwrap(); extend_module!(vm, module, { - "__doc__" => sys::DOC.to_owned().to_pyobject(vm), + "__doc__" => crate::function::plain_doc(sys::DOC).to_pyobject(vm), "modules" => modules, "_jit" => jit_module, }); diff --git a/crates/vm/src/types/slot.rs b/crates/vm/src/types/slot.rs index 1235ef8bf11..4deea4b614e 100644 --- a/crates/vm/src/types/slot.rs +++ b/crates/vm/src/types/slot.rs @@ -7,7 +7,9 @@ use crate::{ bytecode::ComparisonOperator, common::hash::{PyHash, fix_sentinel, hash_bigint}, convert::ToPyObject, - function::{Callee, Either, FromArgs, FuncArgs, PyComparisonValue, PyMethodDef, PySetterValue}, + function::{ + Callee, Either, FromArgs, FuncArgs, ItemDoc, PyComparisonValue, PyMethodDef, PySetterValue, + }, protocol::{ BufferFlags, PyBuffer, PyIterReturn, PyMapping, PyMappingMethods, PyMappingSlots, PyNumber, PyNumberMethods, PyNumberSlots, PySequence, PySequenceMethods, PySequenceSlots, @@ -173,7 +175,7 @@ pub struct PyTypeSlots { pub flags: PyTypeFlags, // tp_doc - pub doc: Option<&'static str>, + pub doc: ItemDoc, // Strong reference on a heap type, borrowed reference on a static type // tp_base diff --git a/crates/vm/src/types/structseq.rs b/crates/vm/src/types/structseq.rs index ed5edfa5d80..1afafe0b2f3 100644 --- a/crates/vm/src/types/structseq.rs +++ b/crates/vm/src/types/structseq.rs @@ -25,7 +25,7 @@ const DEFAULT_STRUCTSEQ_REDUCE: PyMethodDef = PyMethodDef::new_const( )) }, PyMethodFlags::METHOD, - Some("__reduce__($self, /)\n--\n\n"), + crate::function::ItemDoc::static_text("__reduce__($self, /)\n--\n\n"), ); /// Text signature `(iterable=(), /)` shared by every struct sequence. diff --git a/crates/vm/src/vm/context.rs b/crates/vm/src/vm/context.rs index 93917ef30e3..50881318358 100644 --- a/crates/vm/src/vm/context.rs +++ b/crates/vm/src/vm/context.rs @@ -18,7 +18,7 @@ use crate::{ common::rc::PyRc, exceptions, function::{ - HeapMethodDef, IntoPyGetterFunc, IntoPyNativeFn, IntoPySetterFunc, PyMethodDef, + HeapMethodDef, IntoPyGetterFunc, IntoPyNativeFn, IntoPySetterFunc, ItemDoc, PyMethodDef, PyMethodFlags, }, intern::{InternableString, MaybeInternedString, StringPool}, @@ -361,7 +361,7 @@ impl Context { names.__new__.as_str(), PyType::__new__, PyMethodFlags::METHOD, - Some( + ItemDoc::static_text( "__new__($type, /, *args, **kwargs)\n--\n\nCreate and return a new object. See help(type) for accurate signature.", ), ); @@ -641,7 +641,7 @@ impl Context { name: &'static str, f: F, flags: PyMethodFlags, - doc: Option<&'static str>, + doc: ItemDoc, ) -> PyRef where F: IntoPyNativeFn, @@ -650,7 +650,11 @@ impl Context { name, func: Box::leak(Box::new(f.into_func())), flags, - doc, + #[cfg(feature = "doc")] + doc_off: doc.offset, + #[cfg(feature = "doc")] + doc_len: doc.len, + doc: doc.text, }; let payload = HeapMethodDef::new(def); PyRef::new_ref(payload, self.types.method_def.to_owned(), None) @@ -664,7 +668,7 @@ impl Context { offset: isize, flags: i32, class: &'static Py, - doc: Option<&str>, + doc: ItemDoc, ) -> PyRef { let member_descriptor = PyMemberDescriptor { common: PyDescriptorOwned { @@ -677,7 +681,7 @@ impl Context { kind, offset, flags, - doc: doc.map(str::to_owned), + doc, }, access: MemberAccess::Offset, }; @@ -701,7 +705,7 @@ impl Context { kind: MemberKind::Object, offset: index as isize, flags: PY_READONLY, - doc: None, + doc: ItemDoc::NONE, }, access: MemberAccess::TupleItem, }; diff --git a/crates/vm/src/vm/mod.rs b/crates/vm/src/vm/mod.rs index f9569061646..1382eaac4f8 100644 --- a/crates/vm/src/vm/mod.rs +++ b/crates/vm/src/vm/mod.rs @@ -1282,12 +1282,14 @@ impl VirtualMachine { vm.builtins.init_dict( vm.ctx.intern_str("builtins"), - Some(vm.ctx.intern_str(stdlib::builtins::DOC.unwrap()).to_owned()), + crate::function::plain_doc(stdlib::builtins::DOC) + .map(|doc| vm.ctx.intern_str(doc).to_owned()), &vm, ); vm.sys_module.init_dict( vm.ctx.intern_str("sys"), - Some(vm.ctx.intern_str(stdlib::sys::DOC.unwrap()).to_owned()), + crate::function::plain_doc(stdlib::sys::DOC) + .map(|doc| vm.ctx.intern_str(doc).to_owned()), &vm, ); // let name = vm.sys_module.get_attr("__name__", &vm).unwrap(); diff --git a/crates/vm/src/vm/vm_new.rs b/crates/vm/src/vm/vm_new.rs index 3a54150b811..f8efe16a9b0 100644 --- a/crates/vm/src/vm/vm_new.rs +++ b/crates/vm/src/vm/vm_new.rs @@ -394,9 +394,12 @@ impl VirtualMachine { where F: IntoPyNativeFn, { - let def = self - .ctx - .new_method_def(name, f, PyMethodFlags::empty(), None); + let def = self.ctx.new_method_def( + name, + f, + PyMethodFlags::empty(), + crate::function::ItemDoc::NONE, + ); def.build_function(self, None) } @@ -409,9 +412,12 @@ impl VirtualMachine { where F: IntoPyNativeFn, { - let def = self - .ctx - .new_method_def(name, f, PyMethodFlags::METHOD, None); + let def = self.ctx.new_method_def( + name, + f, + PyMethodFlags::METHOD, + crate::function::ItemDoc::NONE, + ); def.build_method(class, self) } diff --git a/crates/wasm/Cargo.toml b/crates/wasm/Cargo.toml index c63d820d5ca..f9ea3ab9e3d 100644 --- a/crates/wasm/Cargo.toml +++ b/crates/wasm/Cargo.toml @@ -12,17 +12,18 @@ license.workspace = true crate-type = ["cdylib", "rlib"] [features] -default = ["freeze-stdlib"] +default = ["freeze-stdlib", "doc"] +doc = ["rustpython-vm/doc", "rustpython-stdlib?/doc"] freeze-stdlib = ["rustpython-vm/freeze-stdlib", "rustpython-pylib/freeze-stdlib", "rustpython-stdlib", "rustpython-stdlib/ssl"] no-start-func = [] [dependencies] rustpython-common = { workspace = true } rustpython-pylib = { workspace = true, optional = true } -rustpython-stdlib = { workspace = true, default-features = false, optional = true } +rustpython-stdlib = { workspace = true, default-features = false, optional = true, features = ["doc"] } ruff_text_size = { workspace = true } # make sure no threading! otherwise wasm build will fail -rustpython-vm = { workspace = true, features = ["compiler", "encodings", "serde", "wasmbind"] } +rustpython-vm = { workspace = true, features = ["compiler", "encodings", "serde", "wasmbind", "doc"] } serde = { workspace = true } wasm-bindgen = { workspace = true }