feat: add option to increase the default Python recursion depth

CHANGELOG.md

@@ -6,6 +6,8 @@
 
 ### Added
 
+- Added support for changing the default Python recursion depth
+  ([#312](https://github.com/fortran-lang/fortls/issues/312))
 - Added support for preprocessor macro expansions
   ([#368](https://github.com/fortran-lang/fortls/pull/368))
 - Added support for leading white spaces in preprocessor directives

docs/options.rst

@@ -47,6 +47,7 @@ All the ``fortls`` settings with their default arguments can be found below
       "nthreads": 4,
       "notify_init": false,
       "incremental_sync": false,
+      "recursion_limit": 1000,
       "sort_keywords": false,
       "disable_autoupdate": false,
       "debug_log": false,

fortls/fortls.schema.json

@@ -27,6 +27,12 @@
       "default": false,
       "type": "boolean"
     },
+    "recursion_limit": {
+      "title": "Recursion Limit",
+      "description": "Set the maximum recursion depth for the parser (default: 1000)",
+      "default": 1000,
+      "type": "integer"
+    },
     "sort_keywords": {
       "title": "Sort Keywords",
       "description": "Display variable keywords information, function/subroutine definitions, etc. in a consistent (sorted) manner default: no sorting, display code as is)",

fortls/interface.py

@@ -74,6 +74,13 @@ def cli(name: str = "fortls") -> argparse.ArgumentParser:
         action="store_true",
         help="Use incremental document synchronization (beta)",
     )
+    parser.add_argument(
+        "--recursion_limit",
+        type=int,
+        default=1000,
+        metavar="INTEGER",
+        help="Set the maximum recursion depth for the parser (default: %(default)s)",
+    )
     parser.add_argument(
         "--sort_keywords",
         action="store_true",

fortls/langserver.py

@@ -198,6 +198,7 @@ def serve_initialize(self, request: dict):
         self.source_dirs.add(self.root_path)
 
         self._load_config_file()
+        update_recursion_limit(self.recursion_limit)
         self._resolve_globs_in_paths()
         self._config_logger(request)
         self._load_intrinsics()
@@ -1593,6 +1594,7 @@ def _load_config_file_general(self, config_dict: dict) -> None:
             "incremental_sync", self.incremental_sync
         )
         self.sync_type: int = 2 if self.incremental_sync else 1
+        self.recursion_limit = config_dict.get("recursion_limit", self.recursion_limit)
         self.sort_keywords = config_dict.get("sort_keywords", self.sort_keywords)
         self.disable_autoupdate = config_dict.get(
             "disable_autoupdate", self.disable_autoupdate
@@ -1826,6 +1828,22 @@ def _update_version_pypi(self, test: bool = False):
         return False
 
 
+def update_recursion_limit(limit: int) -> None:
+    """Update the recursion limit of the Python interpreter
+
+    Parameters
+    ----------
+    limit : int
+        New recursion limit
+
+    Examples
+    --------
+    >>> update_recursion_limit(10000)
+    """
+    if limit != sys.getrecursionlimit():
+        sys.setrecursionlimit(limit)
+
+
 class JSONRPC2Error(Exception):
     def __init__(self, code, message, data=None):
         self.code = code

test/test_interface.py

@@ -104,6 +104,7 @@ def test_config_file_general_options():
     assert server.incremental_sync
     assert server.sort_keywords
     assert server.disable_autoupdate
+    assert server.recursion_limit == 1500
 
 
 def test_config_file_dir_parsing_options():

test/test_source/f90_config.json

@@ -2,6 +2,7 @@
   "nthreads": 8,
   "notify_init": true,
   "incremental_sync": true,
+  "recursion_limit": 1500,
   "sort_keywords": true,
   "disable_autoupdate": true,