Fix option implementation

Author: ldeluigi

docs/options.md

@@ -8,6 +8,7 @@ plugins:
         show_contribution: true
         show_line_count: true
         count_empty_lines: true
+        fallback_to_empty: false
 ```
 
 ## `show_contribution`
@@ -28,3 +29,7 @@ If this option is set to `true` (default: `false`) the number of lines per autho
 ## `count_empty_lines`
 
 If this option is set to `true` (default: `false`) empty lines will count towards an authors' contribution.
+
+## `fallback_to_empty`
+
+If this option is set to `true` (default: `false`) the plugin will work even outside of a proper Git environment, prompting a warning when it's the case, and resulting in empty author list.

mkdocs_git_authors_plugin/plugin.py

@@ -1,5 +1,6 @@
 from mkdocs_git_authors_plugin.git.command import GitCommandError
 import re
+import logging
 from mkdocs.config import config_options
 from mkdocs.plugins import BasePlugin
 
@@ -19,14 +20,8 @@ class GitAuthorsPlugin(BasePlugin):
     )
 
     def __init__(self):
-        try:
-            self._repo = Repo()
-            self._fallback = False
-        except GitCommandError:
-            if self.config["fallback_to_empty"]:
-                self._fallback = True
-            else:
-                raise
+        self._repo = None
+        self._fallback = False
 
     def on_config(self, config, **kwargs):
         """
@@ -47,12 +42,20 @@ def on_config(self, config, **kwargs):
         Returns:
             (updated) configuration object
         """
-        if self._fallback:
-            return
-
-        self.repo().set_config(self.config)
-
-        raise_ci_warnings(path = self.repo()._root)
+        try:
+            self._repo = Repo()
+            self._fallback = False
+            self.repo().set_config(self.config)
+            raise_ci_warnings(path = self.repo()._root)
+        except GitCommandError:
+            if self.config["fallback_to_empty"]:
+                self._fallback = True
+                logging.warning(
+                    "[git-authors-plugin] Unable to find a git directory and/or git is not installed."
+                    " Option 'fallback_to_empty' set to 'true': Falling back to empty authors list"
+                )
+            else:
+                raise
 
     def on_files(self, files, config, **kwargs):
         """

tests/basic_setup/mkdocs_fallback.yml

@@ -0,0 +1,7 @@
+site_name: test gitauthors_plugin
+use_directory_urls: true
+
+plugins:
+    - search
+    - git-authors:
+        fallback_to_empty: true

tests/test_basic.py

@@ -127,13 +127,15 @@ def test_fallback(tmp_path):
         "tests/basic_setup/docs", str(testproject_path / "website" / "docs")
     )
     shutil.copyfile(
-        "tests/basic_setup/mkdocs_w_contribution.yml",
+        "tests/basic_setup/mkdocs_fallback.yml",
         str(testproject_path / "website" / "mkdocs.yml"),
     )
 
     cwd = os.getcwd()
     os.chdir(str(testproject_path))
 
+    print(str(testproject_path))
+
     result = build_docs_setup(
         str(testproject_path / "website/mkdocs.yml"), str(testproject_path / "site")
     )