https://github.com/marcuwynu23/bucket-fileuploader

A web service for uploading files to bucket storage (MinIO, AWS S3, Cloudflare R2, etc.).
https://github.com/marcuwynu23/bucket-fileuploader

file fileuploader minio r2 s3 storage storage-api web

Last synced: 9 days ago
JSON representation

A web service for uploading files to bucket storage (MinIO, AWS S3, Cloudflare R2, etc.).

• Host: GitHub
• URL: https://github.com/marcuwynu23/bucket-fileuploader
• Owner: marcuwynu23
• License: mit
• Created: 2025-09-19T04:45:50.000Z (9 months ago)
• Default Branch: main
• Last Pushed: 2026-05-06T22:50:01.000Z (about 1 month ago)
• Last Synced: 2026-05-07T00:16:11.644Z (about 1 month ago)
• Topics: file, fileuploader, minio, r2, s3, storage, storage-api, web
• Language: Python
• Homepage:
• Size: 170 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md

Awesome Lists containing this project

README

          


# Bucket Storage File Uploader API

![Python Version](https://img.shields.io/badge/python-3.10+-blue.svg) ![License](https://img.shields.io/badge/license-MIT-green.svg) ![Version](https://img.shields.io/badge/version-v1.0.0-orange.svg) ![Flask](https://img.shields.io/badge/Flask-3.1.2-000000?style=flat&logo=flask) ![Bucket Storage](https://img.shields.io/badge/Bucket-Storage-FF9900?style=flat) ![Docker](https://img.shields.io/badge/Docker-Available-2496ED?style=flat&logo=docker)



A web service for uploading files to bucket storage (MinIO, AWS S3, Cloudflare R2, etc.).

---

## Features

- **Security First**: Path traversal protection, magic number validation, and encrypted tokens

- **Bucket Storage Compatible**: Works with any bucket storage backend

- **Multiple Upload Methods**: Single file, multi-file, and chunked uploads for large files

- **Static URLs**: Direct file access with clean URLs

- **Observability**: Prometheus metrics and structured logging

- **Performance**: Optimized caching, presigned URLs for large files, and rate limiting

- **Delete Functionality**: Secure file deletion with encrypted tokens

- **Legacy Support**: Backward compatibility with old token-based render endpoints

- **Docker Ready**: Docker and Docker Compose support out of the box

---

## Documentation Guides

For complete documentation, please refer to the following guides:

- [API Documentation](docs/documentation.md) - Complete API endpoints, configuration, and examples

- [Contributing Guide](CONTRIBUTING.md) - Development setup, testing, and contribution guidelines

- [Release Notes](RELEASE-NOTES.md) - Project release history and changelog

- [Security Policy](SECURITY.md) - Security vulnerability reporting

- [Code of Conduct](CODE_OF_CONDUCT.md) - Community guidelines

### GitHub Templates

- [Pull Request Template](.github/PULL_REQUEST_TEMPLATE.md)

- [Issue Templates](.github/ISSUE_TEMPLATE/)

---

## License

- [License](LICENSE) - MIT License