[yeongseon]

Summary

azure-functions-openapi generate --app module:variable imports the module, so an exception raised by module-level code surfaced as one bare line, for example Failed to generate OpenAPI specification: 'SECRET_KEY', with no mention of the --app target. Every exception raised while importing the target is now reported with the target and the exception type.

Changes

• handle_generate reports any exception raised by the --app import as Error: Could not import module from --app '<value>': <ExceptionType>: <message>. Only ImportError, ValueError and AttributeError were reported this way before. The exit code (1) and the empty stdout are unchanged.
• docs/cli.md shows a minimal environment-flag guard for import-time side effects next to the existing warning, the CI invocation, and the message a still-failing import produces.

Validation

Run locally:

• make check-all: exit 0 (1664 passed, 30 skipped). The skipped tests need the optional azure-functions-validation package, which the Hatch environment does not install.
• The reproduction from fix(cli): include the --app module in import failure messages #860 (env -u SECRET_KEY azure-functions-openapi generate --app my_app:app) prints Error: Could not import module from --app 'my_app:app': KeyError: 'SECRET_KEY' with exit code 1 and empty stdout. On origin/main it prints only Failed to generate OpenAPI specification: 'SECRET_KEY'.
• The documented guard works: without the flag the import fails with the new message, with the flag generation succeeds.
• The four new tests fail when the change is reverted.

GitHub CI on 9e5e3cd: all check runs completed with no failures, including the required Analyze, bandit, ci-required, PR title and semgrep contexts.

Compatibility

The text of the error changes for the three exception types that were already reported: it now includes the exception type, for example ModuleNotFoundError: No module named 'x'. No exit code changes.

Related Issues

Closes #860

[Copilot]

🟢 Approval recommended

There are no active review issues for the CLI import-failure diagnostics change.

No open issues 🎉

What changed in this PR

Improves CLI diagnostics for --app import failures, addressing #860 by identifying the target and exception type while preserving exit code 1 and empty stdout.

Changes:

• Broadens import-error handling to catch Exception and report contextual errors.
• Adds regression tests for import-time KeyError and existing failure cases.
• Documents an environment-flag guard for external initialization during spec generation.

File	Description
tests/​test_cli.py	Tests error context, exception types, exit codes, and empty stdout.
src/​azure_functions_openapi/​cli.py	Reports the --app target and exception type for import failures.
docs/​cli.md	Adds a guarded initialization example, CI command, and failure message.

_{Review effort: Balanced}