bruno-api

Bruno API documentation generator converts .bru files into structured endpoint docs by mapping requests to Django backend implementations. Run the tool on single files, scan directories with --scan, and write output with --output to produce Markdown documentation including authentication, permissions, and code references.

Yes. Bruno API maps requests defined in .bru files to both DRF and Ninja route implementations, automatically extracting and documenting endpoint behaviors, request/response schemas, authentication methods, and permission constraints tied to your actual backend code.

Generated docs cover authentication and permissions, multi-tenant filtering logic, request and response schemas, TypeScript types for frontend integration, example API calls, and line-numbered code references pointing to real route implementations in your Django backend.

Use the --dry-run mode to preview the analysis and generation plan without writing output. This lets you review how Bruno requests map to backend endpoints and validate schema extraction before committing documentation to disk.

Yes. Process single .bru files directly, use --scan to analyze entire directories of Bruno request files, and specify --output to write consolidated documentation to your chosen location with all endpoints documented in one structured Markdown output.

Bruno API eliminates manual documentation drift by generating docs directly from .bru request definitions and tying them to real backend code. This ensures docs stay synchronized with actual implementations, reduces maintenance overhead, and captures authentication, permissions, and multi-tenant logic automatically.