Skip to content

feat(compiler): extract docs info for enums, pipes, and NgModules#51733

Closed
jelbourn wants to merge 7 commits intoangular:mainfrom
jelbourn:api-gen-more-entities
Closed

feat(compiler): extract docs info for enums, pipes, and NgModules#51733
jelbourn wants to merge 7 commits intoangular:mainfrom
jelbourn:api-gen-more-entities

Conversation

@jelbourn
Copy link
Copy Markdown
Contributor

Based on top of #51717

This commit adds extraction for enums, pipes, and NgModules. It also adds a couple of tests for JsDoc extraction that weren't covered in the previous commit.

@jelbourn jelbourn added area: compiler Issues related to `ngc`, Angular's template compiler target: minor This PR is targeted for the next minor release labels Sep 12, 2023
@jelbourn jelbourn requested a review from atscott September 12, 2023 03:09
@ngbot ngbot bot added this to the Backlog milestone Sep 12, 2023
@angular-robot angular-robot bot added the detected: feature PR contains a feature commit label Sep 12, 2023
@jelbourn jelbourn force-pushed the api-gen-more-entities branch from a94175d to 17c7abe Compare September 15, 2023 04:40
jelbourn and others added 7 commits September 15, 2023 10:44
This commit adds a barebones skeleton for extracting information to be used for extracting info that can be used for API reference generation. Subsequent PRs will expand on this with increasingly real extraction. I started with @alxhub's angular#51615 and very slightly polished to get to this minimal commit.
Based on top of angular#51682

This expands on the skeleton previously added to extract docs info for classes, including properties, methods, and method parameters. Type information and Angular-specific info (e.g. inputs) will come in future PRs.
Based on top of angular#51685

This expands on the extraction with information for directives, including inputs and outputs. As part of this change, I've refactored the extraction code related to class and to directives into their own extractor classes to more cleanly separate extraction logic based on type of statement.
Based on top of angular#51697

Adds extraction for accessors (getters/setters), rest params, and resolved type info for everything so far. This also refactors function extraction into a new class and splits tests for common class info and directive info into separate files.
Based on top of #angular#51700

Also updates extraction to ignore un-exported statements.
Based on top of angular#51713

This commit adds docs extraction for information provided in JsDoc comments, including descriptions and Jsdoc tags.
Based on top of angular#51717

This commit adds extraction for enums, pipes, and NgModules. It also adds a couple of tests for JsDoc extraction that weren't covered in the previous commit.
@jelbourn jelbourn force-pushed the api-gen-more-entities branch from 17c7abe to bc9d32f Compare September 15, 2023 17:46
@jelbourn jelbourn added action: merge The PR is ready for merge by the caretaker merge: caretaker note Alert the caretaker performing the merge to check the PR for an out of normal action needed or note labels Sep 15, 2023
@jelbourn
Copy link
Copy Markdown
Contributor Author

Caretaker note: the Windows CI failure is a flake unrelated to this change. This PR includes the changes from all of #51682, #51685, #51697, #51700, #51713, and #51717 all of which have been reviewed and approved.

I can't currently run an internal presubmit for this because my workstation is off network; I would much appreciate if you could run a presubmit for me! (it should not remotely affect Google internal targets)

@pkozlowski-opensource
Copy link
Copy Markdown
Member

This PR was merged into the repository by commit 2e41488.

pkozlowski-opensource pushed a commit that referenced this pull request Sep 18, 2023
Based on top of #51682

This expands on the skeleton previously added to extract docs info for classes, including properties, methods, and method parameters. Type information and Angular-specific info (e.g. inputs) will come in future PRs.

PR Close #51733
pkozlowski-opensource pushed a commit that referenced this pull request Sep 18, 2023
Based on top of #51685

This expands on the extraction with information for directives, including inputs and outputs. As part of this change, I've refactored the extraction code related to class and to directives into their own extractor classes to more cleanly separate extraction logic based on type of statement.

