Summary
Provide more helpful error messages for common failures.
Problem to solve
When inso fails, users see generic "Inso CLI Error" messages. More context would help debugging.
Proposed solution
Detect common error patterns and provide actionable guidance:
- "No collection found" → Suggest checking
identifier and working-directory
- "Environment not found" → List available environments
- "Connection refused" → Suggest checking if API server is running
- Timeout → Suggest increasing
execution-timeout
Implementation:
Add error pattern matching in runner.py:
ERROR_HINTS = {
"no collection": "Check that --identifier matches a collection name in your workspace",
"environment not found": "Available environments can be found in Insomnia's environment dropdown",
"ECONNREFUSED": "Ensure your API server is running and accessible",
}
Alternatives considered
No response
Additional context
Files to modify:
src/insomnia_run/runner.py (add error detection)
src/insomnia_run/reporter.py (display hints in report)
Summary
Provide more helpful error messages for common failures.
Problem to solve
When
insofails, users see generic "Inso CLI Error" messages. More context would help debugging.Proposed solution
Detect common error patterns and provide actionable guidance:
identifierandworking-directoryexecution-timeoutImplementation:
Add error pattern matching in
runner.py:Alternatives considered
No response
Additional context
Files to modify:
src/insomnia_run/runner.py(add error detection)src/insomnia_run/reporter.py(display hints in report)