mtn-cloud 0.3.1__tar.gz → 0.3.3__tar.gz

{mtn_cloud-0.3.1 → mtn_cloud-0.3.3}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: mtn-cloud
-Version: 0.3.1
+Version: 0.3.3
 Summary: Community Python SDK for MTN Cloud - Deploy and manage cloud resources with ease
 Project-URL: Homepage, https://github.com/mahveotm/mtn-cloud-python
 Project-URL: Documentation, https://github.com/mahveotm/mtn-cloud-python#readme
@@ -10,7 +10,7 @@ Author-email: Marvellous Osuolale <m@rvellous.com>
 Maintainer-email: Marvellous Osuolale <m@rvellous.com>
 License: MIT
 License-File: LICENSE
-Keywords: api,cloud,devops,infrastructure,mtn,mtn-cloud,sdk
+Keywords: api,cloud,cloud-management,devops,infrastructure,mtn,mtn-cloud,mtn-cloud-python,sdk
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -31,10 +31,8 @@ Requires-Dist: typing-extensions>=4.5.0
 Requires-Dist: urllib3>=2.0.0
 Provides-Extra: dev
 Requires-Dist: mypy>=1.0.0; extra == 'dev'
-Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
 Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
 Requires-Dist: pytest>=7.0.0; extra == 'dev'
-Requires-Dist: respx>=0.20.0; extra == 'dev'
 Requires-Dist: ruff>=0.1.0; extra == 'dev'
 Requires-Dist: types-requests>=2.28.0; extra == 'dev'
 Provides-Extra: docs
