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

refactor(awslint): construct-base-is-private, resource-attribute #2349

Merged
merged 7 commits into from
May 1, 2019

Conversation

eladb
Copy link
Contributor

@eladb eladb commented Apr 22, 2019

Refactor the rule implementation of awslint such that the context of each linter is implemented as a XxxReflection class (i.e. ConstructReflection, ResourceReflection). This increases our ability to reuse the model extracted from the type system in other linters.

  • awslint:construct-base-is-private will recommend that XxxBase are internal (required merging some files in some places)
  • awslint:resource-attribute: implement missing attributes from several modules
  • In some places, move the ImportedXxx class into the import method as a local class (makes the implementation much nicer because it's closed by the function call).

Misc:

  • update "foreach.sh" to ignore undefined npm scripts
  • update contribution guide with instructions on how to use foreach.sh

Fixes #2426
Fixes #2409

BREAKING CHANGE: s3.Bucket.domainName renamed to s3.Bucket.bucketDomainName.

  • codedeploy.IXxxDeploymentConfig.deploymentConfigArn is now a property and not a method.
  • ec2.SecurityGroupBase is now private
  • ec2.VpcNetworkBase is now private
  • kinesis.StreamBase is now private
  • kms.EncryptionKeyBase is now private
  • logs.LogGroupBase is now private
  • ssm.ParameterBase is now private
  • eks.ClusterBase is now private
  • codebuild.ProjectBase is now private
  • codecommit.RepositoryBase is now private
  • codedeploy.ServerDeploymentGroupBase is now private
  • eks.ClusterBase is now private
  • lambda.LayerVersionBase is now private
  • rds.DatabaseClusterBase is now private
  • secretsmanager.SecretBase is now private
  • ses.ReceiptRuleSetBase is now private

Pull Request Checklist

  • Testing
    • Unit test added (prefer not to modify an existing test, otherwise, it's probably a breaking change)
    • CLI change?: coordinate update of integration tests with team
    • cdk-init template change?: coordinated update of integration tests with team
  • Docs
    • jsdocs: All public APIs documented
    • README: README and/or documentation topic updated
  • Title and Description
    • Change type: title prefixed with fix, feat will appear in changelog
    • Title: use lower-case and doesn't end with a period
    • Breaking?: last paragraph: "BREAKING CHANGE: <describe what changed + link for details>"
    • Issues: Indicate issues fixed via: "Fixes #xxx" or "Closes #xxx"
  • Sensitive Modules (requires 2 PR approvers)
    • IAM Policy Document (in @aws-cdk/aws-iam)
    • EC2 Security Groups and ACLs (in @aws-cdk/aws-ec2)
    • Grant APIs (only if not based on official documentation with a reference)

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

Elad Ben-Israel added 3 commits April 22, 2019 15:07
Implement a "Reflection" class for each rule family (modules, constructs, resources) which
reflect on the type system and expose a relevant API for linter rules.

The rational is that this increases our ability to reuse the model by other rule families.
For example, the "ResourceReflection" extends "ConstructReflection" and adds more
information that's specific to AWS resource constructs.
@eladb eladb requested review from RomainMuller, skinny85 and a team as code owners April 22, 2019 20:28
@eladb eladb requested a review from shivlaks April 22, 2019 20:28
@eladb eladb changed the title Benisrae/awslint refactor refactor(awslint): implement reflection classes and add missing attributes Apr 22, 2019
Copy link
Contributor

@skinny85 skinny85 left a comment

Choose a reason for hiding this comment

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

LGTM!

add awslint:construct-base-is-private

- eks.ClusterBase
- codebuild.ProjectBase
- codecommit.RepositoryBase
- codedeploy.ServerDeploymentGroupBase
- ecr.RepositoryBase
- eks.ClusterBase
- lambda.LayerVersionBase
- rds.DatabaseClusterBase
- secretsmanager.SecretBase
- ses.ReceiptRuleSetBase

- update "foreach.sh" to ignore undefined npm scripts
- update contribution guide with instructions on how to use foreach.sh
@eladb eladb changed the title refactor(awslint): implement reflection classes and add missing attributes refactor(awslint): construct-base-is-private, resource-attribute Apr 22, 2019
@RomainMuller RomainMuller added the package/awscl Cross-cutting issues related to the AWS Construct Library label Apr 23, 2019
@eladb eladb removed package/awscl Cross-cutting issues related to the AWS Construct Library labels May 1, 2019
@eladb eladb merged commit 973b506 into master May 1, 2019
@eladb eladb deleted the benisrae/awslint-refactor branch May 1, 2019 13:22
SanderKnape pushed a commit to SanderKnape/aws-cdk that referenced this pull request May 14, 2019
…#2349)

Refactor the rule implementation of awslint such that the context of each linter is implemented as a `XxxReflection` class (i.e. `ConstructReflection`, `ResourceReflection`). This increases our ability to reuse the model extracted from the type system in other linters.

- `awslint:construct-base-is-private` will recommend that XxxBase are internal (required merging some files in some places)
- `awslint:resource-attribute`: implement missing attributes from several modules
- In some places, move the `ImportedXxx` class into the import method as a local class (makes the implementation much nicer because it's closed by the function call).

Misc:
- update "foreach.sh" to ignore undefined npm scripts
- update contribution guide with instructions on how to use foreach.sh

Fixes aws#2426 
Fixes aws#2409 

BREAKING CHANGE: `s3.Bucket.domainName` renamed to `s3.Bucket.bucketDomainName`.
* `codedeploy.IXxxDeploymentConfig.deploymentConfigArn` is now a property and not a method.
* `ec2.SecurityGroupBase` is now private
* `ec2.VpcNetworkBase` is now private
* `kinesis.StreamBase` is now private
* `kms.EncryptionKeyBase` is now private
* `logs.LogGroupBase` is now private
* `ssm.ParameterBase` is now private
* `eks.ClusterBase` is now private
* `codebuild.ProjectBase` is now private
* `codecommit.RepositoryBase` is now private
* `codedeploy.ServerDeploymentGroupBase` is now private
* `eks.ClusterBase` is now private
* `lambda.LayerVersionBase` is now private
* `rds.DatabaseClusterBase` is now private
* `secretsmanager.SecretBase` is now private
* `ses.ReceiptRuleSetBase` is now private
@NGL321 NGL321 added the contribution/core This is a PR that came from AWS. label Sep 23, 2019
@mergify
Copy link
Contributor

mergify bot commented Sep 23, 2019

Thanks so much for taking the time to contribute to the AWS CDK ❤️

We will shortly assign someone to review this pull request and help get it
merged. In the meantime, please take a minute to make sure you follow this
checklist
:

  • PR title type(scope): text
    • type: fix, feat, refactor go into CHANGELOG, chore is hidden
    • scope: name of module without aws- or cdk- prefix or postfix (e.g. s3 instead of aws-s3-deployment)
    • text: use all lower-case, do not end with a period, do not include issue refs
  • PR Description
    • Rationale: describe rationale of change and approach taken
    • Issues: indicate issues fixed via: fixes #xxx or closes #xxx
    • Breaking?: last paragraph: BREAKING CHANGE: <describe what changed + link for details>
  • Testing
    • Unit test added. Prefer to add a new test rather than modify existing tests
    • CLI or init templates change? Re-run/add CLI integration tests
  • Documentation
    • README: update module README to describe new features
    • API docs: public APIs must be documented. Copy from official AWS docs when possible
    • Design: for significant features, follow design process

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.

awslint:resource-attribute awslint:construct-base-is-private: FooBase should not be public (internal)
4 participants