🔍 Code Extractor

Command-line interface function that moves a single reMarkable document to trash by accepting a document UUID as a command-line argument.

Purpose

This function serves as the entry point for a command-line tool that moves reMarkable documents to trash. It validates command-line arguments, instantiates a DocumentToTrashMover object, executes the trash operation, and provides user-friendly console feedback with emoji indicators for success or failure states.

Source Code

def main():
    """Move a single document to trash via command line parameter"""
    import sys
    
    if len(sys.argv) != 2:
        print("Usage: python move_documents_to_trash.py <document_uuid>")
        print("Example: python move_documents_to_trash.py 206f5df3-07c2-4341-8afd-2b7362aefa91")
        return False
    
    document_uuid = sys.argv[1]
    
    try:
        mover = DocumentToTrashMover()
        
        print(f"🗑️ Moving Document to Trash")
        print(f"Document UUID: {document_uuid}")
        print("=" * 60)
        
        success = mover.move_document_to_trash(document_uuid)
        
        if success:
            print(f"\n🎉 SUCCESS!")
            print(f"✅ Document {document_uuid[:8]}... moved to trash successfully!")
            print(f"📱 Check your reMarkable device - document should now be in trash")
        else:
            print(f"\n❌ FAILED!")
            print(f"❌ Failed to move document {document_uuid[:8]}... to trash")
        
        return success
        
    except Exception as e:
        print(f"❌ Failed to initialize: {e}")
        return False

Return Value

Returns a boolean value: True if the document was successfully moved to trash, False if the operation failed due to incorrect arguments, initialization errors, or trash operation failure.

Dependencies

• json
• time
• hashlib
• uuid
• base64
• zlib
• pathlib
• sys
• crc32c

Required Imports

import sys
from auth import RemarkableAuth
import crc32c

Conditional/Optional Imports

These imports are only needed under specific conditions:

import sys

Usage Example

# Run from command line:
# python move_documents_to_trash.py 206f5df3-07c2-4341-8afd-2b7362aefa91

# Or call programmatically:
if __name__ == '__main__':
    success = main()
    if success:
        print('Document moved successfully')
    else:
        print('Operation failed')

Best Practices

• Always provide exactly one command-line argument (the document UUID) when running this script
• Ensure the DocumentToTrashMover class is properly defined and imported before calling this function
• Verify that authentication credentials for reMarkable API are configured before execution
• The function expects a valid UUID format for the document identifier
• Check the return value to determine if the operation succeeded
• This function is designed to be called as a script entry point (if __name__ == '__main__')
• Error handling is basic - consider wrapping calls in additional try-except blocks for production use

Tags

Similar Components

AI-powered semantic similarity - components with related functionality:

• function main_v86 78.7% similar

  A test function that attempts to move a specific document (identified by UUID) from trash to a 'gpt_in' folder on a reMarkable device using the DocumentMover class.

  From: /tf/active/vicechatdev/e-ink-llm/cloudtest/test_move_from_trash.py

• function simple_move_to_trash 77.7% similar

  Moves all documents from the reMarkable tablet's root directory to trash by uploading an empty root.docSchema file and updating the roothash.

  From: /tf/active/vicechatdev/e-ink-llm/cloudtest/simple_clean_root.py

• function apply_working_trash_move 77.6% similar

  Moves a hardcoded list of reMarkable cloud documents to trash by authenticating with the reMarkable API and applying trash operations to each document.

  From: /tf/active/vicechatdev/e-ink-llm/cloudtest/apply_working_trash_move.py

• function move_document_to_trash 76.7% similar

  Moves a reMarkable document to trash by updating its metadata parent field to 'trash', then propagating the changes through the document schema hierarchy and updating the root hash.

  From: /tf/active/vicechatdev/e-ink-llm/cloudtest/apply_working_trash_move.py

• class DocumentToTrashMover 76.5% similar

  A class that moves reMarkable documents to the trash by updating their metadata parent field to 'trash' and synchronizing changes through the reMarkable cloud API.

  From: /tf/active/vicechatdev/e-ink-llm/cloudtest/move_documents_to_trash.py