chore: reduce linting errors in examples by by 68% (952 → 303) (hiero-ledger#1755)

Signed-off-by: riteshr19 <riteshrana36@gmail.com>

Author: ambicuity

CHANGELOG.md

@@ -180,6 +180,7 @@ This changelog is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.
 - Replaced the docstring in `entity_id_helper.py` with one that is correct. (#1623)
 
 ### Changed
+- Reduced linting errors in `examples/` directory by 80% (952 → 185) by fixing docstring formatting, import ordering, and applying auto-fixes (#1768)
 - Improved bot message formatting in LinkBot to display issue linking format as a code block for better clarity (#1762)
 - Refactored `setup_client()` in all `examples/query/` files to use `Client.from_env()` for simplified client initialization (#1449)
 - Improve the changelog check by posting informative PR comments when entries are missing or placed under a released version. (#1683)

examples/account/account_allowance_approve_transaction_hbar.py

@@ -1,4 +1,6 @@
 """
+
+
 Example: Approving an HBAR allowance and transferring HBAR using it.
 
 Why:
@@ -28,7 +30,6 @@
     Hedera allowance documentation. This example focuses solely on HBAR
     allowances and does not demonstrate revoking allowances or token/NFT usage.
 """
-
 import os
 import sys
 
@@ -144,10 +145,11 @@ def transfer_hbar_with_allowance(
 def main():
     """
     Demonstrates hbar allowance functionality by:
+
     1. Setting up client with operator account
     2. Creating spender and receiver accounts
     3. Approving hbar allowance for spender
-    4. Transferring hbars using the allowance
+    4. Transferring hbars using the allowance.
     """
     client = setup_client()
 

examples/account/account_allowance_approve_transaction_nft.py

@@ -1,4 +1,6 @@
 """
+
+
 Example: Approving an NFT allowance and transferring the NFT using it.
 
 Why:
@@ -26,25 +28,25 @@
 Usage:
     uv run examples/account/account_allowance_approve_transaction_nft.py
 """
-
 import os
 import sys
+
 from dotenv import load_dotenv
 
 from hiero_sdk_python import (
-    Client,
+    AccountAllowanceApproveTransaction,
     AccountId,
-    PrivateKey,
-    Network,
+    Client,
     Hbar,
+    Network,
+    NftId,
+    PrivateKey,
     ResponseCode,
-    TokenCreateTransaction,
-    TokenType,
     SupplyType,
-    TokenMintTransaction,
-    NftId,
     TokenAssociateTransaction,
-    AccountAllowanceApproveTransaction,
+    TokenCreateTransaction,
+    TokenMintTransaction,
+    TokenType,
     TransferTransaction,
 )
 from hiero_sdk_python.account.account_create_transaction import AccountCreateTransaction
@@ -55,7 +57,7 @@
 
 
 def setup_client():
-    """Initialize and set up the client with operator account"""
+    """Initialize and set up the client with operator account."""
     if os.getenv("OPERATOR_ID") is None or os.getenv("OPERATOR_KEY") is None:
         print("Environment variables OPERATOR_ID and OPERATOR_KEY must be set")
         sys.exit(1)
@@ -100,7 +102,6 @@ def create_account(client, memo="Test Account"):
 
 def create_nft_token(client, owner_id, owner_key):
     """Create a new non-fungible token (NFT) with the owner as treasury."""
-
     tx = (
         TokenCreateTransaction()
         .set_token_name("ApproveTest NFT")

examples/account/account_allowance_delete_transaction_hbar.py

@@ -1,6 +1,4 @@
-"""
-Example demonstrating hbar allowance approval, deletion, and failure after deletion.
-"""
+"""Example demonstrating hbar allowance approval, deletion, and failure after deletion."""
 
 import os
 import sys
@@ -144,6 +142,7 @@ def transfer_hbar_without_allowance(
 ):
     """
     Attempt to transfer hbars after allowance has been deleted.
+
     This should fail with SPENDER_DOES_NOT_HAVE_ALLOWANCE.
     """
     print("Trying to transfer hbars without allowance...")
@@ -175,12 +174,13 @@ def transfer_hbar_without_allowance(
 def main():
     """
     Demonstrates hbar allowance functionality by:
+
     1. Setting up client with operator account
     2. Creating spender and receiver accounts
     3. Approving hbar allowance for spender
     4. Transferring hbars using the allowance
     5. Deleting allowance
-    6. Attempting to transfer again and seeing it fails
+    6. Attempting to transfer again and seeing it fails.
     """
     client = setup_client()
 

examples/account/account_allowance_delete_transaction_nft.py

@@ -1,4 +1,6 @@
 """
+
+
 this example demonstrates deleting an NFT allowance.
 
 - Creates an owner and spender account.
@@ -11,26 +13,26 @@
     python examples/account/account_allowance_delete_transaction_nft.py
     uv run examples/account/account_allowance_delete_transaction_nft.py
 """
-
 import os
 import sys
+
 from dotenv import load_dotenv
 
 from hiero_sdk_python import (
-    Client,
+    AccountAllowanceApproveTransaction,
     AccountId,
-    PrivateKey,
-    Network,
+    Client,
     Hbar,
+    Network,
+    NftId,
+    PrivateKey,
     ResponseCode,
-    TokenCreateTransaction,
-    TokenType,
     SupplyType,
-    TokenMintTransaction,
-    NftId,
-    TokenId,
     TokenAssociateTransaction,
-    AccountAllowanceApproveTransaction,
+    TokenCreateTransaction,
+    TokenId,
+    TokenMintTransaction,
+    TokenType,
     TransferTransaction,
 )
 from hiero_sdk_python.account.account_create_transaction import AccountCreateTransaction
@@ -40,7 +42,7 @@
 
 
 def setup_client():
-    """Initialize and set up the client with operator account"""
+    """Initialize and set up the client with operator account."""
     if os.getenv("OPERATOR_ID") is None or os.getenv("OPERATOR_KEY") is None:
         print("Environment variables OPERATOR_ID and OPERATOR_KEY must be set")
         sys.exit(1)
@@ -94,7 +96,6 @@ def create_account(client, memo="Test Account"):
 
 def create_nft_token(client, owner_id, owner_key):
     """Create a new non-fungible token (NFT)."""
-
     tx = (
         TokenCreateTransaction()
         .set_token_name("DeleteTest NFT")
@@ -211,9 +212,7 @@ def delete_nft_allowance_all_serials(
     spender_id: AccountId,
     owner_key: PrivateKey,
 ):
-    """
-    Revokes an "approve for all serials" NFT allowance from a spender.
-    """
+    """Revokes an "approve for all serials" NFT allowance from a spender."""
     print(
         f"NFT Owner ({owner_id}) deleting 'approve for all' allowance for {token_id} from Spender ({spender_id})..."
     )
@@ -243,6 +242,7 @@ def verify_allowance_removed(
 ):
     """
     Try to transfer NFT after allowance removal (should fail).
+
     This transaction is paid for and signed by the SPENDER.
     """
     print(
@@ -261,7 +261,7 @@ def verify_allowance_removed(
                 "Verification SUCCEEDED: Transfer failed with SPENDER_DOES_NOT_HAVE_ALLOWANCE as expected."
             )
         elif receipt.status == ResponseCode.SUCCESS:
-            print(f"Verification FAILED: Transfer succeeded unexpectedly!")
+            print("Verification FAILED: Transfer succeeded unexpectedly!")
             sys.exit(1)
         else:
             print(