mirrors/LibCST
1
0
Fork 0
mirror of https://github.com/Instagram/LibCST.git synced 2025-12-23 10:35:53 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
LibCST/CHANGELOG.md
Zsolt Dollenstein 96f53416e3
Bump version to 1.4.0 (#1152)
2024-05-22 10:20:33 -04:00

42 KiB
Raw Permalink Blame History

1.4.0 - 2024-05-22

Fixed

Added

New Contributors

Full Changelog: https://github.com/Instagram/LibCST/compare/v1.3.1...v1.4.0

1.3.1 - 2024-04-03

Fixed

1.3.0 - 2024-04-03

Updated

1.2.0 - 2024-02-19

Updated

Added

Fixed

New Contributors

Full Changelog: https://github.com/Instagram/LibCST/compare/v1.1.0...v1.2.0

1.1.0 - 2023-10-05

Added

  • PEP 695 support
    • parser: PEP 695 - Type Parameter Syntax #1004
    • Scope provider: support for type annotations #1014
  • PEP 701 support
    • parser: support arbitrarily nested f-strings #1026
    • parser: Parse multiline expressions in f-strings #1027
  • parser: Support files with mixed newlines #1007
  • libcst is now published to crates.io

Fixed

  • codemod/ApplyTypeAnnotationsVisitor: Do not annotate the same variable multiple times #956
  • parser: Don't swallow trailing whitespace #976
  • codemod/rename: Avoid duplicating import statements when the module name doesn't change #981

Updated

  • cli: Don't gather dirs ending .py #994
  • drop support for Python 3.7 #997
  • A few parser performance improvements:
    • Switch to using thread_local regular expressions to stop mutext contention #996
    • Remove need for regex in TextPosition::matches #1002
    • Remove Regexes from whitespace parser #1008

1.0.1 - 2023-06-07

Fixed

New Contributors

Full Changelog: https://github.com/Instagram/LibCST/compare/v1.0.0...v1.0.1

1.0.0 - 2023-05-25

The first major release of LibCST is essentially the same as 0.4.10, but using the newer, Rust-based parser implementation by default. The old, pure Python parser is scheduled for removal in the next (non-patch) release. Until then, it is available with the LIBCST_PARSER_TYPE environment variable set to pure.

Updated

0.4.10 - 2023-05-23

New Contributors

Added

Fixed

Full Changelog: https://github.com/Instagram/LibCST/compare/v0.4.9...v0.4.10

0.4.9 - 2022-11-10

Updated

Full Changelog: https://github.com/Instagram/LibCST/compare/v0.4.8...v0.4.9

0.4.8 - 2022-11-10

New Contributors

Fixed

Added

Full Changelog: https://github.com/Instagram/LibCST/compare/v0.4.7...v0.4.8

0.4.7 - 2022-07-12

New Contributors

Fixed

Added

0.4.6 - 2022-07-04

New Contributors

Fixed

0.4.5 - 2022-06-17

New Contributors

Fixed

0.4.4 - 2022-06-13

New Contributors

Added

Updated

0.4.3 - 2022-05-11

Fixed

0.4.2 - 2022-05-04

New Contributors

Fixed

Added

Updated

0.4.1 - 2022-01-28

New Contributors

Added

Updated

Fixed

0.4.0 - 2022-01-12

This release contains a new parsing infrastructure that is turned off by default. You can enable it by setting the LIBCST_PARSER_TYPE environment variable to native before parsing an input with the usual LibCST APIs. Parsing Python 3.10 documents is only supported in this new mode.

Note: the new parser is built as a native extension, so LibCST will ship with binary wheels from now on.

Added

  • Implement a Python PEG parser in Rust by @zsol in #566
  • implement PEP-654: except* by @zsol in #571
  • Implement PEP-634 - Match statement by @zsol in #568
  • Add instructions to codegen test failures by @stroxler in #582
  • Support Parenthesized With Statements by @stroxler in #584
  • Support relative imports in AddImportsVisitor by @martindemello in #585
  • Codemod for PEP 484 Assign w / type comments -> PEP 526 AnnAssign by @stroxler in #594

Updated

  • Update license headers by @zsol in #560
  • Use precise signature matching when inserting function type annotations by @martindemello in #591

0.3.23 - 2021-11-23

Fixed

  • Fix missing string annotation references #561

0.3.22 - 2021-11-22

Added

  • Add --indent-string option to libcst.tool print #525
  • Publish pre-release packages to test.pypi.org #550
  • Add ImportAssignment class extending Assignment to record assignments for import statements #554

Fixed

  • Various documentation fixes #527, #529
  • Do not add imports if we added no type info in ApplyTypeAnnotationVisitor (commit)
  • Support relative imports in ApplyTypeAnnotationVisitor qualifier handling #538
  • Don't gather metadata if the wrapper already contains it #545
  • Swallow parsing errors in string annotations #548
  • Stop parsing string annotations when no longer in a typing call #546

Updated

  • Move find_qualified_names_for in the Assignment class #557

0.3.21 - 2021-09-21

Fixed

  • Fix pyre command for type inference provider #523

Updated

0.3.20 - 2021-08-09

Fixed

  • Don't reset subprocess environment to fix codemodding on windows #495
  • TypeAnnotationsVisitor: don't truncate function return type #499
  • Docs: Fix typo #492

0.3.19 - 2021-05-12

Updated

  • Return more specific QNames for assignments #477
  • Tie accesses from string annotation to the string node #483

Fixed

  • Fix leaking processes from TypeInferenceProvider #474
  • Fix TypeInferenceProvider breakage with empty cache #476
  • Fix formatting for link to QualifiedName class in docs #480

0.3.18 - 2021-03-29

Added

  • Add FlattenSentinel to support replacing a statement with multiple statements #455
  • Add BuiltinScope #469
  • Add FullyQualifiedNameProvider #465

Updated

  • Split QualifiedNameProvider out from libcst.metadata.scope_provider #464

Fixed

  • Exception while parsing escape character in raw f-strings #462

0.3.17 - 2021-02-08

Updated

  • Optimization: reduce the number of unused parallel processes #440

Fixed

  • Walrus operator's left hand side now has STORE expression context #443
  • ApplyTypeAnnotationsVisitor applies parameter annotations even if no return type is declared #445
  • Work around Windows problem by using dummy pool for jobs=1 #436
  • Remove extra unused imports added in other files #453

0.3.16 - 2020-12-16

Added

  • Support PEP-604 style unions in decorator annotations #429
  • Gathering exports in augmented assignment statements #426

Fixed

  • Don't allow out of order accesses in the global scope #431
  • Handle scope ordering in For statements #430
  • Fix for not parsing subscripts such as cast()["from"] #428
  • Walrus operator's left hand side now has STORE expression context #433

0.3.15 - 2020-12-01

Added

  • Support Named Unicode Characters and yield in f-strings #424

Fixed

  • Assignment/access ordering in comprehensions #423
  • Referencing of remaining objects in cast() #422

0.3.14 - 2020-11-18

Fixed

  • Fix is_annotation for types used in classdef base and assign value #406
  • Visit concatenated f-strings during scope analysis #411
  • Correct handling of walrus operator in function args #417
  • Allow generator expressions in f-strings #419
  • Keep track of assignment/access ordering during scope analysis #413
  • Handle string type references in cast() during scope analysis #418

0.3.13 - 2020-10-12

Fixed

  • Use correct type for AugAssign and AnnAssign target #396
  • Support string annotations for type aliases #401

0.3.12 - 2020-10-01

Fixed

  • fix RemoveImportsVisitor crash when ImportAlias is inserted without comma #397
  • Provide STORE for {Class,Function}Def.name in ExpressionContextProvider #394

0.3.11 - 2020-09-29

Added

  • Implement TypeOf matcher #384

Updated

  • Update return type of ParentNodeProvider to be CSTNode #377
  • Add source code links to each class/function #378

Fixed

  • Removing an import alias with a trailing standalone comment should preserve the comment #392

0.3.10 - 2020-09-17

Added

  • Handle string annotations in ScopeProvider #373
  • Add is_annotation subtype for Access inreferences. #372

Updated

  • Call pyre query with noninteractive logging #371
  • Replace matchers with explicit visitation in gatherers #366
  • Include missing test data in install #365

Fixed

  • Spaces around walrus operator are not required #368
  • SaveMachedNode now matches with trailing empty wildcards #356
  • Correctly extract wildcard matchers #355

0.3.9 - 2020-09-07

Added

  • Support string type annotations in RemoveUnusedImports #353
  • Add scope to ImportAlias #350
  • Add scope to ClassDef #349

Fixed

  • Fixed all pyre related errors #360
  • Fixed enclosing attribute for attributes in call arguments #362

0.3.8 - 2020-07-22

Added

  • Handle type subscripts when applying annotations. #335
  • Added FullRepoManager cache property #330
  • Added optional args for tox commands #327

Updated

  • Only remove trailing comma if the last alias is removed #334

Fixed

  • Fixed inserting imports after module docstring #343
  • Fixed ParenthesizedWhitespace before params in FuncDef #342
  • Fixed validation for ImportAlias and Try statements #340
  • Fixed NotEqual position issue #325
  • Fixed minor typo in scope_provider.py #324

0.3.7 - 2020-06-24

Added

  • Added RenameCommand to rename all instances of a local or imported object to a specified new name. #308

Updated

  • Upgraded Codecov dev dependency to 2.1.4. #311
  • Enabled Pyre strict mode by default. #313

Fixed

  • Fixed ImportError under Python 3.9. #306
  • Fixed stdout being plugged into successfully codemod-ed files. #309
  • Fixed QualifiedName retrieval for names with repeated substrings. #312
  • Fixed default values of keyword-only and positional-only arguments in ApplyTypeAnnotationsVisitor. #314
  • Fixed ExpressionContextProvider by giving subscript values a LOADcontext. #319

0.3.6 - 2020-05-27

Added

  • Added ConvertNamedTupleToDataclassCommand to convert NamedTuple class declarations to Python 3.7 dataclasses using the @dataclass(frozen=True) decorator. #299

Fixed

  • Fixed typo in file name libcst/codemod/commands/convert_percent_format_to_fstring.py. #301
  • Fixed StopIteration exception during scope analysis matching on import names. #302

0.3.5 - 2020-05-12

Updated

  • Expose more granular Assignments and Accesses for dotted imports in ScopeProvider. #284
  • get_qualified_names_for returns the most appropriate qualified name. #290
  • Surface SyntaxError raised by formatter in codemod run. #288 #289
  • Rename ApplyTypeAnnotationsVisitor.add_stub_to_context as ApplyTypeAnnotationsVisitor.store_stub_in_context and add overwrite_existing_annotations to allow overwrite existing type annotations. #289

Fixed

  • Close opened file handles on finishing codemod to avoid Too many open files on OSX. #283

Deprecated

  • ApplyTypeAnnotationsVisitor.add_stub_to_context is renamed as ApplyTypeAnnotationsVisitor.store_stub_in_context.

0.3.4 - 2020-03-27

Added

  • Supported CST parsing for Python 3.0, 3.1 and 3.3. #261
  • Added RemoveUnusedImportsCommand for removing unused import codemod. #266
  • Added ApplyTypeAnnotationsVisitor.add_stub_to_context for apply type annotations from stub modules. #265

Updated

  • Improved exception message of get_metadata when MetadataWrapper is not used. #257
  • New steps for Pyre type check in README.rst which analyzes installed Python sources for better type checking. #262

Fixed

  • Parsed except(Exception): correctly while there is no space after except syntax. #256
  • Fixed RemoveImportsVisitor to not remove imports when references still exist. #264
  • Fixed missing type annotations. #271
  • AddImportsVisitor generates deterministic order for added imports. #274

0.3.3 - 2020-03-05

Added

  • ByteSpanPositionProvider provides start offset and length of CSTNode as metadata.
  • get_docstring helper provides docstring from Module, ClassDef and FunctionDef node types.

Updated

  • Optimized ScopeProvider performance to run faster and use less memory:
    • remove unnecessary Assignment of keyword Arg.
    • don't provide scope object for formatting information nodes.
    • batch set union updates in infer_accesses step.

Fixed

  • Fixed _assignments mutation when calling read-only Scope.get_qualified_names_for and __contains__.

0.3.2 - 2020-02-24

Added

  • Added RemoveImportsVisitor to remove an import if it's not used in a module.
  • Added GatherExportsVisitor to gather exports specified in __all__.
  • Added property helpers evaluated_name and evaluated_name in ImportAlias.
  • Added helper to get full module name: get_absolute_module_for_import and get_absolute_module_for_import_or_raise.
  • Added CodemodContext.full_module_name for full dotted module name.
  • Added format specifiers f-string conversion support to ConvertFormatStringCommand.

Updated

  • Moved LibCST version to _version.py and can print it by python -m libcst.tool --version.
  • Improved EnsureImportPresentCommand with --alias option.
  • Improved ConvertFormatStringCommand with --allow-strip-comments and --allow-await options.

0.3.1 - 2020-02-06

Added

  • Added helpers to get both the raw and evaluated value of a SimpleString.
  • Added helpers to get the quoting and prefix of SimpleString and FormattedString.
  • Added a helper to get the evaluated value of number types.
  • Added templated parsers for statement/expression/module to make constructing updated nodes in transforms easier.
  • FullRepoManager is now integrated into codemods, so metadata requiring full repo analysis can now be used.
  • Added get_full_name_for_node_or_raise helper to remove boilerplate of checking against None.

Updated

  • Upgraded Pyre dependency to 0.0.41.
  • Added additional status to libcst codemod command.
  • get_full_name_for_node now supports decorators.

Fixed

  • Clarified documentation around f-strings, fixed indentation.
  • Fixed libcst list crashing if a codemod does unsafe work on import.
  • Fixed deploy-time dependencies so pyyaml won't have to be manually installed to execute codemods.
  • QualifiedNameProvider no longer erroneously claims names inside attributes are built-ins.

0.3.0 - 2020-01-16

Added

  • Added support for parsing and rendering Python 3.8 source code.
  • Added more documentation for codemods.
  • Added get_full_name_for_expression helper method.
  • Added has_name helper to QualifiedNameProvider.
  • Added a --python-version flag to libcst.tool print utility.

Updated

  • Codemod command can now discover codemods in subdirectories of configured modules.
  • Updgraded Pyre dependency to 0.0.39.

Fixed

  • Cleaned up some typos and formatting issues in comments and documentation.
  • Cleaned up a few redundant typevars.
  • Fixed callable typing in matchers implementation.
  • Fixed incorrect base class references in matcher decorator attribute visitors.
  • Fixed codemod test assertion failing for some whitespace edge cases.
  • Fixed scope analysis to track variable usage on del statements.

Deprecated

  • Deprecated exporting ensure_type from libcst in favor of libcst.helpers.

Removed

  • Removed ExtSlice and helper code in favor of SubscriptElement.
  • Removed default_params attribute on Parameters.
  • Removed SyntacticPositionProvider and BasicPositionProvider.
  • Removed CodePosition and CodeRange exports on libcst in favor of libcst.metadata.

0.2.7 - 2020-01-07

Updated

  • Command-line interface now shows rough estimate of time remaining while executing a codemod.
  • Add needed import now supports import aliases.

0.2.6 - 2020-01-01

Added

  • Added Codemod framework for running code transform over a codebase in parallel.
    • Codemod for code transform logic.
    • CodemodContext for preserving states across transforms.
    • CodemodCommand for CLI interface.
    • CodemodTest for testing codemod easily.
    • yaml codemod config.
    • Pre-build commands in codemod/commands/.
  • Added TypeInferenceProvider for inferred type info from Pyre. A regression test suite was included.
  • Added FullRepoManager for metadata inter-process cache handing.

Fixed

  • Fixed usage link in README.
  • Fixed type annotation for Mypy compatibility.

Updated

  • Upgraded Pyre to 0.0.38

0.2.5 - 2019-12-05

Added

  • Added extract, extractall and replace functions to Matchers API.

Fixed

  • Fixed length restrictions for AllOf and OneOf so that they can be used with sequence expansion operators.
  • Fixed batchable visitors not calling attribute visit functions.
  • Fixed typos in docstrings.
  • Fixed matcher type exception not being pickleable.

Deprecated

  • Deprecated parsing function parameters with defaults into default_params attribute. They can be found in the params attribute instead.

0.2.4 - 2019-11-13

Fixed

  • Fixed broken types for sequence matchers.

0.2.3 - 2019-11-11

Added

  • Preliminary support for 3.8 walrus operator.
  • CI config and fuzz tests for 3.8.
  • Experimental re-entrant codegen API.
  • Added unsafe_skip_copy optimization to MetadataWrapper.
  • Matchers API now includes a findall function.
  • Matchers now have a MatchMetadataIfTrue special matcher.

Updated

  • Updated to latest Black release.
  • Better type documentation for generated matchers.

Fixed

  • Clarified matchers documentation in several confusing areas.
  • Drastically sped up codegen and tests.
  • QualifiedName now supports imported attributtes.
  • ExpressionContext properly marks loop variables as STORE.
  • Various typos in documentation are fixed.

Deprecated

  • Deprecated BasicPositionProvider and SyntacticPositionProvider in favor of WhitespaceInclusivePositionProvider and PositionProvider.

0.2.2 - 2019-10-24

Added

  • Added deep_with_changes helper method on CSTNode.
  • Added metadata support to matchers.
  • Added ability to get the defining node from a LocalScope (FunctionScope, ClassScope or ComprehensionScope).

Updated

  • Many changes to LibCST documentation including a new best practices page and updated scope tutorial.
  • Exported CodePosition and CodeRange from libcst.metadata instead of libcst.

Fixed

  • Disallowed decorating a concrete visit or leave method with @visit or @leave decorators.
  • Renamed position provider classes to be more self-explanatory.
  • Fixed trailing newline detection when the last character in a file was from a continuation.
  • Fixed deep_clone potentially blowing the stack with large LibCST trees.

Deprecated

  • Deprecated ExtSlice in favor of SubscriptElement.
  • Deprecated parsing Subscript slices directly into Index or Slice nodes.

0.2.1 - 2019-10-14

Added

  • Scope.assignments and Scope.accesses APIs to access all references in a scope.
  • Scope analysis tutorial.

Updated

  • Supported <comprehension> in Scope.get_qualified_names_for and QualifiedName.
  • Enforced identity equality for matchers and immutability of non-dataclass matchers.
  • Generalize codegen cleanup steps for all codegen.

Fixed

  • Made BatchableMetadataProvider typing covariant over its typevar.
  • Fixed LICENSE header on generated matcher file.
  • Cleanup unused internal noqa and on-call specification.

0.2.0 - 2019-10-04

Added

  • Added matchers which allow comparing LibCST trees against arbitrary patterns.
  • Improved tree manipulation with deep_remove and deep_replace helper methods on CSTNode.
  • Added new metadata providers: parent node and qualified name.

Updated

  • Updated Pyre to latest release.
  • Updated scope metadata to provide additional helpers.
  • Updated preferred method of removing a node from its parent in a visitor.

Fixed

  • Metadata classes and methods are now exported from "libcst.metadata" instead of several submodules.
  • Fixed LICENSE file to explicitly reference individual files in the repo with different licenses.
  • Fixed deep_clone to correctly clone leaf nodes.
  • Fixed all parse entrypoints to always return a tree with no duplicated leaf nodes.

0.1.3 - 2019-09-18

Added

  • Added preliminary support for parsing Python 3.5 and Python 3.6 source.
  • Added scope analysis metadata provider.
  • Added mypy type support for built package.

Fixed

  • Several typos in documentation are fixed.

0.1.2 - 2019-08-29

Added

  • Added attribute visitor hooks.
  • Added base visit/leave methods which can be subclassed.
  • Hypothesis fuzz testing suite, courtesy of Zac Hatfield-Dodds.

Fixed

  • Metadata documentation is much more complete.
  • Fixed several whitespace validation issues caught by Hypothesis.
  • Parser syntax errors are now used inside parser.

0.1.1 - 2019-08-20

Added

  • Metadata interface is now exported.

Fixed

  • Dependencies are now specified with minimum revisions.
  • Lots of documentation fixes.

0.1 - 2019-07-23

Added

  • First public release of LibCST.
  • Complete, fully typed syntax tree for Python 3.6.
  • Full suite of tests for each defined node type.