Metadata-Version: 2.1
Name: rclone-ls
Version: 0.0.2
Summary: Script to list files/dirs and their sizes in a given rclone path.
Home-page: https://github.com/dportabella/rclone_ls
Author: David Portabella
Author-email: david.portabella@gmail.com
License: MIT
Keywords: Python,rclone,ls
Requires-Python: >=3.0
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: rclone (>=0.4.4)
Requires-Dist: humanize (>=4.6.0)

# rclone_ls

List files/dirs and their sizes in a given rclone path.

## Example usage
```
$ ./rclone_ls googledrive:/backup
8196	.DS_Store
1747191312	books/
1503049236	downloads/
930638960	temp/
total:	8225934615


$ ./rclone_ls -H googledrive:/backup
8.2 kB	.DS_Store
1.7 GB	books/
1.5 GB	downloads/
930.6 MB	temp/
total:	2.7 GB


$ ./rclone_ls /home/david/books
259333833  book1.pdf
4534544    book2.pdf
total:  263868377


$ ./rclone_ls -h
usage: rclone_ls [-h] [-H] [--debug] rclone_path

List files/dirs and their sizes in a given rclone path. For instance: rclone_ls remote:/path

positional arguments:
  rclone_path  rclone path

options:
  -h, --help   show this help message and exit
  -H           Use unit suffixes: Byte, Kilobyte, Megabyte...
  --debug      Enable debug mode
```

## Note
- The `total` output is printed in stderr. 
  To prevent it from being displayed, you can add the following to the command line: `2>/dev/null`.
- The `rclone_path` parameter can also accept a local folder path like `/home/david/books`.


## Installation
- Manually install rclone: https://rclone.org/downloads/
- Configure your rclone remotes: https://rclone.org/commands/rclone_config/
- `$ pip install rclone_ls`


## ChatGPT Python Developer Assistance
I sought assistance from ChatGPT during the the development and publication of this simple Python script, and I must say it was absolutely incredible. I'm sharing a [transcript of our conversation](chatgpt_developer_assistance.md).
