Skip to content

#78 feat: extract doc comments for OpenAPI descriptions#89

Merged
RAprogramm merged 4 commits intodevfrom
78-doc-comments
Jan 7, 2026
Merged

#78 feat: extract doc comments for OpenAPI descriptions#89
RAprogramm merged 4 commits intodevfrom
78-doc-comments

Conversation

@RAprogramm
Copy link
Owner

Summary

  • Add doc comment extraction utilities for OpenAPI descriptions
  • Entity and field doc comments are used in generated API docs
  • First sentence of doc becomes OpenAPI summary

Test plan

  • Unit tests for doc extraction
  • CI checks pass

- Add utils/docs.rs module for doc comment extraction
- Extract /// comments from entity struct for tag descriptions
- Extract /// comments from fields for schema descriptions
- Use entity doc as fallback for tag_description in OpenAPI
- 6 unit tests for doc extraction functions
- Add utils/docs.rs module for doc comment extraction
- Extract /// comments from entity struct for tag descriptions
- Extract /// comments from fields for schema descriptions
- Use entity doc as fallback for tag_description in OpenAPI
- 6 unit tests for doc extraction functions
- Add validation.rs module for #[validate(...)] parsing
- Support length(min, max), range(min, max), email, url, regex
- Generate OpenAPI schema constraints (minLength, maxLength, etc.)
- Store raw attrs for passthrough to generated DTOs
- 8 unit tests for validation parsing
# Conflicts:
#	crates/entity-derive-impl/src/entity/parse/field.rs
@RAprogramm RAprogramm merged commit 33501f3 into dev Jan 7, 2026
2 checks passed
@RAprogramm RAprogramm deleted the 78-doc-comments branch January 7, 2026 04:23
@codecov
Copy link

codecov bot commented Jan 7, 2026

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant