resource/pingone_population: Add export support

.changelog/pr-135.txt

@@ -0,0 +1,3 @@
+```release-note:new-resource
+`resource/pingone_population`: Added export support.
+```

cmd/export_outputs_test.go

@@ -16,12 +16,12 @@ import (
 
 func TestParseOutputPath(t *testing.T) {
 	tests := []struct {
-		name          string
-		raw           string
-		wantOk        bool
-		wantResType   string
-		wantLabel     string
-		wantAttrPath  string
+		name         string
+		raw          string
+		wantOk       bool
+		wantResType  string
+		wantLabel    string
+		wantAttrPath string
 	}{
 		{
 			name:         "valid 3-segment path",

contributing/RESOURCE_COVERAGE.md

@@ -70,7 +70,7 @@ Legend: ✅ Supported · ❌ Not yet supported
 | `pingone_identity_provider` | ❌ |
 | `pingone_identity_provider_attribute` | ❌ |
 | `pingone_password_policy` | ❌ |
-| `pingone_population` | ❌ |
+| `pingone_population` | ✅ |
 | `pingone_population_default` | ❌ |
 | `pingone_population_default_identity_provider` | ❌ |
 | `pingone_resource` | ❌ |

definitions/embed.go

@@ -4,8 +4,10 @@ package definitions
 import "embed"
 
 // FS contains all embedded resource definition YAML files.
-// The embed directive includes all .yaml files under pingone subdirectories.
-// Subdirectories (base/, davinci/, etc.) are organizational only.
+// The embed directive includes all .yaml files under any pingone category
+// subdirectory (base/, davinci/, sso/, etc.) — subdirectories are
+// organizational only. New category directories do not require editing this
+// file.
 //
-//go:embed pingone/base/*.yaml pingone/davinci/*.yaml
+//go:embed pingone/*/*.yaml
 var FS embed.FS

definitions/pingone/sso/population.yaml

@@ -0,0 +1,120 @@
+# PingOne Population Resource Definition
+
+metadata:
+  platform: pingone
+  resource_type: pingone_population
+  api_type: Population
+  name: PingOne Population
+  short_name: population
+  version: "1.0"
+
+api:
+  sdk_package: github.com/patrickcping/pingone-go-sdk-v2/management
+  sdk_type: Population
+  list_method: PopulationsApi.ReadAllPopulations
+  get_method: PopulationsApi.ReadOnePopulation
+  id_field: id
+  name_field: name
+  pagination_type: cursor
+
+attributes:
+  # ID - computed only (resource identifier, not written to HCL as an argument)
+  - name: ID
+    terraform_name: id
+    type: string
+    source_path: Id
+    computed: true
+
+  # Environment ID - required, references environment
+  - name: EnvironmentID
+    terraform_name: environment_id
+    type: string
+    source_path: Environment.Id
+    required: true
+    references_type: pingone_environment
+    reference_field: id
+
+  # Name - required string
+  - name: Name
+    terraform_name: name
+    type: string
+    source_path: Name
+    required: true
+
+  # Description - optional string
+  - name: Description
+    terraform_name: description
+    type: string
+    source_path: Description
+
+  # AlternativeIdentifiers - optional set of strings
+  - name: AlternativeIdentifiers
+    terraform_name: alternative_identifiers
+    type: set
+    source_path: AlternativeIdentifiers
+
+  # PreferredLanguage - optional string
+  - name: PreferredLanguage
+    terraform_name: preferred_language
+    type: string
+    source_path: PreferredLanguage
+
+  # PasswordPolicy - optional nested object. References a password policy
+  # resource. pingone_password_policy is not yet exported by this tool (no
+  # YAML definition/handler exists), so the reference resolver falls back to
+  # a Terraform variable (var.pingone_password_policy_id) until that resource
+  # type is added, at which point resolution is automatically promoted to a
+  # resource reference with no changes needed here.
+  - name: PasswordPolicy
+    terraform_name: password_policy
+    type: object
+    source_path: PasswordPolicy
+    nested_attributes:
+      - name: ID
+        terraform_name: id
+        type: string
+        source_path: Id
+        required: true
+        references_type: pingone_password_policy
+        reference_field: id
+
+  # Theme - optional nested object. References a branding theme resource.
+  # pingone_branding_theme is not yet exported by this tool either (see
+  # resource_flow.go's identical fallback note for the DaVinci showForm theme
+  # reference), so this also falls back to a Terraform variable until that
+  # resource type is added.
+  - name: Theme
+    terraform_name: theme
+    type: object
+    source_path: Theme
+    nested_attributes:
+      - name: ID
+        terraform_name: id
+        type: string
+        source_path: Id
+        references_type: pingone_branding_theme
+        reference_field: id
+
+dependencies:
+  depends_on:
+    - resource_type: pingone_environment
+      field_path: Environment.Id
+      lookup_field: id
+      reference_format: "var.pingone_environment_id"
+
+    - resource_type: pingone_password_policy
+      field_path: PasswordPolicy.ID
+      lookup_field: id
+      reference_format: "pingone_password_policy.{resource_name}.id"
+      optional: true
+
+    - resource_type: pingone_branding_theme
+      field_path: Theme.ID
+      lookup_field: id
+      reference_format: "pingone_branding_theme.{resource_name}.id"
+      optional: true
+
+  import_id_format: "{env_id}/{resource_id}"
+
+variables:
+  eligible_attributes: []

go.mod

@@ -1,11 +1,13 @@
 module github.com/pingidentity/pingcli-plugin-terraformer
 
-go 1.25.1
+go 1.25.6
 
 require (
 	github.com/google/uuid v1.6.0
 	github.com/hashicorp/go-plugin v1.7.0
 	github.com/hashicorp/hcl/v2 v2.24.0
+	github.com/patrickcping/pingone-go-sdk-v2 v0.14.14
+	github.com/patrickcping/pingone-go-sdk-v2/management v0.70.0
 	github.com/pingidentity/pingcli v0.8.0
 	github.com/pingidentity/pingone-go-client v0.12.0
 	github.com/spf13/pflag v1.0.10
@@ -35,6 +37,11 @@ require (
 	github.com/mattn/go-isatty v0.0.20 // indirect
 	github.com/mitchellh/go-wordwrap v1.0.1 // indirect
 	github.com/oklog/run v1.2.0 // indirect
+	github.com/patrickcping/pingone-go-sdk-v2/authorize v0.8.3 // indirect
+	github.com/patrickcping/pingone-go-sdk-v2/credentials v0.12.1 // indirect
+	github.com/patrickcping/pingone-go-sdk-v2/mfa v0.25.1 // indirect
+	github.com/patrickcping/pingone-go-sdk-v2/risk v0.21.1 // indirect
+	github.com/patrickcping/pingone-go-sdk-v2/verify v0.11.2 // indirect
 	github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2 // indirect
 	github.com/zalando/go-keyring v0.2.8 // indirect
 	go.opentelemetry.io/auto/sdk v1.2.1 // indirect

go.sum

@@ -60,6 +60,20 @@ github.com/mitchellh/go-wordwrap v1.0.1 h1:TLuKupo69TCn6TQSyGxwI1EblZZEsQ0vMlAFQ
 github.com/mitchellh/go-wordwrap v1.0.1/go.mod h1:R62XHJLzvMFRBbcrT7m7WgmE1eOyTSsCt+hzestvNj0=
 github.com/oklog/run v1.2.0 h1:O8x3yXwah4A73hJdlrwo/2X6J62gE5qTMusH0dvz60E=
 github.com/oklog/run v1.2.0/go.mod h1:mgDbKRSwPhJfesJ4PntqFUbKQRZ50NgmZTSPlFA0YFk=
+github.com/patrickcping/pingone-go-sdk-v2 v0.14.14 h1:illFMogbGgYoZUr+kW0OQjbLyTfGEemLmTcX6oIIdx8=
+github.com/patrickcping/pingone-go-sdk-v2 v0.14.14/go.mod h1:DhdLzztyNuH03k4h/AvmLjiYdvxHf1EViZBwDMan6BM=
+github.com/patrickcping/pingone-go-sdk-v2/authorize v0.8.3 h1:rB2g0Ry+AlvCxN0gxXNb2AQm/1kyB3G47g2H3KRPHVQ=
+github.com/patrickcping/pingone-go-sdk-v2/authorize v0.8.3/go.mod h1:Tb8FQPxveYj4QOc4VJa42QccMv2hSLNpTKDUSdWXtVk=
+github.com/patrickcping/pingone-go-sdk-v2/credentials v0.12.1 h1:7g4f1UWz85C4Onwg5hfqZPvyWrbqXJ5HlYNeVDRD8Sk=
+github.com/patrickcping/pingone-go-sdk-v2/credentials v0.12.1/go.mod h1:SaqdGPTxYXaeVgOCJXDDCK40Avr+zGujG0YJGQTwyJg=
+github.com/patrickcping/pingone-go-sdk-v2/management v0.70.0 h1:O+tBQC6AreSSoFAproARMxaxcPL3hDJKJmb7GkVm7Sg=
+github.com/patrickcping/pingone-go-sdk-v2/management v0.70.0/go.mod h1:Ld0egUhvuv9SRvTjTgQrzZur6tB+qBTxm4kSfX6uj6Y=
+github.com/patrickcping/pingone-go-sdk-v2/mfa v0.25.1 h1:qLwEQfXJwKsStn935tEUyt9L6r7rJRuukmOfVwRX4H0=
+github.com/patrickcping/pingone-go-sdk-v2/mfa v0.25.1/go.mod h1:U5xu9EHj1Wvgl2an+qoq8QgScAPYB02bF0CKQmpo08Y=
+github.com/patrickcping/pingone-go-sdk-v2/risk v0.21.1 h1:hjXbUFYkKuQEIyu/m8+yDXOkJRIuIB4/LIy1WZ0Zf+U=
+github.com/patrickcping/pingone-go-sdk-v2/risk v0.21.1/go.mod h1:3emXaUBwjjZd6znlR4l9z52j8mryoCuzXOajlQH5Biw=
+github.com/patrickcping/pingone-go-sdk-v2/verify v0.11.2 h1:BfJGv6gmHzUDNYI/ZyqvdBIQVPlkAKwnjYs/kevD/PE=
+github.com/patrickcping/pingone-go-sdk-v2/verify v0.11.2/go.mod h1:qbJfZ1MXPDeouQBsWelraoNfmguOT1/RBJFuAnQvrSA=
 github.com/pingidentity/pingcli v0.8.0 h1:KmUuzGliAtNlLz/okMRtT0vdRoiSAz3Kb+/FGti6rpA=
 github.com/pingidentity/pingcli v0.8.0/go.mod h1:3fAj8w0kZtLU6DBLKdCLQnPCN+gbVjysnwGrgsJoSYY=
 github.com/pingidentity/pingone-go-client v0.12.0 h1:t9L18Qul3UXqqvi0578R7bzys54cEEl+oSJDT6rMdyM=

internal/platform/pingone/client.go

@@ -12,6 +12,8 @@ import (
 	"fmt"
 
 	"github.com/google/uuid"
+	"github.com/patrickcping/pingone-go-sdk-v2/management"
+	pingonesdkv2 "github.com/patrickcping/pingone-go-sdk-v2/pingone"
 	"github.com/pingidentity/pingone-go-client/config"
 	"github.com/pingidentity/pingone-go-client/oauth2"
 	"github.com/pingidentity/pingone-go-client/pingone"
@@ -28,16 +30,46 @@ var _ clients.APIClient = (*Client)(nil)
 // Resource-specific list/get logic and custom handlers live in resource_*.go
 // files. Each file registers everything for its resource via init().
 type Client struct {
-	apiClient     *pingone.APIClient
-	environmentID uuid.UUID
-	warnings      []string
+	apiClient        *pingone.APIClient
+	managementCfg    *pingonesdkv2.Config
+	managementClient *management.APIClient
+	environmentID    uuid.UUID
+	warnings         []string
 }
 
 // New creates a DaVinci APIClient from a pre-built SDK client and environment ID.
 func New(apiClient *pingone.APIClient, environmentID uuid.UUID) *Client {
 	return &Client{apiClient: apiClient, environmentID: environmentID}
 }
 
+// NewWithManagementClient creates a Client from a pre-built DaVinci SDK
+// client and a pre-built management SDK client. Used by tests that need to
+// inject a fake management.APIClient without performing a real OAuth
+// exchange.
+func NewWithManagementClient(apiClient *pingone.APIClient, managementClient *management.APIClient, environmentID uuid.UUID) *Client {
+	return &Client{apiClient: apiClient, managementClient: managementClient, environmentID: environmentID}
+}
+
+// management lazily builds and caches the management SDK API client. The
+// management SDK performs an OAuth token exchange as soon as the client is
+// built (unlike the DaVinci SDK, which defers auth to the first request), so
+// construction is deferred until a management resource handler actually
+// needs it.
+func (c *Client) management(ctx context.Context) (*management.APIClient, error) {
+	if c.managementClient != nil {
+		return c.managementClient, nil
+	}
+	if c.managementCfg == nil {
+		return nil, fmt.Errorf("management API client not configured")
+	}
+	client, err := c.managementCfg.ManagementAPIClient(ctx)
+	if err != nil {
+		return nil, fmt.Errorf("failed to initialize management API client: %w", err)
+	}
+	c.managementClient = client
+	return client, nil
+}
+
 // Platform returns the platform identifier.
 func (c *Client) Platform() string { return "pingone" }
 
@@ -106,12 +138,20 @@ func NewFromCredentials(ctx context.Context, workerEnvID, exportEnvID, region, c
 		return nil, fmt.Errorf("failed to initialize API client: %w", err)
 	}
 
+	regionCode := management.EnumRegionCode(region)
+	managementCfg := &pingonesdkv2.Config{
+		ClientID:      &clientID,
+		ClientSecret:  &clientSecret,
+		EnvironmentID: &workerEnvID,
+		RegionCode:    &regionCode,
+	}
+
 	envUUID, err := uuid.Parse(exportEnvID)
 	if err != nil {
 		return nil, fmt.Errorf("invalid export environment ID format: %w", err)
 	}
 
-	return &Client{apiClient: apiClient, environmentID: envUUID}, nil
+	return &Client{apiClient: apiClient, managementCfg: managementCfg, environmentID: envUUID}, nil
 }
 
 // ValidRegions returns the list of valid PingOne region codes.