@@ -150,33 +148,36 @@ for plan in cloud.instances.list_service_plans(
     print(plan["id"], plan["name"])
 ```
 
-A **resource pool is required** to create an instance — it's where the VM is hosted. Discover it by group name (the cloud/zone is resolved for you), or fetch one directly by name:
+A **resource pool is required** to create an instance — it's where the VM is hosted. `provision()` (below) discovers it for you; or fetch one yourself with `cloud.instances.get_resource_pool("my-project", group="MTNNG_CLOUD_AZ_1")`.
+
+### 2. Create an Instance
+
+The guided `provision()` resolves layout, plan, and resource pool from names — the fastest path:
 
 ```python
-pool = cloud.instances.get_resource_pool(
-    "my-project-name",
-    group="MTNNG_CLOUD_AZ_1",
+instance = cloud.instances.provision(
+    name="web-01",
+    type="MTN-CS10",                # type code
+    group="MTNNG_CLOUD_AZ_1",       # also used as the cloud/zone
+    plan="G2S4",                    # plan name (or numeric id)
+    resource_pool="my-project",     # pool name; auto-selected if the group has only one
 )
-print(pool.code)   # e.g. "pool-214" — pass this as resource_pool_id
+print(instance.id, instance.status, instance.primary_ip)
 ```
 
-### 2. Create an Instance
+For full control over every ID, use `create()` directly:
 
 ```python
-pool = cloud.instances.get_resource_pool("my-project-name", group="MTNNG_CLOUD_AZ_1")
-
 instance = cloud.instances.create(
-    name="my-server",
+    name="web-01",
     cloud="MTNNG_CLOUD_AZ_1",
     type="MTN-CS10",
     group="MTNNG_CLOUD_AZ_1",
     layout=327,
     plan=6776,
-    resource_pool_id=pool.code,   # "pool-214" — or pass the numeric ID 214
+    resource_pool_id="pool-214",    # or the numeric ID 214
     labels=["production", "web"],
 )
-
-print(f"Created: {instance.id} {instance.name} ({instance.status})")
 ```
 
 ### 3. Manage an Instance
@@ -404,6 +405,8 @@ Environment variables:
 | `MTN_CLOUD_MAX_RETRIES` | Maximum retry attempts | `3` |
 | `MTN_CLOUD_RETRY_DELAY` | Retry backoff factor | `1.0` |
 | `MTN_CLOUD_VERIFY_SSL` | Enable SSL verification | `true` |
+| `MTN_CLOUD_USER_AGENT` | Application identity appended to the SDK user agent | - |
+| `MTN_CLOUD_DEBUG` | Enable bounded, secret-redacted HTTP debug logs | `false` |
 
 Programmatic configuration:
 
@@ -416,11 +419,21 @@ config = MTNCloudConfig(
     max_retries=5,
     retry_delay=1.5,
     verify_ssl=True,
+    user_agent="my-automation/1.0",  # appended after the required SDK identity
 )
 
 cloud = MTNCloud(config=config)
 ```
 
+Tokens and passwords are stored as masked Pydantic secret values, and debug
+logging recursively redacts credential-shaped fields. The transport retries
+transient failures only for safe read methods (`GET`, `HEAD`, and `OPTIONS`);
+create, update, action, and delete requests are never status-retried automatically.
+
+The default `mtn-cloud-python/<version>` user-agent prefix is required by the
+MTN Cloud API edge. A configured `user_agent` is treated as an application
+suffix so the SDK identity is preserved.
+
 ## Examples
 
 | Script | What it demonstrates |

{mtn_cloud-0.3.1 → mtn_cloud-0.3.3}/README.md

@@ -106,33 +106,36 @@ for plan in cloud.instances.list_service_plans(
     print(plan["id"], plan["name"])
 ```
 
-A **resource pool is required** to create an instance — it's where the VM is hosted. Discover it by group name (the cloud/zone is resolved for you), or fetch one directly by name:
+A **resource pool is required** to create an instance — it's where the VM is hosted. `provision()` (below) discovers it for you; or fetch one yourself with `cloud.instances.get_resource_pool("my-project", group="MTNNG_CLOUD_AZ_1")`.
+
+### 2. Create an Instance
+
+The guided `provision()` resolves layout, plan, and resource pool from names — the fastest path:
 
 ```python
-pool = cloud.instances.get_resource_pool(
-    "my-project-name",
-    group="MTNNG_CLOUD_AZ_1",
+instance = cloud.instances.provision(
+    name="web-01",
+    type="MTN-CS10",                # type code
+    group="MTNNG_CLOUD_AZ_1",       # also used as the cloud/zone
+    plan="G2S4",                    # plan name (or numeric id)
+    resource_pool="my-project",     # pool name; auto-selected if the group has only one
 )
-print(pool.code)   # e.g. "pool-214" — pass this as resource_pool_id
+print(instance.id, instance.status, instance.primary_ip)
 ```
 
-### 2. Create an Instance
+For full control over every ID, use `create()` directly:
 
 ```python
-pool = cloud.instances.get_resource_pool("my-project-name", group="MTNNG_CLOUD_AZ_1")
-
 instance = cloud.instances.create(
-    name="my-server",
+    name="web-01",
     cloud="MTNNG_CLOUD_AZ_1",
     type="MTN-CS10",
     group="MTNNG_CLOUD_AZ_1",
     layout=327,
     plan=6776,
-    resource_pool_id=pool.code,   # "pool-214" — or pass the numeric ID 214
+    resource_pool_id="pool-214",    # or the numeric ID 214
     labels=["production", "web"],
 )
-
-print(f"Created: {instance.id} {instance.name} ({instance.status})")
 ```
 
 ### 3. Manage an Instance
@@ -360,6 +363,8 @@ Environment variables:
 | `MTN_CLOUD_MAX_RETRIES` | Maximum retry attempts | `3` |
 | `MTN_CLOUD_RETRY_DELAY` | Retry backoff factor | `1.0` |
 | `MTN_CLOUD_VERIFY_SSL` | Enable SSL verification | `true` |
+| `MTN_CLOUD_USER_AGENT` | Application identity appended to the SDK user agent | - |
+| `MTN_CLOUD_DEBUG` | Enable bounded, secret-redacted HTTP debug logs | `false` |
 
 Programmatic configuration:
 
@@ -372,11 +377,21 @@ config = MTNCloudConfig(
     max_retries=5,
     retry_delay=1.5,
     verify_ssl=True,
+    user_agent="my-automation/1.0",  # appended after the required SDK identity
 )
 
 cloud = MTNCloud(config=config)
 ```
 
+Tokens and passwords are stored as masked Pydantic secret values, and debug
+logging recursively redacts credential-shaped fields. The transport retries
+transient failures only for safe read methods (`GET`, `HEAD`, and `OPTIONS`);
+create, update, action, and delete requests are never status-retried automatically.
+
+The default `mtn-cloud-python/<version>` user-agent prefix is required by the
+MTN Cloud API edge. A configured `user_agent` is treated as an application
+suffix so the SDK identity is preserved.
+
 ## Examples
 
 | Script | What it demonstrates |

{mtn_cloud-0.3.1 → mtn_cloud-0.3.3}/docs/advanced-cookbook.md

@@ -5,14 +5,16 @@ Production-friendly patterns for robust automation.
 ## Configure a Resilient Client
 
 ```python
-from mtn_cloud import MTNCloud
+from mtn_cloud import MTNCloud, MTNCloudConfig
 
-cloud = MTNCloud(
+config = MTNCloudConfig(
     token="your-api-token",
     timeout=45,
-    # Retry values are controlled through MTNCloudConfig defaults:
-    # max_retries=3, retry_delay=1.0
+    max_retries=3,
+    retry_delay=1.0,
+    user_agent="my-automation/1.0",
 )
+cloud = MTNCloud(config=config)
 ```
 
 Use environment variables for deployment:
@@ -24,6 +26,15 @@ export MTN_CLOUD_MAX_RETRIES="5"
 export MTN_CLOUD_RETRY_DELAY="1.5"
 ```
 
+Retries apply only to safe reads (`GET`, `HEAD`, and `OPTIONS`). The SDK does
+not automatically retry provisioning, actions, updates, or deletes because a
+server or proxy error does not prove that a write was rejected before execution.
+
+`user_agent` adds an application identity after the SDK's required
+`mtn-cloud-python/<version>` prefix. Debug logging is bounded and recursively
+redacts tokens, passwords, access keys, secret keys, cookies, authorization
+values, and similar credential fields.
+
 ## Pattern: Idempotent "Get or Create"
 
 ```python

{mtn_cloud-0.3.1 → mtn_cloud-0.3.3}/docs/api-overview.md

@@ -42,10 +42,11 @@ cloud.instance_types.get_by_code("MTN-CS10")
 ## Common Write Operations
 
 ```python
-# Discover the resource pool an instance will be hosted in
-pool = cloud.instances.get_resource_pool("my-project", group="MTNNG_CLOUD_AZ_1")
-
-cloud.instances.create(..., resource_pool_id=pool.code)
+# Guided: resolves layout, plan, and resource pool from names
+cloud.instances.provision(name="web-01", type="MTN-CS10",
+                          group="MTNNG_CLOUD_AZ_1", plan="G2S4", resource_pool="my-project")
+# Explicit: full control over each ID
+cloud.instances.create(..., resource_pool_id="pool-214")
 cloud.instances.update(instance_id=123, name="new-name")
 cloud.instances.delete(123)
 

{mtn_cloud-0.3.1 → mtn_cloud-0.3.3}/docs/api-reference/client.md

@@ -1,6 +1,6 @@
 # Client: `MTNCloud`
 
-### `MTNCloud(token=None, username=None, password=None, url=None, timeout=None, verify_ssl=True, config=None)`
+### `MTNCloud(token=None, username=None, password=None, url=None, timeout=None, verify_ssl=None, config=None)`
 
 Creates an SDK client and lazy-loads resource managers.
 
@@ -10,12 +10,27 @@ Creates an SDK client and lazy-loads resource managers.
     - `username`, `password`: OAuth password-grant alternative
     - `url`: MTN Cloud base console URL, no `/api` needed
     - `timeout`: request timeout in seconds
-    - `verify_ssl`: enable/disable TLS certificate validation
+    - `verify_ssl`: enable/disable TLS certificate validation; when omitted,
+      `MTN_CLOUD_VERIFY_SSL` or the configuration default is used
     - `config`: explicit `MTNCloudConfig` object (overrides other args)
 - Returns: `MTNCloud`
 - Raises:
     - `pydantic.ValidationError` if config values violate `MTNCloudConfig` constraints
 
+Tokens and passwords are stored as masked secret values. Use
+`config.get_token_value()` or `config.get_password_value()` only when an explicit
+integration needs the underlying value; normal SDK usage never needs to reveal
+them.
+
+The transport:
+
+- preserves the `mtn-cloud-python/<version>` user-agent identity required by the
+  MTN API edge;
+- recursively redacts secrets from debug logs and raised error response payloads;
+- retries 429 and transient 5xx responses only for `GET`, `HEAD`, and `OPTIONS`;
+- does not automatically status-retry `POST`, `PUT`, `PATCH`, or `DELETE` calls;
+- handles both delta-seconds and HTTP-date `Retry-After` headers.
+
 ### `whoami() -> User`
 
 - Endpoint: `GET /api/whoami`
@@ -41,4 +56,3 @@ Connectivity/auth convenience check.
 - Parameters: none
 - Returns: `None`
 - Raises: none
-

{mtn_cloud-0.3.1 → mtn_cloud-0.3.3}/docs/api-reference/instances.md

@@ -61,6 +61,31 @@
     - common API exceptions
     - `NotFoundError` when `group` cannot be resolved
 
+### `provision(name: str, *, type: str, group: str, plan: str | int, resource_pool=None, cloud=None, availability_zone=None, security_group="default", wait=True, timeout=600, dry_run=False, **create_kwargs) -> Instance | dict`
+
+Guided wrapper over `create()` that resolves IDs from names.
+
+- Endpoint sequence:
+    - `GET /api/groups?name=<group>` (resolve group → `cloud_ids`)
+    - `GET /api/instance-types?code=<type>` (resolve `layout` via `default_layout_id`)
+    - `GET /api/instances/service-plans` (resolve `plan` name → ID, unless `plan` is an int)
+    - `GET /api/options/zonePools` (resolve/auto-select `resource_pool`, unless given as int)
+    - `POST /api/instances`, then polls `GET /api/instances/{id}` when `wait=True`
+- Parameters:
+    - `type`: instance type code; its `default_layout_id` becomes `layout`
+    - `group`: group name; also used as `cloud` unless `cloud` is given
+    - `plan`: plan name (resolved against the live list) or numeric ID
+    - `resource_pool`: pool name, code, or numeric ID. If omitted, the group's single pool is used; if it has several, a `ValidationError` lists them
+    - `cloud`: cloud/zone name; defaults to `group`
+    - `wait`: block until running (default `True`)
+    - `timeout`: max seconds to wait when `wait=True`
+    - `dry_run`: return the resolved config dict instead of creating
+    - `**create_kwargs`: forwarded to `create()` (labels, tags, volumes, network_interfaces, ports, …)
+- Returns: the created `Instance` (running if `wait=True`), or a config `dict` when `dry_run=True`
+- Raises:
+    - `NotFoundError` when the group or instance type can't be resolved
+    - `ValidationError` when the plan or resource pool can't be resolved
+
 ### `update(instance_id: int, name=None, description=None, labels=None) -> Instance`
 
 - Endpoint: `PUT /api/instances/{instance_id}`

{mtn_cloud-0.3.1 → mtn_cloud-0.3.3}/docs/index.md

@@ -15,9 +15,10 @@ Use this guide in two ways:
 5. [Security Groups](./security-groups.md)
 6. [Backups](./backups.md)
 7. [Virtual Images](./virtual-images.md)
-8. [Advanced Cookbook](./advanced-cookbook.md)
-9. [API Overview](./api-overview.md)
-10. [API Reference](./api-reference/index.md)
+8. [Recipes](./recipes.md)
+9. [Advanced Cookbook](./advanced-cookbook.md)
+10. [API Overview](./api-overview.md)
+11. [API Reference](./api-reference/index.md)
 
 ## Who This Is For
 
@@ -41,6 +42,7 @@ Use this guide in two ways:
 5. Security Groups
 6. Backups
 7. Virtual Images
-8. API Overview
-9. API Reference
-10. Advanced Cookbook
+8. Recipes
+9. API Overview
+10. API Reference
+11. Advanced Cookbook

{mtn_cloud-0.3.1 → mtn_cloud-0.3.3}/docs/instances.md

@@ -106,15 +106,44 @@ If you already know the cloud and group IDs, pass them explicitly to skip the gr
 pools = cloud.instances.list_resource_pools(cloud_id=4, group_id=621)
 ```
 
-## Create an Instance
+## Provision an Instance (guided)
+
+`provision()` is the fastest way to create an instance: it takes the names you already know and resolves the numeric IDs for you — the layout from the type code, the plan from its name, and the resource pool from its name (or auto-selects it when the group has exactly one).
 
 ```python
-# Resolve the resource pool once, then use its code directly
-pool = cloud.instances.get_resource_pool(
-    "my-project-Marv-Osuolale",
-    group="MTNNG_CLOUD_AZ_1",
+instance = cloud.instances.provision(
+    name="app-server-01",
+    type="MTN-CS10",                    # type code -> resolves the layout
+    group="MTNNG_CLOUD_AZ_1",           # also used as the cloud/zone
+    plan="G2S4",                        # plan name (or pass a numeric plan ID)
+    resource_pool="my-project",         # pool name; omit if the group has one pool
+    availability_zone="Lagos-AZ-1-fd1",
+    security_group="default",
 )
 
+# wait=True by default, so the instance is already running here
+print(instance.id, instance.name, instance.status, instance.primary_ip)
+```
+
+If a name can't be resolved, the error tells you what's available (e.g. the valid plan names, or the pools to choose from). Set `wait=False` to return immediately, or `dry_run=True` to get the resolved config back without creating anything:
+
+```python
+config = cloud.instances.provision(
+    name="app-server-01", type="MTN-CS10", group="MTNNG_CLOUD_AZ_1",
+    plan="G2S4", resource_pool="my-project", dry_run=True,
+)
+# {"layout": 327, "plan": 6776, "resource_pool_id": "pool-214", ...}
+```
+
+Any extra keyword (labels, tags, volumes, network_interfaces, ports, …) passes straight through to `create()`.
+
+## Create an Instance (explicit)
+
+When you want full control over each ID, call `create()` directly. Resolve the inputs yourself first (see [Discover Required IDs](#discover-required-ids-and-codes)):
+
+```python
+pool = cloud.instances.get_resource_pool("my-project", group="MTNNG_CLOUD_AZ_1")
+
 instance = cloud.instances.create(
     name="app-server-01",
     cloud="MTNNG_CLOUD_AZ_1",
@@ -124,7 +153,7 @@ instance = cloud.instances.create(
     plan=6776,                          # use a plan ID from list_service_plans()
     resource_pool_id=pool.code,         # e.g. "pool-214" (or pass 214 directly)
     availability_zone="Lagos-AZ-1-fd1",
-    security_group="default",           # security group name from the console
+    security_group="default",
 )
 
 print(instance.id, instance.name, instance.status, instance.primary_ip)

mtn_cloud-0.3.3/docs/recipes.md

@@ -0,0 +1,110 @@
+# Recipes
+
+Three complete, real-world workflows. Each assumes an authenticated client:
+
+```python
+from mtn_cloud import MTNCloud
+
+cloud = MTNCloud(token="your-api-token")
+```
+
+For isolated patterns (retries, pagination, idempotency), see the [Advanced Cookbook](./advanced-cookbook.md).
+
+## Provision a Linux VM with SSH
+
+Discover the inputs, open SSH in a security group, provision, and wait until it's reachable.
+
+```python
+group = cloud.groups.get_by_name("MTNNG_CLOUD_AZ_1")
+itype = cloud.instance_types.get_by_code("MTN-CS10")
+pool = cloud.instances.get_resource_pool("my-project", group=group.name)
+plans = cloud.instances.list_service_plans(
+    zone_id=group.cloud_ids[0], layout_id=itype.default_layout_id, group_id=group.id,
+)
+
+sg = cloud.security_groups.create(name="linux-ssh", description="SSH access")
+cloud.security_groups.create_rule(
+    sg.id, name="allow-ssh", direction="ingress", protocol="tcp",
+    port_range="22", source_type="cidr", source="200.200.113.15/32",
+)
+
+instance = cloud.instances.create(
+    name="linux-web-01",
+    cloud=group.name,
+    type=itype.code,
+    group=group.name,
+    layout=itype.default_layout_id,
+    plan=plans[0]["id"],
+    resource_pool_id=pool.code,
+    availability_zone="Lagos-AZ-1-fd1",
+    security_group=sg.name,
+    create_user=True,
+)
+instance = cloud.instances.wait_until_running(instance.id, timeout=600)
+print("ready:", instance.primary_ip)
+```
+
+SSH **keys** are uploaded once in the console (**User Settings → SSH Keys**); the SDK controls the firewall rule and user creation. Then: `ssh <your-user>@<instance.primary_ip>`.
+
+## Back up a folder to MTN Object Storage
+
+Register the provider and bucket idempotently, preview with a dry run, then upload.
+
+```python
+from mtn_cloud import NotFoundError
+
+try:
+    storage = cloud.storage_buckets.get_by_name("my-s3-storage")
+except NotFoundError:
+    storage = cloud.storage_buckets.create_s3(
+        name="my-s3-storage",
+        bucket_name="my-app-objects",
+        access_key="your-access-key",                      # from MOS email
+        secret_key="your-secret-key",                      # from MOS email
+        endpoint="https://ps1csp-s3.ict.mtn.com.ng:9021",
+        create_bucket=True,
+    )
+
+try:
+    archive = cloud.archive_buckets.get_by_name("my-app-archives")
+except NotFoundError:
+    archive = cloud.archive_buckets.create(
+        name="my-app-archives", storage_provider_id=storage.id, visibility="private",
+    )
+
+preview = cloud.archive_buckets.upload_directory(
+    bucket_name=archive.name, remote_path="/backups/",
+    local_directory="./data", recursive=True, dry_run=True,
+)
+if preview.skipped_count:
+    raise RuntimeError(f"{preview.skipped_count} files would be skipped")
+
+result = cloud.archive_buckets.upload_directory(
+    bucket_name=archive.name, remote_path="/backups/",
+    local_directory="./data", recursive=True, strict=True,
+)
+print(f"uploaded={result.uploaded_count} failed={result.failed_count}")
+```
+
+## Tear down demo resources
+
+Delete in dependency order — instances first, then the firewall and network they used. Deletes are best-effort so one failure doesn't block the rest.
+
+```python
+from mtn_cloud import MTNCloudError
+
+def cleanup(manager, items, label):
+    for item in items:
+        if (item.name or "").startswith("demo-"):
+            try:
+                manager.delete(item.id)
+                print("deleted", label, item.id)
+            except MTNCloudError as exc:
+                print("skip", label, item.id, exc)
+
+cleanup(cloud.instances, cloud.instances.list(max_results=100), "instance")
+cleanup(cloud.security_groups, cloud.security_groups.list(), "security-group")
+cleanup(cloud.networks, cloud.networks.list(), "network")
+```
+
+A network or security group can't be deleted while an instance still references it — always remove instances first and let them finish.

{mtn_cloud-0.3.1 → mtn_cloud-0.3.3}/pyproject.toml

@@ -21,7 +21,9 @@ keywords = [
     "sdk",
     "api",
     "infrastructure",
-    "devops"
+    "devops",
+    "cloud-management",
+    "mtn-cloud-python"    
 ]
 classifiers = [
     "Development Status :: 4 - Beta",
@@ -50,8 +52,6 @@ dependencies = [
 dev = [
     "pytest>=7.0.0",
     "pytest-cov>=4.0.0",
-    "pytest-asyncio>=0.21.0",
-    "respx>=0.20.0",
     "ruff>=0.1.0",
     "mypy>=1.0.0",
     "types-requests>=2.28.0",
@@ -121,4 +121,3 @@ ignore_missing_imports = true
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]
-asyncio_mode = "auto"

{mtn_cloud-0.3.1 → mtn_cloud-0.3.3}/src/mtn_cloud/_version.py

@@ -1,3 +1,3 @@
 """Package version metadata."""
 
-__version__ = "0.3.1"
+__version__ = "0.3.3"

{mtn_cloud-0.3.1 → mtn_cloud-0.3.3}/src/mtn_cloud/client.py

@@ -82,7 +82,7 @@ class MTNCloud:
         password: str | None = None,
         url: str | None = None,
         timeout: float | None = None,
-        verify_ssl: bool = True,
+        verify_ssl: bool | None = None,
         config: MTNCloudConfig | None = None,
     ) -> None:
         """
@@ -94,7 +94,8 @@ class MTNCloud:
             password: Password for authentication
             url: API base URL (default: https://console.cloud.mtn.ng)
             timeout: Request timeout in seconds
-            verify_ssl: Verify SSL certificates
+            verify_ssl: Verify SSL certificates. When omitted, configuration and
+                environment settings are respected.
             config: Full configuration object (overrides other args)
         """
         if config:
@@ -102,17 +103,17 @@ class MTNCloud:
         else:
             config_kwargs: dict[str, Any] = {}
 
-            if token:
+            if token is not None:
                 config_kwargs["token"] = token
-            if username:
+            if username is not None:
                 config_kwargs["username"] = username
-            if password:
+            if password is not None:
                 config_kwargs["password"] = password
-            if url:
+            if url is not None:
                 config_kwargs["url"] = url
-            if timeout:
+            if timeout is not None:
                 config_kwargs["timeout"] = timeout
-            if not verify_ssl:
+            if verify_ssl is not None:
                 config_kwargs["verify_ssl"] = verify_ssl
 
             self._config = MTNCloudConfig(**config_kwargs)