python4cpm 1.1.2__tar.gz → 1.1.3__tar.gz

{python4cpm-1.1.2/src/python4cpm.egg-info → python4cpm-1.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python4cpm
-Version: 1.1.2
+Version: 1.1.3
 Summary: Python for CPM
 Author-email: Gonzalo Atienza Rela <gonatienza@gmail.com>
 License-Expression: MIT
@@ -67,7 +67,7 @@ This platform allows you to duplicate it multiple times, simply changing its set
 from python4cpm import Python4CPMHandler
 
 
-class MyRotator(Python4CPMHandler): # create a subclass for the Handler
+class MyRotator(Python4CPMHandler):
     """
     These are the usable properties and methods from Python4CPMHandler:
 
@@ -123,64 +123,33 @@ class MyRotator(Python4CPMHandler): # create a subclass for the Handler
     When calling a signal sys.exit is invoked and the script is terminated.
     If no signal is called, and the script finishes without any exception,
     it will behave like p4cpm.close_fail(unrecoverable=True) and log an error message.
+
     =============================
+    REQUIRED METHODS
     =============================
+    verify(), logon(), change(), prereconcile(), reconcile()
     """
 
-    # =============================
-    # REQUIRED METHODS (MUST DEFINE)
-    # =============================
-    # verify(), logon(), change(), prereconcile(), reconcile()
-
     def verify(self):
-        self._verify()
-        self.log_info("verification successful")
+        # TODO: use account objects for your logic
         self.close_success()
 
     def logon(self):
+        # TODO: use account objects for your logic
         self.close_success()
 
     def change(self):
-        self._change()
-        self.log_error("something went wrong")
-        self.close_fail()
+        # TODO: use account objects for your logic
+        self.close_success()
 
     def prereconcile(self):
-        self._verify(from_reconcile=True)
+        # TODO: use account objects for your logic
         self.close_success()
 
     def reconcile(self):
-        self._change(from_reconcile=True)
+        # TODO: use account objects for your logic
         self.close_success()
 
-    def _verify(self, from_reconcile=False):
-        if from_reconcile is False:
-            pass
-            # TODO: use account objects for your logic
-        else:
-            pass
-            # TODO: use account objects for your logic
-        result = True
-        if result is True:
-            self.log_info("verification successful")
-        else:
-            self.log_error("something went wrong")
-            self.close_fail()
-
-    def _change(self, from_reconcile=False):
-        if from_reconcile is False:
-            pass
-            # TODO: use account objects for your logic
-        else:
-            pass
-            # TODO: use account objects for your logic
-        result = True
-        if result is True:
-            self.log_info("rotation successful")
-        else:
-            self.log_error("something went wrong")
-            self.close_fail()
-
 
 if __name__ == "__main__":
     MyRotator().run() # initializes the class and calls the action that was requested from CPM/SRS.
@@ -193,9 +162,9 @@ When doing `verify`, `change` or `reconcile` from Privilege Cloud/PVWA:
     - If both actions are not terminated with `self.close_success()` and the scripts terminates without any exception, CPM/SRS will see this as a `self.close_fail(unrecoverable=True)`.
 3. Reconcile -> the sciprt will be executed twice, running first the `MyRotator.prereconcile()` method and secondly the `MyRotator.reconcile()` method.
     - If both actions are not terminated with `self.close_success()` and the scripts terminates without any exception, CPM/SRS will see this as a `self.close_fail(unrecoverable=True)`.
-4. When calling `MyRotator.verify()`, `MyRotator.logon()` or `MyRotator.prereconcile()`: `self.target_account.new_password.get()` will always return an empty string.
-5. If a logon account is not linked, `self.logon_account.username` and `self.logon_account.password.get()` will return empty strings.
-6. If a reconcile account is not linked, `self.reconcile_account.username` and `self.reconcile_account.password.get()` will return empty strings.
+4. When calling `MyRotator.verify()`, `MyRotator.logon()` or `MyRotator.prereconcile()`: `self.target_account.new_password` will always return `None`.
+5. If a logon account is not linked, `self.logon_account` will return `None`.
+6. If a reconcile account is not linked, `self.reconcile_account` will return `None`.
 7. The python `Logger` places its logs in the `Logs/ThirdParty` directory.  The filename will be based on the name of the subclass created (e.g., `MyRotator`).
 
 
@@ -210,7 +179,7 @@ As with any python venv, you can install dependencies in your venv.
 
 ## Dev Helper:
 
-For dev purposes, `NETHelper` is a companion helper to test your scripts before shipping to CPM/SRS.  It simplifies the instantiation of the `Python4CPM` or `Python4CPMHandler` objects by simulating how the plugin creates the environment context for the python module.
+For dev purposes, `NETHelper` is a companion helper to test your scripts without CPM/SRS.  It simplifies the instantiation of the `Python4CPM` or `Python4CPMHandler` objects by simulating how the plugin creates the environment context for the python module.
 
 **Note**: As CPM and the SRS management agent run in Windows, the plugin was built to encrypt secrets using DPAPI (a windows only library).  For dev purposes in Linux/Mac dev workstations, those secrets put in the environment context by `NETHelper` will be in plaintext.  In windows dev workstations, `NETHelper` encrypts the secrets as the .NET plugin does.  This is informational only, **the module will use its encryption/decryption capabilities automatically based on the platform** it is running on and you do not have to do anything specific to enable it.
 
@@ -223,7 +192,7 @@ from python4cpm import NETHelper, Python4CPM, Python4CPMHandler
 from getpass import getpass
 
 # Get secrets for your password, logon account password, reconcile account password and new password
-# You can use an empty string if it does not apply
+# You may set to None any argument that does not apply or simply leaving it to its default None value.
 target_password = getpass("password: ") # password from account
 logon_password = getpass("logon_password: ") # password from linked logon account
 reconcile_password = getpass("reconcile_password: ") # password from linked reconcile account
@@ -271,5 +240,4 @@ MyRotator().run()
 
 - Remove the import of `NETHelper`.
 - Remove the `NETHelper.set()` call.
-- If applicable, change the definition of `p4cpm` from `p4cpm = NETHelper.get()` to `p4cpm = Python4CPM("MyApp")`.
 - Remove any secrets prompting or interactive interruptions.

{python4cpm-1.1.2 → python4cpm-1.1.3}/README.md

@@ -56,7 +56,7 @@ This platform allows you to duplicate it multiple times, simply changing its set
 from python4cpm import Python4CPMHandler
 
 
-class MyRotator(Python4CPMHandler): # create a subclass for the Handler
+class MyRotator(Python4CPMHandler):
     """
     These are the usable properties and methods from Python4CPMHandler:
 
@@ -112,64 +112,33 @@ class MyRotator(Python4CPMHandler): # create a subclass for the Handler
     When calling a signal sys.exit is invoked and the script is terminated.
     If no signal is called, and the script finishes without any exception,
     it will behave like p4cpm.close_fail(unrecoverable=True) and log an error message.
+
     =============================
+    REQUIRED METHODS
     =============================
+    verify(), logon(), change(), prereconcile(), reconcile()
     """
 
-    # =============================
-    # REQUIRED METHODS (MUST DEFINE)
-    # =============================
-    # verify(), logon(), change(), prereconcile(), reconcile()
-
     def verify(self):
-        self._verify()
-        self.log_info("verification successful")
+        # TODO: use account objects for your logic
         self.close_success()
 
     def logon(self):
+        # TODO: use account objects for your logic
         self.close_success()
 
     def change(self):
-        self._change()
-        self.log_error("something went wrong")
-        self.close_fail()
+        # TODO: use account objects for your logic
+        self.close_success()
 
     def prereconcile(self):
-        self._verify(from_reconcile=True)
+        # TODO: use account objects for your logic
         self.close_success()
 
     def reconcile(self):
-        self._change(from_reconcile=True)
+        # TODO: use account objects for your logic
         self.close_success()
 
-    def _verify(self, from_reconcile=False):
-        if from_reconcile is False:
-            pass
-            # TODO: use account objects for your logic
-        else:
-            pass
-            # TODO: use account objects for your logic
-        result = True
-        if result is True:
-            self.log_info("verification successful")
-        else:
-            self.log_error("something went wrong")
-            self.close_fail()
-
-    def _change(self, from_reconcile=False):
-        if from_reconcile is False:
-            pass
-            # TODO: use account objects for your logic
-        else:
-            pass
-            # TODO: use account objects for your logic
-        result = True
-        if result is True:
-            self.log_info("rotation successful")
-        else:
-            self.log_error("something went wrong")
-            self.close_fail()
-
 
 if __name__ == "__main__":
     MyRotator().run() # initializes the class and calls the action that was requested from CPM/SRS.
@@ -182,9 +151,9 @@ When doing `verify`, `change` or `reconcile` from Privilege Cloud/PVWA:
     - If both actions are not terminated with `self.close_success()` and the scripts terminates without any exception, CPM/SRS will see this as a `self.close_fail(unrecoverable=True)`.
 3. Reconcile -> the sciprt will be executed twice, running first the `MyRotator.prereconcile()` method and secondly the `MyRotator.reconcile()` method.
     - If both actions are not terminated with `self.close_success()` and the scripts terminates without any exception, CPM/SRS will see this as a `self.close_fail(unrecoverable=True)`.
-4. When calling `MyRotator.verify()`, `MyRotator.logon()` or `MyRotator.prereconcile()`: `self.target_account.new_password.get()` will always return an empty string.
-5. If a logon account is not linked, `self.logon_account.username` and `self.logon_account.password.get()` will return empty strings.
-6. If a reconcile account is not linked, `self.reconcile_account.username` and `self.reconcile_account.password.get()` will return empty strings.
+4. When calling `MyRotator.verify()`, `MyRotator.logon()` or `MyRotator.prereconcile()`: `self.target_account.new_password` will always return `None`.
+5. If a logon account is not linked, `self.logon_account` will return `None`.
+6. If a reconcile account is not linked, `self.reconcile_account` will return `None`.
 7. The python `Logger` places its logs in the `Logs/ThirdParty` directory.  The filename will be based on the name of the subclass created (e.g., `MyRotator`).
 
 
@@ -199,7 +168,7 @@ As with any python venv, you can install dependencies in your venv.
 
 ## Dev Helper:
 
-For dev purposes, `NETHelper` is a companion helper to test your scripts before shipping to CPM/SRS.  It simplifies the instantiation of the `Python4CPM` or `Python4CPMHandler` objects by simulating how the plugin creates the environment context for the python module.
+For dev purposes, `NETHelper` is a companion helper to test your scripts without CPM/SRS.  It simplifies the instantiation of the `Python4CPM` or `Python4CPMHandler` objects by simulating how the plugin creates the environment context for the python module.
 
 **Note**: As CPM and the SRS management agent run in Windows, the plugin was built to encrypt secrets using DPAPI (a windows only library).  For dev purposes in Linux/Mac dev workstations, those secrets put in the environment context by `NETHelper` will be in plaintext.  In windows dev workstations, `NETHelper` encrypts the secrets as the .NET plugin does.  This is informational only, **the module will use its encryption/decryption capabilities automatically based on the platform** it is running on and you do not have to do anything specific to enable it.
 
@@ -212,7 +181,7 @@ from python4cpm import NETHelper, Python4CPM, Python4CPMHandler
 from getpass import getpass
 
 # Get secrets for your password, logon account password, reconcile account password and new password
-# You can use an empty string if it does not apply
+# You may set to None any argument that does not apply or simply leaving it to its default None value.
 target_password = getpass("password: ") # password from account
 logon_password = getpass("logon_password: ") # password from linked logon account
 reconcile_password = getpass("reconcile_password: ") # password from linked reconcile account
@@ -260,5 +229,4 @@ MyRotator().run()
 
 - Remove the import of `NETHelper`.
 - Remove the `NETHelper.set()` call.
-- If applicable, change the definition of `p4cpm` from `p4cpm = NETHelper.get()` to `p4cpm = Python4CPM("MyApp")`.
 - Remove any secrets prompting or interactive interruptions.

{python4cpm-1.1.2 → python4cpm-1.1.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python4cpm"
-version = "1.1.2"
+version = "1.1.3"
 description = "Python for CPM"
 authors = [
   { name = "Gonzalo Atienza Rela", email = "gonatienza@gmail.com" }

{python4cpm-1.1.2 → python4cpm-1.1.3}/src/python4cpm/accounts.py

@@ -7,11 +7,18 @@ class BaseAccount(EnvHandler):
 
     def __init__(
         self,
-        username: str,
-        password: str
+        username: str | None,
+        password: str | None
     ) -> None:
         self._username = username
-        self._password = Secret(password)
+        self._password = Secret.from_env_var(password)
+
+    @classmethod
+    def get(cls) -> object | None:
+        kwargs = cls.get_kwargs()
+        if all(value is None for value in kwargs.values()):
+            return None
+        return cls(**kwargs)
 
     @property
     def username(self) -> str:
@@ -28,11 +35,11 @@ class TargetAccount(BaseAccount):
 
     def __init__(
         self,
-        username: str,
-        password: str,
-        address: str,
-        port: str,
-        new_password: str
+        username: str | None,
+        password: str | None,
+        address: str | None,
+        port: str | None,
+        new_password: str | None
     ) -> None:
         super().__init__(
             username,
@@ -40,14 +47,14 @@ class TargetAccount(BaseAccount):
         )
         self._address = address
         self._port = port
-        self._new_password = Secret(new_password)
+        self._new_password = Secret.from_env_var(new_password)
 
     @property
-    def address(self) -> str:
+    def address(self) -> str | None:
         return self._address
 
     @property
-    def port(self) -> str:
+    def port(self) -> str | None:
         return self._port
 
     @property

{python4cpm-1.1.2 → python4cpm-1.1.3}/src/python4cpm/args.py

@@ -7,8 +7,8 @@ class Args(EnvHandler):
 
     def __init__(
         self,
-        action: str,
-        logging_level: str
+        action: str | None,
+        logging_level: str | None
     ) -> None:
         self._action = action
         self._logging_level = logging_level
@@ -18,5 +18,5 @@ class Args(EnvHandler):
         return self._action
 
     @property
-    def logging_level(self) -> str:
+    def logging_level(self) -> str | None:
         return self._logging_level

{python4cpm-1.1.2 → python4cpm-1.1.3}/src/python4cpm/envhandler.py

@@ -20,10 +20,13 @@ class EnvHandler:
         env_key = f"{cls.PREFIX}{cls.OBJ_PREFIX}{key}"
         return env_key.upper()
 
+    @classmethod
+    def get_kwargs(cls) -> dict:
+        return {
+            prop: os.environ.get(cls.get_key(prop))
+            for prop in cls.PROPS
+        }
+
     @classmethod
     def get(cls) -> object:
-        kwargs = {}
-        for prop in cls.PROPS:
-            value = os.environ.get(cls.get_key(prop))
-            kwargs[prop] = value if value is not None else ""
-        return cls(**kwargs)
+        return cls(**cls.get_kwargs())

{python4cpm-1.1.2 → python4cpm-1.1.3}/src/python4cpm/logger.py

@@ -18,13 +18,14 @@ class Logger:
     def get_logger(
         cls,
         name: str,
-        logging_level: str
+        logging_level: str | None
     ) -> logging.Logger:
         os.makedirs(cls._LOGS_DIR, exist_ok=True)
         logs_file = os.path.join(cls._LOGS_DIR, f"{__name__}-{name}.log")
         _id = os.urandom(4).hex()
         logger = logging.getLogger(_id)
-        if logging_level.lower() in cls._LOGGING_LEVELS:
+        is_logging_level_str = isinstance(logging_level, str)
+        if is_logging_level_str and logging_level.lower() in cls._LOGGING_LEVELS:
             logger.setLevel(cls._LOGGING_LEVELS[logging_level.lower()])
         else:
             logger.setLevel(cls._DEFAULT_LEVEL)

{python4cpm-1.1.2 → python4cpm-1.1.3}/src/python4cpm/nethelper.py

@@ -9,17 +9,17 @@ class NETHelper:
     @classmethod
     def set(
         cls,
-        action: str = "",
-        logging_level: str = "",
-        target_username: str = "",
-        target_address: str = "",
-        target_port: str = "",
-        logon_username: str = "",
-        reconcile_username: str = "",
-        target_password: str = "",
-        logon_password: str = "",
-        reconcile_password: str = "",
-        target_new_password: str = ""
+        action: str | None = None,
+        logging_level: str | None = None,
+        target_username: str | None = None,
+        target_address: str | None = None,
+        target_port: str | None = None,
+        logon_username: str | None = None,
+        reconcile_username: str | None = None,
+        target_password: str | None = None,
+        logon_password: str | None = None,
+        reconcile_password: str | None = None,
+        target_new_password: str | None = None
     ) -> None:
         if Crypto.ENABLED:
             target_password = Crypto.encrypt(target_password)
@@ -53,7 +53,8 @@ class NETHelper:
             target_new_password
         )
         for i, key in enumerate(keys):
-            os.environ.update({key: values[i]})
+            if values[i] is not None:
+                os.environ.update({key: values[i]})
 
     @classmethod
     def get(cls) -> Python4CPM:

{python4cpm-1.1.2 → python4cpm-1.1.3}/src/python4cpm/python4cpm.py

@@ -3,7 +3,6 @@ import atexit
 import logging
 from python4cpm.secret import Secret
 from python4cpm.args import Args
-from python4cpm.crypto import Crypto
 from python4cpm.logger import Logger
 from python4cpm.accounts import TargetAccount, LogonAccount, ReconcileAccount
 
@@ -65,20 +64,18 @@ class Python4CPM:
         if self._args.action not in self._VALID_ACTIONS:
             self._logger.warning(f"Unkonwn action -> '{self._args.action}'")
 
-    def _log_obj(self, obj: object) -> None:
-        for key, value in vars(obj).items():
-            _key = f"{obj.__class__.__name__}.{key.strip('_')}"
-            if value:
-                if not isinstance(value, Secret):
-                    logging_value = f"'{value}'"
-                else:
-                    if Crypto.ENABLED is True:
-                        logging_value = "[ENCRYPTED]"
+    def _log_obj(self, obj: object | None) -> None:
+        if obj is not None:
+            for key, value in vars(obj).items():
+                _key = f"{obj.__class__.__name__}.{key.removeprefix('_')}"
+                if value is not None:
+                    if not isinstance(value, Secret):
+                        logging_value = f"'{value}'"
                     else:
-                        logging_value = "[SET]"
-            else:
-                logging_value = "[NOT SET]"
-            self._logger.debug(f"{_key} -> {logging_value}")
+                        logging_value = str(value)
+                else:
+                    logging_value = "[NOT SET]"
+                self._logger.debug(f"{_key} -> {logging_value}")
 
     def close_fail(self, unrecoverable: bool = False) -> None:
         if unrecoverable is False:

{python4cpm-1.1.2 → python4cpm-1.1.3}/src/python4cpm/python4cpmhandler.py

@@ -18,7 +18,7 @@ class Python4CPMHandler(ABC, Python4CPM):
         if action is not None:
             action()
         else:
-            raise ValueError(f"Unknown action: {self._args.action}")
+            raise ValueError(f"Unknown action: '{self._args.action}'")
 
     @abstractmethod
     def verify(self) -> None:

python4cpm-1.1.3/src/python4cpm/secret.py

@@ -0,0 +1,24 @@
+from python4cpm.crypto import Crypto
+
+
+class Secret:
+    def __init__(self, secret: str) -> None:
+        self._secret = secret
+
+    @classmethod
+    def from_env_var(cls, secret: str | None) -> object | None:
+        if secret is not None:
+            return cls(secret)
+        return None
+
+    def __str__(self) -> str:
+        if Crypto.ENABLED:
+            return "[ENCRYPTED]"
+        else:
+            return "[SET]"
+
+    def get(self) -> str:
+        if Crypto.ENABLED:
+            return Crypto.decrypt(self._secret)
+        else:
+            return self._secret

{python4cpm-1.1.2 → python4cpm-1.1.3/src/python4cpm.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python4cpm
-Version: 1.1.2
+Version: 1.1.3
 Summary: Python for CPM
 Author-email: Gonzalo Atienza Rela <gonatienza@gmail.com>
 License-Expression: MIT
@@ -67,7 +67,7 @@ This platform allows you to duplicate it multiple times, simply changing its set
 from python4cpm import Python4CPMHandler
 
 
-class MyRotator(Python4CPMHandler): # create a subclass for the Handler
+class MyRotator(Python4CPMHandler):
     """
     These are the usable properties and methods from Python4CPMHandler:
 
@@ -123,64 +123,33 @@ class MyRotator(Python4CPMHandler): # create a subclass for the Handler
     When calling a signal sys.exit is invoked and the script is terminated.
     If no signal is called, and the script finishes without any exception,
     it will behave like p4cpm.close_fail(unrecoverable=True) and log an error message.
+
     =============================
+    REQUIRED METHODS
     =============================
+    verify(), logon(), change(), prereconcile(), reconcile()
     """
 
-    # =============================
-    # REQUIRED METHODS (MUST DEFINE)
-    # =============================
-    # verify(), logon(), change(), prereconcile(), reconcile()
-
     def verify(self):
-        self._verify()
-        self.log_info("verification successful")
+        # TODO: use account objects for your logic
         self.close_success()
 
     def logon(self):
+        # TODO: use account objects for your logic
         self.close_success()
 
     def change(self):
-        self._change()
-        self.log_error("something went wrong")
-        self.close_fail()
+        # TODO: use account objects for your logic
+        self.close_success()
 
     def prereconcile(self):
-        self._verify(from_reconcile=True)
+        # TODO: use account objects for your logic
         self.close_success()
 
     def reconcile(self):
-        self._change(from_reconcile=True)
+        # TODO: use account objects for your logic
         self.close_success()
 
-    def _verify(self, from_reconcile=False):
-        if from_reconcile is False:
-            pass
-            # TODO: use account objects for your logic
-        else:
-            pass
-            # TODO: use account objects for your logic
-        result = True
-        if result is True:
-            self.log_info("verification successful")
-        else:
-            self.log_error("something went wrong")
-            self.close_fail()
-
-    def _change(self, from_reconcile=False):
-        if from_reconcile is False:
-            pass
-            # TODO: use account objects for your logic
-        else:
-            pass
-            # TODO: use account objects for your logic
-        result = True
-        if result is True:
-            self.log_info("rotation successful")
-        else:
-            self.log_error("something went wrong")
-            self.close_fail()
-
 
 if __name__ == "__main__":
     MyRotator().run() # initializes the class and calls the action that was requested from CPM/SRS.
@@ -193,9 +162,9 @@ When doing `verify`, `change` or `reconcile` from Privilege Cloud/PVWA:
     - If both actions are not terminated with `self.close_success()` and the scripts terminates without any exception, CPM/SRS will see this as a `self.close_fail(unrecoverable=True)`.
 3. Reconcile -> the sciprt will be executed twice, running first the `MyRotator.prereconcile()` method and secondly the `MyRotator.reconcile()` method.
     - If both actions are not terminated with `self.close_success()` and the scripts terminates without any exception, CPM/SRS will see this as a `self.close_fail(unrecoverable=True)`.
-4. When calling `MyRotator.verify()`, `MyRotator.logon()` or `MyRotator.prereconcile()`: `self.target_account.new_password.get()` will always return an empty string.
-5. If a logon account is not linked, `self.logon_account.username` and `self.logon_account.password.get()` will return empty strings.
-6. If a reconcile account is not linked, `self.reconcile_account.username` and `self.reconcile_account.password.get()` will return empty strings.
+4. When calling `MyRotator.verify()`, `MyRotator.logon()` or `MyRotator.prereconcile()`: `self.target_account.new_password` will always return `None`.
+5. If a logon account is not linked, `self.logon_account` will return `None`.
+6. If a reconcile account is not linked, `self.reconcile_account` will return `None`.
 7. The python `Logger` places its logs in the `Logs/ThirdParty` directory.  The filename will be based on the name of the subclass created (e.g., `MyRotator`).
 
 
@@ -210,7 +179,7 @@ As with any python venv, you can install dependencies in your venv.
 
 ## Dev Helper:
 
-For dev purposes, `NETHelper` is a companion helper to test your scripts before shipping to CPM/SRS.  It simplifies the instantiation of the `Python4CPM` or `Python4CPMHandler` objects by simulating how the plugin creates the environment context for the python module.
+For dev purposes, `NETHelper` is a companion helper to test your scripts without CPM/SRS.  It simplifies the instantiation of the `Python4CPM` or `Python4CPMHandler` objects by simulating how the plugin creates the environment context for the python module.
 
 **Note**: As CPM and the SRS management agent run in Windows, the plugin was built to encrypt secrets using DPAPI (a windows only library).  For dev purposes in Linux/Mac dev workstations, those secrets put in the environment context by `NETHelper` will be in plaintext.  In windows dev workstations, `NETHelper` encrypts the secrets as the .NET plugin does.  This is informational only, **the module will use its encryption/decryption capabilities automatically based on the platform** it is running on and you do not have to do anything specific to enable it.
 
@@ -223,7 +192,7 @@ from python4cpm import NETHelper, Python4CPM, Python4CPMHandler
 from getpass import getpass
 
 # Get secrets for your password, logon account password, reconcile account password and new password
-# You can use an empty string if it does not apply
+# You may set to None any argument that does not apply or simply leaving it to its default None value.
 target_password = getpass("password: ") # password from account
 logon_password = getpass("logon_password: ") # password from linked logon account
 reconcile_password = getpass("reconcile_password: ") # password from linked reconcile account
@@ -271,5 +240,4 @@ MyRotator().run()
 
 - Remove the import of `NETHelper`.
 - Remove the `NETHelper.set()` call.
-- If applicable, change the definition of `p4cpm` from `p4cpm = NETHelper.get()` to `p4cpm = Python4CPM("MyApp")`.
 - Remove any secrets prompting or interactive interruptions.

python4cpm-1.1.2/src/python4cpm/secret.py

@@ -1,15 +0,0 @@
-from python4cpm.crypto import Crypto
-
-
-class Secret:
-    def __init__(self, secret: str) -> None:
-        self._secret = secret
-
-    def __bool__(self) -> bool:
-        return bool(self._secret)
-
-    def get(self) -> str:
-        if Crypto.ENABLED and self._secret:
-            return Crypto.decrypt(self._secret)
-        else:
-            return self._secret