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.
- DOC: illustate how to write type-safe applications of
inifix.load
BUG: fix a bug where inifix-format --diff
would print extraneous trailing newlines
BUG: fix a confusing error message in validation routine for invalid iterable data
- BLD: drop support for CPython 3.8
- TST: add support for CPython 3.12
- DOC: fix a undesired asymmetry in usage example
- DEP: drop more-itertools as a dependency
- DOC: update link to Idefix
- MNT: migrate to src layout
BUG: fix type casting bugs affecting integers and strings
PERF: speedup parsing (take 3) This version is overall ~3x faster than inifix 4.1.0, and ~15% faster than inifix 4.3.0
- ENH: implement --skip-validation for inifix-format CLI
- DOC: improve documentation for pre-commit hooks and validation-skipping options
PERF: optimize parsing speed (reduce reading overhead by an additional 5%)
BUG: fix a regression (in 4.2.0) where signed floats were interpreted as strings
PERF: optimize parsing speed (reduce reading overhead by 60%)
- ENH: allow skipping validation in IO operations
- ENH: allow special character '.' in parameter names
TST: use requirement files instead of optional dependencies for tests and type checking
Installing with extra targets ([test]
and [typecheck]
) isn't supported anymore.
- ENH: optimize startup time
- ENH: add option to load scalars as single-element lists
This release contains a small, yet breaking change: in previous versions of
inifix, t
and f
were read as booleans. This feature was never documented
and was never supported in Idefix. Meanwhile, Idefix (dev) now supports reading
yes
and no
as booleans, so inifix will now also automatically parse these
special strings to booleans.
ENH: add support for binary IO
All internal IO operations are now performed in binary mode whenever possible, assuming UTF-8 encoding.
BUG: fix a regression (inifix 2.2.0) where inifix.dump was able to write to a file even if user doesn't have permission to.
- BUG: fix a critical bug in parsing lines with interleaved quoted strings and other types
- BUG: fix casting for numeric str
- ENH: file writing operations are now atomic
- BUG: fix a bug where formatting would affect spacing within quoted str values
- BUG: fix a bug where strings containing spacing would be dumped without correct quotes, making them appear as multiple separate values
- BUG: fix a bug where special strings 'true', 't', 'false' and 'f' would decay to boolean after two parsing cycles
- BUG: fix import * for inifix.io (add loads and dumps)
BUG: fix a bug where string values containing whitespaces would incorrectly be splitted
inifix-format
now won't report noop by default when files are already formatted.
It can be turned on again with the --report-noop
flag.
This makes the associated pre-commit hook much less verbose.
The format enforced by inifix-format was changed to improve compacity and readability. The new format is designed to be closer to manual formatting that is actually perfomed by Idefix users and contributors.
This is considered a major version change because the --name-column-size
CLI
flag and its corresponding keyword argument from inifix.format.iniformat
were
removed.
The API is otherwize identical to version 1.2.1
BUG: fix section invalidation
- ENH: add two functions to the public API to read from and write to strings (
inifix.loads
andinifix.dumps
) - BUG: use more conservative rules in int/float casting rules to better match Idefix's reading routines.
ENH: inifix-format now produces more compact files, with fewer empty lines. PR #98
BUG: don't try to be clever with cumulative retcodes to avoid retcode overflow PR #97
TYP: add py.typed marker file to improve downstream type-checking PR #94
TYP: improve type-correctness PR #93
The API is now declared stable and any future intentionally breaking change will follow a deprecation cycle.
- DEPR: drop support for Python 3.6 and 3.7, inifix now requires Python 3.8 or newer
- DEPR: end deprecation cycle for function arguments marked as "future-potisional-only"
- ENH: simplify internal logic (remove a non-user facing class, InifixConf)
- TYP: add mypy conf, add missing type annotations
BUG: fix formatting for files with only sections and comments (no parameters) PR #90
BUG: pretty print warnings from iniformat so they don't look as bad from the CLI PR #89
ENH: replace --inplace
option in inifix-format
with a --diff
option
PR #87
- ENH: expose name column length parameter to users in inifix-format PR #73
- BUG: fix formatter behaviour PR #83
BUG: fix a bug in str casting PR #80
ENH: improve schema validation and add a file validation pre-commit hook PR #74
This version is identical to 0.7.0 except that FutureWarning
s are now raised for
api calls using future positional-only arguments using the keyword syntax.
This version is identical to 0.6.0 except that it's compatibly for Python 3.6 to 3.10. Positional-only arguments are not specified any more because their are not available for Python versions earlier than 3.8 Warnings may be added in a following version to discourage usage of keyword syntax for these arguments.