Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

fix(rosetta): stop skipping example values #3128

Merged
merged 3 commits into from
Nov 5, 2021

Conversation

rix0rrr
Copy link
Contributor

@rix0rrr rix0rrr commented Nov 5, 2021

In CDK, we use the @example tag a lot to indicate example values
of some property, instead of code examples. For example, a bucketArn
property might have as annotation @example arn:aws:s3:.....

Rosetta would try to compile those, and fail. To get around this, we would skip
values that looked like they weren't source in rosetta extract.

This doesn't combine well with pacmak live-translation. We are either forced to
try and compile them again during pacmak (adding compile time), or fail
pacmak as soon as we encounter these. And all of this is to work around
abuse of the @example tag for something it's not intended for.

So stop treating these examples specially. They will just fail compilation
unless rewritten. This will force us to deal with them properly in the
CDK source code.


By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

In CDK, we use the `@example` tag a lot to indicate example values
of some property, instead of code examples. For example, a `bucketArn`
property might have as annotation `@example arn:aws:s3:....`.

Rosetta would try to compile those, and fail. To get around this, we would skip
values that *looked* like they weren't source in `rosetta extract`.

This doesn't combine well with pacmak live-translation. We are either forced to
try and compile them again during pacmak (adding compile time), or fail
pacmak as soon as we encounter these. And all of this is to work around
abuse of the `@example` tag for something it's not intended for.

So stop treating these examples specially. They will just fail compilation
unless rewritten. This will force us to deal with them properly in the
CDK source code.
@rix0rrr rix0rrr requested a review from a team November 5, 2021 15:21
@rix0rrr rix0rrr self-assigned this Nov 5, 2021
@mergify mergify bot added the contribution/core This is a PR that came from AWS. label Nov 5, 2021
@mergify
Copy link
Contributor

mergify bot commented Nov 5, 2021

Thank you for contributing! ❤️ I will now look into making sure the PR is up-to-date, then proceed to try and merge it!

@mergify mergify bot added the pr/ready-to-merge This PR is ready to be merged. label Nov 5, 2021
@mergify
Copy link
Contributor

mergify bot commented Nov 5, 2021

Merging (with squash)...

@mergify mergify bot merged commit ee0620a into main Nov 5, 2021
@mergify mergify bot deleted the huijbers/rosetta-every-sample-is-sacred branch November 5, 2021 18:04
@mergify
Copy link
Contributor

mergify bot commented Nov 5, 2021

Merging (with squash)...

@mergify mergify bot removed the pr/ready-to-merge This PR is ready to be merged. label Nov 5, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
contribution/core This is a PR that came from AWS.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants