The Developer-First Interface for AWS S3 Management.
CloudPail is a terminal-based utility designed to bridge the gap between the complex, syntax-heavy AWS CLI and the latency-prone AWS Console. It provides a robust Text User Interface (TUI) for managing cloud storage resources with speed, precision, and operational safety.
Managing S3 resources often requires a trade-off between speed and usability. The AWS Console offers visual feedback but suffers from slow load times and context switching. The AWS CLI offers speed but requires memorizing verbose commands and lacks safeguards against user error.
CloudPail resolves this by offering an interactive shell that adheres to the "Append-Only" design philosophy, preserving session context while providing immediate visual feedback for all operations.
Standard Boto3 implementations often default to global endpoints, causing SignatureDoesNotMatch errors when interacting with buckets in specific regions (e.g., eu-north-1). CloudPail automatically detects the bucket's region and routes requests to the correct regional endpoint, ensuring cryptographic signature compliance across all AWS zones.
- Verification: Implements mandatory
head_objectpre-flight checks before deletion to prevent "false positives" on non-existent resources. - Recursive Cleanup: Includes logic to detect non-empty buckets and offers a recursive deletion workflow to remove all objects, delete markers, and versions before removing the bucket itself.
- Dynamic Profile Switching: Reads directly from
~/.aws/credentialsto allow instant context switching between environments (e.g., Development, Staging, Production) without restarting the shell. - Session Persistence: Maintains authentication state globally across the application lifecycle.
- MIME-Type Detection: Automatically identifies file types during upload to set accurate
Content-Typeheaders, ensuring assets render correctly in web browsers. - Recursive Folder Uploads: Supports batch uploading of directory structures while maintaining the hierarchy within the S3 bucket.
- Presigned URL Generation: Generates secure, time-limited access links (1-hour expiration) and automatically copies them to the system clipboard for immediate sharing.
CloudPail is available on the Python Package Index (PyPI). You can install it directly using pip:
pip install cloudpailTo upgrade to the latest version, run:
pip install --upgrade cloudpailCloudPail utilizes your standard AWS credentials.
- If you have already configured the AWS CLI, no further setup is required.
- If you are setting up this machine for the first time, run:
aws configure
Once installed, the application is available system-wide using the cloudpail command:
cloudpailThe interface uses standard keyboard controls for efficient operation:
- Arrow Keys: Navigate through bucket and object lists.
- Enter: Confirm selection or execute the chosen action.
- Type-to-Filter: Rapidly filter long lists by typing the resource name directly into the menu.
CloudPail is built upon a modern Python stack designed for reliability and performance:
- Boto3: Handles low-level AWS SDK interactions, authentication, and session management.
- Rich: Renders high-performance tables, status indicators, and formatted terminal output.
- InquirerPy: Manages interactive user input, validation, and menu navigation.
- Pyperclip: Provides cross-platform clipboard integration for copying presigned URLs.
CloudPail is an open-source project, and contributions are always welcome! Whether you're interested in fixing bugs, adding new features, or improving documentation, your help is appreciated.
If you'd like to contribute, please feel free to:
- Fork the repository and submit a pull request.
- Open an issue to report bugs or suggest improvements.
This project is distributed under the MIT License. See LICENSE for more information.
Copyright (c) 2025 shakeelsaga.