https://github.com/thevickypedia/lists3
File Browser for S3 buckets
https://github.com/thevickypedia/lists3
filebrowser s3-bucket
Last synced: 2 months ago
JSON representation
File Browser for S3 buckets
- Host: GitHub
- URL: https://github.com/thevickypedia/lists3
- Owner: thevickypedia
- License: mit
- Created: 2024-05-11T21:55:13.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-13T03:28:48.000Z (4 months ago)
- Last Synced: 2025-02-28T10:35:47.612Z (3 months ago)
- Topics: filebrowser, s3-bucket
- Language: Rust
- Homepage:
- Size: 37.1 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ListS3
[![made-with-rust][rust-logo]][rust-src-page]
[![crates.io][crates-logo]][crate]
[![build][gh-logo]][build]
#### Summary
[`lists3`][repo] is a light-weight CLI tool to create a file browser for S3 buckets provisioning bucket listing.
Download pre-compiled OS specific executable
###### macOS (Intel)
```shell
curl -o lists3-darwin-amd64.tar.gz -LH "Accept: application/octet-stream" "https://github.com/thevickypedia/lists3/releases/latest/download/lists3-darwin-amd64.tar.gz"
```
###### macOS (M1)
```shell
curl -o lists3-darwin-arm64.tar.gz -LH "Accept: application/octet-stream" "https://github.com/thevickypedia/lists3/releases/latest/download/lists3-darwin-arm64.tar.gz"
```
###### Linux
```shell
curl -o lists3-linux-amd64.tar.gz -LH "Accept: application/octet-stream" "https://github.com/thevickypedia/lists3/releases/latest/download/lists3-linux-amd64.tar.gz"
```
###### Windows (curl)
```shell
curl -o lists3-windows-amd64.zip -LH "Accept: application/octet-stream" "https://github.com/thevickypedia/lists3/releases/latest/download/lists3-windows-amd64.zip"
```
###### Windows (Invoke-WebRequest)
```shell
Invoke-WebRequest -Uri https://github.com/thevickypedia/lists3/releases/latest/download/lists3-windows-amd64.zip -OutFile lists3-windows-amd64.zip
```
### Arguments
- **--bucket / -b**: Bucket name for which listing has to be created.
- **--region / -r**: Region name where the bucket is present. **Fallback:** Default Region
- **--filter / -f**: S3 prefix to filter (**eg:** `["github/"]`) **Fallback:** `[]`
- **--ignore / -i**: Objects to be ignored (**eg:** `["github/.DS_Store"]`) **Fallback:** `[]`
- **--object / -o**: Object name to upload in s3 (**eg:** `list.html`) **Fallback:** `list`
- **--proxy / -p**: Proxy server's path (**eg:** https://example.com/proxy) **Fallback:** https://jarvis.vigneshrao.com/proxy
- **--style / -s**: Styling for the UI (**eg:** `vanilla`) **Fallback:** bootstrap
### Sample
```shell
./lists3 --bucket thevickypedia.com --object list --filter '["github/"]' --ignore '["github/.DS_Store"]'
```
```shell
./lists3 --bucket thevickypedia.com --object list --filter '["github/"]'
```
## Crate
[https://crates.io/crates/lists3][crate]
### Cargo Docs - Official Runbook
[https://docs.rs/lists3/latest/lists3][docs]
**Generator**
```shell
cargo doc --document-private-items --no-deps
```
## Linting
### Requirement
```shell
rustup component add clippy
```
### Usage
```shell
cargo clippy --no-deps --fix
```
## License & copyright
© Vignesh Rao
Licensed under the [MIT License][license]
[rust-src-page]: https://www.rust-lang.org/
[repo]: https://github.com/thevickypedia/lists3
[license]: https://github.com/thevickypedia/lists3/blob/main/LICENSE
[build]: https://github.com/thevickypedia/lists3/actions/workflows/rust.yaml
[rust-logo]: https://img.shields.io/badge/Made%20with-Rust-black?style=for-the-badge&logo=Rust
[gh-logo]: https://github.com/thevickypedia/lists3/actions/workflows/rust.yaml/badge.svg
[crate]: https://crates.io/crates/lists3
[gh-checks]: https://github.com/thevickypedia/lists3/actions/workflows/rust.yml
[crates-logo]: https://img.shields.io/crates/v/lists3.svg
[docs]: https://docs.rs/lists3/latest/lists3