Match remaining native docs and signatures to CPython 3.14 - #8877

Follow-up to #8836. Fixes the remaining native __doc__/signature mismatches that scripts/whats_left.py --doc --signature reports under CPython 3.14.7, except those from modules RustPython implements in pure Python.

Doc DB generator (crates/doc/generate.py)

• __dir__ was in IGNORED_ATTRS, so object.__dir__, type.__dir__ etc. were never recorded. It is no longer ignored; __base__, __bases__ and __module__ are skipped instead because following them only re-records other objects under a bogus path (this removes 22 builtins.type.__base__* keys).
• New keys that the RustPython lookup needs:
  • native classes whose metaclass is not type, and classes stored under another attribute name keyed by their own __name__ (_json.make_scanner is the class _json.Scanner)
  • native objects exposed by pure-Python modules, keyed by their own __module__/__name__ (ssl.SSLError), or by the exposing module when __module__ is None (the codecs.*_errors handlers)
  • types found through object.__subclasses__() keyed by their own module as well as builtins (_ctypes._CData)
  • getset/member descriptors named like class metadata, which getmembers() hides behind the class's own value (coroutine.__name__)
  • native types a module exposes only through an instance (sys.flags, sys.float_info, …)
• A class counts as native only when it owns its C descriptors (__objclass__ is cls). Before, an enum holding a copied str.__format__ looked native.
• Docstrings are stored unstripped. .strip() removed leading indentation that inspect.cleandoc depends on (_sre.template).
• Output is deterministic: all modules are imported, in sorted order, before any class is classified. Before, the result depended on import order and PYTHONHASHSEED.

data.inc.rs gets the key delta between the old and new generator, both run on macOS with CPython 3.14.7: 5,042 added, 22 removed, 1,773 values changed (mostly unstripped whitespace). Linux/Windows-only keys are picked up by the next update-doc-db run.

/// on Python items

Rust /// comments on #[py*] items were published as __doc__ (e.g. weakref.ref was "PyWeakReference: …"). They are now //. Most of this is split out as #8893; this PR keeps the struct sequence __replace__ and coroutine.__name__/__qualname__ ones, which need the database entries added here.

Names, lookup and signatures

• The weakref type is weakref.ReferenceType; _ctypes.Array.__class_getitem__ is defined on Array, not its metaclass.
• #[pymodule(sub)] bodies declare the Python module they are merged into with name = "...", and doc lookup uses it; without name the database is not consulted. This replaces a guess that searched every module for a unique function name. posix and nt fall back to each other in rustpython_doc::get_qualified, since they are one module under a platform-dependent name. Each name of a multi-name function gets its own doc (posix.remove / posix.unlink).
• As a result posix.DirEntry/ScandirIter have __module__ posix (was _os), and odict_keys/odict_values/odict_items/odict_iterator have builtins (was ordered_dict).
• Methods coming from with(...) traits get the implementing class's doc (dict_items.__reversed__, dict_items.isdisjoint, dict_values.__reversed__). The trait impl cannot name the class, so the derive marks such a method doc_body_pending on its PyMethodDef, and the class fills the span from its attribute doc table when it concatenates the method arrays.
• #[pymodule] classes without their own doc get the database doc, resolved at macro time. The codec error handlers and _lzma.LZMAError resolve theirs in const context through the new ItemDoc::db. Context::new_exception_type_with_doc is added for the latter. No database lookup happens at runtime, so the key table stays out of the binary.
• posix_spawn/posix_spawnp: parameter argv (the field is renamed rather than overridden with name =) and defaults file_actions=(), setpgroup=None, setsigmask=(), setsigdef=(), scheduler=None in CPython's order.
• dict_keys and dict_items are unhashable; _CData.__ctypes_from_outparam__ is added; sys.__doc__ omits the [Windows only] lines on other platforms.

Struct sequence fields

Since #8857 made struct sequence fields member descriptors, their __doc__ has been None (os.stat_result.st_mode, time.struct_time.tm_year, _thread._ExceptHookArgs.exc_type). new_readonly_tuple_member now takes the field's database doc.

Results (macOS arm64, CPython 3.14.7 as reference)

A __doc__ dump over every builtin module's classes, functions and descriptors (5,168 entries) matches CPython in 201 more places than 1a259e4 and in none fewer.

The remaining 267 doc mismatches are all decimal.*, datetime.* and zoneinfo.*: RustPython uses _pydecimal, _pydatetime and _zoneinfo's pure-Python fallbacks there.

¹ functools._make_key, logging.shutdown, platform.architecture and _py_warnings._deprecated render set ordering, paths or sys.version_info in their defaults.

Release binary: 38,088,784 bytes, against 38,048,448 for a 1a259e4 build (+40 KB, mostly the new struct sequence field and attribute doc tables).

Verified with workspace + capi clippy (-D warnings), cargo check --no-default-features without doc, and cargo test --workspace. These unittests pass: test_inspect, test_pydoc, test_weakref, test_ctypes, test_json, test_codecs, test_ssl, test_posix, test_os, test_dict, test_sys, test_lzma, test_builtin, test_descr, test_types, test_zlib, test_csv, test_pickle, test_coroutines, test_time, test_structseq, test_thread and test_threading. extra_tests shows no new failures.

🤖 Generated with Claude Code