refactor: modularize file_append example into setup, create, and appe… (#557)

Signed-off-by: tobi <onatadetobi212@gmail.com>
Signed-off-by: Tobi Onatade <onatadetobi212@gmail.com>

Author: OnatadeTobi

CHANGELOG.md

@@ -34,6 +34,8 @@ This changelog is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.
 - Added "One Issue Per Pull Request" section to `examples/sdk_developers/common_issues.md`.
 - docs: Improved the contributing section in the README.md file
 - Refactored `examples/transfer_nft.py` to be more modular by isolating transfer logic.
+- Refactored `examples/file_append.py` into modular functions for better readability, reuse, and consistency across examples.
+- Ensured identical runtime behavior and output to the previous version to maintain backward compatibility.
 - Renamed `examples/hbar_allowance.py` to `examples/account_allowance_hbar.py` for naming consistency
 - Converted monolithic function in `token_create_nft_infinite.py` to multiple modular functions for better structure and ease.
 - docs: Use relative paths for internal GitHub links (#560).

examples/file_append.py

@@ -36,18 +36,8 @@ def setup_client():
 
     return client
 
-def file_append():
-    """
-    Demonstrates appending content to a file on the network by:
-    1. Setting up client with operator account
-    2. Creating a file with initial content
-    3. Appending additional content to the file
-    """
-    client = setup_client()
-    
-    file_private_key = PrivateKey.generate_ed25519()
-    
-    # Step 1: Create a file with initial content
+def create_file(client, file_private_key):
+    """Create a file with initial content"""
     print("Creating file with initial content...")
     create_receipt = (
         FileCreateTransaction()
@@ -66,7 +56,10 @@ def file_append():
     file_id = create_receipt.file_id
     print(f"File created successfully with ID: {file_id}")
 
-    # Step 2: Append content to the file (single chunk)
+    return file_id
+
+def append_file_single(client, file_id, file_private_key):
+    """Append content to the file (single chunk)"""
     print("\nAppending content to file (single chunk)...")
     append_receipt = (
         FileAppendTransaction()
@@ -82,8 +75,9 @@ def file_append():
         sys.exit(1)
 
     print("Content appended successfully!")
-    
-    # Step 3: Append large content (multi-chunk)
+
+def append_file_large(client, file_id, file_private_key):
+    """Append large content to the file (multi-chunk)"""
     print("\nAppending large content (multi-chunk)...")
     large_content = b"Large content that will be split into multiple chunks. " * 100
 
@@ -105,5 +99,25 @@ def file_append():
     print("Large content appended successfully!")
     print(f"Total chunks used: {FileAppendTransaction().set_contents(large_content).get_required_chunks()}")
 
+def main():
+    """
+    Demonstrates appending content to a file on the network by:
+    1. Setting up client with operator account
+    2. Creating a file with initial content
+    3. Appending additional content to the file
+    """
+    client = setup_client()
+    
+    file_private_key = PrivateKey.generate_ed25519()
+    
+    # Step 1: Create a file with initial content
+    file_id = create_file(client, file_private_key)
+    
+    # Step 2: Append content to the file (single chunk)
+    append_file_single(client, file_id, file_private_key)
+    
+    # Step 3: Append large content (multi-chunk)
+    append_file_large(client, file_id, file_private_key)
+
 if __name__ == "__main__":
-    file_append() 
+    main()