launchpy 0.4.7.post1__tar.gz → 0.4.8__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: launchpy
-Version: 0.4.7.post1
+Version: 0.4.8
 Summary: Adobe Launch API wrapper
 Author-email: Julien Piccini <piccini.julien@gmail.com>
 License: Apache License 2.0
@@ -8,26 +8,26 @@ 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
 Dynamic: license-file
 
 # Launchpy

{launchpy-0.4.7.post1 → launchpy-0.4.8}/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.
+* `-f`, `--force`: Boolean. Create the component if it does not exist. Default True. 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.8}/docs/releases.md

@@ -3,8 +3,16 @@
 This page gathered the changes made between version of the launchpy module.\
 This has been started after the 0.3.0 release.\
 
+## 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.8}/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"
+* force : 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: `True`.
+* 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.8}/launchpy/__init__.py

@@ -48,7 +48,6 @@ 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)
 

launchpy-0.4.8/launchpy/__version__.py

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

{launchpy-0.4.7.post1 → launchpy-0.4.8}/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,8 +567,8 @@ 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("-f", "--force", 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:
@@ -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("-f", "--force", help="Boolean. Create the component if it does not exist. Default True. Possible values: True, False", type=str2bool, default=True)
+        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=str, 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.force,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.force,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.8}/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",

{launchpy-0.4.7.post1 → launchpy-0.4.8}/launchpy/configs.py

@@ -1,7 +1,7 @@
 import json, os
 from pathlib import Path
 from typing import Optional
