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(cfn2ts): some property times have behavioral-interface names #18275

Merged
merged 2 commits into from
Jan 5, 2022

Conversation

RomainMuller
Copy link
Contributor

Some CloudFormation library generated types, such as
@aws-cdk/aws-networkfirewall.CfnRuleGroup.IPSetProperty are meant to
be jsii structs, but have names that cause them to be handled as jsii
behavioral interfaces (I followed by a capital letter).

Mangling the names (i.e: changing IPSet to IpSet) would also work,
but is tedious to maintain and has been proven to lead to inadeverten
releasing of stable code that does not have the intended "shape" in
other languages.

Instead - this uses the jsii type system hints feature introduced a few
months ago in the compiler to force those interfaces to be considered as
structs regardless of their name.

Fixes aws/jsii#2929 (and probably more)

BREAKING CHANGE: some "complex" property types within the generated
CloudFormation interfaces (i.e: properties of Cfn* constructs) with
names starting with a capital letter I followed by another capital
letter are no longer incorrectly treated as behavioral interfaces, and
might hence have different usage patterns in non-TypeScript languages.
Such interfaces were previously very difficult to use in non-TypeScript
languages, and required convoluted workarounds, which can now be removed.


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

Some CloudFormation library generated types, such as
`@aws-cdk/aws-networkfirewall.CfnRuleGroup.IPSetProperty` are meant to
be jsii structs, but have names that cause them to be handled as jsii
behavioral interfaces (`I` followed by a capital letter).

Mangling the names (i.e: changing `IPSet` to `IpSet`) would also work,
but is tedious to maintain and has been proven to lead to inadeverten
releasing of stable code that does not have the intended "shape" in
other languages.

Instead - this uses the jsii type system hints feature introduced a few
months ago in the compiler to force those interfaces to be considered as
structs regardless of their name.

Fixes aws/jsii#2929 (and probably more)
@RomainMuller RomainMuller requested a review from a team January 5, 2022 09:54
@RomainMuller RomainMuller self-assigned this Jan 5, 2022
@gitpod-io
Copy link

gitpod-io bot commented Jan 5, 2022

@mergify mergify bot added the contribution/core This is a PR that came from AWS. label Jan 5, 2022
@rix0rrr rix0rrr added the pr-linter/exempt-test The PR linter will not require test changes label Jan 5, 2022
@mergify
Copy link
Contributor

mergify bot commented Jan 5, 2022

Thank you for contributing! Your pull request will be updated from master and then merged automatically (do not update manually, and be sure to allow changes to be pushed to your fork).

@aws-cdk-automation
Copy link
Collaborator

AWS CodeBuild CI Report

  • CodeBuild project: AutoBuildProject89A8053A-LhjRyN9kxr8o
  • Commit ID: 55dd397
  • Result: SUCCEEDED
  • Build Logs (available for 30 days)

Powered by github-codebuild-logs, available on the AWS Serverless Application Repository

@mergify mergify bot merged commit 6359c12 into master Jan 5, 2022
@mergify mergify bot deleted the rmuller/cfn2ts-at-struct branch January 5, 2022 12:10
@mergify
Copy link
Contributor

mergify bot commented Jan 5, 2022

Thank you for contributing! Your pull request will be updated from master and then merged automatically (do not update manually, and be sure to allow changes to be pushed to your fork).

TikiTDO pushed a commit to TikiTDO/aws-cdk that referenced this pull request Feb 21, 2022
…#18275)

Some CloudFormation library generated types, such as
`@aws-cdk/aws-networkfirewall.CfnRuleGroup.IPSetProperty` are meant to
be jsii structs, but have names that cause them to be handled as jsii
behavioral interfaces (`I` followed by a capital letter).

Mangling the names (i.e: changing `IPSet` to `IpSet`) would also work,
but is tedious to maintain and has been proven to lead to inadeverten
releasing of stable code that does not have the intended "shape" in
other languages.

Instead - this uses the jsii type system hints feature introduced a few
months ago in the compiler to force those interfaces to be considered as
structs regardless of their name.

Fixes aws/jsii#2929 (and probably more)

BREAKING CHANGE: some "complex" property types within the generated
CloudFormation interfaces (i.e: properties of `Cfn*` constructs) with
names starting with a capital letter `I` followed by another capital
letter are no longer incorrectly treated as behavioral interfaces, and
might hence have different usage patterns in non-TypeScript languages.
Such interfaces were previously very difficult to use in non-TypeScript
languages, and required convoluted workarounds, which can now be removed.

----

*By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license*
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. pr-linter/exempt-test The PR linter will not require test changes
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Interface IPsetProperty is unusable in Python
3 participants