Merge pull request #1 from Prodesire/feat/lastest-tf

Update TF to 1.2.2

Author: Prodesire

README.md

@@ -24,8 +24,8 @@ $ pip install libterraform
 
 `TerraformCommand` is used to invoke various Terraform commands.
 
-Now, support all commands (`plan`, `apply`, `destroy` etc.), and return a `CommandResult` object.
-The `CommandResult` object has the following properties:
+Now, support all commands (`plan`, `apply`, `destroy` etc.), and return a `CommandResult` object. The `CommandResult`
+object has the following properties:
 
 - `retcode` indicates the command return code. A value of 0 or 2 is normal, otherwise is abnormal.
 - `value` represents command output. If `json=True` is specified when executing the command, the output will be loaded
@@ -40,11 +40,11 @@ To get Terraform verison:
 >>> TerraformCommand().version()
 <CommandResult retcode=0 json=True>
 >>> _.value
-{'terraform_version': '1.1.7', 'platform': 'darwin_arm64', 'provider_selections': {}, 'terraform_outdated': False}
+{'terraform_version': '1.2.2', 'platform': 'darwin_arm64', 'provider_selections': {}, 'terraform_outdated': False}
 >>> TerraformCommand().version(json=False)
 <CommandResult retcode=0 json=False>
 >>> _.value
-'Terraform v1.1.7\non darwin_arm64\n'
+'Terraform v1.2.2\non darwin_arm64\n'
 ```
 
 To `init` and `apply` according to Terraform configuration files in the specified directory:
@@ -62,7 +62,7 @@ Additionally, `run()` can execute arbitrary commands, returning a tuple `(retcod
 
 ```python
 >>> TerraformCommand.run('version')
-(0, 'Terraform v1.1.7\non darwin_arm64\n', '')
+(0, 'Terraform v1.2.2\non darwin_arm64\n', '')
 >>> TerraformCommand.run('invalid')
 (1, '', 'Terraform has no command named "invalid".\n\nTo see all of Terraform\'s top-level commands, run:\n  terraform -help\n\n')
 ```
@@ -85,14 +85,23 @@ respectively.
 dict_keys(['time_sleep.wait1', 'time_sleep.wait2'])
 ```
 
+## Version comparison
+
+| libterraform                                          | Terraform                                                   |
+|-------------------------------------------------------|-------------------------------------------------------------|
+| [0.4.0](https://pypi.org/project/libterraform/0.4.0/) | [1.2.2](https://github.com/hashicorp/terraform/tree/v1.2.2) |
+| [0.3.1](https://pypi.org/project/libterraform/0.3.1/) | [1.1.7](https://github.com/hashicorp/terraform/tree/v1.1.7) |
+
 ## Building & Testing
 
 If you want to develop this library, should first prepare the following environments:
+
 - [GoLang](https://go.dev/dl/) (Version 1.17.x or 1.16.x)
 - [Python](https://www.python.org/downloads/) (Version 3.6~3.10)
 - GCC
 
 Then, initialize git submodule:
+
 ```bash
 $ git submodule init
 $ git submodule update
@@ -105,22 +114,23 @@ $ pip install poetry pytest
 ```
 
 Now, we can build and test:
+
 ```bash
 $ poetry build -f wheel
 $ pytest
 ```
 
-
 ## Why use this library?
-Terraform is a great tool for deploying resources. If you need to call the Terraform command in the Python program
-for deployment, a new process needs to be created to execute the Terraform command on the system. A typical example 
-of this is the [python-terraform](https://github.com/beelit94/python-terraform) library. 
-Doing so has the following problems:
+
+Terraform is a great tool for deploying resources. If you need to call the Terraform command in the Python program for
+deployment, a new process needs to be created to execute the Terraform command on the system. A typical example of this
+is the [python-terraform](https://github.com/beelit94/python-terraform) library. Doing so has the following problems:
+
 - Requires Terraform commands on the system.
 - The overhead of starting a new process is relatively high.
 
-This library compiles Terraform as a **dynamic link library** in advance, and then loads it for calling. 
-So there is no need to install Terraform, nor to start a new process.
+This library compiles Terraform as a **dynamic link library** in advance, and then loads it for calling. So there is no
+need to install Terraform, nor to start a new process.
 
-In addition, since the Terraform dynamic link library is loaded, this library can further call Terraform's 
+In addition, since the Terraform dynamic link library is loaded, this library can further call Terraform's
 **internal capabilities**, such as parsing Terraform config files.

libterraform/__init__.py

@@ -2,7 +2,7 @@
 from ctypes import cdll, c_void_p
 from libterraform.common import WINDOWS
 
-__version__ = '0.3.1'
+__version__ = '0.4.0'
 
 root = os.path.dirname(os.path.abspath(__file__))
 _lib_filename = 'libterraform.dll' if WINDOWS else 'libterraform.so'

libterraform/cli.py

@@ -1,7 +1,7 @@
 import os
 from ctypes import *
 from threading import Thread
-from typing import List, Sequence
+from typing import List, Sequence, Union
 
 from libterraform import _lib_tf
 from libterraform.common import json_loads, WINDOWS, CmdType
@@ -312,8 +312,8 @@ def plan(
             destroy: bool = None,
             refresh_only: bool = None,
             refresh: bool = None,
-            replace: str = None,
-            target: str = None,
+            replace: Union[str, List[str]] = None,
+            target: Union[str, List[str]] = None,
             vars: dict = None,
             var_files: List[str] = None,
             compact_warnings: bool = None,
@@ -354,6 +354,7 @@ def plan(
         :param replace: Force replacement of a particular resource instance using
             its resource address. If the plan would've normally produced an update or
             no-op action for this instance, Terraform will plan to replace it instead.
+            You can use this option multiple times to replace more than one object.
         :param target: Limit the planning operation to only the given module, resource,
             or resource instance and all of its dependencies. You can use this option
             multiple times to include more than one object. This is for exceptional
@@ -975,6 +976,7 @@ def refresh(
             lock: bool = None,
             lock_timeout: str = None,
             no_color: bool = True,
+            parallelism: int = None,
             **options,
     ) -> CommandResult:
         """Refer to https://www.terraform.io/docs/commands/refresh
@@ -1003,6 +1005,7 @@ def refresh(
             same workspace.
         :param lock_timeout: Duration to retry a state lock.
         :param no_color: True to output not contain any color.
+        :param parallelism: Limit the number of concurrent operations. Defaults to 10.
         :param options: More command options.
         """
         options.update(
@@ -1014,6 +1017,7 @@ def refresh(
             lock=lock,
             lock_timeout=lock_timeout,
             no_color=flag(no_color),
+            parallelism=parallelism,
         )
         retcode, stdout, stderr = self.run('refresh', options=options, chdir=self.cwd, check=check, json=json)
         value = json_loads(stdout, split=True) if json else stdout

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "libterraform"
-version = "0.3.1"
+version = "0.4.0"
 description = "Python binding for Terraform."
 authors = ["Prodesire <[email protected]>"]
 license = "MIT"

terraform

@@ -14,3 +14,8 @@ def test_refresh_with_target(self, cli: TerraformCommand):
         r = cli.refresh(target='time_sleep.wait1')
         assert r.retcode == 0, r.error
         assert r.value
+
+    def test_refresh_with_parallelism(self, cli: TerraformCommand):
+        r = cli.refresh(parallelism=2)
+        assert r.retcode == 0, r.error
+        assert r.value