pangea-sdk 6.1.1__py3-none-any.whl → 6.2.0__py3-none-any.whl

pangea/services/file_scan.py

@@ -1,5 +1,11 @@
 # Copyright 2022 Pangea Cyber Corporation
 # Author: Pangea Cyber Corporation
+
+# TODO: Use `list` instead of `List`.
+# ruff: noqa: UP006, UP035
+
+from __future__ import annotations
+
 import io
 import logging
 from typing import Dict, List, Optional, Tuple
@@ -133,7 +139,7 @@ class FileScan(ServiceBase):
         files: Optional[List[Tuple]] = None
         if file or file_path:
             if file_path:
-                file = open(file_path, "rb")
+                file = open(file_path, "rb")  # noqa: SIM115
             if transfer_method == TransferMethod.POST_URL:
                 params = get_file_upload_params(file)  # type: ignore[arg-type]
                 crc = params.crc_hex

pangea/services/intel.py

@@ -1,10 +1,14 @@
 # Copyright 2022 Pangea Cyber Corporation
 # Author: Pangea Cyber Corporation
+
+# TODO: Use `list` instead of `List`.
+# ruff: noqa: UP006, UP035
+
 from __future__ import annotations
 
 import enum
 import hashlib
-from typing import Dict, List, Optional
+from typing import Dict, List, Literal, Optional
 
 from pangea.exceptions import PangeaException
 from pangea.response import APIRequestModel, PangeaResponse, PangeaResponseResult
@@ -61,8 +65,20 @@ class FileReputationBulkRequest(APIRequestModel):
     hash_type (str): Type of hash, can be "sha256", "sha" or "md5"
     """
 
-    hashes: List[str]
-    hash_type: str
+    hashes: list[str]
+    """The hash of the file to be looked up"""
+
+    hash_type: Literal["sha256", "sha", "md5"]
+    """One of "sha256", "sha", "md5"."""
+
+    verbose: Optional[bool] = None
+    """Echo the API parameters in the response"""
+
+    raw: Optional[bool] = None
+    """Include raw data from this provider"""
+
+    provider: Optional[Literal["reversinglabs", "crowdstrike"]] = None
+    """Use reputation data from this provider"""
 
 
 class FileReputationData(IntelReputationData):
@@ -356,7 +372,8 @@ class DomainWhoIsRequest(DomainCommonRequest):
     Domain whois request data
     """
 
-    pass
+    domain: str
+    """The domain to query."""
 
 
 class DomainWhoIsData(PangeaResponseResult):
@@ -530,11 +547,11 @@ class FileIntel(ServiceBase):
 
     def hash_reputation_bulk(
         self,
-        hashes: List[str],
-        hash_type: str,
-        provider: Optional[str] = None,
-        verbose: Optional[bool] = None,
-        raw: Optional[bool] = None,
+        hashes: list[str],
+        hash_type: Literal["sha256", "sha", "md5"],
+        provider: Literal["reversinglabs", "crowdstrike"] | None = None,
+        verbose: bool | None = None,
+        raw: bool | None = None,
     ) -> PangeaResponse[FileReputationBulkResult]:
         """
         Reputation check V2
@@ -562,7 +579,7 @@ class FileIntel(ServiceBase):
                 provider="reversinglabs",
             )
         """
