gnarly 0.0.0.dev3__tar.gz → 0.0.0.dev6__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of gnarly might be problematic. Click here for more details.

Files changed (42) hide show
  1. {gnarly-0.0.0.dev3 → gnarly-0.0.0.dev6}/PKG-INFO +1 -2
  2. gnarly-0.0.0.dev6/docs/Makefile +20 -0
  3. gnarly-0.0.0.dev6/docs/api/gnarly.rst +45 -0
  4. gnarly-0.0.0.dev6/docs/api/gnarly.utils.code.rst +21 -0
  5. gnarly-0.0.0.dev6/docs/api/gnarly.utils.llm.rst +45 -0
  6. gnarly-0.0.0.dev6/docs/api/gnarly.utils.rst +30 -0
  7. gnarly-0.0.0.dev6/docs/api/modules.rst +7 -0
  8. gnarly-0.0.0.dev6/docs/make.bat +35 -0
  9. gnarly-0.0.0.dev6/docs/source/api/gnarly.rst +45 -0
  10. gnarly-0.0.0.dev6/docs/source/api/gnarly.utils.code.rst +21 -0
  11. gnarly-0.0.0.dev6/docs/source/api/gnarly.utils.llm.rst +45 -0
  12. gnarly-0.0.0.dev6/docs/source/api/gnarly.utils.rst +30 -0
  13. gnarly-0.0.0.dev6/docs/source/api/modules.rst +7 -0
  14. gnarly-0.0.0.dev6/docs/source/api.md +29 -0
  15. gnarly-0.0.0.dev6/docs/source/conf.py +82 -0
  16. gnarly-0.0.0.dev6/docs/source/index.md +15 -0
  17. gnarly-0.0.0.dev6/docs/source/usage.md +11 -0
  18. {gnarly-0.0.0.dev3 → gnarly-0.0.0.dev6}/pyproject.toml +1 -15
  19. gnarly-0.0.0.dev6/src/gnarly/__init__.py +53 -0
  20. {gnarly-0.0.0.dev3 → gnarly-0.0.0.dev6}/src/gnarly/constants.py +8 -3
  21. gnarly-0.0.0.dev6/src/gnarly/errors.py +29 -0
  22. gnarly-0.0.0.dev6/src/gnarly/types.py +103 -0
  23. gnarly-0.0.0.dev6/src/gnarly/utils/__init__.py +44 -0
  24. gnarly-0.0.0.dev6/src/gnarly/utils/code/__init__.py +33 -0
  25. gnarly-0.0.0.dev6/src/gnarly/utils/code/projects.py +205 -0
  26. gnarly-0.0.0.dev6/src/gnarly/utils/io.py +176 -0
  27. gnarly-0.0.0.dev6/src/gnarly/utils/llm/__init__.py +22 -0
  28. gnarly-0.0.0.dev6/src/gnarly/utils/llm/chatgpt.py +93 -0
  29. gnarly-0.0.0.dev6/src/gnarly/utils/llm/claude.py +98 -0
  30. gnarly-0.0.0.dev6/src/gnarly/utils/llm/interfaces.py +293 -0
  31. gnarly-0.0.0.dev6/src/gnarly/utils/llm/models.py +202 -0
  32. {gnarly-0.0.0.dev3 → gnarly-0.0.0.dev6}/tests/test_io_utilities.py +1 -1
  33. gnarly-0.0.0.dev6/uv.lock +80 -0
  34. gnarly-0.0.0.dev3/src/gnarly/__init__.py +0 -31
  35. gnarly-0.0.0.dev3/src/gnarly/utilities/__init__.py +0 -18
  36. gnarly-0.0.0.dev3/src/gnarly/utilities/io.py +0 -114
  37. gnarly-0.0.0.dev3/uv.lock +0 -600
  38. {gnarly-0.0.0.dev3 → gnarly-0.0.0.dev6}/.gitignore +0 -0
  39. {gnarly-0.0.0.dev3 → gnarly-0.0.0.dev6}/.python-version +0 -0
  40. {gnarly-0.0.0.dev3 → gnarly-0.0.0.dev6}/README.md +0 -0
  41. {gnarly-0.0.0.dev3 → gnarly-0.0.0.dev6}/tests/__init__.py +0 -0
  42. {gnarly-0.0.0.dev3 → gnarly-0.0.0.dev6}/tests/test_constants.py +0 -0
