From f0f4db3ca81059924a2a656f83353e53de19b701 Mon Sep 17 00:00:00 2001
From: jifox <josef.fuchs@j-fuchs.at>
Date: Fri, 15 Dec 2023 05:57:00 +0100
Subject: [PATCH 1/3] Add documentation about the transform function

---
 docs/plugins/index.rst | 28 +++++++++++++++-------------
 1 file changed, 15 insertions(+), 13 deletions(-)

diff --git a/docs/plugins/index.rst b/docs/plugins/index.rst
index b94ceee8..83dc29ab 100644
--- a/docs/plugins/index.rst
+++ b/docs/plugins/index.rst
@@ -19,17 +19,17 @@ To do so you can use `entry points <https://setuptools.readthedocs.io/en/latest/
 
 Using entrypoints in your ``setup.py``::
 
-    setup(
-        # ...
-        entry_points={
-          "PATH": "NAME = path.to:Plugin",
-        }
-    )
+  setup(
+    # ...
+    entry_points={
+      "PATH": "NAME = path.to:Plugin",
+    }
+  )
 
 In your pyproject.toml if using ``poetry``::
 
-    [tool.poetry.plugins."PATH"]
-    "NAME" = "path.to:Plugin"
+  [tool.poetry.plugins."PATH"]
+  "NAME" = "path.to:Plugin"
 
 Where PATH is:
 
@@ -40,18 +40,18 @@ Where PATH is:
 
 Where NAME is the way you want to refer to it later on and ``path.to:Plugin`` the import path. For instance::
 
-    [tool.poetry.plugins."nornir.plugins.inventory"]
-    "inventory-name" = "path.to:InventoryPlugin"
+  [tool.poetry.plugins."nornir.plugins.inventory"]
+  "inventory-name" = "path.to:InventoryPlugin"
 
 
 To do it programmatically import the correct plugin register and use the ``register`` method. For instance::
 
-    from nornir.core.plugins.inventory import InventoryPluginRegister
+  from nornir.core.plugins.inventory import InventoryPluginRegister
 
-    from path.to import InventoryPlugin
+  from path.to import InventoryPlugin
 
 
-    InventoryPluginRegister.register("inventory-name", InventoryPlugin)
+  InventoryPluginRegister.register("inventory-name", InventoryPlugin)
 
 Connections
 -----------
@@ -75,6 +75,8 @@ Transform functions
 
 A transform function is a plugin that manipulates the inventory independently from the inventory plugin used. Useful to extend data using the environment, a secret store or similar.
 
+During inventory initialization, the transform function will be called in a for loop for each host. The transform function takes a host object as the first parameter and additional keyword arguments as specified in the `config.inventory.transform_function_options` dictionary.
+
 Runners
 _______
 

From 61c960827377550c0d35b95125bb63234b7490ba Mon Sep 17 00:00:00 2001
From: jifox <josef.fuchs@j-fuchs.at>
Date: Mon, 18 Dec 2023 05:07:28 +0100
Subject: [PATCH 2/3] Undo unwanted changes

---
 docs/plugins/index.rst | 28 +++++++++++++---------------
 1 file changed, 13 insertions(+), 15 deletions(-)

diff --git a/docs/plugins/index.rst b/docs/plugins/index.rst
index 83dc29ab..b94ceee8 100644
--- a/docs/plugins/index.rst
+++ b/docs/plugins/index.rst
@@ -19,17 +19,17 @@ To do so you can use `entry points <https://setuptools.readthedocs.io/en/latest/
 
 Using entrypoints in your ``setup.py``::
 
-  setup(
-    # ...
-    entry_points={
-      "PATH": "NAME = path.to:Plugin",
-    }
-  )
+    setup(
+        # ...
+        entry_points={
+          "PATH": "NAME = path.to:Plugin",
+        }
+    )
 
 In your pyproject.toml if using ``poetry``::
 
-  [tool.poetry.plugins."PATH"]
-  "NAME" = "path.to:Plugin"
+    [tool.poetry.plugins."PATH"]
+    "NAME" = "path.to:Plugin"
 
 Where PATH is:
 
@@ -40,18 +40,18 @@ Where PATH is:
 
 Where NAME is the way you want to refer to it later on and ``path.to:Plugin`` the import path. For instance::
 
-  [tool.poetry.plugins."nornir.plugins.inventory"]
-  "inventory-name" = "path.to:InventoryPlugin"
+    [tool.poetry.plugins."nornir.plugins.inventory"]
+    "inventory-name" = "path.to:InventoryPlugin"
 
 
 To do it programmatically import the correct plugin register and use the ``register`` method. For instance::
 
-  from nornir.core.plugins.inventory import InventoryPluginRegister
+    from nornir.core.plugins.inventory import InventoryPluginRegister
 
-  from path.to import InventoryPlugin
+    from path.to import InventoryPlugin
 
 
-  InventoryPluginRegister.register("inventory-name", InventoryPlugin)
+    InventoryPluginRegister.register("inventory-name", InventoryPlugin)
 
 Connections
 -----------
@@ -75,8 +75,6 @@ Transform functions
 
 A transform function is a plugin that manipulates the inventory independently from the inventory plugin used. Useful to extend data using the environment, a secret store or similar.
 
-During inventory initialization, the transform function will be called in a for loop for each host. The transform function takes a host object as the first parameter and additional keyword arguments as specified in the `config.inventory.transform_function_options` dictionary.
-
 Runners
 _______
 

From cc4f56270a90a53ee33e0e3f49220d0b802eab0c Mon Sep 17 00:00:00 2001
From: jifox <josef.fuchs@j-fuchs.at>
Date: Mon, 18 Dec 2023 05:08:51 +0100
Subject: [PATCH 3/3] redo change

---
 docs/plugins/index.rst | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/docs/plugins/index.rst b/docs/plugins/index.rst
index b94ceee8..41a95269 100644
--- a/docs/plugins/index.rst
+++ b/docs/plugins/index.rst
@@ -75,6 +75,8 @@ Transform functions
 
 A transform function is a plugin that manipulates the inventory independently from the inventory plugin used. Useful to extend data using the environment, a secret store or similar.
 
+During inventory initialization, the transform function will be called in a for loop for each host. The transform function takes a host object as the first parameter and additional keyword arguments as specified in the `config.inventory.transform_function_options` dictionary.
+
 Runners
 _______