-        input = FileReputationBulkRequest(  # type: ignore[call-arg]
+        input = FileReputationBulkRequest(
             hashes=hashes, hash_type=hash_type, verbose=verbose, raw=raw, provider=provider
         )
         return self.request.post("v2/reputation", FileReputationBulkResult, data=input.model_dump(exclude_none=True))
@@ -610,10 +627,10 @@ class FileIntel(ServiceBase):
 
     def filepath_reputation_bulk(
         self,
-        filepaths: List[str],
-        provider: Optional[str] = None,
-        verbose: Optional[bool] = None,
-        raw: Optional[bool] = None,
+        filepaths: list[str],
+        provider: Literal["reversinglabs", "crowdstrike"] | None = None,
+        verbose: bool | None = None,
+        raw: bool | None = None,
     ) -> PangeaResponse[FileReputationBulkResult]:
         """
         Reputation, from filepath V2
@@ -624,10 +641,10 @@ class FileIntel(ServiceBase):
         OperationId: file_intel_post_v2_reputation
 
         Args:
-            filepaths (List[str]): The path list to the files to be looked up
-            provider (str, optional): Use reputation data from these providers: "reversinglabs" or "crowdstrike"
-            verbose (bool, optional): Echo the API parameters in the response
-            raw (bool, optional): Include raw data from this provider
+            filepaths: The path list to the files to be looked up
+            provider: Use reputation data from these providers: "reversinglabs" or "crowdstrike"
+            verbose: Echo the API parameters in the response
+            raw: Include raw data from this provider
 
         Raises:
             PangeaAPIException: If an API Error happens
@@ -777,7 +794,7 @@ class DomainIntel(ServiceBase):
                 provider="whoisxml",
             )
         """
-        input = DomainWhoIsRequest(domain=domain, verbose=verbose, provider=provider, raw=raw)  # type: ignore[call-arg]
+        input = DomainWhoIsRequest(domain=domain, verbose=verbose, provider=provider, raw=raw)
         return self.request.post("v1/whois", DomainWhoIsResult, data=input.model_dump(exclude_none=True))
 
 

pangea/services/redact.py

@@ -1,5 +1,9 @@
 # Copyright 2022 Pangea Cyber Corporation
 # Author: Pangea Cyber Corporation
+
+# TODO: Use `list` instead of `List`.
+# ruff: noqa: UP006, UP035
+
 from __future__ import annotations
 
 import enum

pangea/services/sanitize.py

@@ -1,5 +1,9 @@
 # Copyright 2022 Pangea Cyber Corporation
 # Author: Pangea Cyber Corporation
+
+# TODO: Use `list` instead of `List`.
+# ruff: noqa: UP006, UP035
+
 from __future__ import annotations
 
 import io
@@ -267,7 +271,7 @@ class Sanitize(ServiceBase):
         files: Optional[List[Tuple]] = None
         if file or file_path:
             if file_path:
-                file = open(file_path, "rb")
+                file = open(file_path, "rb")  # noqa: SIM115
             if (
                 transfer_method == TransferMethod.POST_URL
                 and file

pangea/services/share/share.py

@@ -1,10 +1,16 @@
 # Copyright 2022 Pangea Cyber Corporation
 # Author: Pangea Cyber Corporation
+
+# TODO: Use `list` instead of `List`.
+# ruff: noqa: UP006, UP035
+
 from __future__ import annotations
 
 import enum
 import io
-from typing import Dict, List, NewType, Optional, Tuple, Union
+from typing import Dict, List, Optional, Tuple, Union
+
+from pydantic import RootModel
 
 from pangea.config import PangeaConfig
 from pangea.response import APIRequestModel, PangeaResponse, PangeaResponseResult, TransferMethod
@@ -12,8 +18,8 @@ from pangea.services.base import ServiceBase
 from pangea.services.share.file_format import FileFormat
 from pangea.utils import get_file_size, get_file_upload_params
 
-Metadata = NewType("Metadata", Dict[str, str])
-Tags = NewType("Tags", List[str])
+Metadata = RootModel[dict[str, str]]
+Tags = RootModel[list[str]]
 
 
 class ItemOrder(str, enum.Enum):
@@ -916,10 +922,10 @@ class Share(ServiceBase):
 
     def get_archive(
         self,
-        ids: List[str] = [],
-        format: Optional[ArchiveFormat] = None,
-        transfer_method: Optional[TransferMethod] = None,
-        bucket_id: Optional[str] = None,
+        ids: list[str],
+        format: ArchiveFormat | None = None,
+        transfer_method: TransferMethod | None = None,
+        bucket_id: str | None = None,
     ) -> PangeaResponse[GetArchiveResult]:
         """
         Get archive

pangea/services/vault/models/asymmetric.py

@@ -1,5 +1,9 @@
 # Copyright 2022 Pangea Cyber Corporation
 # Author: Pangea Cyber Corporation
+
+# TODO: Use `list` instead of `List`.
+# ruff: noqa: UP006, UP035
+
 from __future__ import annotations
 
 from enum import Enum

pangea/services/vault/models/common.py

@@ -1,5 +1,9 @@
 # Copyright 2022 Pangea Cyber Corporation
 # Author: Pangea Cyber Corporation
+
+# TODO: Use `list` instead of `List`.
+# ruff: noqa: UP006, UP035
+
 from __future__ import annotations
 
 import enum

pangea/services/vault/models/symmetric.py

@@ -1,5 +1,9 @@
 # Copyright 2022 Pangea Cyber Corporation
 # Author: Pangea Cyber Corporation
+
+# TODO: Use `list` instead of `List`.
+# ruff: noqa: UP006, UP035
+
 from __future__ import annotations
 
 from enum import Enum

pangea/services/vault/vault.py

@@ -2,10 +2,9 @@
 # Author: Pangea Cyber Corporation
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Any, List, Literal, Optional, Union, cast, overload
+from typing import TYPE_CHECKING, Annotated, Any, Literal, Optional, Union, cast, overload
 
 from pydantic import Field, TypeAdapter
-from typing_extensions import Annotated
 
 from pangea.response import PangeaResponse, PangeaResponseResult
 from pangea.services.base import ServiceBase
@@ -34,7 +33,6 @@ from pangea.services.vault.models.common import (
     EncryptTransformRequest,
     EncryptTransformResult,
     ExportEncryptionAlgorithm,
-    ExportEncryptionType,
     ExportRequest,
     ExportResult,
     Folder,
@@ -98,7 +96,7 @@ vault_item_adapter: TypeAdapter[VaultItem] = TypeAdapter(VaultItem)
 
 
 class GetBulkResponse(PangeaResponseResult):
-    items: List[VaultItem]
+    items: list[VaultItem]
 
 
 class Vault(ServiceBase):

pangea/tools.py

@@ -1,5 +1,6 @@
 # Copyright 2022 Pangea Cyber Corporation
 # Author: Pangea Cyber Corporation
+from __future__ import annotations
 
 import enum
 import io
@@ -7,9 +8,10 @@ import json
 import logging
 import os
 import sys
+from collections.abc import Iterator
 from datetime import datetime, timezone
 from logging.handlers import TimedRotatingFileHandler
-from typing import Dict, Iterator, List, Optional
+from typing import Optional
 
 from pangea.config import PangeaConfig
 from pangea.exceptions import PangeaException
@@ -17,6 +19,8 @@ from pangea.services import Audit
 
 
 class TestEnvironment(str, enum.Enum):
+    __test__ = False
+
     DEVELOP = "DEV"
     LIVE = "LVE"
     STAGING = "STG"
@@ -28,15 +32,15 @@ class TestEnvironment(str, enum.Enum):
         return str(self.value)
 
 
-class Root(Dict):
+class Root(dict):
     size: int
     tree_name: str
 
 
-class Event(Dict):
+class Event(dict):
     membership_proof: str
     leaf_index: Optional[int]
-    event: Dict
+    event: dict
     hash: str
     tree_size: Optional[int]
 
@@ -68,7 +72,7 @@ def exit_with_error(message: str):
     sys.exit(1)
 
 
-def file_events(root_hashes: Dict[int, str], f: io.TextIOWrapper) -> Iterator[Event]:
+def file_events(root_hashes: dict[int, str], f: io.TextIOWrapper) -> Iterator[Event]:
     """
     Reads a file containing Events in JSON format with the following fields:
     - membership_proof: str
@@ -111,8 +115,8 @@ def make_aware_datetime(d: datetime) -> datetime:
     return d
 
 
-def filter_deep_none(data: Dict) -> Dict:
-    return {k: v if not isinstance(v, Dict) else filter_deep_none(v) for k, v in data.items() if v is not None}
+def filter_deep_none(data: dict) -> dict:
+    return {k: v if not isinstance(v, dict) else filter_deep_none(v) for k, v in data.items() if v is not None}
 
 
 def _load_env_var(env_var_name: str) -> str:
@@ -183,7 +187,7 @@ class SequenceFollower:
             self.numbers.remove(min_val)
             min_val += 1
 
-    def holes(self) -> List[int]:
+    def holes(self) -> list[int]:
         if not self.numbers:
             return []
 
@@ -192,7 +196,7 @@ class SequenceFollower:
         return [val for val in range(min_val, max_val) if val not in self.numbers]
 
 
-loggers: Dict[str, bool] = {}
+loggers: dict[str, bool] = {}
 
 
 def logger_set_pangea_config(logger_name: str, level=logging.DEBUG):

pangea/utils.py

@@ -60,7 +60,7 @@ def canonicalize(data: dict) -> str:
         return json.dumps(
             data, ensure_ascii=False, allow_nan=False, separators=(",", ":"), sort_keys=True, default=default_encoder
         )
-    elif isinstance(data, datetime.datetime) or isinstance(data, datetime.date):
+    elif isinstance(data, (datetime.datetime, datetime.date)):
         return format_datetime(data)
     else:
         return str(data)
@@ -151,10 +151,8 @@ def get_crc32c(data: str) -> str:
 
 
 def hash_256_filepath(filepath: str) -> str:
-    data = open(filepath, "rb")
-    hash = sha256(data.read()).hexdigest()
-    data.close()
-    return hash
+    with open(filepath, "rb") as data:
+        return sha256(data.read()).hexdigest()
 
 
 def get_prefix(hash: str, len: int = 5):

pangea/verify_audit.py

@@ -9,14 +9,16 @@ You can provide a single event (obtained from the PUC) or the result from a sear
 In the latter case, all the events are verified.
 """
 
+from __future__ import annotations
+
 import argparse
 import json
 import logging
 import os
 import sys
-from collections.abc import Set
+from collections.abc import Iterable, Set
 from enum import Enum
-from typing import Dict, Iterable, List, Optional, Union
+from typing import Optional, Union
 
 from pangea.config import PangeaConfig
 from pangea.exceptions import TreeNotFoundException
@@ -36,8 +38,8 @@ from pangea.services.audit.util import (
 )
 
 logger = logging.getLogger("audit")
-arweave_roots: Dict[int, PublishedRoot] = {}  # roots fetched from Arweave
-pangea_roots: Dict[int, Root] = {}  # roots fetched from Pangea
+arweave_roots: dict[int, PublishedRoot] = {}  # roots fetched from Arweave
+pangea_roots: dict[int, Root] = {}  # roots fetched from Pangea
 audit: Optional[Audit] = None
 
 
@@ -72,10 +74,7 @@ class VerifierLogFormatter(logging.Formatter):
             self.in_section = True
             return f"{' ' * self.indent}⎾  {record.msg}"
         else:
-            if self.in_section:
-                pre = f"{' ' * (self.indent+4)}⌲ "
-            else:
-                pre = ""
+            pre = f"{' ' * (self.indent + 4)}⌲ " if self.in_section else ""
             return f"{pre}{record.msg}"
 
 
@@ -100,8 +99,8 @@ formatter = VerifierLogFormatter()
 InvalidTokenError = ValueError("Invalid Pangea Token provided")
 
 
-def get_pangea_roots(tree_name: str, tree_sizes: Iterable[int]) -> Dict[int, Root]:
-    ans: Dict[int, Root] = {}
+def get_pangea_roots(tree_name: str, tree_sizes: Iterable[int]) -> dict[int, Root]:
+    ans: dict[int, Root] = {}
     if audit is None:
         return ans
 
@@ -125,7 +124,7 @@ def get_pangea_roots(tree_name: str, tree_sizes: Iterable[int]) -> Dict[int, Roo
     return ans
 
 
-def _verify_hash(data: Dict, data_hash: str) -> Status:
+def _verify_hash(data: dict, data_hash: str) -> Status:
     log_section("Checking data hash")
     status = Status.SKIPPED
     try:
@@ -213,7 +212,7 @@ def _fetch_roots(tree_name: str, tree_size: int, leaf_index: Optional[int]) -> S
             logger.debug(f"Fetching root(s) {comma_sep(pending_roots)} from Arweave")
             arweave_roots |= {int(k): v for k, v in get_arweave_published_roots(tree_name, pending_roots).items()}
             update_pending_roots()
-        except:
+        except:  # noqa: E722
             pass
 
     if pending_roots:
@@ -227,7 +226,7 @@ def _fetch_roots(tree_name: str, tree_size: int, leaf_index: Optional[int]) -> S
                 pangea_roots |= {int(k): v for k, v in get_pangea_roots(tree_name, pending_roots).items()}
                 update_pending_roots()
                 status = Status.SUCCEEDED_PANGEA
-            except:
+            except:  # noqa: E722
                 pass
 
             if pending_roots:
@@ -244,7 +243,7 @@ def _fetch_roots(tree_name: str, tree_size: int, leaf_index: Optional[int]) -> S
 
 
 def _verify_membership_proof(tree_size: int, node_hash: str, proof: Optional[str]) -> Status:
-    pub_roots: Dict[int, Union[Root, PublishedRoot]] = arweave_roots | pangea_roots
+    pub_roots: dict[int, Union[Root, PublishedRoot]] = arweave_roots | pangea_roots
 
     log_section("Checking membership proof")
 
@@ -277,7 +276,7 @@ def _verify_membership_proof(tree_size: int, node_hash: str, proof: Optional[str
     return status
 
 
-def _consistency_proof_ok(pub_roots: Dict[int, Union[Root, PublishedRoot]], leaf_index: int) -> bool:
+def _consistency_proof_ok(pub_roots: dict[int, Union[Root, PublishedRoot]], leaf_index: int) -> bool:
     """returns true if a consistency proof is correct"""
 
     curr_root = pub_roots[leaf_index + 1]
@@ -296,7 +295,7 @@ def _consistency_proof_ok(pub_roots: Dict[int, Union[Root, PublishedRoot]], leaf
 # Due to an (already fixed) bug, some proofs from Arweave may be wrong.
 # Try the proof from Pangea instead. If the root hash in both Arweave and Pangea is the same,
 # it doesn't matter where the proof came from.
-def _fix_consistency_proof(pub_roots: Dict[int, Union[Root, PublishedRoot]], tree_name: str, leaf_index: int):
+def _fix_consistency_proof(pub_roots: dict[int, Union[Root, PublishedRoot]], tree_name: str, leaf_index: int):
     logger.debug("Consistency proof from Arweave failed to verify")
     size = leaf_index + 1
     logger.debug(f"Fetching root from Pangea for size {size}")
@@ -305,13 +304,13 @@ def _fix_consistency_proof(pub_roots: Dict[int, Union[Root, PublishedRoot]], tre
         raise ValueError("Error fetching root from Pangea")
     pangea_roots[size] = new_roots[size]
     pub_roots[size] = pangea_roots[size]
-    logger.debug(f"Comparing Arweave root hash with Pangea root hash")
+    logger.debug("Comparing Arweave root hash with Pangea root hash")
     if pangea_roots[size].root_hash != arweave_roots[size].root_hash:
         raise ValueError("Hash does not match")
 
 
 def _verify_consistency_proof(tree_name: str, leaf_index: Optional[int]) -> Status:
-    pub_roots: Dict[int, Union[Root, PublishedRoot]] = arweave_roots | pangea_roots
+    pub_roots: dict[int, Union[Root, PublishedRoot]] = arweave_roots | pangea_roots
 
     log_section("Checking consistency proof")
 
@@ -336,10 +335,7 @@ def _verify_consistency_proof(tree_name: str, leaf_index: Optional[int]) -> Stat
                 _fix_consistency_proof(pub_roots, tree_name, leaf_index)
 
                 # check again
-                if _consistency_proof_ok(pub_roots, leaf_index):
-                    status = Status.SUCCEEDED
-                else:
-                    status = Status.FAILED
+                status = Status.SUCCEEDED if _consistency_proof_ok(pub_roots, leaf_index) else Status.FAILED
 
             else:
                 logger.debug(
@@ -356,11 +352,11 @@ def _verify_consistency_proof(tree_name: str, leaf_index: Optional[int]) -> Stat
     return status
 
 
-def create_signed_event(event: Dict) -> Dict:
+def create_signed_event(event: dict) -> dict:
     return {k: v for k, v in event.items() if v is not None}
 
 
-def _verify_signature(data: Dict) -> Status:
+def _verify_signature(data: dict) -> Status:
     log_section("Checking signature")
     if "signature" not in data:
         logger.debug("Signature is not present")
@@ -383,13 +379,13 @@ def _verify_signature(data: Dict) -> Status:
     return status
 
 
-def verify_multiple(root: Dict, unpublished_root: Dict, events: List[Dict]) -> Status:
+def verify_multiple(root: dict, unpublished_root: dict, events: list[dict]) -> Status:
     """
     Verify a list of events.
     Returns a status.
     """
 
-    statuses: List[Status] = []
+    statuses: list[Status] = []
     for counter, event in enumerate(events):
         event.update({"root": root, "unpublished_root": unpublished_root})
         event_status = verify_single(event, counter + 1)
@@ -403,7 +399,7 @@ def verify_multiple(root: Dict, unpublished_root: Dict, events: List[Dict]) -> S
     return Status.SUCCEEDED
 
 
-def verify_single(data: Dict, counter: Optional[int] = None) -> Status:
+def verify_single(data: dict, counter: Optional[int] = None) -> Status:
     """
     Verify a single event.
     Returns a status.

{pangea_sdk-6.1.1.dist-info → pangea_sdk-6.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pangea-sdk
-Version: 6.1.1
+Version: 6.2.0
 Summary: Pangea API SDK
 License: MIT
 Keywords: Pangea,SDK,Audit
@@ -9,16 +9,16 @@ Author-email: glenn.gallien@pangea.cloud
 Requires-Python: >=3.9.2,<4.0.0
 Classifier: Topic :: Software Development
 Classifier: Topic :: Software Development :: Libraries
-Requires-Dist: aiohttp (>=3.11.18,<4.0.0)
-Requires-Dist: cryptography (>=44.0.3,<44.0.4)
+Requires-Dist: aiohttp (>=3.12.13,<4.0.0)
+Requires-Dist: cryptography (>=45.0.4,<46.0.0)
 Requires-Dist: deprecated (>=1.2.18,<2.0.0)
 Requires-Dist: google-crc32c (>=1.7.1,<2.0.0)
-Requires-Dist: pydantic (>=2.11.4,<3.0.0)
+Requires-Dist: pydantic (>=2.11.7,<3.0.0)
 Requires-Dist: python-dateutil (>=2.9.0.post0,<3.0.0)
-Requires-Dist: requests (>=2.32.3,<3.0.0)
+Requires-Dist: requests (>=2.32.4,<3.0.0)
 Requires-Dist: requests-toolbelt (>=1.0.0,<2.0.0)
-Requires-Dist: typing-extensions (>=4.13.2,<5.0.0)
-Requires-Dist: yarl (>=1.20.0,<2.0.0)
+Requires-Dist: typing-extensions (>=4.14.0,<5.0.0)
+Requires-Dist: yarl (>=1.20.1,<2.0.0)
 Description-Content-Type: text/markdown
 
 <a href="https://pangea.cloud?utm_source=github&utm_medium=python-sdk" target="_blank" rel="noopener noreferrer">
@@ -63,13 +63,13 @@ the same compatibility guarantees as stable releases.
 Via pip:
 
 ```bash
-$ pip3 install pangea-sdk==5.5.0b2
+$ pip3 install pangea-sdk==6.2.0b2
 ```
 
 Via poetry:
 
 ```bash
-$ poetry add pangea-sdk==5.5.0b2
+$ poetry add pangea-sdk==6.2.0b2
 ```
 
 ## Usage
@@ -102,6 +102,26 @@ audit = Audit(token, config)
 response = audit.log(message="Hello, World!")
 ```
 
+## Configuration
+
+The SDK supports the following configuration options via `PangeaConfig`:
+
+- `base_url_template` — Template for constructing the base URL for API requests.
+  The placeholder `{SERVICE_NAME}` will be replaced with the service name slug.
+  This is a more powerful version of `domain` that allows for setting more than
+  just the host of the API server. Defaults to
+  `https://{SERVICE_NAME}.aws.us.pangea.cloud`.
+- `domain` — Base domain for API requests. This is a weaker version of
+  `base_url_template` that only allows for setting the host of the API server.
+  Use `base_url_template` for more control over the URL, such as setting
+  service-specific paths. Defaults to `aws.us.pangea.cloud`.
+- `request_retries` — Number of retries on the initial request.
+- `request_backoff` — Backoff strategy passed to 'requests'.
+- `request_timeout` — Timeout used on initial request attempts.
+- `poll_result_timeout` — Timeout used to poll results after 202 (in secs).
+- `queued_retry_enabled` — Enable queued request retry support.
+- `custom_user_agent` — Custom user agent to be used in the request headers.
+
 ## asyncio support
 
 asyncio support is available through the `pangea.asyncio.services` module. The
@@ -156,6 +176,7 @@ options:
 ```
 
 It accepts multiple file formats:
+
 - a Verification Artifact from the Pangea User Console
 - a search response from the REST API:
 
@@ -163,7 +184,6 @@ It accepts multiple file formats:
 $ curl -H "Authorization: Bearer ${PANGEA_TOKEN}" -X POST -H 'Content-Type: application/json'  --data '{"verbose": true}' https://audit.aws.us.pangea.cloud/v1/search
 ```
 
-
 ### Bulk Download Audit Data
 
 Download all audit logs for a given time range. Start and end date should be provided,
@@ -213,15 +233,14 @@ options:
 ```
 
 It accepts multiple file formats:
+
 - a Verification Artifact from the Pangea User Console
 - a file generated by the `dump_audit` command
 - a search response from the REST API (see `verify_audit`)
 
-
-
-   [Documentation]: https://pangea.cloud/docs/sdk/python/
-   [GA Examples]: https://github.com/pangeacyber/pangea-python/tree/main/examples
-   [Beta Examples]: https://github.com/pangeacyber/pangea-python/tree/beta/examples
-   [Pangea Console]: https://console.pangea.cloud/
-   [Secure Audit Log]: https://pangea.cloud/docs/audit
+  [Documentation]: https://pangea.cloud/docs/sdk/python/
+  [GA Examples]: https://github.com/pangeacyber/pangea-python/tree/main/examples
+  [Beta Examples]: https://github.com/pangeacyber/pangea-python/tree/beta/examples
+  [Pangea Console]: https://console.pangea.cloud/
+  [Secure Audit Log]: https://pangea.cloud/docs/audit