@@ -1,9 +1,8 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: gnarly
3
- Version: 0.0.0.dev3
3
+ Version: 0.0.0.dev6
4
4
  Summary: Add your description here
5
5
  Author-email: "K. LeBryce" <k.lebryce@pm.me>
6
6
  Requires-Python: >=3.10
7
- Requires-Dist: pytest>=8.4.0
8
7
  Requires-Dist: python-dotenv>=1.1.0
9
8
  Requires-Dist: starch
@@ -0,0 +1,20 @@
1
+ # Minimal makefile for Sphinx documentation
2
+ #
3
+
4
+ # You can set these variables from the command line, and also
5
+ # from the environment for the first two.
6
+ SPHINXOPTS ?=
7
+ SPHINXBUILD ?= sphinx-build
8
+ SOURCEDIR = source
9
+ BUILDDIR = build
10
+
11
+ # Put it first so that "make" without argument is like "make help".
12
+ help:
13
+ @$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
14
+
15
+ .PHONY: help Makefile
16
+
17
+ # Catch-all target: route all unknown targets to Sphinx using the new
18
+ # "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
19
+ %: Makefile
20
+ @$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
@@ -0,0 +1,45 @@
1
+ gnarly package
2
+ ==============
3
+
4
+ Subpackages
5
+ -----------
6
+
7
+ .. toctree::
8
+ :maxdepth: 4
9
+
10
+ gnarly.utils
11
+
12
+ Submodules
13
+ ----------
14
+
15
+ gnarly.constants module
16
+ -----------------------
17
+
18
+ .. automodule:: gnarly.constants
19
+ :members:
20
+ :undoc-members:
21
+ :show-inheritance:
22
+
23
+ gnarly.errors module
24
+ --------------------
25
+
26
+ .. automodule:: gnarly.errors
27
+ :members:
28
+ :undoc-members:
29
+ :show-inheritance:
30
+
31
+ gnarly.types module
32
+ -------------------
33
+
34
+ .. automodule:: gnarly.types
35
+ :members:
36
+ :undoc-members:
37
+ :show-inheritance:
38
+
39
+ Module contents
40
+ ---------------
41
+
42
+ .. automodule:: gnarly
43
+ :members:
44
+ :undoc-members:
45
+ :show-inheritance:
@@ -0,0 +1,21 @@
1
+ gnarly.utils.code package
2
+ =========================
3
+
4
+ Submodules
5
+ ----------
6
+
7
+ gnarly.utils.code.projects module
8
+ ---------------------------------
9
+
10
+ .. automodule:: gnarly.utils.code.projects
11
+ :members:
12
+ :undoc-members:
13
+ :show-inheritance:
14
+
15
+ Module contents
16
+ ---------------
17
+
18
+ .. automodule:: gnarly.utils.code
19
+ :members:
20
+ :undoc-members:
21
+ :show-inheritance:
@@ -0,0 +1,45 @@
1
+ gnarly.utils.llm package
2
+ ========================
3
+
4
+ Submodules
5
+ ----------
6
+
7
+ gnarly.utils.llm.chatgpt module
8
+ -------------------------------
9
+
10
+ .. automodule:: gnarly.utils.llm.chatgpt
11
+ :members:
12
+ :undoc-members:
13
+ :show-inheritance:
14
+
15
+ gnarly.utils.llm.claude module
16
+ ------------------------------
17
+
18
+ .. automodule:: gnarly.utils.llm.claude
19
+ :members:
20
+ :undoc-members:
21
+ :show-inheritance:
22
+
23
+ gnarly.utils.llm.interfaces module
24
+ ----------------------------------
25
+
26
+ .. automodule:: gnarly.utils.llm.interfaces
27
+ :members:
28
+ :undoc-members:
29
+ :show-inheritance:
30
+
31
+ gnarly.utils.llm.models module
32
+ ------------------------------
33
+
34
+ .. automodule:: gnarly.utils.llm.models
35
+ :members:
36
+ :undoc-members:
37
+ :show-inheritance:
38
+
39
+ Module contents
40
+ ---------------
41
+
42
+ .. automodule:: gnarly.utils.llm
43
+ :members:
44
+ :undoc-members:
45
+ :show-inheritance:
@@ -0,0 +1,30 @@
1
+ gnarly.utils package
2
+ ====================
3
+
4
+ Subpackages
5
+ -----------
6
+
7
+ .. toctree::
8
+ :maxdepth: 4
9
+
10
+ gnarly.utils.code
11
+ gnarly.utils.llm
12
+
13
+ Submodules
14
+ ----------
15
+
16
+ gnarly.utils.io module
17
+ ----------------------
18
+
19
+ .. automodule:: gnarly.utils.io
20
+ :members:
21
+ :undoc-members:
22
+ :show-inheritance:
23
+
24
+ Module contents
25
+ ---------------
26
+
27
+ .. automodule:: gnarly.utils
28
+ :members:
29
+ :undoc-members:
30
+ :show-inheritance:
@@ -0,0 +1,7 @@
1
+ src
2
+ ===
3
+
4
+ .. toctree::
5
+ :maxdepth: 4
6
+
7
+ gnarly
@@ -0,0 +1,35 @@
1
+ @ECHO OFF
2
+
3
+ pushd %~dp0
4
+
5
+ REM Command file for Sphinx documentation
6
+
7
+ if "%SPHINXBUILD%" == "" (
8
+ set SPHINXBUILD=sphinx-build
9
+ )
10
+ set SOURCEDIR=source
11
+ set BUILDDIR=build
12
+
13
+ %SPHINXBUILD% >NUL 2>NUL
14
+ if errorlevel 9009 (
15
+ echo.
16
+ echo.The 'sphinx-build' command was not found. Make sure you have Sphinx
17
+ echo.installed, then set the SPHINXBUILD environment variable to point
18
+ echo.to the full path of the 'sphinx-build' executable. Alternatively you
19
+ echo.may add the Sphinx directory to PATH.
20
+ echo.
21
+ echo.If you don't have Sphinx installed, grab it from
22
+ echo.https://www.sphinx-doc.org/
23
+ exit /b 1
24
+ )
25
+
26
+ if "%1" == "" goto help
27
+
28
+ %SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
29
+ goto end
30
+
31
+ :help
32
+ %SPHINXBUILD% -M help %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%
33
+
34
+ :end
35
+ popd
@@ -0,0 +1,45 @@
1
+ gnarly package
2
+ ==============
3
+
4
+ Subpackages
5
+ -----------
6
+
7
+ .. toctree::
8
+ :maxdepth: 4
9
+
10
+ gnarly.utils
11
+
12
+ Submodules
13
+ ----------
14
+
15
+ gnarly.constants module
16
+ -----------------------
17
+
18
+ .. automodule:: gnarly.constants
19
+ :members:
20
+ :undoc-members:
21
+ :show-inheritance:
22
+
23
+ gnarly.errors module
24
+ --------------------
25
+
26
+ .. automodule:: gnarly.errors
27
+ :members:
28
+ :undoc-members:
29
+ :show-inheritance:
30
+
31
+ gnarly.types module
32
+ -------------------
33
+
34
+ .. automodule:: gnarly.types
35
+ :members:
36
+ :undoc-members:
37
+ :show-inheritance:
38
+
39
+ Module contents
40
+ ---------------
41
+
42
+ .. automodule:: gnarly
43
+ :members:
44
+ :undoc-members:
45
+ :show-inheritance:
@@ -0,0 +1,21 @@
1
+ gnarly.utils.code package
2
+ =========================
3
+
4
+ Submodules
5
+ ----------
6
+
7
+ gnarly.utils.code.projects module
8
+ ---------------------------------
9
+
10
+ .. automodule:: gnarly.utils.code.projects
11
+ :members:
12
+ :undoc-members:
13
+ :show-inheritance:
14
+
15
+ Module contents
16
+ ---------------
17
+
18
+ .. automodule:: gnarly.utils.code
19
+ :members:
20
+ :undoc-members:
21
+ :show-inheritance:
@@ -0,0 +1,45 @@
1
+ gnarly.utils.llm package
2
+ ========================
3
+
4
+ Submodules
5
+ ----------
6
+
7
+ gnarly.utils.llm.chatgpt module
8
+ -------------------------------
9
+
10
+ .. automodule:: gnarly.utils.llm.chatgpt
11
+ :members:
12
+ :undoc-members:
13
+ :show-inheritance:
14
+
15
+ gnarly.utils.llm.claude module
16
+ ------------------------------
17
+
18
+ .. automodule:: gnarly.utils.llm.claude
19
+ :members:
20
+ :undoc-members:
21
+ :show-inheritance:
22
+
23
+ gnarly.utils.llm.interfaces module
24
+ ----------------------------------
25
+
26
+ .. automodule:: gnarly.utils.llm.interfaces
27
+ :members:
28
+ :undoc-members:
29
+ :show-inheritance:
30
+
31
+ gnarly.utils.llm.models module
32
+ ------------------------------
33
+
34
+ .. automodule:: gnarly.utils.llm.models
35
+ :members:
36
+ :undoc-members:
37
+ :show-inheritance:
38
+
39
+ Module contents
40
+ ---------------
41
+
42
+ .. automodule:: gnarly.utils.llm
43
+ :members:
44
+ :undoc-members:
45
+ :show-inheritance:
@@ -0,0 +1,30 @@
1
+ gnarly.utils package
2
+ ====================
3
+
4
+ Subpackages
5
+ -----------
6
+
7
+ .. toctree::
8
+ :maxdepth: 4
9
+
10
+ gnarly.utils.code
11
+ gnarly.utils.llm
12
+
13
+ Submodules
14
+ ----------
15
+
16
+ gnarly.utils.io module
17
+ ----------------------
18
+
19
+ .. automodule:: gnarly.utils.io
20
+ :members:
21
+ :undoc-members:
22
+ :show-inheritance:
23
+
24
+ Module contents
25
+ ---------------
26
+
27
+ .. automodule:: gnarly.utils
28
+ :members:
29
+ :undoc-members:
30
+ :show-inheritance:
@@ -0,0 +1,7 @@
1
+ src
2
+ ===
3
+
4
+ .. toctree::
5
+ :maxdepth: 4
6
+
7
+ gnarly
@@ -0,0 +1,29 @@
1
+ # API Reference
2
+
3
+ ## Core Module
4
+
5
+ ```{eval-rst}
6
+ .. automodule:: gnarly
7
+ :members:
8
+ :undoc-members:
9
+ :show-inheritance:
10
+
11
+ .. automodule:: gnarly.constants
12
+ :members:
13
+ :undoc-members:
14
+ :show-inheritance:
15
+
16
+ .. automodule:: gnarly.errors
17
+ :members:
18
+ :undoc-members:
19
+ :show-inheritance:
20
+
21
+ .. automodule:: gnarly.utils.io
22
+ :members:
23
+ :undoc-members:
24
+ :show-inheritance:
25
+
26
+ .. automodule:: gnarly.utils.code.projects
27
+ :members:
28
+ :undoc-members:
29
+ :show-inheritance:
@@ -0,0 +1,82 @@
1
+ # Configuration file for the Sphinx documentation builder.
2
+ #
3
+ # For the full list of built-in configuration values, see the documentation:
4
+ # https://www.sphinx-doc.org/en/master/usage/configuration.html
5
+
6
+ import os
7
+ import sys
8
+
9
+ # Add your source code to the path so Sphinx can find your modules
10
+ sys.path.insert(0, os.path.abspath('../../src'))
11
+
12
+ # -- Project information -----------------------------------------------------
13
+ # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
14
+
15
+ project = 'gnarly'
16
+ copyright = '2025, K. LeBryce'
17
+ author = 'K. LeBryce'
18
+ release = '0.0.0'
19
+
20
+ # -- General configuration ---------------------------------------------------
21
+ # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
22
+
23
+ extensions = [
24
+ 'sphinx.ext.autodoc', # Automatically generate docs from docstrings
25
+ 'sphinx.ext.viewcode', # Add [source] links to documentation
26
+ 'sphinx.ext.napoleon', # Support for Google and NumPy style docstrings
27
+ 'sphinx.ext.intersphinx', # Link to other project's documentation
28
+ 'myst_parser', # MyST Markdown parser
29
+ 'sphinx_design'
30
+ ]
31
+
32
+ # MyST parser configuration
33
+ myst_enable_extensions = [
34
+ "colon_fence", # ::: fenced code blocks
35
+ "deflist", # Definition lists
36
+ "html_admonition", # HTML-style admonitions
37
+ "html_image", # HTML images with attributes
38
+ "replacements", # Text replacements like (c) -> ©
39
+ "smartquotes", # Smart quotes
40
+ "substitution", # Variable substitutions
41
+ "tasklist", # GitHub-style task lists
42
+ ]
43
+
44
+ # Templates path
45
+ templates_path = ['_templates']
46
+
47
+ # Files to exclude from processing
48
+ exclude_patterns = []
49
+
50
+ # Source file suffixes and their parsers
51
+ source_suffix = {
52
+ '.txt': 'restructuredtext',
53
+ '.rst': 'restructuredtext',
54
+ '.md': 'markdown',
55
+ '.mdx': 'markdown'
56
+ }
57
+
58
+ # -- Options for HTML output -------------------------------------------------
59
+ # https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
60
+
61
+ html_theme = 'sphinx_book_theme'
62
+ html_static_path = ['_static']
63
+
64
+ # -- Extension configuration -------------------------------------------------
65
+
66
+ # Autodoc configuration
67
+ autodoc_default_options = {
68
+ 'members': True,
69
+ 'undoc-members': True,
70
+ 'show-inheritance': True,
71
+ }
72
+
73
+ # Napoleon configuration (for Google/NumPy style docstrings)
74
+ napoleon_google_docstring = True
75
+ napoleon_numpy_docstring = True
76
+ napoleon_include_init_with_doc = False
77
+ napoleon_include_private_with_doc = False
78
+
79
+ # Intersphinx mapping (links to other documentation)
80
+ intersphinx_mapping = {
81
+ 'python': ('https://docs.python.org/3', None),
82
+ }
@@ -0,0 +1,15 @@
1
+ # gnarly Documentation
2
+
3
+ Welcome to the gnarly documentation!
4
+
5
+ ```{toctree}
6
+ :maxdepth: 2
7
+ :caption: Contents:
8
+
9
+ api
10
+ usage
11
+
12
+ .. automodule:: gnarly
13
+ :members:
14
+ :undoc-members:
15
+ :show-inheritance:
@@ -0,0 +1,11 @@
1
+ # Usage Guide
2
+
3
+ This guide shows you how to use gnarly in your projects.
4
+
5
+ ## Installation
6
+
7
+ ```bash
8
+ pip install gnarly
9
+ ```
10
+
11
+
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "gnarly"
3
- version = "0.0.0dev3"
3
+ version = "0.0.0dev6"
4
4
  description = "Add your description here"
