User

Welcome. This guide is organized as a tutorial path so you can integrate DepDigest in your library without friction.

If you follow the pages in order, you will go from a minimal setup to advanced patterns and edge cases.

Before implementing, keep this contract at hand:

• DEPDIGEST_GUIDE.md

If you want to contribute to DepDigest itself (not only integrate it in your own library), continue in the Developers section.

Recommended practice:

• place a copy of DEPDIGEST_GUIDE.md in your project root, so humans and AI agents follow the same contract.

Learning Path

1. Quick Start: first working integration in minutes.

2. Mini Library Walkthrough: complete narrative from zero to production.

3. Configuration: how _depdigest.py defines your dependency policy.

4. Hard vs Soft: what each dependency type means in practice.

5. Integrating in Your Library: implementation blueprint for real codebases.

6. Conditional Dependencies: enforce dependencies only when needed.

7. Lazy Registry: lazy plugin/module loading at scale.

8. Introspection: expose dependency status to your users.

9. SMonitor Integration: understand diagnostics behavior and controls.

10. Edge Cases: recovecos you should know before production.

11. Troubleshooting: fast diagnosis for common integration failures.

12. Audit CLI: detect top-level imports of soft dependencies before release.

13. CI Profile: recommended pipeline checks for integrators.

14. Production Checklist: final verification before release.

15. FAQ: short answers to common integration questions.