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

chore(toolkit): add proposed initial interfaces #32643

Merged
merged 4 commits into from
Dec 24, 2024

Conversation

mrgrain
Copy link
Contributor

@mrgrain mrgrain commented Dec 23, 2024

Issue

Close #32567

Reason for this change

Add proposed interfaces and stub classes to the @aws-cdk/toolkit package according to RFC 300, so integrators can start designing their own solution.

Describe any new or updated permissions being added

n/a

Description of how you validated changes

n/a unused stub interfaces

Checklist


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

@aws-cdk-automation aws-cdk-automation requested a review from a team December 23, 2024 13:14
@github-actions github-actions bot added the p2 label Dec 23, 2024
@mergify mergify bot added the contribution/core This is a PR that came from AWS. label Dec 23, 2024
@mrgrain mrgrain force-pushed the mrgrain/chore/toolkit-interfaces branch from 46af313 to 1194601 Compare December 23, 2024 13:17
Copy link

codecov bot commented Dec 23, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 80.54%. Comparing base (fcf37ee) to head (db41d9f).
Report is 1 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main   #32643   +/-   ##
=======================================
  Coverage   80.54%   80.54%           
=======================================
  Files         106      106           
  Lines        6954     6954           
  Branches     1287     1287           
=======================================
  Hits         5601     5601           
  Misses       1175     1175           
  Partials      178      178           
Flag Coverage Δ
suite.unit 80.54% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

Components Coverage Δ
packages/aws-cdk 80.54% <ø> (ø)

@mrgrain mrgrain force-pushed the mrgrain/chore/toolkit-interfaces branch from 1194601 to 6f15657 Compare December 23, 2024 13:34
@aws-cdk-automation aws-cdk-automation added the pr/needs-maintainer-review This PR needs a review from a Core Team Member label Dec 23, 2024
Copy link
Contributor

@kaizencc kaizencc left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

because this has no impact on public surface area at all, i'm inclined to approve. but before i do, i would like to know which parts (if any) of this PR are copy/paste and which parts are new.

i also believe that eventually we should have linter rules in place that ensure all public APIs have doc strings and all optional properties have default docs. but that's not blocking for now.

packages/@aws-cdk/toolkit/lib/cloud-assembly-source.ts Outdated Show resolved Hide resolved
packages/@aws-cdk/toolkit/lib/cloud-assembly-source.ts Outdated Show resolved Hide resolved
packages/@aws-cdk/toolkit/lib/io-host.ts Outdated Show resolved Hide resolved
packages/@aws-cdk/toolkit/lib/io-host.ts Outdated Show resolved Hide resolved
packages/@aws-cdk/toolkit/lib/types.ts Outdated Show resolved Hide resolved
* If the app includes a single stack, returns it. Otherwise throws an exception.
* This behavior is used by "deploy".
*/
OnlySingle = 'single',
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm more familiar with enums being fully capitalized, like ONLY_SINGLE. curious why the enums in this file follow a different naming scheme

/**
* Don't select any extra stacks
*/
None,
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Isn't it still safer to write None = 'none'?

Comment on lines 55 to 58
export enum RequireApproval {
Never = 'never',
AnyChange = 'any-change',
Broadening = 'broadening',
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i'd like our enum styling to be the same and imo it should be fully capitalized

@aws-cdk-automation aws-cdk-automation removed the pr/needs-maintainer-review This PR needs a review from a Core Team Member label Dec 23, 2024
Copy link
Contributor

mergify bot commented Dec 24, 2024

Thank you for contributing! Your pull request will be updated from main 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: AutoBuildv2Project1C6BFA3F-wQm2hXv2jqQv
  • Commit ID: db41d9f
  • Result: SUCCEEDED
  • Build Logs (available for 30 days)

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

Copy link
Contributor

mergify bot commented Dec 24, 2024

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

@mergify mergify bot merged commit dcf1d74 into main Dec 24, 2024
17 checks passed
@mergify mergify bot deleted the mrgrain/chore/toolkit-interfaces branch December 24, 2024 01:56
Copy link

Comments on closed issues and PRs are hard for our team to see.
If you need help, please open a new issue that references this one.

@github-actions github-actions bot locked as resolved and limited conversation to collaborators Dec 24, 2024
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
contribution/core This is a PR that came from AWS. p2
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Add proposed interfaces
3 participants