5
5
  readme = "README.md"
6
6
  authors = [
@@ -8,7 +8,6 @@ authors = [
8
8
  ]
9
9
  requires-python = ">=3.10"
10
10
  dependencies = [
11
- "pytest>=8.4.0",
12
11
  "python-dotenv>=1.1.0",
13
12
  "starch",
14
13
  ]
@@ -20,18 +19,5 @@ gnarly = "gnarly:main"
20
19
  requires = ["hatchling"]
21
20
  build-backend = "hatchling.build"
22
21
 
23
- [dependency-groups]
24
- dev = [
25
- "mypy>=1.16.0",
26
- "pytest>=8.4.0",
27
- "ruff>=0.11.13",
28
- ]
29
- extras = [
30
- "ipython>=8.37.0",
31
- ]
32
- optional = [
33
- "requests>=2.32.4",
34
- ]
35
-
36
22
  [tool.uv.sources]
37
23
  starch = { path = "../starch" }
@@ -0,0 +1,53 @@
1
+ """
2
+ Gnarly
3
+ ======
4
+
5
+ A general-use abstraction layer for the lazy.
6
+
7
+ """
8
+ import logging
9
+
10
+ from . import errors, constants, utils
11
+ from .errors import NamespaceError
12
+ from .utils import code, io, llm
13
+ from .utils.code.projects import (
14
+ GnarlyProject,
15
+ GnarlyCppProject,
16
+ GnarlyHaskellProject,
17
+ GnarlyJavaScriptProject,
18
+ GnarlyPythonProject,
19
+ GnarlyRProject,
20
+ GnarlyRustProject,
21
+ GnarlySwiftProject,
22
+ GnarlyProjectType,
23
+ Project
24
+ )
25
+ from .utils.io import stream
26
+ from .utils.llm import claude, chatgpt, ChatGPT, Claude
27
+
28
+ logging.basicConfig(level=logging.DEBUG)
29
+ logger = logging.getLogger(__name__)
30
+
31
+ try:
32
+ import starch
33
+ __all__ = ["starch"]
34
+ except ImportError as e:
35
+ logger.error(f"Could not import `starch`: {e}")
36
+
37
+ __all__ = [
38
+ # ─── package-level exports ───────────────────────────────────────────────
39
+ "code", "llm", "utils",
40
+
41
+ # ─── module-level exports ────────────────────────────────────────────────
42
+ "chatgpt", "claude", "errors", "constants", "io",
43
+
44
+ # ─── function-level exports ──────────────────────────────────────────────
45
+ "stream",
46
+
47
+ # ─── class-level exports ─────────────────────────────────────────────────
48
+ "ChatGPT", "Claude",
49
+ "GnarlyProject", "GnarlyCppProject", "GnarlyHaskellProject",
50
+ "GnarlyJavaScriptProject", "GnarlyPythonProject", "GnarlyRustProject",
51
+ "GnarlyRProject", "GnarlyRustProject", "GnarlySwiftProject",
52
+ "GnarlyProjectType", "NamespaceError", "Project"
53
+ ]
@@ -22,9 +22,10 @@ logger.setLevel(logging.DEBUG)
22
22
 
23
23
 
24
24
  # ─── package metadata ─────────────────────────────────────────────────── ✦✦ ─
25
- __author__ = "K. LeBryce <kosmolebryce@gmail.com>"
26
- __package__ = "Gnarly"
27
- __version__ = "0.0.0"
25
+ __author__: str = "K. LeBryce <kosmolebryce@gmail.com>"
26
+ __package__: str = "Gnarly"
27
+ __version__: str = "0.0.0"
28
+ __description__: str = "A sophisticated abstraction layer for lazy developers."
28
29
 
29
30
  # ─── resource references ──────────────────────────────────────────────── ✦✦ ─
30
31
  GNARLY_DATA_DIR: Path = user_data_path(
@@ -55,6 +56,9 @@ GNARLY_LOG_DIR: Path = user_log_path(
55
56
  ensure_exists=True
56
57
  )
57
58
 
59
+ GNARLY_PROJECT_ROOT_PATH: Path = Path.home() / "gnarly/"
60
+ GNARLY_PROJECT_ROOT_PATH.mkdir(exist_ok=True)
61
+
58
62
  DOTENV_FILE_PATH: Path = GNARLY_CONFIG_DIR / "gnarly.env"
59
63
  DOTENV_FILE_PATH.touch()
60
64
 
@@ -75,3 +79,4 @@ except IOError as e:
75
79
  f"{GNARLY_CONFIG_DIR.resolve()}"
76
80
  )
77
81
  raise RuntimeError from e
82
+
@@ -0,0 +1,29 @@
1
+ """
2
+ Errors
3
+ ======
4
+
5
+ This module defines the custom exception types used throughout the
6
+ code base. This is a Gnarly implementation detail.
7
+ """
8
+
9
+ import logging
10
+
11
+ from .constants import GNARLY_LOG_DIR
12
+
13
+ logger = logging.getLogger(__name__)
14
+ logging.basicConfig(
15
+ level=logging.DEBUG,
16
+ filename=(GNARLY_LOG_DIR / "gnarly.log").resolve()
17
+ )
18
+ logger.info("Logger setup complete.")
19
+
20
+ class GnarlyError(Exception):
21
+ """Gnarly's base error class."""
22
+ pass
23
+
24
+
25
+ class NamespaceError(GnarlyError):
26
+ """
27
+ An error type that arises from an improper namespace access attempt.
28
+ """
29
+ pass