cdk-vpc-toumoro-projen 1.5.0

A CDK construct library to create a VPC with public and private subnets.

Contributing to CDK Construct Toumoro

Contributing

Examples

Examples

Documentation API

API

Developpement Guide

AWS CDK Design Guidelines

Naming Conventions

1. Prefixes:

   • Cfn for CloudFormation resources.
   • Fn for constructs generating CloudFormation functions.
   • As for abstract classes.
   • I for interfaces.
   • Vpc for constructs related to Virtual Private Cloud.
   • Lambda for constructs related to AWS Lambda.
   • Example: CfnStack, FnSub, Aspects, IVpc, VpcNetwork, LambdaFunction.

2. Construct Names:

   • Use descriptive names that reflect the purpose of the construct.
   • CamelCase for multi-word names.
   • Avoid abbreviations unless they are widely understood.
   • Example: BucketStack, RestApiConstruct, DatabaseCluster.

3. Property Names:

   • Follow AWS resource naming conventions where applicable.
   • Use camelCase for property names.
   • Use clear and concise names that reflect the purpose of the property.
   • Example: bucketName, vpcId, functionName.

4. Method Names:

   • Use verbs or verb phrases to describe actions performed by methods.
   • Use camelCase.
   • Example: addBucketPolicy, createVpc, invokeLambda.

5. Interface Names:

   • Start with an uppercase I.
   • Use clear and descriptive names.
   • Example: IInstance, ISecurityGroup, IVpc.

6. Module Names:

   • Use lowercase with hyphens for separating words.
   • Be descriptive but concise.
   • Follow a hierarchy if necessary, e.g., aws-cdk.aws_s3 for S3-related constructs.
   • Example: aws-cdk.aws_s3, aws-cdk.aws_ec2, aws-cdk.aws_lambda.

7. Variable Names:

   • Use descriptive names.
   • CamelCase for multi-word names.
   • Keep variable names concise but meaningful.
   • Example: instanceCount, subnetIds, roleArn.

8. Enum and Constant Names:

   • Use uppercase for constants.
   • CamelCase for multi-word names.
   • Be descriptive about the purpose of the constant or enum.
   • Example: MAX_RETRIES, HTTP_STATUS_CODES, VPC_CONFIG.

9. File Names:

   • Use lowercase with hyphens for separating words.
   • Reflect the content of the file.
   • Include version numbers if necessary.
   • Example: s3-bucket-stack.ts, vpc-network.ts, lambda-function.ts.

10. Documentation Comments:

    • Use JSDoc or similar conventions to provide clear documentation for each construct, method, property, etc.
    • Ensure that the documentation is up-to-date and accurately reflects the purpose and usage of the code.