First take

Author: danischm

.gitignore

@@ -24,6 +24,7 @@ website/node_modules
 *.iml
 *.test
 *.iml
+.env
 
 website/vendor
 

docs/data-sources/restconf.md renamed to docs/data-sources/yang.md

@@ -1,19 +1,19 @@
 ---
 # generated by https://github.com/hashicorp/terraform-plugin-docs
-page_title: "iosxe_restconf Data Source - terraform-provider-iosxe"
+page_title: "iosxe_yang Data Source - terraform-provider-iosxe"
 subcategory: "General"
 description: |-
-  This data source can retrieve one or more attributes via RESTCONF.
+  This data source can retrieve one or more attributes via YANG paths.
 ---
 
-# iosxe_restconf (Data Source)
+# iosxe_yang (Data Source)
 
-This data source can retrieve one or more attributes via RESTCONF.
+This data source can retrieve one or more attributes via YANG paths.
 
 ## Example Usage
 
 ```terraform
-data "iosxe_restconf" "example" {
+data "iosxe_yang" "example" {
   path = "Cisco-IOS-XE-native:native/banner/login"
 }
 ```
@@ -23,7 +23,7 @@ data "iosxe_restconf" "example" {
 
 ### Required
 
-- `path` (String) A RESTCONF path, e.g. `openconfig-interfaces:interfaces`.
+- `path` (String) A YANG path, e.g. `openconfig-interfaces:interfaces`.
 
 ### Optional
 

docs/index.md

@@ -51,12 +51,14 @@ provider "iosxe" {
 ### Optional
 
 - `devices` (Attributes List) This can be used to manage a list of devices from a single provider. All devices must use the same credentials. Each resource and data source has an optional attribute named `device`, which can then select a device by its name from this list. (see [below for nested schema](#nestedatt--devices))
+- `host` (String) Hostname or IP address of the Cisco IOS-XE device. Optionally a port can be added with `:port`. Default port is `443` for RESTCONF and `830` for NETCONF. This can also be set as the IOSXE_HOST environment variable.
 - `insecure` (Boolean) Allow insecure HTTPS client. This can also be set as the IOSXE_INSECURE environment variable. Defaults to `true`.
 - `lock_release_timeout` (Number) Number of seconds to wait for the device database lock to be released. This can also be set as the IOSXE_LOCK_RELEASE_TIMEOUT environment variable. Defaults to `120`.
 - `password` (String, Sensitive) Password for the IOS-XE device. This can also be set as the IOSXE_PASSWORD environment variable.
+- `protocol` (String) Protocol to use for device communication. Either `restconf` (HTTPS) or `netconf` (SSH). This can also be set as the IOSXE_PROTOCOL environment variable. Defaults to `restconf`.
 - `retries` (Number) Number of retries for REST API calls. This can also be set as the IOSXE_RETRIES environment variable. Defaults to `10`.
 - `selected_devices` (List of String) This can be used to select a list of devices to manage from the `devices` list. Selected devices will be managed while other devices will be skipped and their state will be frozen. This can be used to deploy changes to a subset of devices. Defaults to all devices.
-- `url` (String) URL of the Cisco IOS-XE device. Optionally a port can be added with `:12345`. The default port is `443`. This can also be set as the IOSXE_URL environment variable.
+- `url` (String, Deprecated) URL of the Cisco IOS-XE device for RESTCONF protocol. Optionally a port can be added with `:12345`. The default port is `443`. This can also be set as the IOSXE_URL environment variable. **Deprecated: Use `host` instead for protocol-agnostic configuration.**
 - `username` (String) Username for the IOS-XE device. This can also be set as the IOSXE_USERNAME environment variable.
 
 <a id="nestedatt--devices"></a>
@@ -65,8 +67,9 @@ provider "iosxe" {
 Required:
 
 - `name` (String) Device name.
-- `url` (String) URL of the Cisco IOS-XE device.
 
 Optional:
 
-- `managed` (Boolean) Enable or disable device management. This can be used to temporarily skip a device due to maintainance for example. Defaults to `true`.
+- `host` (String) Hostname or IP address of the Cisco IOS-XE device. Optionally a port can be added with `:port`.
+- `managed` (Boolean) Enable or disable device management. This can be used to temporarily skip a device due to maintainance for example. Defaults to `true`.
+- `url` (String, Deprecated) URL of the Cisco IOS-XE device for RESTCONF protocol. **Deprecated: Use `host` instead.**

docs/resources/restconf.md renamed to docs/resources/yang.md

@@ -1,26 +1,26 @@
 ---
 # generated by https://github.com/hashicorp/terraform-plugin-docs
-page_title: "iosxe_restconf Resource - terraform-provider-iosxe"
+page_title: "iosxe_yang Resource - terraform-provider-iosxe"
 subcategory: "General"
 description: |-
-  Manages IOS-XE objects via RESTCONF calls. This resource can only manage a single object. It is able to read the state and therefore reconcile configuration drift.
+  Manages IOS-XE objects via YANG paths. This resource can only manage a single object. It is able to read the state and therefore reconcile configuration drift.
 ---
 
-# iosxe_restconf (Resource)
+# iosxe_yang (Resource)
 
-Manages IOS-XE objects via RESTCONF calls. This resource can only manage a single object. It is able to read the state and therefore reconcile configuration drift.
+Manages IOS-XE objects via YANG paths. This resource can only manage a single object. It is able to read the state and therefore reconcile configuration drift.
 
 ## Example Usage
 
 ```terraform
-resource "iosxe_restconf" "simple" {
+resource "iosxe_yang" "simple" {
   path = "Cisco-IOS-XE-native:native/banner/login"
   attributes = {
     banner = "My Banner"
   }
 }
 
-resource "iosxe_restconf" "nested_list" {
+resource "iosxe_yang" "nested_list" {
   path = "Cisco-IOS-XE-native:native/ip"
   attributes = {
     source-route = "true"
@@ -42,7 +42,7 @@ resource "iosxe_restconf" "nested_list" {
 
 ### Required
 
-- `path` (String) A RESTCONF path, e.g. `openconfig-interfaces:interfaces`.
+- `path` (String) A YANG path, e.g. `openconfig-interfaces:interfaces`.
 
 ### Optional
 
@@ -75,5 +75,5 @@ Import is supported using the following syntax:
 The [`terraform import` command](https://developer.hashicorp.com/terraform/cli/commands/import) can be used, for example:
 
 ```shell
-terraform import iosxe_restconf.example "Cisco-IOS-XE-native:native/banner/login"
+terraform import iosxe_yang.example "Cisco-IOS-XE-native:native/banner/login"
 ```

examples/data-sources/iosxe_restconf/data-source.tf renamed to examples/data-sources/iosxe_yang/data-source.tf

@@ -1,3 +1,3 @@
-data "iosxe_restconf" "example" {
+data "iosxe_yang" "example" {
   path = "Cisco-IOS-XE-native:native/banner/login"
 }

examples/resources/iosxe_restconf/import.sh

@@ -0,0 +1 @@
+terraform import iosxe_yang.example "Cisco-IOS-XE-native:native/banner/login"

examples/resources/iosxe_yang/import.sh

@@ -1,11 +1,11 @@
-resource "iosxe_restconf" "simple" {
+resource "iosxe_yang" "simple" {
   path = "Cisco-IOS-XE-native:native/banner/login"
   attributes = {
     banner = "My Banner"
   }
 }
 
-resource "iosxe_restconf" "nested_list" {
+resource "iosxe_yang" "nested_list" {
   path = "Cisco-IOS-XE-native:native/ip"
   attributes = {
     source-route = "true"

examples/resources/iosxe_restconf/resource.tf renamed to examples/resources/iosxe_yang/resource.tf

@@ -84,9 +84,9 @@ func main() {
 		}
 	}
 
-	// update iosxe_restconf resource and data source
+	// update iosxe_yang resource and data source
 	for _, path := range docPaths {
-		filename := path + "restconf.md"
+		filename := path + "yang.md"
 		content, err := os.ReadFile(filename)
 		if err != nil {
 			log.Fatalf("Error opening documentation: %v", err)