Skip to main content

A simple script to list folder sizes

Project description

FolderSizes Project

Description

FolderSizes is a Python package that provides a command-line interface for displaying the sizes of directories and files in a human-readable format. It allows users to easily visualize the space usage of their file system.

Features

  • Recursively calculates the total size of directories.
  • Displays sizes in both human-readable format and in bytes.
  • Optionally includes files in the size listing.
  • Sorts entries by size, largest first.

Installation

To install FolderSizes, you can use pip. First, ensure you have Python and pip installed on your system. Then, run the following command:

pip install FolderSizes

Usage

After installation, you can use the foldersizes command in your terminal. Here are some examples of how to use it:

  1. To display sizes of subdirectories in the current directory:

    foldersizes
    
  2. To display sizes in a human-readable format:

    foldersizes -H
    
  3. To include files in the listing:

    foldersizes --files
    
  4. To sort entries by size, largest first:

    foldersizes -s
    

Requirements

This package requires the click library. It will be installed automatically when you install FolderSizes.

License

This project is licensed under the MIT License. See the LICENSE file for more details.

Contributing

Contributions are welcome! Please feel free to submit a pull request or open an issue for any suggestions or improvements.

Author

Carter Struck

Acknowledgments

  • Thanks to the contributors of the click library for making command-line interfaces easier to implement.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

foldersizes-0.1.0.tar.gz (4.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

foldersizes-0.1.0-py3-none-any.whl (4.4 kB view details)

Uploaded Python 3

File details

Details for the file foldersizes-0.1.0.tar.gz.

File metadata

  • Download URL: foldersizes-0.1.0.tar.gz
  • Upload date:
  • Size: 4.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for foldersizes-0.1.0.tar.gz
Algorithm Hash digest
SHA256 13bab558654303e91f6a102055d97422c64c88f792e858b1b1b7326c61fa00bc
MD5 a2c7f8d5a472d87a267925ef4704553b
BLAKE2b-256 25930ea045437615c1b06777d5d6a416a04996e66bff538b870b68c11eeb24a8

See more details on using hashes here.

File details

Details for the file foldersizes-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: foldersizes-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 4.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for foldersizes-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 50dc898cdfb90e62d3be04b123073ef8575f7c50d93e66a1ef6d37ff4b948592
MD5 adf186c2612fe4acf297d19abcd497c7
BLAKE2b-256 a15c40cefac5acc1be631e9bdf5b7394b648e33c65090ac5247a7a9e56928cdb

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page