Release develop into main

[hakancelikdev]

Brings everything reviewed on develop into main: 60 commits, from PRs #31–#36, #38 and #46–#64.

Python support

• Python 3.10–3.14 are supported; 3.8 and 3.9 are dropped (Support for python 3.12 #28, Support for python 3.13 #29, Support for python 3.14 #30, Require Python 3.10+ and mark the project as Beta #38).
• ast.Str is no longer used (3.14).

__all__ correctness

• Imports
  • Re-exported imports already listed in __all__ are kept (Re-exported imports are removed from __all__ #39).
  • # unexport: not-public works on imports (Honor # unexport: not-public on imports #57).
  • An imported or unpacked __all__ is treated as dynamic (Treat an imported or unpacked __all__ as dynamic instead of overriding it #60).
• Names that don't exist at runtime are not exported (Names that don't exist at runtime are added to __all__ #40)
  • del, including X = 1; del X on one line
  • names under if TYPE_CHECKING:, the main guard or if False:
  • comprehension variables, and walrus targets in lambdas
  • bare annotations (X: int)
  • TypeVars, including those bound by tuple unpacking (Don't add TypeVars to __all__ #34, Don't export TypeVars bound by tuple unpacking #56)
  • names bound in only one branch of an undecidable if (Don't add names that are bound in only one branch of an undecidable if #64)
• Listed names kept because they exist at runtime (Keep listed names that exist at runtime without a visible binding #61): package submodules, PEP 562 __getattr__, globals() / @enum.global_enum and match captures.
• Other __all__ handling
  • Duplicate names are listed once (A name defined both as a class/function and a variable is listed twice in __all__ #43).
  • A stale __all__ is emptied (A stale __all__ is never fixed when nothing is public anymore #45); an empty set becomes set() (Write set() instead of {} when a set __all__ becomes empty #54).
  • Every __all__ form is read (+=, annotated, append/extend, inside if/try). One built from several statements, or holding comments, is reported but not rewritten (__all__ built with +=, an annotation, extend(tuple) or concatenation is misread and rewritten incorrectly #41, Don't drop comments inside __all__, and only read markers from comments #63).

Refactoring

• Token-level rewrite that keeps formatting and is UTF-8 column safe (Make the refactoring feature at the token level. #12, Refactor __all__ as beautifully #22).
• A new __all__ is inserted after the docstring, shebang or coding line (New __all__ is inserted above the module docstring #42), and correctly when the file ends with an import (Fix inserting __all__ after an import that ends the file #53).
• CRLF newlines are kept (Keep the file's newline style when refactoring #62).

CLI

• Unreadable, undecodable, null-byte and syntax-error files are reported with exit code 1 (Syntax errors are silently ignored and unreadable files crash the run #44, Report files with null bytes as errors instead of crashing #58).
• # unexport: markers are only read from comments (Don't drop comments inside __all__, and only read markers from comments #63).

Checks

CI passed on every merged PR. The combined branch passes on 3.10 / 3.12 / 3.14, and pre-commit, mypy and the self-check pass.

Closes #37

🤖 Generated with Claude Code

https://claude.ai/code/session_019P9bvuGwAyVCNUdsAYPB1V

---

Generated by Claude Code