gha-debug 0.1.2__tar.gz → 0.2.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 (23) hide show
  1. {gha_debug-0.1.2 → gha_debug-0.2.0}/LICENSE +21 -21
  2. {gha_debug-0.1.2 → gha_debug-0.2.0}/PKG-INFO +113 -113
  3. {gha_debug-0.1.2 → gha_debug-0.2.0}/README.md +88 -88
  4. {gha_debug-0.1.2 → gha_debug-0.2.0}/gha_debug/__init__.py +3 -3
  5. {gha_debug-0.1.2 → gha_debug-0.2.0}/gha_debug/cli.py +187 -146
  6. {gha_debug-0.1.2 → gha_debug-0.2.0}/gha_debug/formatter.py +102 -102
  7. {gha_debug-0.1.2 → gha_debug-0.2.0}/gha_debug/parser.py +97 -97
  8. gha_debug-0.2.0/gha_debug/report.py +160 -0
  9. {gha_debug-0.1.2 → gha_debug-0.2.0}/gha_debug/runner.py +190 -190
  10. {gha_debug-0.1.2 → gha_debug-0.2.0}/gha_debug/validator.py +96 -96
  11. {gha_debug-0.1.2 → gha_debug-0.2.0}/gha_debug.egg-info/PKG-INFO +113 -113
  12. {gha_debug-0.1.2 → gha_debug-0.2.0}/gha_debug.egg-info/SOURCES.txt +1 -0
  13. {gha_debug-0.1.2 → gha_debug-0.2.0}/pyproject.toml +35 -35
  14. {gha_debug-0.1.2 → gha_debug-0.2.0}/setup.cfg +4 -4
  15. {gha_debug-0.1.2 → gha_debug-0.2.0}/tests/test_cli.py +232 -232
  16. {gha_debug-0.1.2 → gha_debug-0.2.0}/tests/test_formatter.py +153 -153
  17. {gha_debug-0.1.2 → gha_debug-0.2.0}/tests/test_parser.py +102 -102
  18. {gha_debug-0.1.2 → gha_debug-0.2.0}/tests/test_runner.py +226 -226
  19. {gha_debug-0.1.2 → gha_debug-0.2.0}/tests/test_validator.py +113 -113
  20. {gha_debug-0.1.2 → gha_debug-0.2.0}/gha_debug.egg-info/dependency_links.txt +0 -0
  21. {gha_debug-0.1.2 → gha_debug-0.2.0}/gha_debug.egg-info/entry_points.txt +0 -0
  22. {gha_debug-0.1.2 → gha_debug-0.2.0}/gha_debug.egg-info/requires.txt +0 -0
  23. {gha_debug-0.1.2 → gha_debug-0.2.0}/gha_debug.egg-info/top_level.txt +0 -0
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2026 Intellirim
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.
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Intellirim
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.
@@ -1,113 +1,113 @@
1
- Metadata-Version: 2.4
2
- Name: gha-debug
3
- Version: 0.1.2
4
- Summary: Debug GitHub Actions workflows locally with step-by-step execution
5
- Author: Intellirim
6
- License: MIT
7
- Project-URL: Homepage, https://github.com/intellirim/gha-debug
8
- Keywords: github-actions,developer-tools,cli,ci-cd,workflow-debugging,devops
9
- Classifier: Development Status :: 4 - Beta
10
- Classifier: Intended Audience :: Developers
11
- Classifier: License :: OSI Approved :: MIT License
12
- Classifier: Programming Language :: Python :: 3
13
- Classifier: Programming Language :: Python :: 3.8
14
- Classifier: Programming Language :: Python :: 3.9
15
- Classifier: Programming Language :: Python :: 3.10
16
- Classifier: Programming Language :: Python :: 3.11
17
- Classifier: Programming Language :: Python :: 3.12
18
- Requires-Python: >=3.8
19
- Description-Content-Type: text/markdown
20
- License-File: LICENSE
21
- Requires-Dist: click>=8.1.0
22
- Requires-Dist: pyyaml>=6.0
23
- Requires-Dist: rich>=13.0.0
24
- Dynamic: license-file
25
-
26
- # gha-debug
27
-
28
- Debug GitHub Actions workflows locally with step-by-step execution
29
-
30
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
31
-
32
- ## Overview
33
-
34
- `gha-debug` is a lightweight CLI tool that helps developers test and debug GitHub Actions workflows locally before pushing to CI. Unlike heavy Docker-based solutions, it provides fast validation, clear step-by-step execution visibility, and helpful error messages.
35
-
36
- ## Installation
37
-
38
- ```bash
39
- pip install gha-debug
40
- ```
41
-
42
- ## Usage
43
-
44
- ### Run a workflow locally
45
-
46
- ```bash
47
- gha-debug run .github/workflows/test.yml
48
- ```
49
-
50
- ### Run a specific job with verbose output
51
-
52
- ```bash
53
- gha-debug run .github/workflows/build.yml --job build --verbose
54
- ```
55
-
56
- ### List all workflows and jobs
57
-
58
- ```bash
59
- gha-debug list
60
- ```
61
-
62
- ### Show environment variables for a job
63
-
64
- ```bash
65
- gha-debug env .github/workflows/deploy.yml --job deploy
66
- ```
67
-
68
- ### Validate workflow syntax
69
-
70
- ```bash
71
- gha-debug validate .github/workflows/*.yml
72
- ```
73
-
74
- ## Features
75
-
76
- - ✅ Parse and validate GitHub Actions workflow YAML files
77
- - ✅ List all workflows, jobs, and steps with clear formatting
78
- - ✅ Run workflows locally with simulated GitHub Actions environment
79
- - ✅ Show detailed step-by-step execution with timing information
80
- - ✅ Display environment variables and contexts for debugging
81
- - ✅ Validate workflow syntax and catch common errors before pushing
82
- - ✅ Colorized output for better readability
83
- - ✅ Support for filtering by specific job within a workflow
84
-
85
- ## Why gha-debug?
86
-
87
- Debugging GitHub Actions workflows is painful:
88
- - Logs are hard to navigate in the web interface
89
- - Re-running failed jobs wastes time
90
- - No simple local testing that mirrors the CI environment
91
-
92
- `gha-debug` solves this by providing a fast feedback loop. It doesn't try to perfectly replicate GitHub's environment (which causes compatibility issues), but instead focuses on what developers need most: quick validation and clear error messages.
93
-
94
- ## Example Output
95
-
96
- ```
97
- $ gha-debug run .github/workflows/test.yml
98
-
99
- Running workflow: test.yml
100
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
101
-
102
- Job: test
103
- ✓ Checkout code (1.2s)
104
- ✓ Setup Python 3.11 (0.8s)
105
- ✓ Install dependencies (4.5s)
106
- ✓ Run tests (12.3s)
107
-
108
- ✓ Workflow completed successfully in 18.8s
109
- ```
110
-
111
- ## License
112
-
113
- MIT License - Copyright (c) 2026 Intellirim
1
+ Metadata-Version: 2.4
2
+ Name: gha-debug
3
+ Version: 0.2.0
4
+ Summary: Debug GitHub Actions workflows locally with step-by-step execution
5
+ Author: Intellirim
6
+ License: MIT
7
+ Project-URL: Homepage, https://github.com/intellirim/gha-debug
8
+ Keywords: github-actions,developer-tools,cli,ci-cd,workflow-debugging,devops
9
+ Classifier: Development Status :: 4 - Beta
10
+ Classifier: Intended Audience :: Developers
11
+ Classifier: License :: OSI Approved :: MIT License
12
+ Classifier: Programming Language :: Python :: 3
13
+ Classifier: Programming Language :: Python :: 3.8
14
+ Classifier: Programming Language :: Python :: 3.9
15
+ Classifier: Programming Language :: Python :: 3.10
16
+ Classifier: Programming Language :: Python :: 3.11
17
+ Classifier: Programming Language :: Python :: 3.12
18
+ Requires-Python: >=3.8
19
+ Description-Content-Type: text/markdown
20
+ License-File: LICENSE
21
+ Requires-Dist: click>=8.1.0
22
+ Requires-Dist: pyyaml>=6.0
23
+ Requires-Dist: rich>=13.0.0
24
+ Dynamic: license-file
25
+
26
+ # gha-debug
27
+
28
+ Debug GitHub Actions workflows locally with step-by-step execution
29
+
30
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
31
+
32
+ ## Overview
33
+
34
+ `gha-debug` is a lightweight CLI tool that helps developers test and debug GitHub Actions workflows locally before pushing to CI. Unlike heavy Docker-based solutions, it provides fast validation, clear step-by-step execution visibility, and helpful error messages.
35
+
36
+ ## Installation
37
+
38
+ ```bash
39
+ pip install gha-debug
40
+ ```
41
+
42
+ ## Usage
43
+
44
+ ### Run a workflow locally
45
+
46
+ ```bash
47
+ gha-debug run .github/workflows/test.yml
48
+ ```
49
+
50
+ ### Run a specific job with verbose output
51
+
52
+ ```bash
53
+ gha-debug run .github/workflows/build.yml --job build --verbose
54
+ ```
55
+
56
+ ### List all workflows and jobs
57
+
58
+ ```bash
59
+ gha-debug list
60
+ ```
61
+
62
+ ### Show environment variables for a job
63
+
64
+ ```bash
65
+ gha-debug env .github/workflows/deploy.yml --job deploy
66
+ ```
67
+
68
+ ### Validate workflow syntax
69
+
70
+ ```bash
71
+ gha-debug validate .github/workflows/*.yml
72
+ ```
73
+
74
+ ## Features
75
+
76
+ - ✅ Parse and validate GitHub Actions workflow YAML files
77
+ - ✅ List all workflows, jobs, and steps with clear formatting
78
+ - ✅ Run workflows locally with simulated GitHub Actions environment
79
+ - ✅ Show detailed step-by-step execution with timing information
80
+ - ✅ Display environment variables and contexts for debugging
81
+ - ✅ Validate workflow syntax and catch common errors before pushing
82
+ - ✅ Colorized output for better readability
83
+ - ✅ Support for filtering by specific job within a workflow
84
+
85
+ ## Why gha-debug?
86
+
87
+ Debugging GitHub Actions workflows is painful:
88
+ - Logs are hard to navigate in the web interface
89
+ - Re-running failed jobs wastes time
90
+ - No simple local testing that mirrors the CI environment
91
+
92
+ `gha-debug` solves this by providing a fast feedback loop. It doesn't try to perfectly replicate GitHub's environment (which causes compatibility issues), but instead focuses on what developers need most: quick validation and clear error messages.
93
+
94
+ ## Example Output
95
+
96
+ ```
97
+ $ gha-debug run .github/workflows/test.yml
98
+
99
+ Running workflow: test.yml
100
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
101
+
102
+ Job: test
103
+ ✓ Checkout code (1.2s)
104
+ ✓ Setup Python 3.11 (0.8s)
105
+ ✓ Install dependencies (4.5s)
106
+ ✓ Run tests (12.3s)
107
+
108
+ ✓ Workflow completed successfully in 18.8s
109
+ ```
110
+
111
+ ## License
112
+
113
+ MIT License - Copyright (c) 2026 Intellirim
@@ -1,88 +1,88 @@
1
- # gha-debug
2
-
3
- Debug GitHub Actions workflows locally with step-by-step execution
4
-
5
- [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
6
-
7
- ## Overview
8
-
9
- `gha-debug` is a lightweight CLI tool that helps developers test and debug GitHub Actions workflows locally before pushing to CI. Unlike heavy Docker-based solutions, it provides fast validation, clear step-by-step execution visibility, and helpful error messages.
10
-
11
- ## Installation
12
-
13
- ```bash
14
- pip install gha-debug
15
- ```
16
-
17
- ## Usage
18
-
19
- ### Run a workflow locally
20
-
21
- ```bash
22
- gha-debug run .github/workflows/test.yml
23
- ```
24
-
25
- ### Run a specific job with verbose output
26
-
27
- ```bash
28
- gha-debug run .github/workflows/build.yml --job build --verbose
29
- ```
30
-
31
- ### List all workflows and jobs
32
-
33
- ```bash
34
- gha-debug list
35
- ```
36
-
37
- ### Show environment variables for a job
38
-
39
- ```bash
40
- gha-debug env .github/workflows/deploy.yml --job deploy
41
- ```
42
-
43
- ### Validate workflow syntax
44
-
45
- ```bash
46
- gha-debug validate .github/workflows/*.yml
47
- ```
48
-
49
- ## Features
50
-
51
- - ✅ Parse and validate GitHub Actions workflow YAML files
52
- - ✅ List all workflows, jobs, and steps with clear formatting
53
- - ✅ Run workflows locally with simulated GitHub Actions environment
54
- - ✅ Show detailed step-by-step execution with timing information
55
- - ✅ Display environment variables and contexts for debugging
56
- - ✅ Validate workflow syntax and catch common errors before pushing
57
- - ✅ Colorized output for better readability
58
- - ✅ Support for filtering by specific job within a workflow
59
-
60
- ## Why gha-debug?
61
-
62
- Debugging GitHub Actions workflows is painful:
63
- - Logs are hard to navigate in the web interface
64
- - Re-running failed jobs wastes time
65
- - No simple local testing that mirrors the CI environment
66
-
67
- `gha-debug` solves this by providing a fast feedback loop. It doesn't try to perfectly replicate GitHub's environment (which causes compatibility issues), but instead focuses on what developers need most: quick validation and clear error messages.
68
-
69
- ## Example Output
70
-
71
- ```
72
- $ gha-debug run .github/workflows/test.yml
73
-
74
- Running workflow: test.yml
75
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
76
-
77
- Job: test
78
- ✓ Checkout code (1.2s)
79
- ✓ Setup Python 3.11 (0.8s)
80
- ✓ Install dependencies (4.5s)
81
- ✓ Run tests (12.3s)
82
-
83
- ✓ Workflow completed successfully in 18.8s
84
- ```
85
-
86
- ## License
87
-
88
- MIT License - Copyright (c) 2026 Intellirim
1
+ # gha-debug
2
+
3
+ Debug GitHub Actions workflows locally with step-by-step execution
4
+
5
+ [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
6
+
7
+ ## Overview
8
+
9
+ `gha-debug` is a lightweight CLI tool that helps developers test and debug GitHub Actions workflows locally before pushing to CI. Unlike heavy Docker-based solutions, it provides fast validation, clear step-by-step execution visibility, and helpful error messages.
10
+
11
+ ## Installation
12
+
13
+ ```bash
14
+ pip install gha-debug
15
+ ```
16
+
17
+ ## Usage
18
+
19
+ ### Run a workflow locally
20
+
21
+ ```bash
22
+ gha-debug run .github/workflows/test.yml
23
+ ```
24
+
25
+ ### Run a specific job with verbose output
26
+
27
+ ```bash
28
+ gha-debug run .github/workflows/build.yml --job build --verbose
29
+ ```
30
+
31
+ ### List all workflows and jobs
32
+
33
+ ```bash
34
+ gha-debug list
35
+ ```
36
+
37
+ ### Show environment variables for a job
38
+
39
+ ```bash
40
+ gha-debug env .github/workflows/deploy.yml --job deploy
41
+ ```
42
+
43
+ ### Validate workflow syntax
44
+
45
+ ```bash
46
+ gha-debug validate .github/workflows/*.yml
47
+ ```
48
+
49
+ ## Features
50
+
51
+ - ✅ Parse and validate GitHub Actions workflow YAML files
52
+ - ✅ List all workflows, jobs, and steps with clear formatting
53
+ - ✅ Run workflows locally with simulated GitHub Actions environment
54
+ - ✅ Show detailed step-by-step execution with timing information
55
+ - ✅ Display environment variables and contexts for debugging
56
+ - ✅ Validate workflow syntax and catch common errors before pushing
57
+ - ✅ Colorized output for better readability
58
+ - ✅ Support for filtering by specific job within a workflow
59
+
60
+ ## Why gha-debug?
61
+
62
+ Debugging GitHub Actions workflows is painful:
63
+ - Logs are hard to navigate in the web interface
64
+ - Re-running failed jobs wastes time
65
+ - No simple local testing that mirrors the CI environment
66
+
67
+ `gha-debug` solves this by providing a fast feedback loop. It doesn't try to perfectly replicate GitHub's environment (which causes compatibility issues), but instead focuses on what developers need most: quick validation and clear error messages.
68
+
69
+ ## Example Output
70
+
71
+ ```
72
+ $ gha-debug run .github/workflows/test.yml
73
+
74
+ Running workflow: test.yml
75
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
76
+
77
+ Job: test
78
+ ✓ Checkout code (1.2s)
79
+ ✓ Setup Python 3.11 (0.8s)
80
+ ✓ Install dependencies (4.5s)
81
+ ✓ Run tests (12.3s)
82
+
83
+ ✓ Workflow completed successfully in 18.8s
84
+ ```
85
+
86
+ ## License
87
+
88
+ MIT License - Copyright (c) 2026 Intellirim
@@ -1,3 +1,3 @@
1
- """gha-debug: Debug GitHub Actions workflows locally."""
2
-
3
- __version__ = "0.1.1"
1
+ """gha-debug: Debug GitHub Actions workflows locally."""
2
+
3
+ __version__ = "0.2.0"