feat(lib): add resource move functionality

CHANGELOG.md

@@ -6,6 +6,10 @@
 
 Since the long-term support for Node.js 16 ended on 2023-09-11, we updated our minimum compatible Node.js version to 18.12.
 
+### Potential provider naming collision with instance function `moveTo` on `TerraformResource`
+
+We have added support for resource refactoring and renaming with the addition of the instance function `moveTo` on `TerraformResource`. We forsee the potential for naming collision with providers using `moveTo` as an attribute. In instances where provider bindings fail to compile due to the collision, regenerate your provider bindings and replace the provider related usage of `moveTo` to `moveToAttribute` in your configuration if applicable.
+
 ## 0.18.2
 
 Fixes a bug in 0.18.1 that broke crash reporting due to a partial dependency upgrade.

examples/python/aws-move/.gitignore

@@ -0,0 +1,3 @@
+dist/
+imports/
+terraform.tfstate*

examples/python/aws-move/Pipfile

@@ -0,0 +1,10 @@
+[[source]]
+name = "pypi"
+url = "https://pypi.org/simple"
+verify_ssl = true
+
+[requires]
+python_version = "3.7"
+
+[packages]
+cdktf = {path = "./../../../dist/python/cdktf-0.0.0-py3-none-any.whl"}

examples/python/aws-move/README.md

@@ -0,0 +1,70 @@
+# python-aws
+
+A CDK for Terraform application in Python.
+
+## Usage
+
+Install Pipenv using Homebrew by running:
+
+```bash
+$ brew install pipenv
+```
+
+You can install Pipenv by visiting the [website](https://pipenv.pypa.io/en/latest/).
+
+Install project dependencies
+
+```shell
+pipenv install
+```
+
+Generate CDK for Terraform constructs for Terraform providers and modules used in the project.
+
+```bash
+cdktf get
+```
+
+You can now edit the `main.py` file if you want to modify any code.
+
+```python
+vim main.py
+#!/usr/bin/env python
+from constructs import Construct
+from cdktf import App, TerraformStack
+from imports.aws import SnsTopic, AwsProvider
+from imports.terraform_aws_modules.vpc.aws import Vpc
+
+class MyStack(TerraformStack):
+    def __init__(self, scope: Construct, ns: str):
+        super().__init__(scope, ns)
+
+        AwsProvider(self, 'Aws', region='eu-central-1')
+
+        Vpc(self, 'CustomVpc',
+        name='custom-vpc',
+        cidr='10.0.0.0/16',
+        azs=["us-east-1a", "us-east-1b"],
+        public_subnets=["10.0.1.0/24", "10.0.2.0/24"]
+        )
+        SnsTopic(self, 'Topic', display_name='my-first-sns-topic')
+
+app = App()
+MyStack(app, "python-aws")
+
+app.synth()
+```
+
+Compile and generate Terraform configuration
+
+```bash
+cdktf synth
+```
+
+The above command will create a folder called `cdktf.out` that contains all Terraform JSON configuration that was generated.
+
+Run cdktf-cli commands
+
+```bash
+cdktf diff
+cdktf deploy
+```

examples/python/aws-move/cdktf.json

@@ -0,0 +1,11 @@
+{
+  "language": "python",
+  "app": "pipenv run python main.py",
+  "terraformProviders": [
+    "aws@~> 3.0"
+  ],
+  "terraformModules": [
+    "terraform-aws-modules/vpc/[email protected]"
+  ],
+  "codeMakerOutput": "imports"
+}

examples/python/aws-move/help

@@ -0,0 +1,22 @@
+========================================================================================================
+
+Your cdktf Python project is ready!
+
+cat help Prints this message
+
+Compile:
+pipenv run ./main.py Compile and run the python code.
+
+Synthesize:
+cdktf synth Synthesize Terraform resources to cdktf.out/
+
+Diff:
+cdktf diff Perform a diff (terraform plan) for the given stack
+
+Deploy:
+cdktf deploy Deploy the given stack
+
+Destroy:
+cdktf destroy Destroy the given stack
+
+========================================================================================================

examples/python/aws-move/main.py

@@ -0,0 +1,30 @@
+# Copyright (c) HashiCorp, Inc.
+# SPDX-License-Identifier: MPL-2.0
+
+from constructs import Construct
+from cdktf import App, TerraformStack
+import os
+from imports.aws.provider import AwsProvider
+from imports.aws.s3_bucket import S3Bucket
+
+# To properly see the move functionality in action, the resource being moved needs to be deployed
+# First run "deploy" with the STEP_1 env flag set, then "plan" or "deploy" with the STEP_2 env flag set
+
+class MyStack(TerraformStack):
+    def __init__(self, scope: Construct, ns: str):
+        super().__init__(scope, ns)
+
+        AwsProvider(self, 'Aws', region='eu-central-1')
+
+        if os.environ.get('STEP_1')=='True':
+            S3Bucket(self, "old-bucket", bucket='python-move-test-bucket')
+
+        if os.environ.get('STEP_2')=='True':
+            S3Bucket(self, "old-bucket", bucket='python-move-test-bucket').move_to("move-s3")
+            S3Bucket(self, "new-bucket", bucket='python-move-test-bucket').add_move_target("move-s3")
+
+
+app = App()
+MyStack(app, "python-aws-move")
+
+app.synth()

examples/python/aws-move/package.json

@@ -0,0 +1,12 @@
+{
+  "//": "This example test is disabled via the 'private' attribute since Terraform 1.5 is required for proper synth, and as of writing CI has a lesser version",
+  "private": true,
+  "name": "@examples/python-aws-move",
+  "version": "0.0.0",
+  "license": "MPL-2.0",
+  "scripts": {
+    "reinstall": "rm Pipfile.lock && PIPENV_IGNORE_VIRTUALENVS=1 pipenv install ./../../../dist/python/*.whl",
+    "build": "cdktf get",
+    "synth": "cdktf synth"
+  }
+}

examples/typescript/aws-move/.gitignore

@@ -0,0 +1,11 @@
+*.d.ts
+*.js
+node_modules
+cdktf.out
+cdktf.log
+*terraform.*.tfstate*
+.gen
+.terraform
+tsconfig.tsbuildinfo
+!jest.config.js
+!setup.js