launchpy 0.5.1__tar.gz → 0.5.3__tar.gz

launchpy-0.5.3/PKG-INFO

@@ -0,0 +1,122 @@
+Metadata-Version: 2.4
+Name: launchpy
+Version: 0.5.3
+Summary: Adobe Launch API wrapper
+Author-email: Julien Piccini <piccini.julien@gmail.com>
+License: Apache License 2.0
+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 :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+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.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas
+Requires-Dist: requests
+Requires-Dist: pathlib2
+Requires-Dist: pathlib
+Requires-Dist: aepp
+Requires-Dist: rich
+Requires-Dist: deprecated
+Requires-Dist: httpx
+Dynamic: license-file
+
+# Launchpy
+
+Python wrapper for the Adobe Launch API.\
+This module is named launchpy.
+
+Current version: **0.5.2**. This version fixes GET retries and adds automatic
+HTTP 429 retries across all five connector methods. See the
+[0.5.2 release notes](./docs/releases.md#052) for details.
+
+## Installation
+
+You can install the module by realising the following pip command:\
+`pip install launchpy`
+
+You can access the version of the module that you run via the following attribute:\
+`launchpy.__version__`
+
+## Content of the module
+
+This module is built around 7 main parts:
+
+- Helping functions [Core Components](./docs/main.md)
+- Admin instantiating functions [Admin Class](./docs/admin.md)
+- Managing properties [Property Class](./docs/property.md)
+- Managing Publishing Cycle [Library Class](./docs/library.md)
+- Translator functionationality [Translator Class](./docs/translator.md)
+- Synchronizer [Synchronizer Class](./docs/synchronizer.md)
+- Command Line Interface [CLI](./docs/cli.md)
+
+## Get Started
+
+A [get started guide](./docs/getstarted.md) has been created to explain the different functionality.
+You can find a more detail description functionalities at [datanalyst.info](https://datanalyst.info).
+
+## Main documentation
+
+Most of the documentation has been imported from the datanalyst website [here](./docs/main.md).
+
+## Release information
+
+You can find release information [here](./docs/releases.md).
+
+## Proxy support
+
+Pass a `proxy` URL to `launchpy.configure(...)`, or add `"proxy"` to
+your JSON configuration file. The same proxy serves both HTTP and HTTPS.
+Proxy settings apply to OAuth authentication,
+API requests, and asynchronous property exports, with separate settings per
+organization.
+
+```python
+launchpy.configure(
+    org_id="your-org@AdobeOrg",
+    client_id="your-client-id",
+    secret="your-secret",
+    scopes="your-scopes",
+    proxy="http://proxy.example.com:8080",
+)
+```
+
+The CLI accepts `--proxy URL` at startup and in the interactive `config`
+command. An explicit CLI proxy overrides the file setting.
+Without an explicit proxy, existing environment-based proxy behavior is unchanged.
+See the [Python and JSON examples](./docs/getstarted.md#proxy-configuration)
+and [CLI examples](./docs/cli.md#proxy-configuration).
+
+## HTTP retries
+
+The `AdobeRequest` connector always retries HTTP 429 responses for GET, POST,
+PUT, PATCH, and DELETE, even when their body is not JSON or `retry=0`.
+Rate-limit retries have no attempt limit and do not consume the configured
+`retry` budget. A request can therefore keep waiting while the API remains
+rate limited; it can be interrupted normally.
+
+The connector
+honors `Retry-After` in seconds or HTTP-date format; absent or invalid values
+use exponential backoff starting at 45 seconds and capped at 300 seconds.
+The JSON-returning methods also always retry Adobe error code `429050`.
+
+The `retry` setting is reserved for other retryable errors: currently, GET
+responses that cannot be decoded as JSON. It specifies the number of
+**additional attempts**, with a default of `0`. Set
+`property.connector.retry = 3` or pass `retry=3` to a connector method to
+override this budget; neither setting limits rate-limit retries.
+
+Successful return values are unchanged: DELETE returns the HTTP status code,
+while the other methods return decoded JSON. GET also retries invalid JSON
+responses with a 30-second delay. Invalid JSON from write operations and
+network exceptions do not trigger retries, to avoid replaying writes that
+may already have succeeded. This policy applies to the five connector methods,
+not the separate OAuth token request or async property-extraction requests.

launchpy-0.5.3/README.md

@@ -0,0 +1,91 @@
+# Launchpy
+
+Python wrapper for the Adobe Launch API.\
+This module is named launchpy.
+
+Current version: **0.5.2**. This version fixes GET retries and adds automatic
+HTTP 429 retries across all five connector methods. See the
+[0.5.2 release notes](./docs/releases.md#052) for details.
+
+## Installation
+
+You can install the module by realising the following pip command:\
+`pip install launchpy`
+
+You can access the version of the module that you run via the following attribute:\
+`launchpy.__version__`
+
+## Content of the module
+
+This module is built around 7 main parts:
+
+- Helping functions [Core Components](./docs/main.md)
+- Admin instantiating functions [Admin Class](./docs/admin.md)
+- Managing properties [Property Class](./docs/property.md)
+- Managing Publishing Cycle [Library Class](./docs/library.md)
+- Translator functionationality [Translator Class](./docs/translator.md)
+- Synchronizer [Synchronizer Class](./docs/synchronizer.md)
+- Command Line Interface [CLI](./docs/cli.md)
+
+## Get Started
+
+A [get started guide](./docs/getstarted.md) has been created to explain the different functionality.
+You can find a more detail description functionalities at [datanalyst.info](https://datanalyst.info).
+
+## Main documentation
+
+Most of the documentation has been imported from the datanalyst website [here](./docs/main.md).
+
+## Release information
+
+You can find release information [here](./docs/releases.md).
+
+## Proxy support
+
+Pass a `proxy` URL to `launchpy.configure(...)`, or add `"proxy"` to
+your JSON configuration file. The same proxy serves both HTTP and HTTPS.
+Proxy settings apply to OAuth authentication,
+API requests, and asynchronous property exports, with separate settings per
+organization.
+
+```python
+launchpy.configure(
+    org_id="your-org@AdobeOrg",
+    client_id="your-client-id",
+    secret="your-secret",
+    scopes="your-scopes",
+    proxy="http://proxy.example.com:8080",
+)
+```
+
+The CLI accepts `--proxy URL` at startup and in the interactive `config`
+command. An explicit CLI proxy overrides the file setting.
+Without an explicit proxy, existing environment-based proxy behavior is unchanged.
+See the [Python and JSON examples](./docs/getstarted.md#proxy-configuration)
+and [CLI examples](./docs/cli.md#proxy-configuration).
+
+## HTTP retries
+
+The `AdobeRequest` connector always retries HTTP 429 responses for GET, POST,
+PUT, PATCH, and DELETE, even when their body is not JSON or `retry=0`.
+Rate-limit retries have no attempt limit and do not consume the configured
+`retry` budget. A request can therefore keep waiting while the API remains
+rate limited; it can be interrupted normally.
+
+The connector
+honors `Retry-After` in seconds or HTTP-date format; absent or invalid values
+use exponential backoff starting at 45 seconds and capped at 300 seconds.
+The JSON-returning methods also always retry Adobe error code `429050`.
+
+The `retry` setting is reserved for other retryable errors: currently, GET
+responses that cannot be decoded as JSON. It specifies the number of
+**additional attempts**, with a default of `0`. Set
+`property.connector.retry = 3` or pass `retry=3` to a connector method to
+override this budget; neither setting limits rate-limit retries.
+
+Successful return values are unchanged: DELETE returns the HTTP status code,
+while the other methods return decoded JSON. GET also retries invalid JSON
+responses with a 30-second delay. Invalid JSON from write operations and
+network exceptions do not trigger retries, to avoid replaying writes that
+may already have succeeded. This policy applies to the five connector methods,
+not the separate OAuth token request or async property-extraction requests.

{launchpy-0.5.1 → launchpy-0.5.3}/docs/cli.md

@@ -10,6 +10,7 @@ This document provides an overview of the command line interface (CLI) for `laun
     - [Instantiation](#instantiation)
       - [create\_config\_file](#create_config_file)
       - [config](#config)
+      - [Proxy configuration](#proxy-configuration)
       - [change\_org](#change_org)
       - [get\_properties](#get_properties)
       - [create\_property](#create_property)
@@ -148,6 +149,7 @@ Arguments
 `-cf`,`--config_file`: The path to the config file that contains your credentials and other necessary information.
 `-p`,`--property` : The property name to be used and directly instantiated the property layer. This is an optional parameter.
 `-on`,`--org_name`: The organization name to use when your `--config_file` is a multi-org config file (see [create_config_file](#create_config_file)). This is an optional parameter, it defaults to the first organization found in the file (or `default` when using individual parameters).
+`--proxy`: Proxy URL for both HTTP and HTTPS destinations.
 
 Example via parameters:
 ```bash
@@ -195,6 +197,47 @@ launchpy:client_a>
 When in a non-multi-org environment, the prompt of the CLI will be `launchpy>`, and when in a multi-org environment, the prompt will be `launchpy:<org_name>`, where `<org_name>` is the name of the organization you are currently connected to.\
 By default, the first organization found in the multi-org config file will be used if no `--org_name` is provided. You can switch between organizations using the `change_org` command.
 
+#### Proxy configuration
+
+The single `--proxy` option works both at startup and in the interactive `config` command,
+with either a config file or individual credentials:
+
+```bash
+python -m launchpy.cli --config_file config.json --proxy http://proxy.example.com:8080
+```
+
+```text
+(Cmd) config --config_file config.json --proxy http://proxy.example.com:8080
+(Cmd) config --client_id <client_id> --secret <secret> --org_id <org_id> --scopes <scopes> --proxy http://proxy.example.com:8080
+```
+
+You can also store a single `proxy` URL in the JSON file:
+
+```json
+{
+    "org_id": "your-org@AdobeOrg",
+    "client_id": "your-client-id",
+    "secret": "your-secret",
+    "scopes": "your-scopes",
+    "proxy": "http://proxy.example.com:8080"
+}
+```
+
+The same proxy is used for both HTTP and HTTPS destinations. `--proxy` overrides
+the file's proxy URL. For multi-org files, put `proxy` in each organization's
+object; `--proxy` overrides it for every organization loaded from that file.
+`change_org` preserves each organization's effective proxy settings.
+
+The proxy covers authentication, token refresh, API calls, and property
+exports. Existing files and commands without proxy options continue to work,
+including environment-based proxy settings. Omitting `proxy` or setting it to
+`null` in JSON does not disable environment proxies. Empty strings and non-string
+values are rejected. TLS verification remains
+enabled. For URL schemes, authentication, and Python configuration examples,
+see [Proxy configuration in Getting Started](./getstarted.md#proxy-configuration).
+Avoid putting proxy credentials on a shared terminal's command line or in
+committed configuration files.
+
 #### change_org
 Switch the current CLI session to another organization that has already been loaded from a multi-org config file (via `config` or `--config_file` at startup). This avoids re-running `config` when you need to move between organizations.\
 Arguments:

{launchpy-0.5.1 → launchpy-0.5.3}/docs/getstarted.md

@@ -101,6 +101,61 @@ So your config file will look like this:
 ```
 
 
+### Proxy configuration
+
+To connect through a proxy, pass the optional `proxy` URL to `configure`.
+The same proxy is used for both HTTP and HTTPS:
+
+```python
+lp.configure(
+    org_id="your-org@AdobeOrg",
+    client_id="your-client-id",
+    secret="your-secret",
+    scopes="your-scopes",
+    proxy="http://proxy.example.com:8080",
+)
+```
+
+Alternatively, add `proxy` to your configuration JSON and load it with
+`lp.importConfigFile("myconfig.json")` as usual:
+
+```json
+{
+    "org_id": "your-org@AdobeOrg",
+    "client_id": "your-client-id",
+    "secret": "your-secret",
+    "scopes": "your-scopes",
+    "proxy": "http://proxy.example.com:8080"
+}
+```
+
+The proxy URL includes its scheme and port.
+An HTTPS destination commonly uses an `http://` proxy
+URL, which tunnels HTTPS with CONNECT; use `https://` only if the proxy itself
+requires TLS. TLS certificate verification remains enabled.
+
+For proxy authentication, use `http://username:password@proxy.example.com:8080`,
+URL-encoding special characters in the username and password. Treat files and
+command-line arguments containing proxy credentials as secrets.
+
+In a multi-org JSON file, put `proxy` inside each organization's object.
+Organizations can use different proxies, or omit the field independently.
+To override the file's proxy for every imported organization, use
+`lp.importConfigFile("myconfig.json", proxy="http://other-proxy:8080")`.
+
+The settings apply to initial OAuth token acquisition, token refresh, all API
+methods and their retries, and asynchronous rule-component downloads during
+`extractProperty`. Configure before creating `Admin`, `Property`, `Library`,
+or `Synchronizer` instances; existing connectors retain their configuration.
+Calling `configure` again without `proxy` clears the previous explicit
+proxy for that organization.
+
+Omitting `proxy` or passing `None` preserves the HTTP libraries'
+normal environment-based behavior (`HTTP_PROXY`, `HTTPS_PROXY`, `ALL_PROXY`,
+and `NO_PROXY`). This does **not** disable environment proxies.
+Empty strings and non-string proxy values are rejected.
+Existing configuration files without a proxy require no changes.
+
 ## 5. Instantiate the Admin class & get Company ID to retrieve properties
 
 Once all of these setup steps are completed, you can instantiate the `Admin` class.

{launchpy-0.5.1 → launchpy-0.5.3}/docs/main.md

@@ -37,6 +37,11 @@ launchpy.importConfigFile('myConfig.json')
 launchpy.config.config_object
 ```
 
+Configuration JSON files can include an optional `proxy` URL, independently
+for each organization in multi-org files. `importConfigFile` also accepts
+`proxy=...` to override the file's proxy for all imported organizations.
+See [Proxy configuration](./getstarted.md#proxy-configuration) for examples.
+
 ### Configure method
 
 The configure method enables you to configure the `config_object` directly from the python console with environment.\
@@ -56,6 +61,12 @@ lp.configure(
 )
 ```
 
+`configure` also accepts `proxy="http://proxy.example.com:8080"`.
+This single URL is used for both HTTP and HTTPS destinations. These settings
+apply to OAuth, API requests, and property exports. Omit the argument to retain
+normal environment-based proxy behavior; configuring an organization again
+without it clears that organization's previous explicit proxy.
+
 ## 1. The Admin class
 
 The Admin methods helps your retrieving vital information to use the API later, such as the companyId.\

{launchpy-0.5.1 → launchpy-0.5.3}/docs/releases.md

@@ -3,6 +3,29 @@
 This page gathered the changes made between version of the launchpy module.\
 This has been started after the 0.3.0 release.\
 
+## 0.5.3
+* Adding optional `proxy` support to `configure`, `importConfigFile`, `createConfigFile` and JSON configuration files. A single proxy URL is used for both HTTP and HTTPS, with separate settings per organization.
+* Applying proxy settings to OAuth token acquisition and refresh, all API requests and their retries, and asynchronous rule-component downloads during `extractProperty`.
+* Adding `--proxy` to CLI startup and the interactive `config` command. Explicit CLI and `importConfigFile` proxy arguments override file settings for all organizations loaded from the file.
+* Preserving environment-based proxy behavior when no explicit proxy is supplied. Existing configuration files require no changes; empty strings and non-string proxy values are rejected.
+* Fixing CLI configuration state and organization selection when `--org_name` is omitted. `change_org` now uses the shared connection setup and preserves each organization's proxy settings.
+* Adding proxy configuration examples and documentation for Python, JSON, and CLI usage.
+
+## 0.5.2
+* Fixing recursive GET retries and always retrying HTTP 429 responses for GET, POST, PUT, PATCH, and DELETE.
+* Respecting `Retry-After` seconds and HTTP dates, with exponential backoff when the header is absent or invalid.
+* Keeping rate-limit retries independent of the connector's `retry` budget and per-call overrides, including when `retry=0`. Other retryable errors remain bounded by that budget.
+* Preserving DELETE request bodies when sending and retrying requests.
+
+## 0.5.1
+* Raising the minimum supported Python version from 3.10 to 3.12.
+* `syncComponent` now returns a dictionary of per-target status messages. `syncComponents`, `syncRules`, `syncDataElements`, `syncExtensions`, and `syncFromLibrary` now return results grouped by component name or ID, including error messages when library synchronization fails.
+* Updating the CLI synchronization commands to report missing components instead of always reporting success. Successful per-target operations are displayed when verbose mode is enabled.
+* Adding the `-v` / `--verbose` flag to the `sync_rules`, `sync_data_elements`, and `upgrade_extension` CLI commands.
+* `checkExtensionUpdate` now raises a descriptive error when the requested extension is not installed, including the installed extension names.
+* `upgradeTargetExtension` now respects the `platform` parameter and returns per-target upgrade, already-up-to-date, or failure messages. The CLI displays upgrade failures instead of reporting success.
+* Fixing library-linked component preparation when no library component was retrieved, avoiding an uninitialized-variable error.
+
 ## 0.5.0
 * Fixing the `create_property` method in the CLI
 * Adding support for multi-org config files.

{launchpy-0.5.1 → launchpy-0.5.3}/launchpy/__init__.py

@@ -5,6 +5,7 @@ May  15 12:04:49 2019
 """
 from launchpy.__version__ import __version__
 from launchpy.configs import *
+from launchpy.configs import _validate_proxy
 from launchpy.library import Library
 from launchpy.admin import Admin
 from launchpy.property import Property
@@ -42,10 +43,13 @@ async def __extractRuleComponents__(rule: dict, client: httpx.AsyncClient, folde
                 json.dump(component, f, indent=4)
 
 # 3. Use an orchestrator instead of ThreadPoolExecutor
-async def process_all_rules(rules_list, folder, header):
+async def process_all_rules(rules_list, folder, header,
+                           proxy: str | None = None):
+    proxy = _validate_proxy(proxy)
     timeout = httpx.Timeout(10.0, read=120.0)
     limits = httpx.Limits(max_connections=100, max_keepalive_connections=50)
-    async with httpx.AsyncClient(timeout=timeout, limits=limits) as client:
+    proxy_kwargs = {"proxy": proxy} if proxy is not None else {}
+    async with httpx.AsyncClient(timeout=timeout, limits=limits, **proxy_kwargs) 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
@@ -90,7 +94,7 @@ def extractProperty(property: dict | Property, publishedVersion: bool = False,fo
             except Exception as e:
                 published_rules.append(rule)
         rules = published_rules
-    asyncio.run(process_all_rules(rules, folder, property.header))
+    asyncio.run(process_all_rules(rules, folder, property.header, property.connector.proxy))
     dataElements = property.getDataElements()
     if publishedVersion:
         published_data_elements = []

launchpy-0.5.3/launchpy/__version__.py

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

{launchpy-0.5.1 → launchpy-0.5.3}/launchpy/cli/__main__.py

@@ -1,5 +1,6 @@
 import launchpy
 from launchpy.config import config_objects, headers
+from launchpy.configs import _validate_proxy
 import argparse, cmd, shlex, json
 from functools import wraps
 from rich.console import Console
@@ -961,6 +962,7 @@ class MainShell(cmd.Cmd):
 
     def __init__(self, **kwargs:ParamSpecKwargs) -> None:
         super().__init__()
+        proxy = _validate_proxy(kwargs.get("proxy"))
         self.admin = None
         self.cid = None
         self.properties = None
@@ -988,12 +990,13 @@ class MainShell(cmd.Cmd):
             with open(config_path, "rb") as f:
                 dict_config = json.load(f)
             if type(dict_config) == dict:
-                config_key = kwargs.get("org_name", "default")
+                config_key = kwargs.get("org_name") or "default"
                 self.config = {config_key: deepcopy(self.config_template)}
                 self.config[config_key]['secret'] = dict_config.get("secret", kwargs.get("secret"))
                 self.config[config_key]['org_id'] = dict_config.get("org_id", kwargs.get("org_id"))
                 self.config[config_key]['client_id'] = dict_config.get("client_id", dict_config.get("api_key", kwargs.get("client_id", kwargs.get("api_key"))))
                 self.config[config_key]['scopes'] = dict_config.get("scopes", kwargs.get("scopes"))
+                self.config[config_key]['proxy'] = proxy if proxy is not None else _validate_proxy(dict_config.get("proxy"))
                 config_objects.update(self.config)
             elif type(dict_config) == list:
                 self.config = {}
@@ -1007,15 +1010,17 @@ class MainShell(cmd.Cmd):
                     self.config[config_key]['org_id'] = config.get("org_id", kwargs.get("org_id"))
                     self.config[config_key]['client_id'] = config.get("client_id", config.get("api_key", kwargs.get("client_id", kwargs.get("api_key"))))
                     self.config[config_key]['scopes'] = config.get("scopes", kwargs.get("scopes"))
+                    self.config[config_key]['proxy'] = proxy if proxy is not None else _validate_proxy(config.get("proxy"))
                 config_objects.update(self.config)
                 config_key = dict_config[0].get("org_name", "default")
         else:
-            config_key = kwargs.get("org_name", "default")
+            config_key = kwargs.get("org_name") or "default"
             self.config = {config_key: deepcopy(self.config_template)}
             self.config[config_key]['secret'] = kwargs.get("secret")
             self.config[config_key]['org_id'] = kwargs.get("org_id")
             self.config[config_key]['client_id'] = kwargs.get("client_id",kwargs.get("api_key"))
             self.config[config_key]['scopes'] = kwargs.get("scopes")
+            self.config[config_key]['proxy'] = proxy
             config_objects.update(self.config)
         if self.config[config_key]['secret'] is not None and self.config[config_key]['org_id'] is not None and self.config[config_key]['client_id'] is not None and self.config[config_key]['scopes'] is not None:
             myheaders = {}
@@ -1024,7 +1029,7 @@ class MainShell(cmd.Cmd):
                 myheaders[org_name]["x-gw-ims-org-id"] = config['org_id']
                 myheaders[org_name]["x-api-key"] = config['client_id']
             headers.update(myheaders)
-            config_key = kwargs.get("org_name", config_key)
+            config_key = kwargs.get("org_name") or config_key
             console.print("Configuring connection...", style="blue")
             self._configure_connection(config_key)
             if kwargs.get("property") is not None:
@@ -1051,13 +1056,15 @@ class MainShell(cmd.Cmd):
         else:
             config_key = list(self.config.keys())[0]
         self.org_name = config_key
-        self.config = launchpy.configure(
+        launchpy.configure(
             secret=config_objects[config_key]['secret'],
             org_id=config_objects[config_key]['org_id'],
             client_id=config_objects[config_key]['client_id'],
             scopes=config_objects[config_key]['scopes'],
-            org_name=config_key
+            org_name=config_key,
+            proxy=config_objects[config_key].get("proxy")
         )
+        self.config = config_objects
         self.admin = launchpy.Admin(org_name=config_key)
         self.cid = self.admin.getCompanyId()
         if config_key == 'default' or config_key is None:
@@ -1075,16 +1082,7 @@ class MainShell(cmd.Cmd):
             if org_name not in config_objects.keys():
                 console.print(f"(!) Error: Organization '{org_name}' not found in the configuration.", style="red")
                 return
-            self.config = launchpy.configure(
-                secret=config_objects[org_name]['secret'],
-                org_id=config_objects[org_name]['org_id'],
-                client_id=config_objects[org_name]['client_id'],
-                scopes=config_objects[org_name]['scopes'],
-                org_name=org_name
-            )
-            self.admin = launchpy.Admin(org_name=org_name)
-            self.cid = self.admin.getCompanyId()
-            self.prompt = f"launchpy:{org_name}> "
+            self._configure_connection(org_name)
             console.print(f"Switched to organization '{org_name}'.", style="green")
         except Exception as e:
             console.print(f"(!) Error: {str(e)}", style="red")
@@ -1097,10 +1095,11 @@ class MainShell(cmd.Cmd):
         parser = argparse.ArgumentParser(prog='create_config_file', add_help=True)
         parser.add_argument("-fn", "--file_name", help="file name for your config file", default="launchpy_config.json",type=str)
         parser.add_argument("-m","--multi_org", help="Enable multi-org configuration", action="store_true", default=False)
+        parser.add_argument("-p","--proxy", help="Enable proxy for the connection", action="store_true", default=False) 
         try:
             args = parser.parse_args(shlex.split(arg))
             filename = args.file_name
-            launchpy.createConfigFile(filename=filename,multi_org=args.multi_org)
+            launchpy.createConfigFile(filename=filename,proxy=args.proxy,multi_org=args.multi_org)
             filename_json = filename + ".json" if not filename.endswith(".json") else filename
             console.print(f"Configuration file created at {Path.cwd() / Path(filename_json)}", style="green")
             return
@@ -1121,8 +1120,10 @@ class MainShell(cmd.Cmd):
         parser.add_argument("-cf", "--config_file", help="Path to config file", default=None)
         parser.add_argument("-p", "--property", help="Property Name to auto-load on startup", default=None)
         parser.add_argument("-on", "--org_name", help="Organization Name to use from config file", default=None)
+        parser.add_argument("--proxy", help="Proxy URL for both HTTP and HTTPS")
         try:
             args = parser.parse_args(shlex.split(arg))
+            proxy = _validate_proxy(args.proxy)
             if args.config_file is not None:
                 config_path = Path(args.config_file)
                 if not config_path.is_absolute():
@@ -1136,6 +1137,7 @@ class MainShell(cmd.Cmd):
                     self.config[config_key]['org_id'] = dict_config.get("org_id", args.org_id)
                     self.config[config_key]['client_id'] = dict_config.get("client_id", dict_config.get("api_key", args.client_id))
                     self.config[config_key]['scopes'] = dict_config.get("scopes", args.scopes)
+                    self.config[config_key]['proxy'] = proxy if proxy is not None else _validate_proxy(dict_config.get("proxy"))
                     config_objects.update(self.config)
                 elif type(dict_config) == list:
                     self.config = {}
@@ -1149,6 +1151,7 @@ class MainShell(cmd.Cmd):
                         self.config[config_key]['org_id'] = config.get("org_id", args.org_id)
                         self.config[config_key]['client_id'] = config.get("client_id", config.get("api_key", args.client_id))
                         self.config[config_key]['scopes'] = config.get("scopes", args.scopes)
+                        self.config[config_key]['proxy'] = proxy if proxy is not None else _validate_proxy(config.get("proxy"))
                     config_objects.update(self.config)
                     config_key = dict_config[0].get("org_name")
             else:
@@ -1160,6 +1163,7 @@ class MainShell(cmd.Cmd):
                 if args.org_id: self.config[config_key]['org_id'] = str(args.org_id)
                 if args.scopes: self.config[config_key]['scopes'] = str(args.scopes)
                 if args.client_id: self.config[config_key]['client_id'] = str(args.client_id)
+                self.config[config_key]['proxy'] = proxy
                 config_objects.update(self.config)
             missing = [
                 key for key, value in {
@@ -1423,6 +1427,7 @@ def main():
     parser.add_argument("-cf", "--config_file", help="Path to config file", default=None)
     parser.add_argument("-p", "--property", help="Property Name to auto-load on startup", default=None)
     parser.add_argument("-on", "--org_name", help="Organization Name to use from config file", default=None)
+    parser.add_argument("--proxy", help="Proxy URL for both HTTP and HTTPS")
     args = parser.parse_args() 
     shell = MainShell(**vars(args))
     try: