Mercurial > hgrepos > Python > libs > ConfigMix
annotate docs/changes.rst @ 251:2a8dcab2de8c
Do not implicitely convert a configuration value to text if the value is the result of just a variable expansion.
This is technically a breaking change. But no known client code uses the old
behaviour.
| author | Franz Glasner <fzglas.hg@dom66.de> |
|---|---|
| date | Tue, 07 Jul 2020 22:21:27 +0200 |
| parents | ab3d0326419c |
| children | 42a6d59cf2ad |
| rev | line source |
|---|---|
|
192
46c7d872db83
Changelog: note the latest refactorings
Franz Glasner <fzglas.hg@dom66.de>
parents:
176
diff
changeset
|
1 .. -*- coding: utf-8; mode: rst; -*- |
| 91 | 2 |
| 3 ========= | |
| 4 Changes | |
| 5 ========= | |
| 6 | |
|
111
d51a18e5b0e3
Reimplement configmix.safe_merge() do to a deepcopy of all source configurations when merging.
Franz Glasner <hg@dom66.de>
parents:
91
diff
changeset
|
7 All major changes over the versions are listed here. For breaking |
| 91 | 8 changes have a look at :ref:`api-changes`, they are listed there in |
| 9 detail. | |
| 10 | |
| 11 .. include:: ../CHANGES.txt | |
| 12 | |
| 13 | |
| 14 .. _api-changes: | |
| 15 | |
|
111
d51a18e5b0e3
Reimplement configmix.safe_merge() do to a deepcopy of all source configurations when merging.
Franz Glasner <hg@dom66.de>
parents:
91
diff
changeset
|
16 Breaking Changes |
|
d51a18e5b0e3
Reimplement configmix.safe_merge() do to a deepcopy of all source configurations when merging.
Franz Glasner <hg@dom66.de>
parents:
91
diff
changeset
|
17 ================ |
|
d51a18e5b0e3
Reimplement configmix.safe_merge() do to a deepcopy of all source configurations when merging.
Franz Glasner <hg@dom66.de>
parents:
91
diff
changeset
|
18 |
|
176
24a05dae0e76
FIX: Document the breaking change in the upcoming v0.7 in the chapter for "Breaking Changes" also
Franz Glasner <f.glasner@feldmann-mg.com>
parents:
160
diff
changeset
|
19 0.7 |
|
24a05dae0e76
FIX: Document the breaking change in the upcoming v0.7 in the chapter for "Breaking Changes" also
Franz Glasner <f.glasner@feldmann-mg.com>
parents:
160
diff
changeset
|
20 --- |
|
24a05dae0e76
FIX: Document the breaking change in the upcoming v0.7 in the chapter for "Breaking Changes" also
Franz Glasner <f.glasner@feldmann-mg.com>
parents:
160
diff
changeset
|
21 |
|
201
24f4ab79a3ab
FIX: Docu: "Overhowl" -> "Overhaul".
Franz Glasner <fzglas.hg@dom66.de>
parents:
192
diff
changeset
|
22 - A major overhaul of how filename extensions are associated with loaders |
|
192
46c7d872db83
Changelog: note the latest refactorings
Franz Glasner <fzglas.hg@dom66.de>
parents:
176
diff
changeset
|
23 has been done: |
|
46c7d872db83
Changelog: note the latest refactorings
Franz Glasner <fzglas.hg@dom66.de>
parents:
176
diff
changeset
|
24 |
|
46c7d872db83
Changelog: note the latest refactorings
Franz Glasner <fzglas.hg@dom66.de>
parents:
176
diff
changeset
|
25 + Filename extensions in :mod:`fnmatch` style are associated with |
|
205
344da17f01e3
Doc: wording in "Changes"
Franz Glasner <fzglas.hg@dom66.de>
parents:
201
diff
changeset
|
26 file-mode strings. |
|
344da17f01e3
Doc: wording in "Changes"
Franz Glasner <fzglas.hg@dom66.de>
parents:
201
diff
changeset
|
27 |
|
344da17f01e3
Doc: wording in "Changes"
Franz Glasner <fzglas.hg@dom66.de>
parents:
201
diff
changeset
|
28 These file-mode strings are associated with loader |
|
344da17f01e3
Doc: wording in "Changes"
Franz Glasner <fzglas.hg@dom66.de>
parents:
201
diff
changeset
|
29 functions separately via the mapping :py:data:`configmix.mode_loaders`. |
|
192
46c7d872db83
Changelog: note the latest refactorings
Franz Glasner <fzglas.hg@dom66.de>
parents:
176
diff
changeset
|
30 |
|
46c7d872db83
Changelog: note the latest refactorings
Franz Glasner <fzglas.hg@dom66.de>
parents:
176
diff
changeset
|
31 + :py:func:`configmix.set_assoc`, :py:func:`configmix.get_assoc`, |
|
46c7d872db83
Changelog: note the latest refactorings
Franz Glasner <fzglas.hg@dom66.de>
parents:
176
diff
changeset
|
32 :py:func:`configmix.clear_assoc` and |
|
46c7d872db83
Changelog: note the latest refactorings
Franz Glasner <fzglas.hg@dom66.de>
parents:
176
diff
changeset
|
33 :py:func:`configmix.get_default_assoc` are the new names for the old |
|
46c7d872db83
Changelog: note the latest refactorings
Franz Glasner <fzglas.hg@dom66.de>
parents:
176
diff
changeset
|
34 `set_loader()`, `get_loader()`, `clear_loader()` and |
|
46c7d872db83
Changelog: note the latest refactorings
Franz Glasner <fzglas.hg@dom66.de>
parents:
176
diff
changeset
|
35 `get_default_loader()` functions. |
|
205
344da17f01e3
Doc: wording in "Changes"
Franz Glasner <fzglas.hg@dom66.de>
parents:
201
diff
changeset
|
36 They are used for associating :mod:`fnmatch` style filename patterns |
|
344da17f01e3
Doc: wording in "Changes"
Franz Glasner <fzglas.hg@dom66.de>
parents:
201
diff
changeset
|
37 to file-mode strings. Previously they associated loader functions |
|
344da17f01e3
Doc: wording in "Changes"
Franz Glasner <fzglas.hg@dom66.de>
parents:
201
diff
changeset
|
38 directly. |
|
192
46c7d872db83
Changelog: note the latest refactorings
Franz Glasner <fzglas.hg@dom66.de>
parents:
176
diff
changeset
|
39 |
|
46c7d872db83
Changelog: note the latest refactorings
Franz Glasner <fzglas.hg@dom66.de>
parents:
176
diff
changeset
|
40 + :py:func:`configmix.set_assoc` now requires a :mod:`fnmatch` style |
|
46c7d872db83
Changelog: note the latest refactorings
Franz Glasner <fzglas.hg@dom66.de>
parents:
176
diff
changeset
|
41 pattern instead of just a file extension string (i.e. a plain trailer). |
|
46c7d872db83
Changelog: note the latest refactorings
Franz Glasner <fzglas.hg@dom66.de>
parents:
176
diff
changeset
|
42 The previons dictionary with mapping from filename extensions to loader |
|
46c7d872db83
Changelog: note the latest refactorings
Franz Glasner <fzglas.hg@dom66.de>
parents:
176
diff
changeset
|
43 callables is now a list of tuples containing the :mod:`fnmatch` style |
|
46c7d872db83
Changelog: note the latest refactorings
Franz Glasner <fzglas.hg@dom66.de>
parents:
176
diff
changeset
|
44 pattern and the corresponding loader callable. |
|
176
24a05dae0e76
FIX: Document the breaking change in the upcoming v0.7 in the chapter for "Breaking Changes" also
Franz Glasner <f.glasner@feldmann-mg.com>
parents:
160
diff
changeset
|
45 |
|
24a05dae0e76
FIX: Document the breaking change in the upcoming v0.7 in the chapter for "Breaking Changes" also
Franz Glasner <f.glasner@feldmann-mg.com>
parents:
160
diff
changeset
|
46 |
|
111
d51a18e5b0e3
Reimplement configmix.safe_merge() do to a deepcopy of all source configurations when merging.
Franz Glasner <hg@dom66.de>
parents:
91
diff
changeset
|
47 0.6 |
|
d51a18e5b0e3
Reimplement configmix.safe_merge() do to a deepcopy of all source configurations when merging.
Franz Glasner <hg@dom66.de>
parents:
91
diff
changeset
|
48 --- |
| 91 | 49 |
|
111
d51a18e5b0e3
Reimplement configmix.safe_merge() do to a deepcopy of all source configurations when merging.
Franz Glasner <hg@dom66.de>
parents:
91
diff
changeset
|
50 - :py:func:`configmix.safe_merge` does now a deepcopy of all source |
| 160 | 51 configurations when merging. Changes in configuration instances |
| 52 afterwards will not be reflected in the merged configuration any | |
| 53 more. | |
|
111
d51a18e5b0e3
Reimplement configmix.safe_merge() do to a deepcopy of all source configurations when merging.
Franz Glasner <hg@dom66.de>
parents:
91
diff
changeset
|
54 |
|
d51a18e5b0e3
Reimplement configmix.safe_merge() do to a deepcopy of all source configurations when merging.
Franz Glasner <hg@dom66.de>
parents:
91
diff
changeset
|
55 The public signature of :py:func:`configmix.safe_merge` has *not* |
|
d51a18e5b0e3
Reimplement configmix.safe_merge() do to a deepcopy of all source configurations when merging.
Franz Glasner <hg@dom66.de>
parents:
91
diff
changeset
|
56 changed. |
|
120
ba5970a2dcef
The default file encoding when reading INI style files with configmix.ini.load() is now "UTF-8".
Franz Glasner <f.glasner@feldmann-mg.com>
parents:
111
diff
changeset
|
57 |
|
ba5970a2dcef
The default file encoding when reading INI style files with configmix.ini.load() is now "UTF-8".
Franz Glasner <f.glasner@feldmann-mg.com>
parents:
111
diff
changeset
|
58 - The default file encoding when reading INI style files with |
|
ba5970a2dcef
The default file encoding when reading INI style files with configmix.ini.load() is now "UTF-8".
Franz Glasner <f.glasner@feldmann-mg.com>
parents:
111
diff
changeset
|
59 :py:func:`configmix.ini.load` is now "UTF-8". Previously it was undefined |
|
ba5970a2dcef
The default file encoding when reading INI style files with configmix.ini.load() is now "UTF-8".
Franz Glasner <f.glasner@feldmann-mg.com>
parents:
111
diff
changeset
|
60 and therefore dependent on the user's locale. |
