add version id (#6)

* add version id

* pre-commit hook with tfdocs

Author: sblack4

README.md

@@ -17,37 +17,51 @@ module "random_password" {
 ```
 
 <!-- BEGINNING OF PRE-COMMIT-TERRAFORM DOCS HOOK -->
+## Requirements
+
+| Name | Version |
+|------|---------|
+| random | >= 2.2.0 |
+
+## Providers
+
+| Name | Version |
+|------|---------|
+| aws | n/a |
+| random | >= 2.2.0 |
+
 ## Inputs
 
 | Name | Description | Type | Default | Required |
-|------|-------------|:----:|:-----:|:-----:|
-| cloudtrail\_log\_group | Cloudtrail Log Group name \(required if `enable\_secret\_access\_notification=true`\) | string | `"change_me"` | no |
-| create\_secret | If false, this module does nothing \(since tf doesn't support conditional modules\) | bool | `"true"` | no |
-| description | Description to add to Secret | string | `""` | no |
-| enable\_secret\_access\_notification | Notify SNS topic on secret access \(not recommended for most use cases\) | bool | `"false"` | no |
-| length | Length of string | number | n/a | yes |
-| min\_lower | Minimum number of lower case characters | number | `"0"` | no |
-| min\_numeric | Minimum number of numbers | number | `"0"` | no |
-| min\_special | Minimum number of special characters | number | `"0"` | no |
-| min\_upper | Minimum number of upper case characters | number | `"0"` | no |
-| name | Name \(omit to use name\_prefix\) | string | `""` | no |
-| name\_prefix | Name Prefix \(not used if name specified\) | string | `"terraform"` | no |
-| override\_special |  | string | `""` | no |
-| pass\_version | Password version. Increment this to trigger a new password. | number | `"1"` | no |
-| secret\_access\_metric\_namespace | Metric namespace to use for CloudWatch metric | string | `"SecretsManager"` | no |
-| secret\_access\_notification\_arn | SNS topic to notify on secret access \(required if `enable\_secret\_access\_notification=true`\) | string | `""` | no |
-| tags | Tags to add to supported resources | map(string) | `{}` | no |
-| use\_lower | Use lower case  characters | bool | `"true"` | no |
-| use\_number | Use numbers | bool | `"true"` | no |
-| use\_special | Use special characters | bool | `"true"` | no |
-| use\_upper | Use upper case characters | bool | `"true"` | no |
+|------|-------------|------|---------|:--------:|
+| cloudtrail\_log\_group | Cloudtrail Log Group name (required if `enable_secret_access_notification=true`) | `string` | `"change_me"` | no |
+| create\_secret | If false, this module does nothing (since tf doesn't support conditional modules) | `bool` | `true` | no |
+| description | Description to add to Secret | `string` | `""` | no |
+| enable\_secret\_access\_notification | Notify SNS topic on secret access (not recommended for most use cases) | `bool` | `false` | no |
+| length | Length of string | `number` | n/a | yes |
+| min\_lower | Minimum number of lower case characters | `number` | `0` | no |
+| min\_numeric | Minimum number of numbers | `number` | `0` | no |
+| min\_special | Minimum number of special characters | `number` | `0` | no |
+| min\_upper | Minimum number of upper case characters | `number` | `0` | no |
+| name | Name (omit to use name\_prefix) | `string` | `""` | no |
+| name\_prefix | Name Prefix (not used if name specified) | `string` | `"terraform"` | no |
+| override\_special | n/a | `string` | `""` | no |
+| pass\_version | Password version. Increment this to trigger a new password. | `number` | `1` | no |
+| secret\_access\_metric\_namespace | Metric namespace to use for CloudWatch metric | `string` | `"SecretsManager"` | no |
+| secret\_access\_notification\_arn | SNS topic to notify on secret access (required if `enable_secret_access_notification=true`) | `string` | `""` | no |
+| tags | Tags to add to supported resources | `map(string)` | `{}` | no |
+| use\_lower | Use lower case  characters | `bool` | `true` | no |
+| use\_number | Use numbers | `bool` | `true` | no |
+| use\_special | Use special characters | `bool` | `true` | no |
+| use\_upper | Use upper case characters | `bool` | `true` | no |
 
 ## Outputs
 
 | Name | Description |
 |------|-------------|
 | secret | Generated secret |
 | secret\_arn | The ARN of the secret |
+| version\_id | The unique identifier of the version of the secret. |
 
 <!-- END OF PRE-COMMIT-TERRAFORM DOCS HOOK -->
 

outputs.tf

@@ -7,3 +7,8 @@ output "secret_arn" {
   description = "The ARN of the secret"
   value       = var.create_secret ? aws_secretsmanager_secret.secret[0].arn : ""
 }
+
+output "version_id" {
+  description = "The unique identifier of the version of the secret."
+  value       = var.create_secret ? aws_secretsmanager_secret_version.secret_val[0].version_id : ""
+}