feature - Project owners and fixes (#24)

CONTRIBUTING.md

@@ -0,0 +1,5 @@
+# Contributing
+
+## Running Unit Tests
+See `env.vars.example` for an example of the set of environment variables that need to be set in order to run acceptance tests.  
+In order to run Tableau Server (not Cloud) specific tests, an additional `TF_ACC_SERVER` environment variable must be set, as some API methods do not apply to Tableau Cloud, i.e. Sites.  

docs/data-sources/group.md

@@ -10,7 +10,13 @@ description: |-
 
 Retrieve group details
 
+## Example Usage
 
+```terraform
+data "tableau_group" "example" {
+    id = "abc"
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema
@@ -23,5 +29,3 @@ Retrieve group details
 
 - `minimum_site_role` (String) Minimum site role for the group
 - `name` (String) Name for the group
-
-

docs/data-sources/project.md

@@ -25,5 +25,3 @@ Retrieve project details
 - `description` (String) Description for the project
 - `name` (String) Name for the project
 - `parent_project_id` (String) Identifier for the parent project
-
-

docs/data-sources/site.md

@@ -10,7 +10,13 @@ description: |-
 
 Retrieve site details
 
+## Example Usage
 
+```terraform
+data "tableau_site" "example" {
+    id = "abc"
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema

docs/data-sources/user.md

@@ -10,7 +10,13 @@ description: |-
 
 Retrieve user details
 
+## Example Usage
 
+```terraform
+data "tableau_user" "example" {
+    id = "abc"
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema
@@ -26,5 +32,3 @@ Retrieve user details
 - `full_name` (String) Full name for user
 - `name` (String) Name for the user
 - `site_role` (String) Site role for the user
-
-

docs/index.md

@@ -30,5 +30,5 @@ provider "tableau" {
 - `personal_access_token_secret` (String, Sensitive) Personal access token secret - TABLEAU_PERSONAL_ACCESS_TOKEN_SECRET env var
 - `server_url` (String) URL of your Tableau server - TABLEAU_SERVER_URL env var
 - `server_version` (String) Version of the server identified in URL - TABLEAU_SERVER_VERSION env var
-- `site` (String) Site name from your Tableau URL - TABLEAU_SITE_NAME env var - for Tableau Server default sites leave as ""
+- `site` (String) Site name from your Tableau URL - TABLEAU_SITE_NAME env var - for Tableau Server default sites leave as ''
 - `username` (String) Login Username - TABLEAU_USERNAME env var

docs/resources/group.md

@@ -10,7 +10,15 @@ description: |-
 
 
 
+## Example Usage
 
+```terraform
+resource "tableau_group" "example" {
+  grant_license_mode = "onLogin"
+  minimum_site_role  = "Explorer"
+  name               = "Test Users"
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema
@@ -31,4 +39,4 @@ Import is supported using the following syntax:
 
 ```shell
 terraform import tableau_group.example "group_id"
-```
+```

docs/resources/group_user.md

@@ -10,7 +10,14 @@ description: |-
 
 
 
+## Example Usage
 
+```terraform
+resource "tableau_group_user" "example" {
+  group_id = tableau_group.test_users.id
+  user_id  = tableau_user.test_user.id
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema
@@ -25,11 +32,10 @@ description: |-
 - `id` (String) The ID of this resource.
 - `last_updated` (String)
 
-
 ## Import
 
 Import is supported using the following syntax:
 
 ```shell
 terraform import group_user.example "group_id:user_id"
-```
+```

docs/resources/project.md

@@ -10,7 +10,16 @@ description: |-
 
 
 
-
+## Example Usage
+
+```terraform
+resource "tableau_project" "test" {
+  name = "test"
+  description = "Moo"
+  content_permissions = "LockedToProject"
+  parent_project_id = tableau_project.test_parent.id
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema
@@ -23,12 +32,13 @@ description: |-
 ### Optional
 
 - `description` (String) Description for the project
+- `owner_id` (String) Identifier for the project owner
 - `parent_project_id` (String) Identifier for the parent project
 
 ### Read-Only
 
 - `id` (String) The ID of this resource.
-- `last_updated` (String)
+- `last_updated` (String) Timestamp of the last Terraform update of the project
 
 ## Import
 

docs/resources/site.md

@@ -10,7 +10,14 @@ description: |-
 
 
 
+## Example Usage
 
+```terraform
+resource "tableau_site" "test" {
+  name = "test"
+  content_url = "Moo"
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema
@@ -27,3 +34,11 @@ description: |-
 
 - `id` (String) The ID of this resource.
 - `last_updated` (String)
+
+## Import
+
+Import is supported using the following syntax:
+
+```shell
+terraform import tableau_site.example "site_id"
+```

docs/resources/user.md

@@ -10,7 +10,17 @@ description: |-
 
 
 
-
+## Example Usage
+
+```terraform
+resource "tableau_user" "example" {
+  auth_setting = "SAML"
+  email        = "[email protected]"
+  full_name    = "[email protected]"
+  name         = "[email protected]"
+  site_role    = "SiteAdministratorCreator"
+}
+```
 
 <!-- schema generated by tfplugindocs -->
 ## Schema
@@ -34,4 +44,4 @@ Import is supported using the following syntax:
 
 ```shell
 terraform import tableau_user.example "user_id"
-```
+```

env.vars.example

@@ -0,0 +1,5 @@
+export TABLEAU_SERVER_URL=
+export TABLEAU_SERVER_VERSION=
+export TABLEAU_PERSONAL_ACCESS_TOKEN_NAME=
+export TABLEAU_PERSONAL_ACCESS_TOKEN_SECRET=
+export TABLEAU_SITE_NAME=

go.mod

@@ -1,16 +1,14 @@
 module github.com/gthesheep/terraform-provider-tableau
 
-go 1.22.0
-
-toolchain go1.23.1
+go 1.23.1
 
 require (
-	github.com/hashicorp/terraform-plugin-docs v0.19.4
-	github.com/hashicorp/terraform-plugin-framework v1.1.1
-	github.com/hashicorp/terraform-plugin-framework-validators v0.9.0
-	github.com/hashicorp/terraform-plugin-go v0.14.3
-	github.com/hashicorp/terraform-plugin-log v0.7.0
-	github.com/hashicorp/terraform-plugin-sdk/v2 v2.24.1
+	github.com/hashicorp/terraform-plugin-docs v0.20.0
+	github.com/hashicorp/terraform-plugin-framework v1.13.0
+	github.com/hashicorp/terraform-plugin-framework-validators v0.15.0
+	github.com/hashicorp/terraform-plugin-go v0.25.0
+	github.com/hashicorp/terraform-plugin-log v0.9.0
+	github.com/hashicorp/terraform-plugin-sdk/v2 v2.35.0
 )
 
 require (
@@ -21,70 +19,67 @@ require (
 	github.com/Masterminds/sprig/v3 v3.2.3 // indirect
 	github.com/ProtonMail/go-crypto v1.1.0-alpha.2 // indirect
 	github.com/agext/levenshtein v1.2.2 // indirect
-	github.com/apparentlymart/go-textseg/v13 v13.0.0 // indirect
 	github.com/apparentlymart/go-textseg/v15 v15.0.0 // indirect
 	github.com/armon/go-radix v1.0.0 // indirect
 	github.com/bgentry/speakeasy v0.1.0 // indirect
-	github.com/bmatcuk/doublestar/v4 v4.6.1 // indirect
+	github.com/bmatcuk/doublestar/v4 v4.7.1 // indirect
 	github.com/cloudflare/circl v1.3.7 // indirect
-	github.com/davecgh/go-spew v1.1.1 // indirect
 	github.com/fatih/color v1.16.0 // indirect
-	github.com/golang/protobuf v1.5.2 // indirect
+	github.com/golang/protobuf v1.5.4 // indirect
 	github.com/google/go-cmp v0.6.0 // indirect
-	github.com/google/uuid v1.3.0 // indirect
+	github.com/google/uuid v1.6.0 // indirect
 	github.com/hashicorp/cli v1.1.6 // indirect
 	github.com/hashicorp/errwrap v1.1.0 // indirect
 	github.com/hashicorp/go-checkpoint v0.5.0 // indirect
 	github.com/hashicorp/go-cleanhttp v0.5.2 // indirect
 	github.com/hashicorp/go-cty v1.4.1-0.20200414143053-d3edf31b6320 // indirect
-	github.com/hashicorp/go-hclog v1.2.1 // indirect
+	github.com/hashicorp/go-hclog v1.6.3 // indirect
 	github.com/hashicorp/go-multierror v1.1.1 // indirect
-	github.com/hashicorp/go-plugin v1.4.8 // indirect
+	github.com/hashicorp/go-plugin v1.6.2 // indirect
+	github.com/hashicorp/go-retryablehttp v0.7.7 // indirect
 	github.com/hashicorp/go-uuid v1.0.3 // indirect
 	github.com/hashicorp/go-version v1.7.0 // indirect
-	github.com/hashicorp/hc-install v0.7.0 // indirect
-	github.com/hashicorp/hcl/v2 v2.15.0 // indirect
+	github.com/hashicorp/hc-install v0.9.0 // indirect
+	github.com/hashicorp/hcl/v2 v2.22.0 // indirect
 	github.com/hashicorp/logutils v1.0.0 // indirect
 	github.com/hashicorp/terraform-exec v0.21.0 // indirect
-	github.com/hashicorp/terraform-json v0.22.1 // indirect
-	github.com/hashicorp/terraform-registry-address v0.1.0 // indirect
-	github.com/hashicorp/terraform-svchost v0.0.0-20200729002733-f050f53b9734 // indirect
-	github.com/hashicorp/yamux v0.0.0-20181012175058-2f1d1f20f75d // indirect
+	github.com/hashicorp/terraform-json v0.23.0 // indirect
+	github.com/hashicorp/terraform-registry-address v0.2.3 // indirect
+	github.com/hashicorp/terraform-svchost v0.1.1 // indirect
+	github.com/hashicorp/yamux v0.1.1 // indirect
 	github.com/huandu/xstrings v1.3.3 // indirect
 	github.com/imdario/mergo v0.3.15 // indirect
 	github.com/mattn/go-colorable v0.1.13 // indirect
 	github.com/mattn/go-isatty v0.0.20 // indirect
 	github.com/mattn/go-runewidth v0.0.9 // indirect
-	github.com/mitchellh/cli v1.1.4 // indirect
 	github.com/mitchellh/copystructure v1.2.0 // indirect
 	github.com/mitchellh/go-testing-interface v1.14.1 // indirect
 	github.com/mitchellh/go-wordwrap v1.0.0 // indirect
 	github.com/mitchellh/mapstructure v1.5.0 // indirect
 	github.com/mitchellh/reflectwalk v1.0.2 // indirect
 	github.com/oklog/run v1.0.0 // indirect
 	github.com/posener/complete v1.2.3 // indirect
-	github.com/russross/blackfriday v1.6.0 // indirect
 	github.com/shopspring/decimal v1.3.1 // indirect
 	github.com/spf13/cast v1.5.0 // indirect
 	github.com/vmihailenco/msgpack v4.0.4+incompatible // indirect
-	github.com/vmihailenco/msgpack/v4 v4.3.12 // indirect
-	github.com/vmihailenco/tagparser v0.1.2 // indirect
-	github.com/yuin/goldmark v1.7.1 // indirect
+	github.com/vmihailenco/msgpack/v5 v5.4.1 // indirect
+	github.com/vmihailenco/tagparser/v2 v2.0.0 // indirect
+	github.com/yuin/goldmark v1.7.7 // indirect
 	github.com/yuin/goldmark-meta v1.1.0 // indirect
-	github.com/zclconf/go-cty v1.14.4 // indirect
+	github.com/zclconf/go-cty v1.15.0 // indirect
 	go.abhg.dev/goldmark/frontmatter v0.2.0 // indirect
-	golang.org/x/crypto v0.27.0 // indirect
+	golang.org/x/crypto v0.28.0 // indirect
 	golang.org/x/exp v0.0.0-20230626212559-97b1e661b5df // indirect
 	golang.org/x/mod v0.21.0 // indirect
-	golang.org/x/net v0.29.0 // indirect
+	golang.org/x/net v0.28.0 // indirect
 	golang.org/x/sync v0.8.0 // indirect
-	golang.org/x/sys v0.25.0 // indirect
-	golang.org/x/text v0.18.0 // indirect
-	golang.org/x/tools v0.25.0 // indirect
-	google.golang.org/appengine v1.6.7 // indirect
-	google.golang.org/genproto v0.0.0-20200904004341-0bd0a958aa1d // indirect
-	google.golang.org/grpc v1.51.0 // indirect
-	google.golang.org/protobuf v1.33.0 // indirect
+	golang.org/x/sys v0.26.0 // indirect
+	golang.org/x/text v0.19.0 // indirect
+	golang.org/x/tools v0.22.0 // indirect
+	google.golang.org/appengine v1.6.8 // indirect
+	google.golang.org/genproto/googleapis/rpc v0.0.0-20240814211410-ddb44dafa142 // indirect
+	google.golang.org/grpc v1.67.1 // indirect
+	google.golang.org/protobuf v1.35.1 // indirect
 	gopkg.in/yaml.v2 v2.3.0 // indirect
 	gopkg.in/yaml.v3 v3.0.1 // indirect
 )