chore: In amino.pkg, add optional WithComments, use them in GenerateProto3MessagePartial

[jefft0]

This PR resolves issue #1157 by adding support for the optional WithComments. See the issue for motivation.

• In amino.pkg.Type, add optional fields Comment and FieldComments .
• Add the Package method WithComments which can optionally be used after WithTypes. This reads the Go source file and scans the AST for struct and field comments which are added to the Type object.
• Update GenerateProto3MessagePartial to copy the comments to the P3Doc and related P3Field objects which already have an optional Comment field for comments that are already included in the Protobuf file.
• Add test file comments_test.go .

As shown in the test, you can use WithComments after WithTypes:

pkg := amino.RegisterPackage(
    amino.NewPackage(
        "github.com/gnolang/gno/tm2/pkg/amino/genproto",
        "amino_test",
        amino.GetCallersDirname(),
    ).WithTypes(
        &TestMessageName{},
        &TestMessageName2{},
    // Add comments from this same source file.
    ).WithComments(path.Join(amino.GetCallersDirname(), "comments_test.go")))

If your Go struct looks like:

// message comment
type TestMessageName struct {
    // field comment 1
    FieldName1 string
    // field comment 2
    FieldName2 []uint64
}

then your Protobuf file has:

// message comment
message TestMessageName {
    // field comment 1
    string FieldName1 = 1;
    // field comment 2
    repeated uint64 FieldName2 = 2;
}

Contributors' checklist...

• Added new tests, or not needed, or not feasible
• Provided an example (e.g. screenshot) to aid review or the PR is self-explanatory
• Updated the official documentation or not needed
• No breaking changes were made, or a BREAKING CHANGE: xxx message was included in the description
• Added references to related issues and PRs
• Provided any useful hints for running manual tests
• Added new benchmarks to generated graphs, if any. More info here.

[codecov]

Codecov Report

Attention: 39 lines in your changes are missing coverage. Please review.

Comparison is base (5aa8676) 55.59% compared to head (b746716) 55.84%.
Report is 6 commits behind head on master.

Files	Patch %	Lines
tm2/pkg/amino/pkg/pkg.go	0.00%	39 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master    #1235      +/-   ##
==========================================
+ Coverage   55.59%   55.84%   +0.25%     
==========================================
  Files         420      422       +2     
  Lines       65470    65686     +216     
==========================================
+ Hits        36395    36685     +290     
+ Misses      26222    26130      -92     
- Partials     2853     2871      +18     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[thehowl]

LGTM

[gfanton]

lgtm (after flatten :) )

[jefft0]

Hi @thehowl . Thanks for doing the flattening. I pushed one last commit to fix a problem with running make in misc/genproto.
b746716