lupaxa-github-intel 0.1.0__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.
Files changed (48) hide show
  1. lupaxa_github_intel-0.1.0/LICENCE +21 -0
  2. lupaxa_github_intel-0.1.0/PKG-INFO +180 -0
  3. lupaxa_github_intel-0.1.0/README.md +121 -0
  4. lupaxa_github_intel-0.1.0/pyproject.toml +319 -0
  5. lupaxa_github_intel-0.1.0/setup.cfg +4 -0
  6. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/__init__.py +13 -0
  7. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/__main__.py +8 -0
  8. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/app.py +493 -0
  9. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/checks/__init__.py +1 -0
  10. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/checks/base.py +17 -0
  11. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/checks/releases.py +59 -0
  12. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/checks/workflows.py +34 -0
  13. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/cli.py +699 -0
  14. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/config/__init__.py +1 -0
  15. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/config/defaults.py +150 -0
  16. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/config/editor.py +316 -0
  17. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/config/loader.py +412 -0
  18. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/config/models.py +310 -0
  19. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/config/paths.py +84 -0
  20. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/config/profiles.py +143 -0
  21. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/constants.py +54 -0
  22. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/dates.py +179 -0
  23. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/errors.py +72 -0
  24. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/github/__init__.py +1 -0
  25. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/github/auth.py +40 -0
  26. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/github/client.py +239 -0
  27. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/github/rate_limit.py +107 -0
  28. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/layout.py +141 -0
  29. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/logging_setup.py +51 -0
  30. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/present.py +361 -0
  31. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/reports/__init__.py +1 -0
  32. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/reports/render.py +113 -0
  33. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/storage/__init__.py +1 -0
  34. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/storage/database.py +419 -0
  35. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/sync/__init__.py +1 -0
  36. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/sync/engine.py +671 -0
  37. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/sync/summary.py +308 -0
  38. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/tui/__init__.py +1 -0
  39. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/tui/application.py +487 -0
  40. lupaxa_github_intel-0.1.0/src/lupaxa/github_intel/views.py +896 -0
  41. lupaxa_github_intel-0.1.0/src/lupaxa_github_intel.egg-info/PKG-INFO +180 -0
  42. lupaxa_github_intel-0.1.0/src/lupaxa_github_intel.egg-info/SOURCES.txt +46 -0
  43. lupaxa_github_intel-0.1.0/src/lupaxa_github_intel.egg-info/dependency_links.txt +1 -0
  44. lupaxa_github_intel-0.1.0/src/lupaxa_github_intel.egg-info/entry_points.txt +2 -0
  45. lupaxa_github_intel-0.1.0/src/lupaxa_github_intel.egg-info/requires.txt +28 -0
  46. lupaxa_github_intel-0.1.0/src/lupaxa_github_intel.egg-info/top_level.txt +1 -0
  47. lupaxa_github_intel-0.1.0/tests/test_cli.py +439 -0
  48. lupaxa_github_intel-0.1.0/tests/test_version.py +24 -0
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) The Lupaxa Project
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,180 @@
1
+ Metadata-Version: 2.4
2
+ Name: lupaxa-github-intel
3
+ Version: 0.1.0
4
+ Summary: Monitor an explicit collection of GitHub repositories from the local machine.
5
+ Author: The Lupaxa Project
6
+ Maintainer: The Lupaxa Project
7
+ License-Expression: MIT
8
+ Project-URL: Homepage, https://github.com/lupaxa-gh-toolbox/github-intel
9
+ Project-URL: Documentation, https://github-intel.thelupaxaproject.org/
10
+ Project-URL: Repository, https://github.com/lupaxa-gh-toolbox/github-intel
11
+ Project-URL: Issues, https://github.com/lupaxa-gh-toolbox/github-intel/issues
12
+ Keywords: cli,github,github-intel,python,toolbox
13
+ Classifier: Development Status :: 2 - Pre-Alpha
14
+ Classifier: Environment :: Console
15
+ Classifier: Intended Audience :: Developers
16
+ Classifier: Natural Language :: English
17
+ Classifier: Operating System :: MacOS
18
+ Classifier: Operating System :: Microsoft :: Windows
19
+ Classifier: Operating System :: POSIX
20
+ Classifier: Operating System :: POSIX :: Linux
21
+ Classifier: Programming Language :: Python
22
+ Classifier: Programming Language :: Python :: 3
23
+ Classifier: Programming Language :: Python :: 3 :: Only
24
+ Classifier: Programming Language :: Python :: 3.11
25
+ Classifier: Programming Language :: Python :: 3.12
26
+ Classifier: Programming Language :: Python :: 3.13
27
+ Classifier: Programming Language :: Python :: 3.14
28
+ Classifier: Topic :: Software Development
29
+ Requires-Python: >=3.11
30
+ Description-Content-Type: text/markdown
31
+ License-File: LICENCE
32
+ Requires-Dist: aiosqlite<1,>=0.20
33
+ Requires-Dist: httpx<1,>=0.28
34
+ Requires-Dist: platformdirs<5,>=4
35
+ Requires-Dist: pydantic<3,>=2.10
36
+ Requires-Dist: rich<15,>=14
37
+ Requires-Dist: ruamel.yaml<0.19,>=0.18
38
+ Requires-Dist: textual<9,>=3
39
+ Requires-Dist: typer<1,>=0.15
40
+ Provides-Extra: dev
41
+ Requires-Dist: build<2.0.0,>=1.2.2; extra == "dev"
42
+ Requires-Dist: mkdocs==1.6.1; extra == "dev"
43
+ Requires-Dist: mkdocs-material==9.7.7; extra == "dev"
44
+ Requires-Dist: mypy<2.0.0,>=1.17.0; extra == "dev"
45
+ Requires-Dist: pre-commit<5.0.0,>=4.2.0; extra == "dev"
46
+ Requires-Dist: pytest<9.0.0,>=8.4.0; extra == "dev"
47
+ Requires-Dist: pytest-asyncio<2,>=1.5; extra == "dev"
48
+ Requires-Dist: pytest-cov<7.0.0,>=6.2.0; extra == "dev"
49
+ Requires-Dist: respx<1,>=0.22; extra == "dev"
50
+ Requires-Dist: ruff<1.0.0,>=0.12.0; extra == "dev"
51
+ Requires-Dist: twine<7.0.0,>=6.1.0; extra == "dev"
52
+ Requires-Dist: types-setuptools<81.0.0,>=80.1.7; extra == "dev"
53
+ Provides-Extra: test
54
+ Requires-Dist: pytest>=8.4; extra == "test"
55
+ Requires-Dist: pytest-asyncio<2,>=1.5; extra == "test"
56
+ Requires-Dist: pytest-cov>=5.0; extra == "test"
57
+ Requires-Dist: respx<1,>=0.22; extra == "test"
58
+ Dynamic: license-file
59
+
60
+ <p align="center">
61
+ <a href="https://github.com/lupaxa-gh-toolbox">
62
+ <img src="https://raw.githubusercontent.com/the-lupaxa-project/brand-assets/master/logos/organisations/gh-toolbox/readme-logo.png" alt="The Lupaxa Project: GitHub Toolbox" />
63
+ </a>
64
+ </p>
65
+
66
+ <h1 align="center">GitHub Intel</h1>
67
+
68
+ **GitHub Intel** monitors an explicit list of GitHub repositories. It stores the results locally and can show them without a network connection. Groups organise the list. Profiles decide which checks run.
69
+
70
+ ## Features
71
+
72
+ - An explicit repository list. Nothing is discovered.
73
+ - Profiles for releases, workflows, issues, pull requests, and quality.
74
+ - Profile inheritance. An explicit false overrides an inherited true.
75
+ - A local SQLite cache, so lists and reports work offline.
76
+ - Release and workflow checks, without a file inventory or an issues list.
77
+ - Human tables, JSON, CSV, and Markdown.
78
+ - A terminal interface for the same cached view.
79
+ - Dates in a configurable pattern. The default is `DD/MM/YYYY HH:mm UTC`.
80
+ - Authentication through the GitHub CLI. The token is not stored.
81
+
82
+ ## Installation
83
+
84
+ Install the latest release from PyPI.
85
+
86
+ ```bash
87
+ pip install lupaxa-github-intel
88
+ ```
89
+
90
+ Verify the installation.
91
+
92
+ ```bash
93
+ github-intel --version
94
+ ```
95
+
96
+ Private repositories use the GitHub CLI login:
97
+
98
+ ```bash
99
+ gh auth login
100
+ ```
101
+
102
+ ## Quick Start
103
+
104
+ The first `repo add` creates `~/.config/github-intel/`.
105
+
106
+ ```bash
107
+ github-intel repo add owner/name --group examples --profile upstream
108
+ github-intel config validate
109
+ github-intel sync
110
+ github-intel repo list
111
+ github-intel repo show owner name
112
+ ```
113
+
114
+ `github-intel` with no arguments opens the terminal interface when the terminal is interactive.
115
+
116
+ ## Command-Line Interface
117
+
118
+ `github-intel repo list` reads the cache. `github-intel sync` is the command that calls GitHub.
119
+
120
+ ### Repositories
121
+
122
+ | Command | Description |
123
+ | -------------------------------------------------- | ------------------------------------------------ |
124
+ | `github-intel repo add OWNER/NAME` | Add a repository. This does not call GitHub |
125
+ | `github-intel repo list` | Show the cached table |
126
+ | `github-intel repo show ORG REPO` | Show one repository |
127
+ | `github-intel repo set-profile OWNER/NAME PROFILE` | Choose the checks for one repository |
128
+
129
+ ### Synchronisation and Reports
130
+
131
+ | Command | Description |
132
+ | -------------------------------- | ------------------------------------------------ |
133
+ | `github-intel sync` | Refresh stale or missing information |
134
+ | `github-intel sync --force` | Ignore cache freshness and `sync.interval` |
135
+ | `github-intel report` | Write a Markdown report |
136
+ | `github-intel audit` | Show repositories with failing checks |
137
+
138
+ ### Configuration
139
+
140
+ | Command | Description |
141
+ | -------------------------------- | ------------------------------------------------ |
142
+ | `github-intel config init` | Write the default files. `--force` overwrites |
143
+ | `github-intel config validate` | Load the files and report the repository count |
144
+ | `github-intel config paths` | Print configuration and cache paths |
145
+ | `github-intel profile show NAME` | Show the effective checks |
146
+
147
+ > **Note:** `--config FILE` selects a different main file. Without it, the files are `config.yml`, `profiles.yml`, and `repositories.yml` in `~/.config/github-intel/`.
148
+
149
+ ## Documentation
150
+
151
+ Online documentation:
152
+
153
+ [https://github-intel.thelupaxaproject.org/](https://github-intel.thelupaxaproject.org/)
154
+
155
+ Serve the docs locally:
156
+
157
+ ```bash
158
+ make init
159
+ make python-install-dev
160
+ make mkdocs-serve
161
+ ```
162
+
163
+ ## Development
164
+
165
+ Install makefile skills, then the development extra:
166
+
167
+ ```bash
168
+ make init
169
+ make python-install-dev
170
+ ```
171
+
172
+ Lint, type-check, and test:
173
+
174
+ ```bash
175
+ make python-check
176
+ ```
177
+
178
+ <a href="https://github.com/the-lupaxa-project">
179
+ <img src="https://raw.githubusercontent.com/the-lupaxa-project/brand-assets/master/logos/components/footer-for-child-orgs.svg" alt="The Lupaxa Project Footer" width="100%" />
180
+ </a>
@@ -0,0 +1,121 @@
1
+ <p align="center">
2
+ <a href="https://github.com/lupaxa-gh-toolbox">
3
+ <img src="https://raw.githubusercontent.com/the-lupaxa-project/brand-assets/master/logos/organisations/gh-toolbox/readme-logo.png" alt="The Lupaxa Project: GitHub Toolbox" />
4
+ </a>
5
+ </p>
6
+
7
+ <h1 align="center">GitHub Intel</h1>
8
+
9
+ **GitHub Intel** monitors an explicit list of GitHub repositories. It stores the results locally and can show them without a network connection. Groups organise the list. Profiles decide which checks run.
10
+
11
+ ## Features
12
+
13
+ - An explicit repository list. Nothing is discovered.
14
+ - Profiles for releases, workflows, issues, pull requests, and quality.
15
+ - Profile inheritance. An explicit false overrides an inherited true.
16
+ - A local SQLite cache, so lists and reports work offline.
17
+ - Release and workflow checks, without a file inventory or an issues list.
18
+ - Human tables, JSON, CSV, and Markdown.
19
+ - A terminal interface for the same cached view.
20
+ - Dates in a configurable pattern. The default is `DD/MM/YYYY HH:mm UTC`.
21
+ - Authentication through the GitHub CLI. The token is not stored.
22
+
23
+ ## Installation
24
+
25
+ Install the latest release from PyPI.
26
+
27
+ ```bash
28
+ pip install lupaxa-github-intel
29
+ ```
30
+
31
+ Verify the installation.
32
+
33
+ ```bash
34
+ github-intel --version
35
+ ```
36
+
37
+ Private repositories use the GitHub CLI login:
38
+
39
+ ```bash
40
+ gh auth login
41
+ ```
42
+
43
+ ## Quick Start
44
+
45
+ The first `repo add` creates `~/.config/github-intel/`.
46
+
47
+ ```bash
48
+ github-intel repo add owner/name --group examples --profile upstream
49
+ github-intel config validate
50
+ github-intel sync
51
+ github-intel repo list
52
+ github-intel repo show owner name
53
+ ```
54
+
55
+ `github-intel` with no arguments opens the terminal interface when the terminal is interactive.
56
+
57
+ ## Command-Line Interface
58
+
59
+ `github-intel repo list` reads the cache. `github-intel sync` is the command that calls GitHub.
60
+
61
+ ### Repositories
62
+
63
+ | Command | Description |
64
+ | -------------------------------------------------- | ------------------------------------------------ |
65
+ | `github-intel repo add OWNER/NAME` | Add a repository. This does not call GitHub |
66
+ | `github-intel repo list` | Show the cached table |
67
+ | `github-intel repo show ORG REPO` | Show one repository |
68
+ | `github-intel repo set-profile OWNER/NAME PROFILE` | Choose the checks for one repository |
69
+
70
+ ### Synchronisation and Reports
71
+
72
+ | Command | Description |
73
+ | -------------------------------- | ------------------------------------------------ |
74
+ | `github-intel sync` | Refresh stale or missing information |
75
+ | `github-intel sync --force` | Ignore cache freshness and `sync.interval` |
76
+ | `github-intel report` | Write a Markdown report |
77
+ | `github-intel audit` | Show repositories with failing checks |
78
+
79
+ ### Configuration
80
+
81
+ | Command | Description |
82
+ | -------------------------------- | ------------------------------------------------ |
83
+ | `github-intel config init` | Write the default files. `--force` overwrites |
84
+ | `github-intel config validate` | Load the files and report the repository count |
85
+ | `github-intel config paths` | Print configuration and cache paths |
86
+ | `github-intel profile show NAME` | Show the effective checks |
87
+
88
+ > **Note:** `--config FILE` selects a different main file. Without it, the files are `config.yml`, `profiles.yml`, and `repositories.yml` in `~/.config/github-intel/`.
89
+
90
+ ## Documentation
91
+
92
+ Online documentation:
93
+
94
+ [https://github-intel.thelupaxaproject.org/](https://github-intel.thelupaxaproject.org/)
95
+
96
+ Serve the docs locally:
97
+
98
+ ```bash
99
+ make init
100
+ make python-install-dev
101
+ make mkdocs-serve
102
+ ```
103
+
104
+ ## Development
105
+
106
+ Install makefile skills, then the development extra:
107
+
108
+ ```bash
109
+ make init
110
+ make python-install-dev
111
+ ```
112
+
113
+ Lint, type-check, and test:
114
+
115
+ ```bash
116
+ make python-check
117
+ ```
118
+
119
+ <a href="https://github.com/the-lupaxa-project">
120
+ <img src="https://raw.githubusercontent.com/the-lupaxa-project/brand-assets/master/logos/components/footer-for-child-orgs.svg" alt="The Lupaxa Project Footer" width="100%" />
121
+ </a>
@@ -0,0 +1,319 @@
1
+ [build-system]
2
+ requires = [
3
+ "setuptools>=77.0.0",
4
+ ]
5
+ build-backend = "setuptools.build_meta"
6
+
7
+ [project]
8
+ name = "lupaxa-github-intel"
9
+ version = "0.1.0"
10
+ description = "Monitor an explicit collection of GitHub repositories from the local machine."
11
+ readme = "README.md"
12
+ requires-python = ">=3.11"
13
+ license = "MIT"
14
+ license-files = [
15
+ "LICENCE",
16
+ ]
17
+
18
+ authors = [
19
+ { name = "The Lupaxa Project" },
20
+ ]
21
+
22
+ maintainers = [
23
+ { name = "The Lupaxa Project" },
24
+ ]
25
+
26
+ keywords = [
27
+ "cli",
28
+ "github",
29
+ "github-intel",
30
+ "python",
31
+ "toolbox",
32
+ ]
33
+
34
+ classifiers = [
35
+ "Development Status :: 2 - Pre-Alpha",
36
+ "Environment :: Console",
37
+ "Intended Audience :: Developers",
38
+ "Natural Language :: English",
39
+ "Operating System :: MacOS",
40
+ "Operating System :: Microsoft :: Windows",
41
+ "Operating System :: POSIX",
42
+ "Operating System :: POSIX :: Linux",
43
+ "Programming Language :: Python",
44
+ "Programming Language :: Python :: 3",
45
+ "Programming Language :: Python :: 3 :: Only",
46
+ "Programming Language :: Python :: 3.11",
47
+ "Programming Language :: Python :: 3.12",
48
+ "Programming Language :: Python :: 3.13",
49
+ "Programming Language :: Python :: 3.14",
50
+ "Topic :: Software Development",
51
+ ]
52
+
53
+ dependencies = [
54
+ "aiosqlite>=0.20,<1",
55
+ "httpx>=0.28,<1",
56
+ "platformdirs>=4,<5",
57
+ "pydantic>=2.10,<3",
58
+ "rich>=14,<15",
59
+ "ruamel.yaml>=0.18,<0.19",
60
+ "textual>=3,<9",
61
+ "typer>=0.15,<1",
62
+ ]
63
+
64
+ [project.optional-dependencies]
65
+ dev = [
66
+ "build>=1.2.2,<2.0.0",
67
+ "mkdocs==1.6.1",
68
+ "mkdocs-material==9.7.7",
69
+ "mypy>=1.17.0,<2.0.0",
70
+ "pre-commit>=4.2.0,<5.0.0",
71
+ "pytest>=8.4.0,<9.0.0",
72
+ "pytest-asyncio>=1.5,<2",
73
+ "pytest-cov>=6.2.0,<7.0.0",
74
+ "respx>=0.22,<1",
75
+ "ruff>=0.12.0,<1.0.0",
76
+ "twine>=6.1.0,<7.0.0",
77
+ "types-setuptools>=80.1.7,<81.0.0",
78
+ ]
79
+ test = [
80
+ "pytest>=8.4",
81
+ "pytest-asyncio>=1.5,<2",
82
+ "pytest-cov>=5.0",
83
+ "respx>=0.22,<1",
84
+ ]
85
+
86
+ [project.urls]
87
+ Homepage = "https://github.com/lupaxa-gh-toolbox/github-intel"
88
+ Documentation = "https://github-intel.thelupaxaproject.org/"
89
+ Repository = "https://github.com/lupaxa-gh-toolbox/github-intel"
90
+ Issues = "https://github.com/lupaxa-gh-toolbox/github-intel/issues"
91
+
92
+ [project.scripts]
93
+ github-intel = "lupaxa.github_intel.cli:main"
94
+
95
+ [tool.setuptools]
96
+ package-dir = { "" = "src" }
97
+
98
+ [tool.setuptools.packages.find]
99
+ where = [
100
+ "src",
101
+ ]
102
+ include = [
103
+ "lupaxa.github_intel*",
104
+ ]
105
+ namespaces = true
106
+
107
+ [tool.ruff]
108
+ target-version = "py311"
109
+ line-length = 88
110
+ src = [
111
+ "src",
112
+ "tests",
113
+ ]
114
+ extend-exclude = [
115
+ ".mypy_cache",
116
+ ".pytest_cache",
117
+ ".tox",
118
+ ".venv",
119
+ "build",
120
+ "dist",
121
+ ]
122
+
123
+ [tool.ruff.lint]
124
+ # Core Lupaxa rule set
125
+ select = [
126
+ # --- Essential correctness + hygiene ---
127
+ "E", # pycodestyle: basic style errors
128
+ "F", # pyflakes: unused vars, undefined names
129
+ "I", # import sorting
130
+ "B", # bugbear: common footguns
131
+
132
+ # --- Security layer ---
133
+ "S", # bandit-like security checks
134
+
135
+ # --- Modernisation + cleanup ---
136
+ "UP", # pyupgrade: modern Python idioms
137
+ "SIM", # simplify complex expressions/conditions
138
+ "C4", # flake8-comprehensions
139
+ "ISC", # implicit string-concat safety
140
+
141
+ # --- New additions (strict mode) ---
142
+ "D", # pydocstyle: docstring formatting/consistency
143
+ "ANN", # annotations: missing/incorrect typing hints
144
+ "PT", # pytest: best practices for tests
145
+ ]
146
+
147
+ # Disable rules that conflict with the Lupaxa documentation style
148
+ # or with Ruff's formatter.
149
+ ignore = [
150
+ "D200", # One-line docstring should fit on one line
151
+ "D201", # No blank lines allowed before function docstring
152
+ "D202", # No blank lines allowed after function docstring
153
+ "D203", # One blank line required before class docstring
154
+ "D204", # One blank line required after class docstring
155
+ "D205", # Blank line required between summary and description
156
+ "D206", # Docstring indentation
157
+ "D207", # Docstring under-indentation
158
+ "D208", # Docstring over-indentation
159
+ "D209", # Multi-line docstring closing quotes placement
160
+ "D210", # No surrounding whitespace allowed
161
+ "D211", # No blank line allowed before class docstring
162
+ "D212", # Summary must start on the first physical line
163
+ "ISC001", # Conflicts with Ruff formatting
164
+ ]
165
+
166
+ [tool.ruff.lint.per-file-ignores]
167
+ "src/lupaxa/github_intel/cli.py" = [
168
+ "B008", # Typer reads Option() and Argument() defaults at definition time
169
+ ]
170
+ "tests/**/*.py" = [
171
+ "ANN", # Test functions and fixtures may use relaxed annotations
172
+ "D", # Test modules do not require full public documentation
173
+ "S101", # Allow assert statements in tests
174
+ "S105", # Allow password-like test literals
175
+ ]
176
+
177
+ [tool.ruff.lint.flake8-annotations]
178
+ allow-star-arg-any = false
179
+ ignore-fully-untyped = false
180
+ mypy-init-return = true
181
+ suppress-dummy-args = false
182
+ suppress-none-returning = false
183
+
184
+ [tool.ruff.lint.flake8-builtins]
185
+ builtins-ignorelist = [
186
+ "id",
187
+ ]
188
+
189
+ [tool.ruff.lint.flake8-pytest-style]
190
+ fixture-parentheses = false
191
+ mark-parentheses = false
192
+ parametrize-names-type = "tuple"
193
+ parametrize-values-row-type = "tuple"
194
+ parametrize-values-type = "list"
195
+
196
+ [tool.ruff.lint.flake8-quotes]
197
+ docstring-quotes = "double"
198
+ inline-quotes = "double"
199
+ multiline-quotes = "double"
200
+
201
+ [tool.ruff.lint.flake8-tidy-imports]
202
+ ban-relative-imports = "parents"
203
+
204
+ [tool.ruff.lint.isort]
205
+ combine-as-imports = true
206
+ force-sort-within-sections = true
207
+ known-first-party = [
208
+ "lupaxa",
209
+ ]
210
+ split-on-trailing-comma = true
211
+
212
+ [tool.ruff.lint.mccabe]
213
+ max-complexity = 10
214
+
215
+ [tool.ruff.lint.pep8-naming]
216
+ classmethod-decorators = [
217
+ "classmethod",
218
+ ]
219
+ staticmethod-decorators = [
220
+ "staticmethod",
221
+ ]
222
+
223
+ [tool.ruff.lint.pylint]
224
+ allow-dunder-method-names = []
225
+ max-args = 10
226
+ max-branches = 12
227
+ max-returns = 6
228
+ max-statements = 50
229
+
230
+ [tool.ruff.lint.pyupgrade]
231
+ keep-runtime-typing = false
232
+
233
+ [tool.ruff.format]
234
+ docstring-code-format = true
235
+ docstring-code-line-length = 88
236
+ indent-style = "space"
237
+ line-ending = "lf"
238
+ quote-style = "double"
239
+ skip-magic-trailing-comma = false
240
+
241
+ [tool.mypy]
242
+ python_version = "3.11"
243
+ explicit_package_bases = true
244
+ files = [
245
+ "src",
246
+ "tests",
247
+ ]
248
+ mypy_path = "src"
249
+ packages = [
250
+ "lupaxa.github_intel",
251
+ ]
252
+ strict = true
253
+ pretty = true
254
+ show_column_numbers = true
255
+ show_error_codes = true
256
+ show_error_context = true
257
+ show_traceback = true
258
+ warn_unreachable = true
259
+ warn_unused_configs = true
260
+ exclude = [
261
+ "^build/",
262
+ "^dist/",
263
+ ]
264
+
265
+ [tool.pytest.ini_options]
266
+ minversion = "8.0"
267
+ asyncio_mode = "auto"
268
+ asyncio_default_fixture_loop_scope = "function"
269
+ addopts = [
270
+ "--strict-config",
271
+ "--strict-markers",
272
+ "--showlocals",
273
+ "--tb=short",
274
+ ]
275
+ testpaths = [
276
+ "tests",
277
+ ]
278
+ pythonpath = [
279
+ "src",
280
+ ]
281
+ xfail_strict = true
282
+ filterwarnings = [
283
+ "error",
284
+ ]
285
+
286
+ [tool.pyright]
287
+ reportMissingImports = "none"
288
+
289
+ [tool.coverage.run]
290
+ branch = true
291
+ parallel = true
292
+ source = [
293
+ "lupaxa.github_intel",
294
+ ]
295
+
296
+ [tool.coverage.paths]
297
+ source = [
298
+ "src/lupaxa/github_intel",
299
+ "*/site-packages/lupaxa/github_intel",
300
+ ]
301
+
302
+ [tool.coverage.report]
303
+ exclude_also = [
304
+ "if TYPE_CHECKING:",
305
+ "if __name__ == \"__main__\":",
306
+ "raise AssertionError",
307
+ "raise NotImplementedError",
308
+ ]
309
+ fail_under = 90
310
+ precision = 2
311
+ show_missing = true
312
+ skip_covered = false
313
+ skip_empty = true
314
+
315
+ [tool.coverage.html]
316
+ directory = "coverage/html"
317
+
318
+ [tool.coverage.xml]
319
+ output = "coverage/coverage.xml"
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+
@@ -0,0 +1,13 @@
1
+ """
2
+ GitHub Intel.
3
+
4
+ Python command-line tool for GitHub intelligence.
5
+ """
6
+
7
+ from __future__ import annotations
8
+
9
+ from .cli import main
10
+
11
+ __all__ = [
12
+ "main",
13
+ ]
@@ -0,0 +1,8 @@
1
+ """Package entry point for ``python -m lupaxa.github_intel``."""
2
+
3
+ from __future__ import annotations
4
+
5
+ from .cli import main
6
+
7
+ if __name__ == "__main__":
8
+ main()