bibtexparser 2.0.0b7__tar.gz → 2.0.0b8__tar.gz

{bibtexparser-2.0.0b7 → bibtexparser-2.0.0b8}/LICENSE

@@ -18,4 +18,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

{bibtexparser-2.0.0b7 → bibtexparser-2.0.0b8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: bibtexparser
-Version: 2.0.0b7
+Version: 2.0.0b8
 Summary: Bibtex parser for python 3
 Home-page: https://github.com/sciunto-org/python-bibtexparser
 Author: Michael Weiss and other contributors
@@ -21,10 +21,6 @@ Requires-Dist: pytest; extra == "test"
 Requires-Dist: pytest-xdist; extra == "test"
 Requires-Dist: pytest-cov; extra == "test"
 Requires-Dist: jupyter; extra == "test"
-Provides-Extra: lint
-Requires-Dist: black==23.3.0; extra == "lint"
-Requires-Dist: isort==5.12.0; extra == "lint"
-Requires-Dist: docstr-coverage==2.2.0; extra == "lint"
 Provides-Extra: docs
 Requires-Dist: sphinx; extra == "docs"
 
@@ -49,11 +45,11 @@ If instead, you want to use v1, install it using:
 pip install bibtexparser~=1.0
 ```
 
-Note that all development and maintenance effort is focussed on v2. 
+Note that all development and maintenance effort is focussed on v2.
 Small PRs for v1 are still accepted, but only as long as they are backwards compatible and don't introduce much additional technical debt.
-Development of version one happens on the dedicated [v1 branch](https://github.com/sciunto-org/python-bibtexparser/tree/v1). 
+Development of version one happens on the dedicated [v1 branch](https://github.com/sciunto-org/python-bibtexparser/tree/v1).
 
-The remainder of this README is specific to v2. 
+The remainder of this README is specific to v2.
 
 ## Documentation
 Go check out our documentation on [https://bibtexparser.readthedocs.io/en/main/](https://bibtexparser.readthedocs.io/en/main/).
@@ -96,7 +92,7 @@ new_bibtex_string = bibtexparser.write_string(bib_database,
 )
 ```
 
-These examples really only show the bare minimum. 
+These examples really only show the bare minimum.
 Consult the documentation for a list of available middleware, parsing options and write-formatting options.
 
 ## V2 Architecture and Terminology
@@ -106,21 +102,21 @@ Consult the documentation for a list of available middleware, parsing options an
 The architecture consists of the following components:
 
 #### Library
-Reflects the contents of a parsed bibtex files, including all comments, entries, strings, preamples and their metadata (e.g. order). 
+Reflects the contents of a parsed bibtex files, including all comments, entries, strings, preamples and their metadata (e.g. order).
 
 #### A Splitter
 Splits a bibtex string into basic blocks (Entry, String, Preamble, ...), with correspondingly split content (e.g. fields on Entry, key-value on String, ...).
-The splitter aims to be forgiving when facing invalid bibtex: A line starting with a block definition (`@....`) ends the previous block, even if not yet every bracket is closed, failing the parsing of the previous block. Correspondingly, one block type is "ParsingFailedBlock".
+The splitter aims to be forgiving when facing invalid bibtex: A line starting with a block definition (``@....``) ends the previous block, even if not yet every bracket is closed, failing the parsing of the previous block. Correspondingly, one block type is "ParsingFailedBlock".
 
 #### Middleware
-Middleware layers transform a library and its blocks, for example by decoding latex special characters, interpolating string references, resoling crossreferences or re-ordering blocks. Thus, the choice of middleware allows to customize parsing and writing to ones specific usecase. Note: Middlewares, by default, no not mutate their input, but return a modified copy. 
+Middleware layers transform a library and its blocks, for example by decoding latex special characters, interpolating string references, resoling crossreferences or re-ordering blocks. Thus, the choice of middleware allows to customize parsing and writing to ones specific usecase. Note: Middlewares, by default, no not mutate their input, but return a modified copy.
 
 #### Writer
-Writes the content of a bibtex library to a `.bib` file. Optional formatting parameters can be passed using a corresponding dedicated data structure.
+Writes the content of a bibtex library to a ``.bib`` file. Optional formatting parameters can be passed using a corresponding dedicated data structure.
 
 ## About
 
-Since 2022, `bibtexparser` is primarily written and maintained by Michael Weiss ([@MiWeiss](https://github.com/MiWeiss/)). In 2024, Tom de Geus ([@tdegeus](https://github.com/tdegeus)) joined as co-maintainer. 
+Since 2022, `bibtexparser` is primarily written and maintained by Michael Weiss ([@MiWeiss](https://github.com/MiWeiss/)). In 2024, Tom de Geus ([@tdegeus](https://github.com/tdegeus)) joined as co-maintainer.
 
 Credits and thanks to the many contributors who helped creating this library, including
 François Boulogne ([@sciunto](https://github.com/sciunto/), creator of the first version) and Olivier Mangin ([@omangin](https://github.com/omangin/), long-term contributor).

{bibtexparser-2.0.0b7 → bibtexparser-2.0.0b8}/README.md

@@ -19,11 +19,11 @@ If instead, you want to use v1, install it using:
 pip install bibtexparser~=1.0
 ```
 
-Note that all development and maintenance effort is focussed on v2. 
+Note that all development and maintenance effort is focussed on v2.
 Small PRs for v1 are still accepted, but only as long as they are backwards compatible and don't introduce much additional technical debt.
-Development of version one happens on the dedicated [v1 branch](https://github.com/sciunto-org/python-bibtexparser/tree/v1). 
+Development of version one happens on the dedicated [v1 branch](https://github.com/sciunto-org/python-bibtexparser/tree/v1).
 
-The remainder of this README is specific to v2. 
+The remainder of this README is specific to v2.
 
 ## Documentation
 Go check out our documentation on [https://bibtexparser.readthedocs.io/en/main/](https://bibtexparser.readthedocs.io/en/main/).
@@ -66,7 +66,7 @@ new_bibtex_string = bibtexparser.write_string(bib_database,
 )
 ```
 
-These examples really only show the bare minimum. 
+These examples really only show the bare minimum.
 Consult the documentation for a list of available middleware, parsing options and write-formatting options.
 
 ## V2 Architecture and Terminology
@@ -76,21 +76,21 @@ Consult the documentation for a list of available middleware, parsing options an
 The architecture consists of the following components:
 
 #### Library
-Reflects the contents of a parsed bibtex files, including all comments, entries, strings, preamples and their metadata (e.g. order). 
+Reflects the contents of a parsed bibtex files, including all comments, entries, strings, preamples and their metadata (e.g. order).
 
 #### A Splitter
 Splits a bibtex string into basic blocks (Entry, String, Preamble, ...), with correspondingly split content (e.g. fields on Entry, key-value on String, ...).
-The splitter aims to be forgiving when facing invalid bibtex: A line starting with a block definition (`@....`) ends the previous block, even if not yet every bracket is closed, failing the parsing of the previous block. Correspondingly, one block type is "ParsingFailedBlock".
+The splitter aims to be forgiving when facing invalid bibtex: A line starting with a block definition (``@....``) ends the previous block, even if not yet every bracket is closed, failing the parsing of the previous block. Correspondingly, one block type is "ParsingFailedBlock".
 
 #### Middleware
-Middleware layers transform a library and its blocks, for example by decoding latex special characters, interpolating string references, resoling crossreferences or re-ordering blocks. Thus, the choice of middleware allows to customize parsing and writing to ones specific usecase. Note: Middlewares, by default, no not mutate their input, but return a modified copy. 
+Middleware layers transform a library and its blocks, for example by decoding latex special characters, interpolating string references, resoling crossreferences or re-ordering blocks. Thus, the choice of middleware allows to customize parsing and writing to ones specific usecase. Note: Middlewares, by default, no not mutate their input, but return a modified copy.
 
 #### Writer
-Writes the content of a bibtex library to a `.bib` file. Optional formatting parameters can be passed using a corresponding dedicated data structure.
+Writes the content of a bibtex library to a ``.bib`` file. Optional formatting parameters can be passed using a corresponding dedicated data structure.
 
 ## About
 
-Since 2022, `bibtexparser` is primarily written and maintained by Michael Weiss ([@MiWeiss](https://github.com/MiWeiss/)). In 2024, Tom de Geus ([@tdegeus](https://github.com/tdegeus)) joined as co-maintainer. 
+Since 2022, `bibtexparser` is primarily written and maintained by Michael Weiss ([@MiWeiss](https://github.com/MiWeiss/)). In 2024, Tom de Geus ([@tdegeus](https://github.com/tdegeus)) joined as co-maintainer.
 
 Credits and thanks to the many contributors who helped creating this library, including
 François Boulogne ([@sciunto](https://github.com/sciunto/), creator of the first version) and Olivier Mangin ([@omangin](https://github.com/omangin/), long-term contributor).

bibtexparser-2.0.0b8/bibtexparser/__init__.py

@@ -0,0 +1,11 @@
+import bibtexparser.exceptions
+import bibtexparser.middlewares
+import bibtexparser.model
+from bibtexparser.entrypoint import parse_file
+from bibtexparser.entrypoint import parse_string
+from bibtexparser.entrypoint import write_file
+from bibtexparser.entrypoint import write_string
+from bibtexparser.library import Library
+from bibtexparser.writer import BibtexFormat
+
+__version__ = "2.0.0b8"

{bibtexparser-2.0.0b7 → bibtexparser-2.0.0b8}/bibtexparser/entrypoint.py

@@ -1,11 +1,17 @@
 import warnings
-from typing import Iterable, List, Optional, TextIO, Union
+from typing import Iterable
+from typing import List
+from typing import Optional
+from typing import TextIO
+from typing import Union
 
 from .library import Library
 from .middlewares.middleware import Middleware
-from .middlewares.parsestack import default_parse_stack, default_unparse_stack
+from .middlewares.parsestack import default_parse_stack
+from .middlewares.parsestack import default_unparse_stack
 from .splitter import Splitter
-from .writer import BibtexFormat, write
+from .writer import BibtexFormat
+from .writer import write
 
 
 def _build_parse_stack(
@@ -27,7 +33,7 @@ def _build_parse_stack(
         return list(parse_stack)
 
     parse_stack_types = [type(m) for m in parse_stack]
-    append_stack_types = set([type(m) for m in append_middleware])
+    append_stack_types = {type(m) for m in append_middleware}
     stack_types_intersect = set(parse_stack_types).intersection(append_stack_types)
     if len(stack_types_intersect) > 0:
         warnings.warn(
@@ -57,7 +63,7 @@ def _build_unparse_stack(
         return list(unparse_stack)
 
     parse_stack_types = [type(m) for m in unparse_stack]
-    append_stack_types = set([type(m) for m in prepend_middleware])
+    append_stack_types = {type(m) for m in prepend_middleware}
     stack_types_intersect = set(parse_stack_types).intersection(append_stack_types)
     if len(stack_types_intersect) > 0:
         warnings.warn(

{bibtexparser-2.0.0b7 → bibtexparser-2.0.0b8}/bibtexparser/exceptions.py

@@ -1,4 +1,5 @@
-from typing import List, Optional
+from typing import List
+from typing import Optional
 
 
 class ParsingException(Exception):

{bibtexparser-2.0.0b7 → bibtexparser-2.0.0b8}/bibtexparser/library.py

@@ -1,15 +1,15 @@
-from typing import Dict, List, Union
-
-from .model import (
-    Block,
-    DuplicateBlockKeyBlock,
-    Entry,
-    ExplicitComment,
-    ImplicitComment,
-    ParsingFailedBlock,
-    Preamble,
-    String,
-)
+from typing import Dict
+from typing import List
+from typing import Union
+
+from .model import Block
+from .model import DuplicateBlockKeyBlock
+from .model import Entry
+from .model import ExplicitComment
+from .model import ImplicitComment
+from .model import ParsingFailedBlock
+from .model import Preamble
+from .model import String
 
 # TODO Use functools.lru_cache for library properties (which create lists when called)
 
@@ -24,9 +24,7 @@ class Library:
         if blocks is not None:
             self.add(blocks)
 
-    def add(
-        self, blocks: Union[List[Block], Block], fail_on_duplicate_key: bool = False
-    ):
+    def add(self, blocks: Union[List[Block], Block], fail_on_duplicate_key: bool = False):
         """Add blocks to library.
 
         The adding is key-safe, i.e., it is made sure that no duplicate keys are added.
@@ -34,7 +32,8 @@ class Library:
         a DuplicateKeyBlock.
 
         :param blocks: Block or list of blocks to add.
-        :param fail_on_duplicate_key: If True, raises ValueError if a block was replaced with a DuplicateKeyBlock.
+        :param fail_on_duplicate_key:
+            If True, raises ValueError if a block was replaced with a DuplicateKeyBlock.
         """
         if isinstance(blocks, Block):
             blocks = [blocks]
@@ -49,7 +48,7 @@ class Library:
         if fail_on_duplicate_key:
             duplicate_keys = []
             for original, added in zip(blocks, _added_blocks):
-                if not original is added and isinstance(added, DuplicateBlockKeyBlock):
+                if original is not added and isinstance(added, DuplicateBlockKeyBlock):
                     duplicate_keys.append(added.key)
 
             if len(duplicate_keys) > 0:
@@ -74,9 +73,7 @@ class Library:
             elif isinstance(block, String):
                 del self._strings_by_key[block.key]
 
-    def replace(
-        self, old_block: Block, new_block: Block, fail_on_duplicate_key: bool = True
-    ):
+    def replace(self, old_block: Block, new_block: Block, fail_on_duplicate_key: bool = True):
         """Replace a block with another block, at the same position.
 
         :param old_block: Block to replace.
@@ -196,7 +193,5 @@ class Library:
     def comments(self) -> List[Union[ExplicitComment, ImplicitComment]]:
         """All comment blocks in the library, preserving order of insertion."""
         return [
-            block
-            for block in self._blocks
-            if isinstance(block, (ExplicitComment, ImplicitComment))
+            block for block in self._blocks if isinstance(block, (ExplicitComment, ImplicitComment))
         ]

bibtexparser-2.0.0b8/bibtexparser/middlewares/__init__.py

@@ -0,0 +1,22 @@
+from bibtexparser.middlewares.enclosing import AddEnclosingMiddleware
+from bibtexparser.middlewares.enclosing import RemoveEnclosingMiddleware
+from bibtexparser.middlewares.fieldkeys import NormalizeFieldKeys
+from bibtexparser.middlewares.interpolate import ResolveStringReferencesMiddleware
+from bibtexparser.middlewares.latex_encoding import LatexDecodingMiddleware
+from bibtexparser.middlewares.latex_encoding import LatexEncodingMiddleware
+from bibtexparser.middlewares.middleware import BlockMiddleware
+from bibtexparser.middlewares.middleware import LibraryMiddleware
+from bibtexparser.middlewares.month import MonthAbbreviationMiddleware
+from bibtexparser.middlewares.month import MonthIntMiddleware
+from bibtexparser.middlewares.month import MonthLongStringMiddleware
+from bibtexparser.middlewares.names import MergeCoAuthors
+from bibtexparser.middlewares.names import MergeNameParts
+from bibtexparser.middlewares.names import NameParts
+from bibtexparser.middlewares.names import SeparateCoAuthors
+from bibtexparser.middlewares.names import SplitNameParts
+from bibtexparser.middlewares.sorting_blocks import SortBlocksByTypeAndKeyMiddleware
+from bibtexparser.middlewares.sorting_entry_fields import SortFieldsAlphabeticallyMiddleware
+from bibtexparser.middlewares.sorting_entry_fields import SortFieldsCustomMiddleware
+
+from .parsestack import default_parse_stack
+from .parsestack import default_unparse_stack

{bibtexparser-2.0.0b7 → bibtexparser-2.0.0b8}/bibtexparser/middlewares/enclosing.py

@@ -1,6 +1,10 @@
-from typing import Tuple, Union
+from typing import Tuple
+from typing import Union
 
-from bibtexparser.model import Entry, Field, String
+from bibtexparser.library import Library
+from bibtexparser.model import Entry
+from bibtexparser.model import Field
+from bibtexparser.model import String
 
 from .middleware import BlockMiddleware
 
@@ -51,7 +55,7 @@ class RemoveEnclosingMiddleware(BlockMiddleware):
         return value, "no-enclosing"
 
     # docstr-coverage: inherited
-    def transform_entry(self, entry: Entry, library: "Library") -> Entry:
+    def transform_entry(self, entry: Entry, library: Library) -> Entry:
         field: Field
         metadata = dict()
         for field in entry.fields:
@@ -62,7 +66,7 @@ class RemoveEnclosingMiddleware(BlockMiddleware):
         return entry
 
     # docstr-coverage: inherited
-    def transform_string(self, string: String, library: "Library") -> String:
+    def transform_string(self, string: String, library: Library) -> String:
         stripped, enclosing = self._strip_enclosing(string.value)
         string.value = stripped
         string.parser_metadata[self.metadata_key()] = enclosing
@@ -101,8 +105,7 @@ class AddEnclosingMiddleware(BlockMiddleware):
 
         if default_enclosing not in ("{", '"'):
             raise ValueError(
-                "default_enclosing must be either '{' or '\"'"
-                f"not '{default_enclosing}'"
+                "default_enclosing must be either '{' or '\"'" f"not '{default_enclosing}'"
             )
         self._default_enclosing = default_enclosing
         self._reuse_previous_enclosing = reuse_previous_enclosing
@@ -113,9 +116,7 @@ class AddEnclosingMiddleware(BlockMiddleware):
     def metadata_key(cls) -> str:
         return "remove_enclosing"
 
-    def _enclose(
-        self, value: str, metadata_enclosing: str, apply_int_rule: bool
-    ) -> str:
+    def _enclose(self, value: str, metadata_enclosing: str, apply_int_rule: bool) -> str:
         enclosing = self._default_enclosing
         if self._reuse_previous_enclosing and metadata_enclosing is not None:
             enclosing = metadata_enclosing
@@ -129,8 +130,7 @@ class AddEnclosingMiddleware(BlockMiddleware):
         if enclosing == "no-enclosing":
             return value
         raise ValueError(
-            f"enclosing must be either '{{' or '\"' or 'no-enclosing', "
-            f"not '{enclosing}'"
+            f"enclosing must be either '{{' or '\"' or 'no-enclosing', " f"not '{enclosing}'"
         )
 
     # docstr-coverage: inherited
@@ -142,13 +142,9 @@ class AddEnclosingMiddleware(BlockMiddleware):
         for field in entry.fields:
             apply_int_rule = field.key in ENTRY_POTENTIALLY_INT_FIELDS
             prev_encoding = (
-                metadata_enclosing.get(field.key, None)
-                if metadata_enclosing is not None
-                else None
-            )
-            field.value = self._enclose(
-                field.value, prev_encoding, apply_int_rule=apply_int_rule
+                metadata_enclosing.get(field.key, None) if metadata_enclosing is not None else None
             )
+            field.value = self._enclose(field.value, prev_encoding, apply_int_rule=apply_int_rule)
         return entry
 
     # docstr-coverage: inherited

bibtexparser-2.0.0b8/bibtexparser/middlewares/fieldkeys.py

@@ -0,0 +1,54 @@
+import logging
+from typing import Dict
+from typing import List
+from typing import Set
+
+from bibtexparser.library import Library
+from bibtexparser.model import Entry
+from bibtexparser.model import Field
+
+from .middleware import BlockMiddleware
+
+logger = logging.getLogger(__name__)
+
+
+class NormalizeFieldKeys(BlockMiddleware):
+    """Normalize field keys to lowercase.
+
+    In case of conflicts (e.g. both 'author' and 'Author' exist in the same entry),
+    a warning is emitted, and the last value wins.
+
+    Some other middlewares, such as `SeparateCoAuthors`, assume lowercase key names.
+    """
+
+    def __init__(self, allow_inplace_modification: bool = True):
+        super().__init__(
+            allow_inplace_modification=allow_inplace_modification,
+            allow_parallel_execution=True,
+        )
+
+    # docstr-coverage: inherited
+    def transform_entry(self, entry: Entry, library: "Library") -> Entry:
+        seen_normalized_keys: Set[str] = set()
+        new_fields_dict: Dict[str, Field] = {}
+        for field in entry.fields:
+            normalized_key: str = field.key.lower()
+            # if the normalized key is already present, apply "last one wins"
+            # otherwise preserve insertion order
+            # if a key is overwritten, emit a detailed warning
+            # if performance is a concern, we could emit a warning with only {entry.key}
+            # to remove "seen_normalized_keys" and this if statement
+            if normalized_key in seen_normalized_keys:
+                logger.warning(
+                    f"NormalizeFieldKeys: in entry '{entry.key}': "
+                    + f"duplicate normalized key '{normalized_key}' "
+                    + f"(original '{field.key}'); overriding previous value"
+                )
+            seen_normalized_keys.add(normalized_key)
+            field.key = normalized_key
+            new_fields_dict[normalized_key] = field
+
+        new_fields: List[Field] = list(new_fields_dict.values())
+        entry.fields = new_fields
+
+        return entry

{bibtexparser-2.0.0b7 → bibtexparser-2.0.0b8}/bibtexparser/middlewares/interpolate.py

@@ -3,7 +3,8 @@ from copy import deepcopy
 from typing import Any
 
 from bibtexparser.library import Library
-from bibtexparser.model import Entry, Field
+from bibtexparser.model import Entry
+from bibtexparser.model import Field
 
 from .enclosing import REMOVED_ENCLOSING_KEY
 from .middleware import LibraryMiddleware
@@ -41,10 +42,7 @@ class ResolveStringReferencesMiddleware(LibraryMiddleware):
         raised_enclosing_warning = False
         for entry in library.entries:
             resolved_fields = list()
-            if (
-                not raised_enclosing_warning
-                and REMOVED_ENCLOSING_KEY in entry.parser_metadata
-            ):
+            if not raised_enclosing_warning and REMOVED_ENCLOSING_KEY in entry.parser_metadata:
                 raised_enclosing_warning = True
                 warnings.warn(
                     (

{bibtexparser-2.0.0b7 → bibtexparser-2.0.0b8}/bibtexparser/middlewares/latex_encoding.py

@@ -1,23 +1,29 @@
 import abc
 import logging
 import re
-from typing import List, Optional, Tuple
+from typing import List
+from typing import Optional
+from typing import Tuple
 
 import pylatexenc
-from pylatexenc.latex2text import LatexNodes2Text, MacroTextSpec
-from pylatexenc.latexencode import (
-    RULE_REGEX,
-    UnicodeToLatexConversionRule,
-    UnicodeToLatexEncoder,
-)
+from pylatexenc.latex2text import LatexNodes2Text
+from pylatexenc.latex2text import MacroTextSpec
+from pylatexenc.latexencode import RULE_REGEX
+from pylatexenc.latexencode import UnicodeToLatexConversionRule
+from pylatexenc.latexencode import UnicodeToLatexEncoder
 
 from bibtexparser.exceptions import PartialMiddlewareException
 from bibtexparser.library import Library
-from bibtexparser.model import Block, Entry, MiddlewareErrorBlock, String
+from bibtexparser.model import Block
+from bibtexparser.model import Entry
+from bibtexparser.model import MiddlewareErrorBlock
+from bibtexparser.model import String
 
 from .middleware import BlockMiddleware
 from .names import NameParts
 
+logger = logging.getLogger(__name__)
+
 
 class _PyStringTransformerMiddleware(BlockMiddleware, abc.ABC):
     """Abstract utility class allowing to modify python-strings"""
@@ -33,9 +39,7 @@ class _PyStringTransformerMiddleware(BlockMiddleware, abc.ABC):
         raise NotImplementedError("called abstract method")
 
     # docstr-coverage: inherited
-    def _transform_all_strings(
-        self, list_of_strings: List[str], errors: List[str]
-    ) -> List[str]:
+    def _transform_all_strings(self, list_of_strings: List[str], errors: List[str]) -> List[str]:
         """Called for every python (value, not key) string found on Entry and String blocks"""
         res = []
         for s in list_of_strings:
@@ -52,14 +56,12 @@ class _PyStringTransformerMiddleware(BlockMiddleware, abc.ABC):
                 field.value, e = self._transform_python_value_string(field.value)
                 errors.append(e)
             elif isinstance(field.value, NameParts):
-                field.value.first = self._transform_all_strings(
-                    field.value.first, errors
-                )
+                field.value.first = self._transform_all_strings(field.value.first, errors)
                 field.value.last = self._transform_all_strings(field.value.last, errors)
                 field.value.von = self._transform_all_strings(field.value.von, errors)
                 field.value.jr = self._transform_all_strings(field.value.jr, errors)
             else:
-                logging.info(
+                logger.info(
                     f" [{self.metadata_key()}] Cannot python-str transform field {field.key}"
                     f" with value type {type(field.value)}"
                 )
@@ -76,7 +78,7 @@ class _PyStringTransformerMiddleware(BlockMiddleware, abc.ABC):
         if isinstance(string.value, str):
             string.value = self._transform_python_value_string(string.value)
         else:
-            logging.info(
+            logger.info(
                 f" [{self.metadata_key()}] Cannot python-str transform string {string.key}"
                 f" with value type {type(string.value)}"
             )
@@ -162,9 +164,7 @@ class LatexDecodingMiddleware(_PyStringTransformerMiddleware):
             allow_parallel_execution=True,
         )
 
-        if decoder is not None and (
-            keep_braced_groups is not None or keep_math_mode is not None
-        ):
+        if decoder is not None and (keep_braced_groups is not None or keep_math_mode is not None):
             raise ValueError(
                 "Cannot specify both encoder and one of "
                 "`keep_braced_groups` or `keep_braced_groups`."
@@ -174,9 +174,7 @@ class LatexDecodingMiddleware(_PyStringTransformerMiddleware):
 
         # Defaults (not specified as defaults in args,
         #   to make sure we can identify if they were specified)
-        keep_braced_groups = (
-            keep_braced_groups if keep_braced_groups is not None else False
-        )
+        keep_braced_groups = keep_braced_groups if keep_braced_groups is not None else False
         keep_math_mode = keep_math_mode if keep_math_mode is not None else True
 
         if decoder is None:

{bibtexparser-2.0.0b7 → bibtexparser-2.0.0b8}/bibtexparser/middlewares/middleware.py

@@ -1,17 +1,18 @@
 import abc
 import logging
 from copy import deepcopy
-from typing import Collection, Union
+from typing import Collection
+from typing import Union
 
 from bibtexparser.library import Library
-from bibtexparser.model import (
-    Block,
-    Entry,
-    ExplicitComment,
-    ImplicitComment,
-    Preamble,
-    String,
-)
+from bibtexparser.model import Block
+from bibtexparser.model import Entry
+from bibtexparser.model import ExplicitComment
+from bibtexparser.model import ImplicitComment
+from bibtexparser.model import Preamble
+from bibtexparser.model import String
+
+logger = logging.getLogger(__name__)
 
 
 class Middleware(abc.ABC):
@@ -94,9 +95,7 @@ class BlockMiddleware(Middleware, abc.ABC):
                 blocks.extend(transformed)
             # Case 4: Something else. Error.
             else:
-                raise TypeError(
-                    f"Illegal output type from transform_block: {type(transformed)}"
-                )
+                raise TypeError(f"Illegal output type from transform_block: {type(transformed)}")
         return Library(blocks=blocks)
 
     def transform_block(
@@ -131,7 +130,7 @@ class BlockMiddleware(Middleware, abc.ABC):
         elif isinstance(block, ImplicitComment):
             return self.transform_implicit_comment(block, library)
 
-        logging.warning(f"Unknown block type {type(block)}")
+        logger.warning(f"Unknown block type {type(block)}")
         return block
 
     def transform_entry(

{bibtexparser-2.0.0b7 → bibtexparser-2.0.0b8}/bibtexparser/middlewares/month.py

@@ -1,9 +1,12 @@
 import abc
 from collections import OrderedDict
-from typing import Tuple, Union
+from typing import Tuple
+from typing import Union
 
 from bibtexparser.library import Library
-from bibtexparser.model import Block, Entry, Field
+from bibtexparser.model import Block
+from bibtexparser.model import Entry
+from bibtexparser.model import Field
 
 from .middleware import BlockMiddleware
 
@@ -31,9 +34,7 @@ class _MonthInterpolator(BlockMiddleware, abc.ABC):
         return entry
 
     @abc.abstractmethod
-    def resolve_month_field_val(
-        self, month_field: Field
-    ) -> Tuple[Union[str, int], str]:
+    def resolve_month_field_val(self, month_field: Field) -> Tuple[Union[str, int], str]:
         """Transform the month field.
 
         Args: