mkdocs-include-markdown-plugin 6.0.3__py3-none-any.whl → 6.0.5__py3-none-any.whl

mkdocs_include_markdown_plugin/event.py

@@ -48,7 +48,9 @@ class Settings:  # noqa: D101
     exclude: list[str] | None
 
 
-logger = logging.getLogger('mkdocs.plugins.mkdocs_include_markdown_plugin')
+# TODO: when Mkdocs < 1.5.0 support is dropped, use
+# mkdocs.plugin.get_plugin_logger
+logger = logging.getLogger('mkdocs.plugins.include_markdown')
 
 
 def lineno_from_content_start(content: str, start: int) -> int:
@@ -276,26 +278,15 @@ def get_file_content(  # noqa: PLR0913, PLR0915
                     markdown,
                     directive_match_start,
                 )
+                relative_path = os.path.relpath(page_src_path, docs_dir)
                 logger.warning(
                     (
-                        "Delimiter {delimiter_name} '{delimiter_value}'"
-                        " of '{directive}' directive at"
-                        ' {relative_path}:{line_number}'
-                        ' not detected in the file{plural_suffix}'
-                        ' {readable_files_to_include}'
+                        f"Delimiter {delimiter_name} '{delimiter_value}'"
+                        " of 'include' directive at"
+                        f' {relative_path}:{lineno}'
+                        f' not detected in the file{plural_suffix}'
+                        f' {readable_files_to_include}'
                     ),
-                    extra={
-                        'delimiter_name': delimiter_name,
-                        'delimiter_value': delimiter_value,
-                        'directive': 'include',
-                        'relative_path': os.path.relpath(
-                            page_src_path,
-                            docs_dir,
-                        ),
-                        'line_number': lineno,
-                        'plural_suffix': plural_suffix,
-                        'readable_files_to_include': readable_files_to_include,
-                    },
                 )
 
         return text_to_include
@@ -453,8 +444,8 @@ def get_file_content(  # noqa: PLR0913, PLR0915
             arguments_string,
         )
         if offset_match:
-            offset = offset_match[1]
-            if offset == '':
+            offset_raw_value = offset_match[1]
+            if offset_raw_value == '':
                 lineno = lineno_from_content_start(
                     markdown,
                     directive_match_start,
@@ -465,15 +456,15 @@ def get_file_content(  # noqa: PLR0913, PLR0915
                     f' {os.path.relpath(page_src_path, docs_dir)}:{lineno}',
                 )
             try:
-                offset = int(offset)
+                offset = int(offset_raw_value)
             except ValueError:
                 lineno = lineno_from_content_start(
                     markdown,
                     directive_match_start,
                 )
                 raise PluginError(
-                    f"Invalid 'heading-offset' argument \"{offset}\" in"
-                    " 'include-markdown' directive at "
+                    f"Invalid 'heading-offset' argument \"{offset_raw_value}\""
+                    " in 'include-markdown' directive at "
                     f'{os.path.relpath(page_src_path, docs_dir)}:{lineno}',
                 ) from None
         else:
@@ -565,7 +556,7 @@ def get_file_content(  # noqa: PLR0913, PLR0915
                     )
                 )
 