PR Close #51733
pkozlowski-opensource pushed a commit that referenced this pull request Sep 18, 2023
…51733)

Based on top of #51697

Adds extraction for accessors (getters/setters), rest params, and resolved type info for everything so far. This also refactors function extraction into a new class and splits tests for common class info and directive info into separate files.

PR Close #51733
pkozlowski-opensource pushed a commit that referenced this pull request Sep 18, 2023
Based on top of ##51700

Also updates extraction to ignore un-exported statements.

PR Close #51733
pkozlowski-opensource pushed a commit that referenced this pull request Sep 18, 2023
Based on top of #51713

This commit adds docs extraction for information provided in JsDoc comments, including descriptions and Jsdoc tags.

PR Close #51733
pkozlowski-opensource pushed a commit that referenced this pull request Sep 18, 2023
…1733)

Based on top of #51717

This commit adds extraction for enums, pipes, and NgModules. It also adds a couple of tests for JsDoc extraction that weren't covered in the previous commit.

PR Close #51733
@angular-automatic-lock-bot
Copy link
Copy Markdown

This issue has been automatically locked due to inactivity.
Please file a new issue if you are encountering a similar or related problem.

Read more about our automatic conversation locking policy.

This action has been performed automatically by a bot.

@angular-automatic-lock-bot angular-automatic-lock-bot bot locked and limited conversation to collaborators Oct 19, 2023
ChellappanRajan pushed a commit to ChellappanRajan/angular that referenced this pull request Jan 23, 2024
This commit adds a barebones skeleton for extracting information to be used for extracting info that can be used for API reference generation. Subsequent PRs will expand on this with increasingly real extraction. I started with @alxhub's angular#51615 and very slightly polished to get to this minimal commit.

PR Close angular#51733
ChellappanRajan pushed a commit to ChellappanRajan/angular that referenced this pull request Jan 23, 2024
Based on top of angular#51682

This expands on the skeleton previously added to extract docs info for classes, including properties, methods, and method parameters. Type information and Angular-specific info (e.g. inputs) will come in future PRs.

PR Close angular#51733
ChellappanRajan pushed a commit to ChellappanRajan/angular that referenced this pull request Jan 23, 2024
Based on top of angular#51685

This expands on the extraction with information for directives, including inputs and outputs. As part of this change, I've refactored the extraction code related to class and to directives into their own extractor classes to more cleanly separate extraction logic based on type of statement.

PR Close angular#51733
ChellappanRajan pushed a commit to ChellappanRajan/angular that referenced this pull request Jan 23, 2024
…ngular#51733)

Based on top of angular#51697

Adds extraction for accessors (getters/setters), rest params, and resolved type info for everything so far. This also refactors function extraction into a new class and splits tests for common class info and directive info into separate files.

PR Close angular#51733
ChellappanRajan pushed a commit to ChellappanRajan/angular that referenced this pull request Jan 23, 2024
…lar#51733)

Based on top of #angular#51700

Also updates extraction to ignore un-exported statements.

PR Close angular#51733
ChellappanRajan pushed a commit to ChellappanRajan/angular that referenced this pull request Jan 23, 2024
Based on top of angular#51713

This commit adds docs extraction for information provided in JsDoc comments, including descriptions and Jsdoc tags.

PR Close angular#51733
ChellappanRajan pushed a commit to ChellappanRajan/angular that referenced this pull request Jan 23, 2024
…gular#51733)

Based on top of angular#51717

This commit adds extraction for enums, pipes, and NgModules. It also adds a couple of tests for JsDoc extraction that weren't covered in the previous commit.

PR Close angular#51733
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

action: merge The PR is ready for merge by the caretaker area: compiler Issues related to `ngc`, Angular's template compiler detected: feature PR contains a feature commit merge: caretaker note Alert the caretaker performing the merge to check the PR for an out of normal action needed or note target: minor This PR is targeted for the next minor release

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants