All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
ℹ️ Note that python-minifier depends on the python interpreter for parsing source code, and will output source code compatible with the version of the interpreter it is run with.
This means that if you minify code written for Python 3.11 using python-minifier running with Python 3.12, the minified code may only run with Python 3.12.
2.11.2 - 2024-10-03
- Using the positional only parameter separator
/
in method definitions could cause the following parameter to be incorrectly renamed in place, which could lead to failure if the method was called with that parameter as a keyword argument. This has been fixed.
2.11.1 - 2024-09-29
- Using the
--remove-class-attribute-annotations
option together with--rename-globals
was incorrectly causing class attributes to be renamed. Both of these options are unsafe for arbitrary code and are disabled by default but this was not the intended behavior, and has been fixed.
2.11.0 - 2024-09-26
- Python 3.13 support, including:
- PEP 696 Type parameter defaults
2.10.0 - 2024-09-15
-
Python 3.12 support, including:
- PEP 695 Type parameter syntax
- PEP 701 Improved f-strings
-
A new transform to remove the brackets when instantiating and raising built-in exceptions, which is enabled by default. e.g.
def a(): raise ValueError()
Will be minified to:
def a():raise ValueError
The raise statement automatically instantiates classes derived from Exception, so the brackets are not required.
-
A new constant folding transform, which is enabled by default. This will evaluate simple expressions when minifying, e.g.
SECONDS_IN_A_DAY = 60 * 60 * 24
Will be minified to:
SECONDS_IN_A_DAY=86400
-
Annotation removal is now more configurable, with separate options for:
- Removal of variable annotations (
--no-remove-variable-annotations
) - Removal of function return annotations (
--no-remove-return-annotations
) - Removal of function argument annotations (
--no-remove-argument-annotations
) - Removal of class attribute annotations (
--remove-class-attribute-annotations
)
The default behavior has changed, with class attribute annotations no longer removed by default. These are increasingly being used at runtime, and removing them can cause issues.
- Removal of variable annotations (
- Fixed various subtle issues with renaming of names that overlap class scope.
2.9.0 - 2023-05-01
-
A new transform to remove
return
statements that are not required, which is enabled by default. e.g.def important(a): if a > 3: return a if a < 2: return None a.adjust(1) return None
Will be minified to:
def important(a): if a > 3: return a if a < 2: return a.adjust(1)
-
The f-string debug specifier will now be used where possible, e.g.
f'my_var={my_var!r}'
will be minified tof'{my_var=}'
. The debug specifier should now be preserved where it is used in the input source. -
Many small improvements to minification to be more precise about where whitespace or parentheses required
- Thanks luk3yx for improving whitespace in relative import statements.
- A generator as the sole argument to a function call is no longer wrapped in parentheses
- float literals can use a more compact scientific notation
- Many more subtle improvements
2.8.1 - 2023-03-15
- A bug shortening names in the iterable of a comprehension when the original name was also used as a target in the comprehension
e.g.
def f(x): return [x for x in x]
would be incorrectly minified todef f(x):return[A for A in A]
, instead ofdef f(x):return[A for A in x]
.
2.8.0 - 2022-12-27
- New transforms that together work similarly to Python's -O option
- Remove asserts, which removes assert statements and is disabled by default
- Remove debug, which removes any
if
block that tests__debug__ is True
and is disabled by default
- When minifiying a directory, files ending with '.pyw' will now be minified.
2.7.0 - 2022-10-27
- Python 3.11 support, including exception groups syntax
- Improved detection of dataclasses when using the remove annotations transform, which suppresses removal of annotations for those classes
- Renamed
nonlocal
names could be incorrect if the name isn't local in the immediate parent function scope. (or it was bound in the immediate parent, but after the definition of the nested scope)
2.6.0 - 2022-04-10
- A new option to preserve the shebang line from the source file, which is enabled by default
- More flexible file processing options for the
pyminify
command:- A new
--output
argument for writing the minified output to a file without having to use shell redirection - A new
--in-place
option which overwrites the specified path with the minified output path
arguments may be directories, which minifies all *.py files below that directory- Multiple
path
arguments may be specified, which will all be minified
- A new
- Type information is included in the package to enable type checking of the public functions
- No longer assumes files read from stdin are utf-8.
2.5.0 - 2021-10-06
- Support for Python 3.10, including pattern matching syntax
- Makes better decisions about when renaming is space efficient
2.4.2 - 2021-06-28
- Rare Exceptions when encountering empty f-string str parts
- Missing required parentheses in return statements for iterable unpacking in python <3.8
- Missing parentheses in some complex dict expansions
- Python 2.6 support
2.4.1 - 2020-10-17
- When the remove annotation transformation is enabled, annotations are preserved on detected usage of TypedDict or NamedTuple
2.4.0 - 2020-10-15
- Support for Python 3.9, including:
- PEP 614 - Relaxing Grammar Restrictions On Decorators
2.3.2 - 2020-10-11
- await keyword can now be used in f-string expression parts
2.3.1 - 2020-05-04
args
andkwargs
could have been renamed incorrectly in Python 2.6/2.7, particularly when reminifying a file
2.3.0 - 2019-11-18
- Optional source transform:
- convert positional arguments to normal arguments, enabled by default
- Unnecessary spaces after ',' in tuple values
- Removing annotations for positional-only arguments (Thanks luk3yx!)
--no-remove-annotations
argument topyminify
had no effect
2.2.1 - 2019-11-03
- Unnecessary spaces after ';' in minified output have been removed
- Fixed PendingDeprecationWarnings
2.2.0 - 2019-10-27
- Support for Python 3.8 language features:
- Assignment expressions
- Positional parameters
- f-string = specifier
- Removed unnecessary parenthesis around yield statements
- Reading from stdin
2.1.2 - 2019-06-27
- Improved renaming performance
2.1.1 - 2019-04-07
- Removed redundant parentheses from comprehension iteration values
2.1.0 - 2019-01-24
- Optional source transforms:
- remove object base, enabled by default
- Return statements no longer wrap tuples in extraneous parentheses
- Duplicated literals are only raised to the lowest common function namespace
2.0.0 - 2019-01-13
- Optional source transformations:
- Rename locals, enabled by default
- Rename globals, disabled by default
- Minified code will no longer have leading or trailing whitespace
- Generated names for hoisted literals will have an initial underscore if rename globals is disabled
- Suites of simple statements won't create an indented block
- All transforms are now functional on all supported python versions
- The module docstring is not removed by the remove literal statements transformation if there is a name bound for it
- Python 3.7 dataclass field annotations are no longer removed when the remove annotation transformation is enabled
1.1.0 - 2018-06-05
- Optional source transformations:
- Combine import statements
- Remove annotations
- Remove pass statements
- Remove unused literals, including docstrings
- Move duplicated literals into module level variables
1.0.0 - 2018-05-25
- python-minifier package
- pyminify command