-            if offset_match:
+            if offset:
                 new_text_to_include = process.increase_headings_offset(
                     new_text_to_include,
                     offset=offset + cumulative_heading_offset,
@@ -586,26 +577,15 @@ def get_file_content(  # noqa: PLR0913, PLR0915
                     markdown,
                     directive_match_start,
                 )
+                relative_path = os.path.relpath(page_src_path, docs_dir)
                 logger.warning(
                     (
-                        "Delimiter {delimiter_name} '{delimiter_value}' of"
-                        " '{directive}' directive at"
-                        ' {relative_path}:{line_number}'
-                        ' not detected in the file{plural_suffix}'
-                        ' {readable_files_to_include}'
+                        f"Delimiter {delimiter_name} '{delimiter_value}' of"
+                        " 'include-markdown' directive at"
+                        f' {relative_path}:{lineno}'
+                        f' not detected in the file{plural_suffix}'
+                        f' {readable_files_to_include}'
                     ),
-                    extra={
-                        'delimiter_name': delimiter_name,
-                        'delimiter_value': delimiter_value,
-                        'directive': 'include-markdown',
-                        'relative_path': os.path.relpath(
-                            page_src_path,
-                            docs_dir,
-                        ),
-                        'line_number': lineno,
-                        'plural_suffix': plural_suffix,
-                        'readable_files_to_include': readable_files_to_include,
-                    },
                 )
 
         return text_to_include

{mkdocs_include_markdown_plugin-6.0.3.dist-info → mkdocs_include_markdown_plugin-6.0.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.3
 Name: mkdocs-include-markdown-plugin
-Version: 6.0.3
+Version: 6.0.5
 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
@@ -96,46 +96,51 @@ plugins:
       end: <!--end-->
 ```
 
-- <a name="config_tags" href="#config_tags">#</a> **opening_tag** and
-  **closing_tag**: The default opening and closing tags. By default are
-  `{%` and `%}`.
-
-  ```yaml
-  plugins:
-    - include-markdown:
-        opening_tag: "{!"
-        closing_tag: "!}"
-  ```
-
-- <a name="config_exclude" href="#config_exclude">#</a> **exclude**: Define
-  global exclusion wildcard patterns. Relative paths defined here will be
-  relative to the _docs/_ directory.
-
-  ```yaml
-  plugins:
-    - include-markdown:
-        exclude:
-          - LICENSE.md
-          - api/**
-  ```
-
-- <a name="config_cache" href="#config_cache">#</a> **cache**: Define a
-  expiration time in seconds for cached HTTP requests when including
-  from URLs.
-
-  ```yaml
-  plugins:
-    - include-markdown:
-        cache: 600
-  ```
-
-  In order to use this feature, the dependency [platformdirs] must be installed.
-  You can include it in the installation of the plugin adding the `cache` extra:
-
-  ```txt
-  # requirements.txt
-  mkdocs-include-markdown-plugin[cache]
-  ```
+#### `opening_tag` and `closing_tag`
+
+Default opening and closing tags. When not specified they are `{%` and `%}`.
+
+```yaml
+plugins:
+  - include-markdown:
+      opening_tag: "{!"
+      closing_tag: "!}"
+```
+
+<!-- mdpo-disable-next-line -->
+
+#### `exclude`
+
+Global exclusion wildcard patterns. Relative paths defined here will be
+relative to the [`docs_dir`] directory.
+
+```yaml
+plugins:
+  - include-markdown:
+      exclude:
+        - LICENSE.md
+        - api/**
+```
+
+<!-- mdpo-disable-next-line -->
+
+#### `cache`
+
+Expiration time in seconds for cached HTTP requests when including from URLs.
+
+```yaml
+plugins:
+  - include-markdown:
+      cache: 600
+```
+
+In order to use this feature, the dependency [platformdirs] must be installed.
+You can include it in the installation of the plugin adding the `cache` extra:
+
+```txt
+# requirements.txt
+mkdocs-include-markdown-plugin[cache]
+```
 
 ### Reference
 
@@ -148,7 +153,9 @@ Paths of included files can be either:
 - Local files:
   - Absolute paths (starting with a path separator).
   - Relative from the file that includes them (starting with `./` or `../`).
-  - Relative from the _docs/_ directory.
+  - Relative to the [`docs_dir`] directory. For instance if your `docs_dir` is
+    _./docs/_, then `includes/header.md` will match the file
+    _./docs/includes/header.md_.
 - [Bash wildcard globs] matching multiple local files.
 
 File paths to include and string arguments can be wrapped by double `"` or
@@ -212,7 +219,7 @@ content to include.
 
 ```jinja
 {%
-   include-markdown 'docs/includes/header.md'
+   include-markdown 'includes/header.md'
    start='<!--\n\ttable-start\n-->'
    end='<!--\n\ttable-end\n-->'
    rewrite-relative-urls=false
@@ -222,7 +229,7 @@ content to include.
 
 ```jinja
 {%
-   include-markdown "docs/includes/header.md"
+   include-markdown "includes/header.md"
    heading-offset=1
 %}
 ```
@@ -303,6 +310,10 @@ Includes the content of a file or a group of files.
   [giving me the permissions][cibuildwheel-470] to separate this plugin from the
   documentation of [cibuildwheel][cibuildwheel-repo-link].
 
+[Bash wildcard globs]: https://facelessuser.github.io/wcmatch/glob/#syntax
+
+<!-- mdpo-disable -->
+
 [pypi-link]: https://pypi.org/project/mkdocs-include-markdown-plugin
 [pypi-version-badge-link]: https://img.shields.io/pypi/v/mkdocs-include-markdown-plugin?logo=pypi&logoColor=white
 [tests-image]: https://img.shields.io/github/actions/workflow/status/mondeja/mkdocs-include-markdown-plugin/ci.yml?logo=github&label=tests&branch=master
@@ -316,4 +327,4 @@ Includes the content of a file or a group of files.
 [cibuildwheel-repo-link]: https://github.com/pypa/cibuildwheel
 [es-readme-link]: https://github.com/mondeja/mkdocs-include-markdown-plugin/blob/master/locale/es/README.md
 [fr-readme-link]: https://github.com/mondeja/mkdocs-include-markdown-plugin/blob/master/locale/fr/README.md
-[Bash wildcard globs]: https://facelessuser.github.io/wcmatch/glob/#syntax
+[`docs_dir`]: https://www.mkdocs.org/user-guide/configuration/#docs_dir

{mkdocs_include_markdown_plugin-6.0.3.dist-info → mkdocs_include_markdown_plugin-6.0.5.dist-info}/RECORD

@@ -2,13 +2,13 @@ mkdocs_include_markdown_plugin/__init__.py,sha256=ByOde15RQSHlZTmkepPSzIt0GzUIv_
 mkdocs_include_markdown_plugin/cache.py,sha256=2CAVNwDUHilY1-x1VMLw33hxv76z1wcpid22jTyoJyI,2784
 mkdocs_include_markdown_plugin/config.py,sha256=qySvva9IBKtnyDEpbYeeXI0HiJ8ONhkVmxEIErW__f0,818
 mkdocs_include_markdown_plugin/directive.py,sha256=Vva7wW2vUc3OUz6NZzlIjzlFCx-YRsD70U4Jdvghomo,7441
-mkdocs_include_markdown_plugin/event.py,sha256=YGQVoEP60EP4FauMw0Wd3dYYcsRhBMk3ML-_g1wR4Rs,23853
+mkdocs_include_markdown_plugin/event.py,sha256=xG-Cc-NnDCKrinL6n3rtjTNO0z4GK5WCZL4QmnknHRg,22963
 mkdocs_include_markdown_plugin/files_watcher.py,sha256=hu-63u8syl00mXP59vP_iqD7T1R9iU9JjiZOHDV5fas,298
 mkdocs_include_markdown_plugin/plugin.py,sha256=bnJCikomoNQlMhKbaK__wKXrd-wYssfTzhzLzCrWd5c,3829
 mkdocs_include_markdown_plugin/process.py,sha256=uifgQdkn3lmAmztdEZK4LdaTNzEevx_jl0n3jQWIgWc,14404
 mkdocs_include_markdown_plugin/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-mkdocs_include_markdown_plugin-6.0.3.dist-info/METADATA,sha256=aOXATtVvXaLRjclukDsIsvRhd3-E96b9kuIYZ0xzItA,11087
-mkdocs_include_markdown_plugin-6.0.3.dist-info/WHEEL,sha256=9QBuHhg6FNW7lppboF2vKVbCGTVzsFykgRQjjlajrhA,87
-mkdocs_include_markdown_plugin-6.0.3.dist-info/entry_points.txt,sha256=WEL5m7sw5ZMBwmdOs5S_9mGoZfLCaUDPkDKw7CUk16Q,96
-mkdocs_include_markdown_plugin-6.0.3.dist-info/licenses/LICENSE,sha256=d3MolmZ_-5-o5EvHFp6u0NWmwOcygLKa1TAnUB1fr8k,11365
-mkdocs_include_markdown_plugin-6.0.3.dist-info/RECORD,,
+mkdocs_include_markdown_plugin-6.0.5.dist-info/METADATA,sha256=VcFeSqQDP1AK5kJ_6ghpRrwlY15JmjSpglEyaoQDJ5E,11158
+mkdocs_include_markdown_plugin-6.0.5.dist-info/WHEEL,sha256=uNdcs2TADwSd5pVaP0Z_kcjcvvTUklh2S7bxZMF8Uj0,87
+mkdocs_include_markdown_plugin-6.0.5.dist-info/entry_points.txt,sha256=WEL5m7sw5ZMBwmdOs5S_9mGoZfLCaUDPkDKw7CUk16Q,96
+mkdocs_include_markdown_plugin-6.0.5.dist-info/licenses/LICENSE,sha256=OunyKlPxiuvLB3ENbo2nyV-OPndkwzyZ5Gzwei0ofbc,11365
+mkdocs_include_markdown_plugin-6.0.5.dist-info/RECORD,,

{mkdocs_include_markdown_plugin-6.0.3.dist-info → mkdocs_include_markdown_plugin-6.0.5.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: hatchling 1.18.0
+Generator: hatchling 1.22.4
 Root-Is-Purelib: true
 Tag: py3-none-any

{mkdocs_include_markdown_plugin-6.0.3.dist-info → mkdocs_include_markdown_plugin-6.0.5.dist-info}/licenses/LICENSE

@@ -187,7 +187,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2017-2023 Joe Rickerby and contributors
+   Copyright 2017-2024 Joe Rickerby and contributors
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.