launchpy 0.4.7.post1__tar.gz → 0.4.9__tar.gz

{launchpy-0.4.7.post1/launchpy.egg-info → launchpy-0.4.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: launchpy
-Version: 0.4.7.post1
+Version: 0.4.9
 Summary: Adobe Launch API wrapper
 Author-email: Julien Piccini <piccini.julien@gmail.com>
 License: Apache License 2.0
@@ -8,26 +8,27 @@ Project-URL: homepage, https://github.com/pitchmuc/launchpy
 Project-URL: changelog, https://github.com/pitchmuc/launchpy/blob/master/docs/releases.md
 Keywords: adobe,analytics,API,python
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 Classifier: Topic :: Scientific/Engineering :: Information Analysis
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Development Status :: 4 - Beta
-Requires-Python: >=3.7
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: pandas
 Requires-Dist: requests
-Requires-Dist: PyJWT
-Requires-Dist: PyJWT[crypto]
 Requires-Dist: pathlib2
 Requires-Dist: pathlib
 Requires-Dist: aepp
 Requires-Dist: rich
+Requires-Dist: deprecated
+Requires-Dist: httpx
 Dynamic: license-file
 
 # Launchpy

{launchpy-0.4.7.post1 → launchpy-0.4.9}/docs/cli.md

@@ -43,6 +43,7 @@ This document provides an overview of the command line interface (CLI) for `laun
       - [get\_base\_libraries](#get_base_libraries)
       - [get\_base\_library](#get_base_library)
       - [sync\_from\_library](#sync_from_library)
+    - [Behaviors for sync\_from\_library](#behaviors-for-sync_from_library)
       - [create\_libraries](#create_libraries)
 
 
@@ -479,8 +480,23 @@ synchronizer:Base_Property_Name> get_base_library -n "Library Name"
 #### sync_from_library
 This command allows you to synchronize a library from the base property to the target properties.\
 **IMPORTANT**:By default it will use the published version of the elements that are part of the library. 
-`-n`, `--name`: The name of the library to sync from. This is a required parameter.
-`-id`, `--id`: The ID of the library to sync from (overrides name if both provided). This is an optional parameter.
+* `-n`, `--name`: Name of the library to sync from. This is a required parameter.
+* `-id`, `--id`: ID of the library to sync from (overrides name if both provided). This is an optional parameter.
+* `-c`, `--create`: Boolean. Create the component if it does not exist. Default `False`. Possible values: True, False
+* `-ll`, `--library_linked`: Boolean. Whether to use library linked components or not. If set to True, the sync will be done using the library linked components. If set to False, the sync will be done using the component IDs in the library. Default `True`. Possible values: True, False
+* `-p`, `--published`: Boolean. Sync the latest published version of the component instead of the current version. Default `False`. Possible values: True, False
+* `-dr`, `--dry_run`: Boolean. If set to True, will only check the sync status of the components without actually syncing them. Default `False`. Possible values: True, False
+
+```bash
+synchronizer:Base_Property_Name> sync_from_library -id "LibraryId" -ll False -p True -dr True
+```
+
+
+### Behaviors for sync_from_library
+By default, the method will sync the components present in the library as they are in the library.
+If the `published` is set to True, it will try to sync the version that has been published in the base property to the targets.\
+If the `library_linked` is set to `False` and the `published` is set to `False` (default), it will try to sync the latest version of the components present in the base property library to the targets.\
+
 
 ```bash
 synchronizer:Base_Property_Name> sync_from_library -n "Library Name"
@@ -490,9 +506,14 @@ synchronizer:Base_Property_Name> sync_from_library -n "Library Name"
 This command allows you to create a library in the destination properties with the elements you have sync.\
 Arguments:
 `name`: Name for the new library to be created in the destination properties. This is a required parameter.
-`-env`, `--environment`: Boolean. Try to find an empty environment to build the library. Default False. Possible values: `True`, `False`
+`-env`, `--environment`: String. If set to `True`, it will try to find a free environment and assign it to the library. If none is available, it will not assign any environment to the library. If the name of the environment is provided, it will try to assign it to that library. If the environment is already used in a Library, it will remove that association and assign it to the new library. Default False. Possible values: `True`, `False` or a `string` which is the (partial) name of the environment you want to assign to the library.
 
 ```bash
 synchronizer:Base_Property_Name> create_library "Library Name" -env True
 ```
+
+```bash
+synchronizer:Base_Property_Name> create_library "Library Name" -env "Environment Name
+
+```
         

{launchpy-0.4.7.post1 → launchpy-0.4.9}/docs/releases.md

@@ -3,8 +3,22 @@
 This page gathered the changes made between version of the launchpy module.\
 This has been started after the 0.3.0 release.\
 
+## 0.4.9
+* fixing httpx dependency requirement
+* extractProperty will now also extract Data Elements and Extensions configurations in separate folders.
+* fix the argument handling for linkedLibrary in CLI.
+* Change of the `force` parameter to `create` in the synchronizer CLI for better understanding of the action. `create` is now default to `False`. The synchronizer module keeps its long name `forceCreation` for backward compatibility and better understanding of the action. Also turning it to `False` by default. 
+
+## 0.4.8
+* Adding the `clear` method in CLI
+* Adding `syncFromLibrary` in synchronizer[doc](./synchronizer.md#syncFromLibrary).
+* Adding `sync_from_library` command in CLI[doc](./cli.md#sync_from_library-command).
+* Cleaning the JWT components and requirements
+* Adding the `definition` attribute in the Library class
+* Adding capability to define a specific environment name when creating a library in synchronizer.
+
 ## 0.4.7
-* modify `getRuleComponents` to `getRulesComponents` as it can return all the rules components if no rule is specified. Kept `getRuleComponents` as an alias for backward compatibility and also provide a single rule components retrieval.
+* Modify `getRuleComponents` to `getRulesComponents` as it can return all the rules components if no rule is specified. Kept `getRuleComponents` as an alias for backward compatibility and also provide a single rule components retrieval.
 * Adding the `CLI` layer. [Documentation to CLI](cli.md)
 
 ## 0.4.6

{launchpy-0.4.7.post1 → launchpy-0.4.9}/docs/synchronizer.md

@@ -6,6 +6,16 @@ You can recreate a (more advanced) version that supports additional methods or e
 
 The Synchronizer will allow you to specify a template property and target property **within the same organization** in order to sync these properties rules and data elements.
 
+## Menu 
+
+[MENUI](#menu)
+[Pre Requisite](#pre-requisite)
+[Instantiation](#instantiation)
+[SyncComponent Method](#syncComponent-Method)
+[SyncComponents](#syncComponents)
+[SyncFromLibrary](#syncFromLibrary)
+[createTargetsLibrary](#createTargetsLibrary)
+[renameComponent](#renameComponent)
 
 
 ## PRE REQUISITE
@@ -85,7 +95,6 @@ synchronizor = lp.Synchronizer(base=base,targets=['another Property Name to sync
 
 ```
 
-
 ### Additional options
 There is a possibility to setup some rules so you can filter when migrating from one property to another. See [dynamic Filtering](#dynamic-component-filter)
 
@@ -122,7 +131,7 @@ The method will delete all rule components existing in the Target property for t
 It will then copy all template rule component existing in that base property to the target properties.\
 No history is saved from the existing rule component, which will make revision check very hard.
 
-## SyncComponents Method
+## SyncComponents
 
 You can pass down a list of component names or componentIds.\
 It takes 3 arguments:\
@@ -131,10 +140,28 @@ Arguments:
 * componentsId : REQUIRED : The list of component ID to sync*
 * publishedVersion : OPTIONAL : if you want to take the version that has been published
 
+## syncFromLibrary
+
+This method allows you to take a library in your base property and sync all of the components in that library to the target properties.
+Arguments: 
+* library : REQUIRED : the name or the ID of the library to sync from.
+* state : OPTIONAL : the state of the library to sync from. Default: 'published', possible states: "development", "submitted", "approved", "rejected", "published"
+* create : OPTIONAL : If set to True, it will create the element sync if it does not exist in the target property. Set to `False`, it will prevent that behavior. Default: `False`.
+* libraryLinked : OPTIONAL : If set to True, it will use library linked components for comparison. Default: `True`.
+* publishedVersion : OPTIONAL : If set to True, it will compare the components to the published version in the target properties. Default: `False`.
+* dryRun : OPTIONAL : If set to True, will only check the sync status of the components without actually syncing them. Default `False`. Possible values: `True`, `False`
+
+**Note**: A library is not created automatically, so you will need to create a new one via the `createTargetsLibrary` method.
+
+### Behaviors for syncFromLibrary
+By default, the method will sync the components present in the library as they are in the library.
+If the `publishedVersion` is set to True, it will try to sync the version that has been published in the base property to the targets.\
+If the `libraryLinked` is set to `False` and the `publishedVersion` is set to `False` (default), it will try to sync the latest version of the components present in the base property library to the targets.\
+
 ## createTargetsLibrary
 
 The synchronizer will automatically track the component that has been updated via the module.\
-When you are done synchronizing your components, you can run this method to create a library, that will contain all of your elements you synchronized.\
+When you are done synchronizing your components, you can run this method to create a library, that will contain all the elements you synchronized.\
 The library will be available within all of your synch properties.
 
 You can pass a name to define the library name that is created.\
@@ -142,7 +169,10 @@ The name is then used to match if a library already exist with that name, in the
 Note that the match looked for is using regular expression (`re.search`) to find a match in the existing libraries name.\
 Arguments:
 * name : REQUIRED : Name of the library to create or to use.
-* assignEnv : OPTIONAL : If you want to automatically assign an environment to the library and build it. Default False. Possible values: `True`, `False`
+* assignEnv : OPTIONAL : If you want to automatically assign an environment to the library and build it. Default False. 
+  Possible values: `True`, `False` or a `string` which is the name of the environment you want to assign to the library.\
+  If `True`, it will try to find a free environment and assign it to the library. If none is available, it will not assign any environment to the library.\
+  If the name of the environment is provided, it will try to assign it to that library. If the environment is already used in a Library, it will remove that association and assign it to the new library. (A print statement will be printed to warn about that change of association)
 
 ## renameComponent
 
@@ -198,14 +228,10 @@ For Data Elements:
 
 #### Additional elements
 On top of the different properties check, additional information will be provided for the base component: 
-* `base-publihsed`: If the current component check is published.\
+* `base-published`: If the current component check is published.\
   **IMPORTANT NOTE**: When you using the `publishedVersion` parameter set to True, most of the element will be set to Published. In reverse, it is not because the component current version is not published that it has never been published. Use the `publishedVersion` to ensure this.
 * `base-enabled`: If the current component check is enabled. 
-* `base-state`: 
-  * `Latest`: If the component retrieved is the latest latest version
-  * `Unknown`: If the component retrieved cannot be evaluated to know if it is the latest.
-  * `Draft` : If the component retrieved is not the latest and it has not yet been published
-  * `Edited`: If the component retrieved is not the latest and has been published before.
+
 
 #### Similar vs Same
 The idea of checking the similarity of 2 components is partially done as not everything can be tested during the check.\

{launchpy-0.4.7.post1 → launchpy-0.4.9}/launchpy/__init__.py

@@ -9,7 +9,7 @@ from launchpy.library import Library
 from launchpy.admin import Admin
 from launchpy.property import Property
 from launchpy.synchronizer import Synchronizer
-import re
+import re,json
 from pathlib import Path
 import httpx, asyncio
 
@@ -48,10 +48,18 @@ async def process_all_rules(rules_list, folder, header):
     async with httpx.AsyncClient(timeout=timeout, limits=limits) as client:
         # Create a list of "tasks" to run
         tasks = [__extractRuleComponents__(rule, client, folder, header) for rule in rules_list]
-        
         # 'gather' runs them all concurrently
         await asyncio.gather(*tasks)
 
+
+async def write_all_data_elements(data_elements_list, folder, header):
+    for data_element in data_elements_list:
+        data_element_name = __safe_name__(data_element['attributes']['name'])
+        file_path = Path(folder) / f"{data_element_name}.json"
+        with open(file_path, "w") as f:
+            json.dump(data_element, f, indent=4)
+
+
 def extractProperty(property: dict | Property):
     if property is None:
         raise ValueError("Property is None")
@@ -63,4 +71,16 @@ def extractProperty(property: dict | Property):
     folder = __safe_name__(property.name)
     Path(folder).mkdir(parents=True, exist_ok=True)
     rules = property.getRules()
-    asyncio.run(process_all_rules(rules, folder, property.header))
+    asyncio.run(process_all_rules(rules, folder, property.header))
+    dataElements = property.getDataElements()
+    dataElements_folder = Path(folder) / "data_elements"
+    Path(dataElements_folder).mkdir(parents=True, exist_ok=True)
+    asyncio.run(write_all_data_elements(dataElements, dataElements_folder, property.header))
+    extension_folder = Path(folder) / "extensions"
+    extension_folder.mkdir(parents=True, exist_ok=True)
+    extensions = property.getExtensions()
+    for extension in extensions:
+        extension_name = __safe_name__(extension['attributes']['name'])
+        file_path = extension_folder / f"{extension_name}.json"
+        with open(file_path, "w") as f:
+            json.dump(extension, f, indent=4)

launchpy-0.4.9/launchpy/__version__.py

@@ -0,0 +1 @@
+__version__ = "0.4.9"

{launchpy-0.4.7.post1 → launchpy-0.4.9}/launchpy/cli/__main__.py

@@ -1,5 +1,4 @@
-from rich import rule
-import launchpy
+import launchpy
 import argparse, cmd, shlex, json
 from functools import wraps
 from rich.console import Console
@@ -10,6 +9,17 @@ import pandas as pd
 from datetime import datetime, timedelta
 from typing import Any, Concatenate, ParamSpec, ParamSpecKwargs
 from collections.abc import Callable
+import os
+
+def str2bool(v):
+    if isinstance(v, bool):
+        return v
+    if v.lower() in ('yes', 'true', 't', 'y', '1'):
+        return True
+    elif v.lower() in ('no', 'false', 'f', 'n', '0'):
+        return False
+    else:
+        raise argparse.ArgumentTypeError('Boolean value expected.')
 
 P = ParamSpec("P")
 
@@ -33,6 +43,11 @@ def login_required(f:Callable[Concatenate["MainShell", P], None]) -> Callable[Co
         return f(self, *args, **kwargs)
     return wrapper
 
+def clear_terminal():
+    """Clears the terminal screen based on the OS."""
+    # os.name is 'nt' for Windows, 'posix' for Mac/Linux
+    os.system('cls' if os.name == 'nt' else 'clear')
+
 console = Console()
 
 class PropertyCLI(cmd.Cmd):
@@ -48,7 +63,7 @@ class PropertyCLI(cmd.Cmd):
     def do_get_extensions(self, arg):
         """Get all extensions in the property and list them."""
         parser = argparse.ArgumentParser(prog='get_extensions', add_help=True)
-        parser.add_argument("-s", "--save", help="Boolean. Save extensions to a CSV file. Default False. Possible values: True, False", type=bool, default=False)
+        parser.add_argument("-s", "--save", help="Boolean. Save extensions to a CSV file. Default False. Possible values: True, False", type=str2bool,  nargs="?", const=True, default=False)
         try:
             args = parser.parse_args(shlex.split(arg))
             extensions = self.property.getExtensions()
@@ -82,7 +97,7 @@ class PropertyCLI(cmd.Cmd):
         """Get details for a specific extension by name."""
         parser = argparse.ArgumentParser(prog='get_extension', add_help=True)
         parser.add_argument("name", help="Name of the extension to get details for", type=str)
-        parser.add_argument("-s", "--save", help="Boolean. Save extension details to a JSON file. Default False. Possible values: True, False", type=bool, default=False)
+        parser.add_argument("-s", "--save", help="Boolean. Save extension details to a JSON file. Default False. Possible values: True, False", type=str2bool, nargs="?", const=True, default=False)
         try:
             args = parser.parse_args(shlex.split(args))
             extensions = self.property.getExtensions()
@@ -107,7 +122,7 @@ class PropertyCLI(cmd.Cmd):
         """Get all rules for the property."""
         parser = argparse.ArgumentParser(prog='get_rules', add_help=True)
         parser.add_argument("-n", "--name", help="Filter rules by name (partial match, non-case sensitive)", type=str, default=None)
-        parser.add_argument("-s", "--save", help="Boolean. Save rules to a CSV file. Default False. Possible values: True, False", type=bool, default=False)
+        parser.add_argument("-s", "--save", help="Boolean. Save rules to a CSV file. Default False. Possible values: True, False", type=str2bool, nargs="?", const=True, default=False)
         try:
             args = parser.parse_args(shlex.split(arg))
             rules = self.property.getRules()
@@ -143,7 +158,7 @@ class PropertyCLI(cmd.Cmd):
         parser = argparse.ArgumentParser(prog='get_rule', add_help=True)
         parser.add_argument("-n", "--name", help="Name of the rule to get details for", type=str)
         parser.add_argument("-id", "--id", help="ID of the rule to get details for (overrides name if both provided)", type=str)
-        parser.add_argument("-s", "--save", help="Boolean. Save rule details to a JSON file. Default False. Possible values: True, False", type=bool, default=False)
+        parser.add_argument("-s", "--save", help="Boolean. Save rule details to a JSON file. Default False. Possible values: True, False", type=str2bool, nargs="?", const=True, default=False)
         try:
             args = parser.parse_args(shlex.split(arg))
             if self.rules is None:
@@ -180,7 +195,7 @@ class PropertyCLI(cmd.Cmd):
         parser = argparse.ArgumentParser(prog='get_rules_components', add_help=True)
         parser.add_argument("-rn", "--rule_name", help="(Partial) Name of the rule to get components for", type=str,default=None)
         parser.add_argument("-rid", "--rule_id", help="ID of the rule to get components for (overrides rule_name if both provided)", type=str, default=None)
-        parser.add_argument("-s", "--save", help="Boolean. Save components to a CSV file. Default False. Possible values: True, False", type=bool, default=False)
+        parser.add_argument("-s", "--save", help="Boolean. Save components to a CSV file. Default False. Possible values: True, False", type=str2bool, nargs="?", const=True, default=False)
         try:
             args = parser.parse_args(shlex.split(arg))
             if self.rules_components is None:
@@ -244,7 +259,7 @@ class PropertyCLI(cmd.Cmd):
         parser = argparse.ArgumentParser(prog='get_rule_components', add_help=True)
         parser.add_argument("-rn", "--rule_name", help="(Partial) Name of the rule to get components for", type=str, default=None)
         parser.add_argument("-rid", "--rule_id", help="ID of the rule to get components for (overrides rule_name if both provided)", type=str, default=None)
-        parser.add_argument("-s", "--save", help="Boolean. Save components to a JSON file. Default False. Possible values: True, False", type=bool, default=False)
+        parser.add_argument("-s", "--save", help="Boolean. Save components to a JSON file. Default False. Possible values: True, False", type=str2bool, nargs="?", const=True, default=False)
         try:
             args = parser.parse_args(shlex.split(arg))
             rule = None ## fallback
@@ -285,7 +300,7 @@ class PropertyCLI(cmd.Cmd):
         """Get all data elements, or only the ones matching a name filter, for the property. Can save them in CSV file."""
         parser = argparse.ArgumentParser(prog='get_data_elements', add_help=True)
         parser.add_argument("-n", "--name", help="Filter data elements by name (partial match, non-case sensitive)", type=str, default=None)
-        parser.add_argument("-s", "--save", help="Boolean. Save data elements to a CSV file. Default False. Possible values: True, False", type=bool, default=False)
+        parser.add_argument("-s", "--save", help="Boolean. Save data elements to a CSV file. Default False. Possible values: True, False", type=str2bool, nargs="?", const=True, default=False)
         try:
             args = parser.parse_args(shlex.split(args))
             des = self.property.getDataElements()
@@ -320,7 +335,7 @@ class PropertyCLI(cmd.Cmd):
         """Get details for a specific data element by name."""
         parser = argparse.ArgumentParser(prog='get_data_element', add_help=True)
         parser.add_argument("name", help="Name of the data element to get details for", type=str)
-        parser.add_argument("-s", "--save", help="Boolean. Save data element details to a JSON file. Default False. Possible values: True, False", type=bool, default=False)
+        parser.add_argument("-s", "--save", help="Boolean. Save data element details to a JSON file. Default False. Possible values: True, False", type=str2bool, nargs="?", const=True, default=False)
         try:
             args = parser.parse_args(shlex.split(args))
             if self.data_elements is None:
@@ -349,7 +364,7 @@ class PropertyCLI(cmd.Cmd):
         parser = argparse.ArgumentParser(prog='get_latest_published_version', add_help=True)
         parser.add_argument("-n", "--name", help="Name of the component to get the latest published version for", type=str, default=None)
         parser.add_argument("-t", "--type", help="Type of the component (e.g. 'rule', 'data_element', 'extension') to get the latest published version for. Default None", type=str, default=None)
-        parser.add_argument("-s", "--save", help="Boolean. Save the latest published version details to a JSON file. Default False. Possible values: True, False", type=bool, default=False)
+        parser.add_argument("-s", "--save", help="Boolean. Save the latest published version details to a JSON file. Default False. Possible values: True, False", type=str2bool,  nargs="?", const=True, default=False)
         try:
             args = parser.parse_args(shlex.split(arg))
             if args.type and args.name is None:
@@ -419,7 +434,7 @@ class PropertyCLI(cmd.Cmd):
     def do_get_libraries(self, arg: Any):
         """Get all libraries for the property."""
         parser = argparse.ArgumentParser(prog='get_libraries', add_help=True)
-        parser.add_argument("-s", "--save", help="Boolean. Save libraries to a CSV file. Default False. Possible values: True, False", type=bool, default=False)
+        parser.add_argument("-s", "--save", help="Boolean. Save libraries to a CSV file. Default False. Possible values: True, False", type=str2bool, nargs="?", const=True, default=False)
         parser.add_argument("-st", "--state", help="Filter by library state. Possible values: 'development' (default), 'submitted', 'approved', 'rejected', 'published'", type=str, default="development")
         try:
             args = parser.parse_args(shlex.split(arg))
@@ -507,6 +522,10 @@ class PropertyCLI(cmd.Cmd):
         except SystemExit:
             return
     
+    def do_clear(self, arg) -> None:
+        """Clear the terminal screen."""
+        clear_terminal()
+
     def do_exit(self, arg):
         """Return to the main menu."""
         console.print(Panel("Returning to main menu..."),style="blue")
@@ -529,7 +548,7 @@ class SynchronizerCLI(cmd.Cmd):
         parser = argparse.ArgumentParser(prog='check_component', add_help=True)
         parser.add_argument("-n", "--name", help="Name of the component to check", type=str)
         parser.add_argument("-id", "--id", help="ID of the component to check (overrides name if both provided)", type=str)
-        parser.add_argument("-p", "--published", help="Boolean. Check the latest published version of the component instead of the current version. Default False. Possible values: True, False", type=bool, default=False)
+        parser.add_argument("-p", "--published", help="Boolean. Check the latest published version of the component instead of the current version. Default False. Possible values: True, False", type=str2bool,  nargs="?", const=True, default=False)
         try:
             args = parser.parse_args(shlex.split(ars))
             if args.id is not None:
@@ -548,14 +567,14 @@ class SynchronizerCLI(cmd.Cmd):
         parser = argparse.ArgumentParser(prog='sync', add_help=True)
         parser.add_argument("-n", "--name", help="Name of the component to sync", type=str)
         parser.add_argument("-id", "--id", help="ID of the component to sync (overrides name if both provided)", type=str)
-        parser.add_argument("-p", "--published", help="Boolean. Sync the latest published version of the component instead of the current version. Default False. Possible values: True, False", type=bool, default=False)
-        parser.add_argument("-f", "--force", help="Boolean. Create the component if it does not exist. Default True. Possible values: True, False", type=bool, default=True)
+        parser.add_argument("-p", "--published", help="Boolean. Sync the latest published version of the component instead of the current version. Default False. Possible values: True, False", type=str2bool,  nargs="?", const=True, default=False)
+        parser.add_argument("-c", "--create", help="Boolean. Create the component if it does not exist. Default True. Possible values: True, False", type=str2bool, default=True)
         try:
             args = parser.parse_args(shlex.split(args))
             if args.id is not None:
-                result = self.synchronizer.syncComponent(componentId=args.id, publishedVersion=args.published, forceCreation=args.force)
+                result = self.synchronizer.syncComponent(componentId=args.id, publishedVersion=args.published, forceCreation=args.create)
             else:
-                result = self.synchronizer.syncComponent(componentName=args.name, publishedVersion=args.published, forceCreation=args.force)
+                result = self.synchronizer.syncComponent(componentName=args.name, publishedVersion=args.published, forceCreation=args.create)
             console.print(f"Component '{args.name or args.id}' synced successfully.", style="green")
         except Exception as e:
             console.print(f"(!) Error: {str(e)}", style="red")
@@ -741,12 +760,22 @@ class SynchronizerCLI(cmd.Cmd):
             return
 
     def do_sync_from_library(self,args:Any):
-        """Sync all components from a base library in the source property to the destination properties. Rules and data elements will be the latest published one"""
+        """Sync all components from a base library in the source property to the destination properties. 
+        Rules and data elements will be the library version by default. Can be changed with --ll parameter."""
         parser = argparse.ArgumentParser(prog='sync_from_library', add_help=True)
         parser.add_argument("-n", "--name", help="Name of the library to sync from", type=str)
         parser.add_argument("-id", "--id", help="ID of the library to sync from (overrides name if both provided)", type=str)
+        parser.add_argument("-c", "--create", help="Boolean. Create the component if it does not exist. Default True. Possible values: True, False", type=str2bool, default=False)
+        parser.add_argument("-ll", "--library_linked", help="Boolean. Whether to use library linked components or not. If set to True, the sync will be done using the library linked components. If set to False, the sync will be done using the component IDs in the library. Default True. Possible values: True, False", type=str2bool, default=True)
+        parser.add_argument("-p", "--published", help="Boolean. Sync the latest published version of the component instead of the current version. Default False. Possible values: True, False", type=str2bool, nargs="?", const=True, default=False,)
+        parser.add_argument("-dr", "--dry_run", help="Boolean. If set to True, will only check the sync status of the components without actually syncing them. Default False. Possible values: True, False", type=str2bool, nargs="?", const=True, default=False,)
         try:
             args = parser.parse_args(shlex.split(args))
+            publishedVersion = args.published # default False
+            libraryLinked = args.library_linked # default True
+            if args.published:
+                publishedVersion = True
+                libraryLinked = False
             if args.id is not None:
                 lib = self.synchronizer.base["api"].getLibrary(args.id, return_class=True)
             else:
@@ -756,6 +785,10 @@ class SynchronizerCLI(cmd.Cmd):
                     console.print(f"Library '{args.name}' not found in this property.", style="red")
                     return
                 lib = self.synchronizer.base["api"].getLibrary(matching_libs[0]['id'], return_class=True)
+            if args.dry_run:
+                results = self.synchronizer.__checkLibrarySync__(library=lib.id, state=lib.state, excludeSimilar=False,libraryLinked=libraryLinked,publishedVersion=publishedVersion)
+                console.print_json(json.dumps(results, indent=4))
+                return
             rules = lib.getRules()
             dataelements = lib.getDataElements()
             extensions = lib.getExtensions()
@@ -771,7 +804,11 @@ class SynchronizerCLI(cmd.Cmd):
                 console.print(f"Syncing {len(rules)} rule{'s' if len(rules) > 1 else ''} from library '{lib.name}'...", style="blue")
                 for rule in rules:
                     try:
-                        self.synchronizer.syncComponent(componentId=rule['id'], publishedVersion=True, forceCreation=True)
+                        if args.library_linked:
+                            ruleId = rule['links']['self'].split('/').pop()
+                        else:
+                            ruleId = rule['id']
+                        self.synchronizer.syncComponent(componentId=ruleId, publishedVersion=publishedVersion, forceCreation=args.create,libraryLinked=libraryLinked)
                         console.print(f"Rule '{rule['attributes']['name']}' synced successfully.", style="green")
                     except Exception as e:
                         console.print(f"(!) Error syncing rule '{rule['attributes']['name']}': {str(e)}", style="red")
@@ -779,7 +816,11 @@ class SynchronizerCLI(cmd.Cmd):
                 console.print(f"Syncing {len(dataelements)} data element{'s' if len(dataelements) > 1 else ''} from library '{lib.name}'...", style="blue")
                 for de in dataelements:
                     try:
-                        self.synchronizer.syncComponent(componentId=de['id'], publishedVersion=True, forceCreation=True)
+                        if args.library_linked:
+                            deId = de['links']['self'].split('/').pop()
+                        else:
+                            deId = de['id']
+                        self.synchronizer.syncComponent(componentId=deId, publishedVersion=publishedVersion, forceCreation=args.create,libraryLinked=libraryLinked)
                         console.print(f"Data element '{de['attributes']['name']}' synced successfully.", style="green")
                     except Exception as e:
                         console.print(f"(!) Error syncing data element '{de['attributes']['name']}': {str(e)}", style="red")
@@ -793,9 +834,13 @@ class SynchronizerCLI(cmd.Cmd):
         """Create libraries in the destination property based on the libraries in the source property that are selected for synchronization."""
         parser = argparse.ArgumentParser(prog='create_libraries', add_help=True)
         parser.add_argument("name",help="Name for the new library to be created in the destination properties", type=str)
-        parser.add_argument("-env",'--environment',help='Boolean. try to find an empty environment to build the library. Default False.',type=bool,default=False)
+        parser.add_argument("-env",'--environment',help='Set to True to try to assign an available environment. Set a string with name of an environment to set a specific environment. Default False',type=str,default=False)
         try:
             args = parser.parse_args(shlex.split(args))
+            if args.environment == "True":
+                args.environment = True
+            if args.environment == "False":
+                args.environment = False
             res = self.synchronizer.createTargetsLibrary(name=args.name,assignEnv=args.environment)
             console.print_json(json.dumps(res, indent=4))
         except Exception as e:
@@ -804,6 +849,10 @@ class SynchronizerCLI(cmd.Cmd):
         except SystemExit:
             return
 
+    def do_clear(self, arg) -> None:
+        """Clear the terminal screen."""
+        clear_terminal()
+
     def do_exit(self, arg):
         """Return to the main menu."""
         console.print(Panel("Returning to main menu...", style="blue"))
@@ -965,7 +1014,7 @@ class MainShell(cmd.Cmd):
         """List all properties available in the connected AEP instance."""
         parser = argparse.ArgumentParser(prog='get_properties', add_help=True)
         parser.add_argument("-n", "--name", help="Filter properties by name (partial match, non-case sensitive)", type=str, default=None)
-        parser.add_argument("-s", "--save", help="Boolean. Save properties to a CSV file. Default False. Possible values: True, False", type=bool, default=False)
+        parser.add_argument("-s", "--save", help="Boolean. Save properties to a CSV file. Default False. Possible values: True, False", type=str2bool, nargs="?", const=True, default=False)
         try:
             args = parser.parse_args(shlex.split(arg))
             properties = self.admin.getProperties(self.cid)
@@ -1094,7 +1143,7 @@ class MainShell(cmd.Cmd):
     def do_get_extensions(self, arg:Any) -> None:
         """List all available extensions in the connected Adobe Launch organization."""
         parser = argparse.ArgumentParser(prog='get_extensions', add_help=True)
-        parser.add_argument("-s", "--save", help="Boolean. Save extensions to a JSON file. Default False. Possible values: True, False", type=bool, default=False)
+        parser.add_argument("-s", "--save", help="Boolean. Save extensions to a JSON file. Default False. Possible values: True, False", type=str2bool, nargs="?", const=True, default=False)
         try:
             args = parser.parse_args(shlex.split(arg))
             extensions = self.admin.getExtensionsCatalogue()
@@ -1144,6 +1193,10 @@ class MainShell(cmd.Cmd):
         except SystemExit:
             return
 
+    def do_clear(self, arg:Any) -> None:
+        """Clear the terminal screen."""
+        clear_terminal()
+
     def do_exit(self, arg:Any) -> bool:
         """Exit the application."""
         console.print(Panel("Exiting...", style="blue"))

{launchpy-0.4.7.post1 → launchpy-0.4.9}/launchpy/config.py

@@ -3,9 +3,7 @@ token = ""
 config_object = {
     "org_id": "",
     "api_key": "",
-    "pathToKey": "",
     "secret": "",
-    "jwtTokenEndpoint" : "https://ims-na1.adobelogin.com/ims/exchange/jwt",
     "oauthTokenEndpointV2" : "https://ims-na1.adobelogin.com/ims/token/v2",
     "date_limit" : 0,
     "scope_admin" : "https://ims-na1.adobelogin.com/s/ent_reactor_admin_sdk",