mkdocs-include-markdown-plugin 7.1.5__tar.gz → 7.1.7__tar.gz

{mkdocs_include_markdown_plugin-7.1.5 → mkdocs_include_markdown_plugin-7.1.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mkdocs-include-markdown-plugin
-Version: 7.1.5
+Version: 7.1.7
 Summary: Mkdocs Markdown includer plugin.
 Project-URL: Source, https://github.com/mondeja/mkdocs-include-markdown-plugin
 Project-URL: Documentation, https://github.com/mondeja/mkdocs-include-markdown-plugin#documentation

{mkdocs_include_markdown_plugin-7.1.5 → mkdocs_include_markdown_plugin-7.1.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mkdocs-include-markdown-plugin"
-version = "7.1.5"
+version = "7.1.7"
 description = "Mkdocs Markdown includer plugin."
 readme = "README.md"
 license = "Apache-2.0"

{mkdocs_include_markdown_plugin-7.1.5 → mkdocs_include_markdown_plugin-7.1.7}/src/mkdocs_include_markdown_plugin/cache.py

@@ -78,7 +78,7 @@ def get_cache_directory(cache_dir: str) -> str | None:
         return None
 
     try:
-        from platformdirs import user_data_dir
+        from platformdirs import user_data_dir  # noqa: PLC0415
     except ImportError:  # pragma: no cover
         return None
     else:

{mkdocs_include_markdown_plugin-7.1.5 → mkdocs_include_markdown_plugin-7.1.7}/src/mkdocs_include_markdown_plugin/directive.py

@@ -208,7 +208,7 @@ def parse_filename_argument(
 
 def parse_string_argument(match: re.Match[str] | None) -> str | None:
     """Return the string argument matched by ``match``."""
-    if match is None:
+    if match is None:  # pragma: no cover
         return None
     value = match[1]
     if value is None:

{mkdocs_include_markdown_plugin-7.1.5 → mkdocs_include_markdown_plugin-7.1.7}/src/mkdocs_include_markdown_plugin/event.py

@@ -436,27 +436,30 @@ def get_file_content(  # noqa: PLR0913, PLR0915
             offset_match = ARGUMENT_REGEXES['heading-offset']().search(
                 arguments_string,
             )
-            if offset_match:
-                offset_raw_value = offset_match[1]
-                if offset_raw_value == '':
-                    location = process.file_lineno_message(
-                        page_src_path, docs_dir, directive_lineno(),
-                    )
-                    raise PluginError(
-                        "Invalid empty 'heading-offset' argument in"
-                        f" 'include-markdown' directive at {location}",
-                    )
-                try:
-                    offset = int(offset_raw_value)
-                except ValueError:
-                    location = process.file_lineno_message(
-                        page_src_path, docs_dir, directive_lineno(),
-                    )
-                    raise PluginError(
-                        f"Invalid 'heading-offset' argument"
-                        f" '{offset_raw_value}' in 'include-markdown'"
-                        f" directive at {location}",
-                    ) from None
+            try:
+                # Here None[1] would raise a TypeError
+                offset_raw_value = offset_match[1]  # type: ignore
+            except (IndexError, TypeError):  # pragma: no cover
+                offset_raw_value = ''
+            if offset_raw_value == '':
+                location = process.file_lineno_message(
+                    page_src_path, docs_dir, directive_lineno(),
+                )
+                raise PluginError(
+                    "Invalid empty 'heading-offset' argument in"
+                    f" 'include-markdown' directive at {location}",
+                )
+            try:
+                offset = int(offset_raw_value)
+            except ValueError:
+                location = process.file_lineno_message(
+                    page_src_path, docs_dir, directive_lineno(),
+                )
+                raise PluginError(
+                    f"Invalid 'heading-offset' argument"
+                    f" '{offset_raw_value}' in 'include-markdown'"
+                    f" directive at {location}",
+                ) from None
 
         bool_options, invalid_bool_args = parse_bool_options(
             [

{mkdocs_include_markdown_plugin-7.1.5 → mkdocs_include_markdown_plugin-7.1.7}/src/mkdocs_include_markdown_plugin/process.py

@@ -33,7 +33,7 @@ if TYPE_CHECKING:  # pragma: no cover
 # previous to Python3.11. Also, these nested brackets can be recursive in the
 # Perl implementation but this doesn't seem possible in Python, the current
 # implementation only reaches two levels.
-MARKDOWN_LINK_REGEX = re.compile(  # noqa: DUO138
+MARKDOWN_LINK_REGEX = re.compile(
     r'''
         (                 # wrap whole match in $1
           (?<!!)          # don't match images - negative lookbehind
@@ -291,7 +291,7 @@ def rewrite_relative_urls(
     ``destination_path``.
     """
     def rewrite_url(url: str) -> str:
-        if is_url(url) or is_absolute_path(url):
+        if is_url(url) or is_absolute_path(url) or is_anchor(url):
             return url
 
         new_path = os.path.relpath(
@@ -427,17 +427,19 @@ def filter_inclusions(  # noqa: PLR0912
 def _transform_negative_offset_func_factory(
         offset: int,
 ) -> Callable[[str], str]:
-    heading_prefix = '#' * abs(offset)
+    abs_offset = abs(offset)
 
     def transform(line: str) -> str:
         try:
             if line[0] != '#':
                 return line
         except IndexError:  # pragma: no cover
+            # Note for pragma: all lines include a newline
+            # so this exception is never raised in tests.
             return line
-        if line.startswith(heading_prefix):
-            return heading_prefix + line.lstrip('#')
-        return '#' + line.lstrip('#')
+        stripped_line = line.lstrip('#')
+        new_n_headings = max(len(line) - len(stripped_line) - abs_offset, 1)
+        return '#' * new_n_headings + stripped_line
 
     return transform
 
@@ -449,11 +451,11 @@ def _transform_positive_offset_func_factory(
 
     def transform(line: str) -> str:
         try:
-            prefix = line[0]
+            if line[0] != '#':
+                return line
         except IndexError:  # pragma: no cover
             return line
-        else:
-            return heading_prefix + line if prefix == '#' else line
+        return heading_prefix + line
 
     return transform
 
@@ -583,6 +585,17 @@ def is_absolute_path(string: str) -> bool:
         return False
 
 
+def is_anchor(string: str) -> bool:
+    """Check if a string looks like an anchor.
+
+    An anchor is a string that starts with `#` and is not a relative path.
+    """
+    try:
+        return string[0] == '#'
+    except IndexError:  # pragma: no cover
+        return False
+
+
 def read_file(file_path: str, encoding: str) -> str:
     """Read a file and return its content."""
     f = open(file_path, encoding=encoding)  # noqa: SIM115
@@ -597,7 +610,7 @@ def read_url(
         encoding: str = 'utf-8',
 ) -> Any:
     """Read an HTTP location and return its content."""
-    from urllib.request import Request, urlopen
+    from urllib.request import Request, urlopen  # noqa: PLC0415
 
     if http_cache is not None:
         cached_content = http_cache.get_(url, encoding)