-from .config import config_object, header
+from launchpy.config import config_object, header
 
 def find_path(path: str) -> Optional[Path]:
     """Checks if the file denoted by the specified `path` exists and returns the Path object
@@ -30,7 +30,7 @@ def createConfigFile(filename:str='config_launch',auth_type: str = "oauthV2", sc
             scope="https://ims-na1.adobelogin.com/s/ent_reactor_admin_sdk"
             or 
             scope="https://ims-na1.adobelogin.com/s/ent_reactor_sdk"
-        auth_type : OPTIONAL : The type of Oauth type you want to use for your config file. Possible value: "jwt" or "oauthV2"
+        auth_type : OPTIONAL : The type of Oauth type you want to use for your config file. Possible value: "oauthV2"
     """
     json_data = {
         'org_id': '<orgID>',
@@ -39,10 +39,6 @@ def createConfigFile(filename:str='config_launch',auth_type: str = "oauthV2", sc
     }
     if auth_type == 'oauthV2':
         json_data['scopes'] = "<scopes>"
-    elif auth_type == 'jwt':
-        json_data["tech_id"] = "<something>@techacct.adobe.com"
-        json_data["pathToKey"] = "<path/to/your/privatekey.key>"
-        json_data['scope'] = scope
     if '.json' not in filename:
         filename = f"{filename}.json"
     with open(filename, 'w') as cf:
@@ -84,8 +80,6 @@ def importConfigFile(path: str = None,auth_type:str=None) -> None:
         if auth_type is None:
             if 'scopes' in provided_keys:
                 auth_type = 'oauthV2'
-            elif 'tech_id' in provided_keys and "pathToKey" in provided_keys:
-                auth_type = 'jwt'
         args = {
             "org_id" : provided_config['org_id'],
             "secret" : provided_config['secret'],
@@ -94,9 +88,6 @@ def importConfigFile(path: str = None,auth_type:str=None) -> None:
         }
         if auth_type == 'oauthV2':
             args["scopes"] = provided_config["scopes"].replace(' ','')
-        if auth_type == 'jwt':
-            args["tech_id"] = provided_config["tech_id"]
-            args["path_to_key"] = provided_config["pathToKey"]
         configure(**args)
 
 
@@ -129,19 +120,17 @@ def configure(org_id: str = None,
               tech_id: str = None,
               secret: str = None,
               client_id: str = None,
-              path_to_key: str=None,
-              private_key: str = None,
               scopes : str= None,
               scope: str="https://ims-na1.adobelogin.com/s/ent_reactor_admin_sdk",
+              **kwargs
               ):
     """Performs programmatic configuration of the API using provided values.
     Arguments:
         org_id : REQUIRED : Organization ID
         tech_id : REQUIRED : Technical Account ID
         secret : REQUIRED : secret generated for your connection
-        client_id : REQUIRED : The client_id (old api_key) provided by the JWT connection. 
-        path_to_key : REQUIRED : If you have a file containing your private key value.
-        private_key : REQUIRED : If you do not use a file but pass a variable directly.
+        client_id : REQUIRED : The client_id (old api_key) provided by the Adobe Project. 
+        scopes : REQUIRED : The scopes required for the Oauth connection
         scope : OPTIONAL : Scope that is needed for JWT auth.
             Possible scope: https://www.adobe.io/authentication/auth-methods.html#!AdobeDocs/adobeio-auth/master/JWT/Scopes.md
     """
@@ -149,37 +138,18 @@ def configure(org_id: str = None,
         raise ValueError("`org_id` must be specified in the configuration.")
     if not client_id:
         raise ValueError("`client_id` must be specified in the configuration.")
-    if not tech_id and not scopes:
-        raise ValueError("`tech_id` must be specified in the configuration.")
+    if not scopes:
+        raise ValueError("`scopes` must be specified in the configuration.")
     if not secret:
         raise ValueError("`secret` must be specified in the configuration.")
-    if not path_to_key and not private_key and not scopes:
-        raise ValueError("`scopes` must be specified if Oauth setup.\n `pathToKey` or `private_key` must be specified in the configuration if JWT setup.")
     config_object["org_id"] = org_id
     header["x-gw-ims-org-id"] = org_id
     config_object["client_id"] = client_id
     header["x-api-key"] = client_id
     config_object["tech_id"] = tech_id
     config_object["secret"] = secret
-    config_object["pathToKey"] = path_to_key
-    config_object["private_key"] = private_key
     config_object["official_scope"] = scope
     config_object["scopes"] = scopes
     # ensure the reset of the state by overwriting possible values from previous import.
     config_object["date_limit"] = 0
     config_object["token"] = ""
-
-
-def get_private_key_from_config(config: dict) -> str:
-    """
-    Returns the private key directly or read a file to return the private key.
-    """
-    private_key = config.get('private_key')
-    if private_key is not None:
-        return private_key
-    private_key_path = find_path(config['pathToKey'])
-    if private_key_path is None:
-        raise FileNotFoundError(f'Unable to find the private key under path `{config["pathToKey"]}`.')
-    with open(Path(private_key_path), 'r') as f:
-        private_key = f.read()
-    return private_key

{launchpy-0.4.7.post1 → launchpy-0.4.8}/launchpy/connector.py

@@ -85,8 +85,6 @@ class AdobeRequest:
         if now > self.config['date_limit']:
             if self.connectionType =='oauthV2':
                 token_and_expiry = self.get_oauth_token_and_expiry_for_config(config=self.config)
-            elif self.connectionType == 'jwt':
-                token_and_expiry = self.get_jwt_token_and_expiry_for_config(config=self.config)
             token = token_and_expiry['token']
             self.config['token'] = deepcopy(token)
             self.config['date_limit'] = deepcopy(time.time() + token_and_expiry['expiry'] - 500)

{launchpy-0.4.7.post1 → launchpy-0.4.8}/launchpy/library.py

@@ -2,6 +2,8 @@ import time
 # Non standard libraries
 from launchpy import config, connector
 from typing import Union
+from copy import deepcopy
+import json
 
 class Library:
     """
@@ -26,6 +28,7 @@ class Library:
         self.name = data['attributes']['name']
         self.state = data['attributes']['state']
         self.build_required = data['attributes']['build_required']
+        self.definition = deepcopy(data)
         self._DataElements = config.endpoints['global'] + \
             '/libraries/'+data['id']+'/data_elements'
         self._Extensions = config.endpoints['global'] + \
@@ -40,6 +43,12 @@ class Library:
         self.relationships = {}
         self._environments = {}
         self._dev_env = ''
+    
+    def __str__(self):
+        return json.dumps(self.definition, indent=4)
+    
+    def __repr__(self):
+        return json.dumps(self.definition, indent=4)
 
     def getDataElements(self,page:int=0,pageSize:int=50,origin:bool=True)->list:
         """
@@ -355,13 +364,24 @@ class Library:
         res = self._setEnvironment(obj,verbose=verbose)
         return res
 
-    def _removeEnvironment(self)->None:
+    def removeEnvironment(self)->None:
         """
         Remove environment
         """
-        path = f'/libraries/{self.id}/relationships/environment'
-        new_env = self.connector.getData(self.endpoint+path) 
-        return new_env
+        path = f'/libraries/{self.id}'
+        data = {
+            "data": {
+                "id": self.id,
+                "type": "libraries",
+                "relationships": {
+                    "environment": {
+                        "data": None
+                    }
+                }
+            }
+        }
+        res = self.connector.patchData(self.endpoint+path, data=data) 
+        return res
 
     def updateLibrary(self,empty:bool=False)->dict:
         """
@@ -418,7 +438,6 @@ class Library:
                     "type": "environments"
                 }
             }
-            self._removeEnvironment()
             status = self._setEnvironment(obj,verbose=verbose)
         elif self.state == 'submitted':
             env = 'staging'
@@ -428,7 +447,6 @@ class Library:
                     "type": "environments"
                 }
             }
-            self._removeEnvironment()
             status = self._setEnvironment(obj,verbose=verbose)
         elif self.state == 'approved':
             env = 'production'
@@ -438,7 +456,6 @@ class Library:
                     "type": "environments"
                 }
             }
-            self._removeEnvironment()
             status = self._setEnvironment(obj,verbose=verbose)
         if 'error' in status.keys():
             raise SystemExit('Issue setting environment')

{launchpy-0.4.7.post1 → launchpy-0.4.8}/launchpy/property.py

@@ -1334,6 +1334,16 @@ class Property:
         envs = self.getEnvironments()
         staging = [env for env in envs if env['attributes']['stage'] == 'staging'][0]
         return staging['meta']['script_sources'][0]["license_path"]
+    
+    def getEnvironmentLibrary(self,env_id:str)->dict:
+        """
+        Returns the library URL to use on the website for a specific environment.
+        Arguments:
+            env_id : REQUIRED : Environment ID
+        """
+        path = f"/environments/{env_id}/library"
+        res = self.connector.getData('https://reactor.adobe.io'+path)
+        return res.get('data',{})
 
 def extensionsInfo(data: list)->dict:
     """

{launchpy-0.4.7.post1 → launchpy-0.4.8}/launchpy/synchronizer.py

@@ -1,10 +1,9 @@
 import re,json
 # Non standard libraries
-from .admin import Admin
-from .property import Property
-from .library import Library
-from .launchpy import Translator, copySettings
-from collections import defaultdict
+from launchpy.admin import Admin
+from launchpy.property import Property
+from launchpy.library import Library
+from launchpy.launchpy import Translator, copySettings
 from copy import deepcopy
 from aepp import som
 
@@ -126,31 +125,52 @@ class Synchronizer:
                             'inclComponents': deepcopy(self.dict_config[rule]['inclComponents'])
                         }
     
-    def __prepareBaseComponent__(self,componentName:str=None,componentId:str=None,publishedVersion:bool=False)->dict:
+    def __prepareBaseComponent__(self,componentName:str=None,componentId:str=None,publishedVersion:bool=False,**kwargs)->dict:
         """
         Prepare the base component to be used in the syncComponent method.
         Arguments:
             componentName : REQUIRED : the name of the component to sync
             componentID : REQUIRED : the id of the component to sync
             publishedVersion : OPTIONAL : if you want to take the version that has been published
+        kwargs: 
+            libraryLinked : OPTIONAL : If you want to pass ID that are associated to a specific library. Default: False
         """
         cmp_base=None
+        componentBase = None
         if componentId is not None:
             if componentId.startswith('DE'): ## if data element
+                if kwargs.get('libraryLinked',False):
+                    lib_cmp_base = self.base['api'].getDataElement(componentId)
+                    if lib_cmp_base is None:
+                         raise KeyError("Component ID cannot be found")
+                    componentId = lib_cmp_base['links']['origin'].split('/').pop()
                 componentBase = [de for de in self.base['dataElements'] if de['id'] == componentId]
                 if len(componentBase)==0:
                     raise KeyError("Component ID cannot be found")
-                cmp_base = componentBase[0]
+                if type(componentBase) == list and len(componentBase)>0:
+                    cmp_base = componentBase[0]
             elif componentId.startswith('RL'): ## if a rule
+                if kwargs.get('libraryLinked',False):
+                    lib_cmp_base = self.base['api'].getRule(componentId)
+                    if lib_cmp_base is None:
+                         raise KeyError("Component ID cannot be found")
+                    componentId = lib_cmp_base['links']['origin'].split('/').pop()
                 componentBase = [de for de in self.base['rules'] if de['id'] == componentId]
                 if len(componentBase)==0:
                     raise KeyError("Component ID cannot be found")
-                cmp_base = componentBase[0]
+                if type(componentBase) == list and len(componentBase)>0:
+                    cmp_base = componentBase[0]
             elif componentId.startswith('EX'): ## if an extension
+                if kwargs.get('libraryLinked',False):
+                    lib_cmp_base = self.base['api'].getExtension(componentId)
+                    if lib_cmp_base is None:
+                         raise KeyError("Component ID cannot be found")
+                    componentId = lib_cmp_base['links']['origin'].split('/').pop()
                 componentBase = [ext for ext in self.base['extensions'] if ext['id'] == componentId]
                 if len(componentBase)==0:
-                    raise KeyError("Component ID cannot be found")
-                cmp_base = componentBase[0]
+                        raise KeyError("Component ID cannot be found")
+                if type(componentBase) == list and len(componentBase)>0:
+                    cmp_base = componentBase[0]
         if componentId is None and componentName is not None: ## If only componentName
             for rule in self.base['rules']:
                 if componentName == rule['attributes']['name']:
@@ -174,7 +194,7 @@ class Synchronizer:
             data = self.base['api'].getRevisions(cmp_baseDict['component'])
             publishedVersion = self.base['api'].getLatestPublishedVersion(data) 
             if publishedVersion['attributes']['name'] != cmp_baseDict['name']:
-                ## Updating mapping table with old name when published version name diff than last versio name.
+                ## Updating mapping table with old name when published version name diff than last version name.
                 if cmp_baseDict['component']['type'] == 'rules':
                     self.translator.extendBaseRules(
                     ruleName=publishedVersion['attributes']['name'],
@@ -183,10 +203,18 @@ class Synchronizer:
                     self.base['rules'].append(publishedVersion)
                 if cmp_baseDict['component']['type'] == 'data_elements':
                     self.base['dataElements'].append(publishedVersion)
-            cmp_baseDict['id'] = publishedVersion['id']
-            cmp_baseDict['name'] = publishedVersion['attributes']['name']
-            cmp_baseDict['component'] = publishedVersion
-            cmp_baseDict['copy'] = copySettings(publishedVersion)
+            cmp_baseDict = {'id':publishedVersion['id'],'name':publishedVersion['attributes']['name'],'component':publishedVersion,'copy':copySettings(publishedVersion)}
+        if kwargs.get('libraryLinked',False) and cmp_baseDict['component']['type'] in ['rules','data_elements']:
+            if lib_cmp_base['attributes']['name'] != cmp_baseDict['name']:
+                if cmp_baseDict['component']['type'] == 'rules':
+                    self.translator.extendBaseRules(
+                    ruleName=lib_cmp_base['attributes']['name'],
+                    ruleId=lib_cmp_base['id'],
+                    property_name=self.base["name"])
+                    self.base['rules'].append(lib_cmp_base)
+                if cmp_baseDict['component']['type'] == 'data_elements':
+                    self.base['dataElements'].append(lib_cmp_base)
+            cmp_baseDict = {'id':lib_cmp_base['id'],'name':lib_cmp_base['attributes']['name'],'component':lib_cmp_base,'copy':copySettings(lib_cmp_base)}
         return cmp_baseDict
 
     def syncComponent(self,componentName:str=None,componentId:str=None,publishedVersion:bool=False,forceCreation:bool=True,**kwargs)->None:
@@ -202,11 +230,13 @@ class Synchronizer:
             forceCreation : OPTIONAL : If the component does not exist in the target property, create it. Default: True
         possible kwargs:
             timeout : OPTIONAL : The timeout to be used for the rule component. If not provided, the existing timeout will be used.
+            libraryLinked : OPTIONAL : If you want to take a component ID that are associated to a specific library. Default: False. If set to True, the method will look for the component in the library and take the version linked to the library instead of the latest version in the property. Do not work for Extensions.
         """
         timeout = kwargs.get('timeout',None)
+        libraryLinked = kwargs.get('libraryLinked',False)
         if componentName is None and componentId is None:
             raise ValueError('Require a component Name of a component ID')
-        cmp_baseDict = self.__prepareBaseComponent__(componentName=componentName,componentId=componentId,publishedVersion=publishedVersion)
+        cmp_baseDict = self.__prepareBaseComponent__(componentName=componentName,componentId=componentId,publishedVersion=publishedVersion,libraryLinked=libraryLinked)
         ## handling the data element
         if cmp_baseDict['component']['type'] == 'data_elements':
             for target in list(self.targets.keys()):
@@ -369,14 +399,15 @@ class Synchronizer:
             for component in componentsId:
                 self.syncComponent(componentId=component,publishedVersion=publishedVersion)
     
-    def createTargetsLibrary(self,name:str="syncComponents",assignEnv:bool=False)->None:
+    def createTargetsLibrary(self,name:str="syncComponents",assignEnv:bool|str=False)->None:
         """
         This method will create or update a Library in all of the target properties to gather all elements changed.
         If a library exists and **contains** the same name, it will be used.
         Argument:
             name : REQUIRED : The name of the library to create. Default : "syncComponents"
-            assignEnv : REQUIRED : If you want to assign a library to an environment. By default, the library is not assigned to any environment.
+            assignEnv : REQUIRED : If you want to assign a library to an environment. 
                     If set to True, the library will be assigned to an available environment in the Target Property if available and build it.
+                    If set to a string (regex supported), the library will be assigned to the environment with the name provided if it exists, and build it. If that environment is used in a Library, it will remove that environment from the library and assign it to the new one. Default: False  
         """
         response = {target:{'libraryName':name} for target in self.targets.keys()}
         for target in list(self.targets.keys()):
@@ -410,8 +441,14 @@ class Synchronizer:
                 self.targets[target]['library'].updateExtensions(existingExtensions)
             if len(newExtensions)>0:
                 self.targets[target]['library'].addExtensions(newExtensions)
-            if assignEnv:
+            if type(assignEnv) == bool and assignEnv == True:
                 envs = self.targets[target]['api'].getEnvironments()
+                prod = [env for env in envs if env['attributes']['stage'].lower() == 'production']
+                if len(prod) == 0:
+                    prod_script = "https://assets.adobedtm.com/" ## default script source when no production environment exist, with a random id to avoid any conflict with an existing environment script source.
+                else:
+                    prod = prod[0]
+                    prod_script = prod['meta'].get('script_sources',[{}])[0].get('minified')
                 found_free_env = False
                 if len(envs)>0:
                     for env in envs:
@@ -426,10 +463,48 @@ class Synchronizer:
                     self.targets[target]['library'].setEnvironment(envId)
                     self.targets[target]['library'].build()
                     response[target]['environment'] = envName
-                    response[target]['script'] = scriptSource
+                    response[target]['script'] = {f"{target} - {self.targets[target]['library'].name}" : {
+                        "replace": prod_script,
+                        "with": scriptSource
+                    }}
+                    response[target]['build_status'] = self.targets[target]['library'].build_status
                 else:
                     response[target]['environment'] = "No free environment to assign"
                     response[target]['script'] = None
+            elif type(assignEnv) == str:
+                envs = self.targets[target]['api'].getEnvironments()
+                prod = [env for env in envs if env['attributes']['stage'].lower() == 'production']
+                if len(prod) == 0:
+                    prod_script = "https://assets.adobedtm.com/" ## default script source when no production environment exist, with a random id to avoid any conflict with an existing environment script source.
+                else:
+                    prod = prod[0]
+                    prod_script = prod['meta'].get('script_sources',[{}])[0].get('minified')
+                env = [env for env in envs if re.search(assignEnv, env['attributes']['name'], re.IGNORECASE)]
+                if len(env) == 0:
+                    response[target]['environment'] = f"No environment with the name {assignEnv} to assign"
+                    response[target]['script'] = None
+                elif len(env) == 1:
+                    env = env[0]
+                    envId = env['id']
+                    envName = env['attributes']['name']
+                    scriptSource = env['meta'].get('script_sources',[{}])[0].get('minified')
+                    libraryUsed = self.targets[target]["api"].getEnvironmentLibrary(envId)
+                    if libraryUsed is not None:
+                        print(f'Environment is already used by library "{libraryUsed["attributes"]["name"]}" in "{target}" property. Removing the environment from that library.')
+                        libraryUsedId = libraryUsed['id']
+                        tmp_lib = Library(libraryUsedId,config_object=self.targets[target]['api'].connector.config,header=self.targets[target]['api'].connector.header)
+                        tmp_lib.removeEnvironment()
+                    self.targets[target]['library'].setEnvironment(envId)
+                    self.targets[target]['library'].build()
+                    response[target]['environment'] = envName
+                    response[target]['script'] = {f"{target} - {self.targets[target]['library'].name}" : {
+                    "replace": prod_script,
+                    "with": scriptSource
+                    }}
+                    response[target]['build_status'] = self.targets[target]['library'].build_status
+                else:
+                    response[target]['environment'] = f"Multiple environment with the name {assignEnv} to assign"
+                    response[target]['script'] = None
         return response
 
 
@@ -514,25 +589,14 @@ class Synchronizer:
             action_setting_path : [str,list] : The dot notation of the paths you want to verify for the settings object. ex: ["code","customAttributes"]. If not provided, the complete settings are compared.
             condition_setting_path : [str,list] : The dot notation of the paths you want to verify for the setting object . ex: ["id",""]. If not provided, the complete settings are compared
             event_setting_path : [str,list] : The dot notation of the paths you want to verify for the setting object . ex: ["id",""]. If not provided, the complete settings are compared
+            libraryLinked : bool : If you want to pass ID that are associated to a specific library. Default: False
         """
         if componentName is None and componentId is None:
             raise ValueError('Require a component Name of a component ID')
-        cmp_baseDict = self.__prepareBaseComponent__(componentName=componentName,componentId=componentId,publishedVersion=publishedVersion)
+        cmp_baseDict = self.__prepareBaseComponent__(componentName=componentName,componentId=componentId,publishedVersion=publishedVersion,libraryLinked=kwargs.get('libraryLinked',False))
         dict_result = {tar:"" for tar in self.targets.keys()}
         dict_result['base-enabled'] = cmp_baseDict['component']['attributes'].get('enabled',False)
         dict_result['base-published'] = cmp_baseDict['component']['attributes'].get('published',False)
-        if cmp_baseDict['component']['attributes'].get('latest',False):
-            dict_result['base-state'] = "Latest"
-        else:
-            if cmp_baseDict['component']['attributes'].get('latest','unknown') == 'unknown':
-                if dict_result['base-enabled']:
-                    dict_result['base-state'] = "Draft"
-                else:
-                    dict_result['base-state'] = "Unknown"
-            elif dict_result['base-published'] == False:
-                dict_result['base-state'] = "Draft"
-            else:
-                dict_result['base-state'] = "Edited"
         if cmp_baseDict['component']['type'] == 'data_elements':
             for target in list(self.targets.keys()):
                 ## if it does not exist
@@ -675,4 +739,98 @@ class Synchronizer:
                         else:
                             if not excludeSimilar:
                                 dict_result[target] = 'Similar'+issue_pub
-        return dict_result
+        return dict_result
+    
+    def __checkLibrarySync__(self,library:str=None,state='published',excludeSimilar:bool=False,libraryLinked:bool=True,publishedVersion:bool=False)->dict:
+        """
+        Check if the components in a library, from the base property, is synced to the different target properties.
+        By default, it will compare the version of the library to the latest version in the target properties.
+        It will return a dictionary with the key being the component name and the value being the result of the evaluation, such as {componentName: {'targetProperty': 'similar'}} when library have same settings.
+        Arguments:
+            library : REQUIRED : the library name or the library ID to get the components.
+            state : OPTIONAL : the state of the library to compare. Default: 'published', possible states: "development", "submitted", "approved", "rejected", "published"
+            excludeSimilar : OPTIONAL : If you do not want to see the result if the comparison provide a "similar" result. Similar means that the elements are about the same. 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.
+        """
+        if library is None:
+            raise ValueError('Require a library Name of a library ID')
+        libraryLink = True
+        base_libraries = self.base['api'].getLibraries(state=state)
+        if library in [lib['attributes']['name'] for lib in base_libraries]:
+            base_library = [lib for lib in base_libraries if lib['attributes']['name'] == library][0]
+        elif library in [lib['id'] for lib in base_libraries]:
+            base_library = [lib for lib in base_libraries if lib['id'] == library][0]
+        else:
+            raise ValueError('The library name or ID provided does not exist in the base property')
+        myLib = Library(base_library['id'],config_object=self.base['api'].connector.config,header=self.base['api'].connector.header)
+        components = myLib.getFullLibrary()
+        rules = components['rules']
+        dataElements = components['data_elements']
+        extensions = components['extensions']
+        elements = rules + dataElements + extensions
+        if publishedVersion == True:
+            element_ids = {elem['id']: elem['attributes']['name'] for elem in elements}
+            libraryLink = False
+        elif libraryLinked == True:
+            element_ids ={elem['links']['self'].split('/').pop():elem['attributes']['name'] for elem in elements}
+        else:
+            element_ids = {elem['id']: elem['attributes']['name'] for elem in elements}
+        dict_check = {}
+        for element_id, element_name in element_ids.items():
+            dict_check[element_name] = self.checkComponentSync(componentId=element_id, excludeSimilar=excludeSimilar,publishedVersion=publishedVersion,libraryLinked=libraryLink)
+        return dict_check
+    
+    def syncFromLibrary(self,library:str=None,state='published',force:bool=True,libraryLinked:bool=True,publishedVersion:bool=False,dryRun:bool=False)->None:
+        """
+        Sync the components in a library, from the base property, to the different target properties by using the createTargetsLibrary method.
+        Arguments:
+            library : REQUIRED : the library name or the library ID to get the components.
+            state : OPTIONAL : the state of the library to compare. Default: 'published', possible states: "development", "submitted", "approved", "rejected", "published"
+            force : OPTIONAL : If set to True, it will sync the components even if they do not exist in the target properties. If set to False, it will only sync the components that already exist in the target properties. Default: True.
+            libraryLinked : OPTIONAL : If set to True, it will sync the components using the library version. Default: False.
+            publishedVersion : OPTIONAL : if you want to sync the version of the library that has been published in your base vs the published version of your target. Default: False.
+            dryRun : OPTIONAL : If set to True, it will not actually sync the components but will return a dictionary with the components that would be synced and the target properties they would be synced to. Default: False.
+        """
+        if library is None:
+            raise ValueError('Require a library Name of a library ID')
+        libs = self.base['api'].getLibraries(state=state)
+        if library in [lib['attributes']['name'] for lib in libs]:
+            libraryId = [lib for lib in libs if lib['attributes']['name'] == library][0]['id']
+        elif library in [lib['id'] for lib in libs]:
+            libraryId = [lib for lib in libs if lib['id'] == library][0]['id']
+        else:
+            raise ValueError('The library name or ID provided does not exist in the base property')
+        if dryRun:
+            return self.__checkLibrarySync__(library=library,state=state,excludeSimilar=False,libraryLinked=libraryLinked,publishedVersion=publishedVersion)
+        myLib = self.base['api'].getLibrary(libraryId,return_class=True)
+        rules = myLib.getRules()
+        dataelements = myLib.getDataElements()
+        extensions = myLib.getExtensions()
+        if len(extensions)>0:
+            for ext in extensions:
+                try:
+                    self.upgradeTargetExtension(extensionName=ext['attributes']['name'])
+                except:
+                    print(f'Extension {ext["attributes"]["name"]} could not be updated in the target properties. Please check if the extension exist and if there is an update available.')
+        if len(rules)>0:
+            for rule in rules:
+                try:
+                    if libraryLinked:
+                        ruleId = rule['links']['self'].split('/').pop()
+                    else:
+                        ruleId = rule['id']
+                    self.syncComponent(componentId=ruleId,publishedVersion=publishedVersion, forceCreation=force,libraryLinked=libraryLinked)
+                except:
+                    print(f'Rule {rule["attributes"]["name"]} could not be updated in the target properties. Please check if the rule exist.')
+        if len(dataelements)>0:
+            for de in dataelements:
+                try:
+                    if libraryLinked:
+                        deId = de['links']['self'].split('/').pop()
+                    else:
+                        deId = de['id']
+                    self.syncComponent(componentId=deId,publishedVersion=publishedVersion,forceCreation=force,libraryLinked=libraryLinked)
+                except:
+                    print(f'Data Element {de["attributes"]["name"]} could not be updated in the target properties. Please check if the data element exist.')
+        return 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: launchpy
-Version: 0.4.7.post1
+Version: 0.4.8
 Summary: Adobe Launch API wrapper
 Author-email: Julien Piccini <piccini.julien@gmail.com>
 License: Apache License 2.0
@@ -8,26 +8,26 @@ 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
 Dynamic: license-file
 
 # Launchpy

{launchpy-0.4.7.post1 → launchpy-0.4.8}/launchpy.egg-info/requires.txt

@@ -1,8 +1,7 @@
 pandas
 requests
-PyJWT
-PyJWT[crypto]
 pathlib2
 pathlib
 aepp
 rich
+deprecated

{launchpy-0.4.7.post1 → launchpy-0.4.8}/pyproject.toml

@@ -10,29 +10,29 @@ authors = [
 description = "Adobe Launch API wrapper"
 dynamic = ["version"]
 readme = "README.md"
-requires-python = ">=3.7"
+requires-python = ">=3.10"
 keywords = ["adobe", "analytics", "API", "python"]
 license = {text = "Apache License 2.0"}
 classifiers = [
     "Intended Audience :: Developers",
-    "License :: OSI Approved :: GNU General Public License v3 (GPLv3)",
+    "License :: OSI Approved :: Apache Software License",
     "Operating System :: OS Independent",
     "Programming Language :: Python",
     "Topic :: Scientific/Engineering :: Information Analysis",
-    "Programming Language :: Python :: 3.6",
-    "Programming Language :: Python :: 3.7",
-    "Programming Language :: Python :: 3.8",
-    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Development Status :: 4 - Beta"
 ]
 dependencies = ['pandas', 
                 "requests",
-                "PyJWT", 
-                 "PyJWT[crypto]",
                  "pathlib2", 
                  "pathlib",
                  "aepp",
-                 "rich",]
+                 "rich",
+                 "deprecated"]
 
 [project.urls]
 homepage = "https://github.com/pitchmuc/launchpy"

{launchpy-0.4.7.post1 → launchpy-0.4.8}/requirements.txt

@@ -1,9 +1,7 @@
 pathlib>=1.0.0
 pathlib2>=2.3.5
 requests>=2.25.0
-aepp=>0.3.10
-pandas>=2.1.0
 aepp>=0.3.12
-httpx>=0.24.0
-asyncio>=3.0.0
-rich>=14.0.0
+pandas>=2.1.0
+rich>=14.0.0
+deprecated

launchpy-0.4.7.post1/launchpy/__version__.py

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