Skip to main content

hb_organiser

PyPI image Unittests codecov Pylint

Organises Humble Bundle bundles based on their platform. Designed to work around the structure created via Talonius' hb-downloader. Other automated HB downloaders may not work with this out of the box.

An image of hb-organiser copying files

Install

As it's packaged as a Pip module, python3-pip is required. Run pip install --user hb-organiser to install only for your user and omit --user to install for all. See hb_organiser -h for help.

Why is this needed?

I mainly use Humble Bundle to purchase book bundles (that I'll totally read at some point, I swear!) and have accumulated thousands of books over the years. I would like to have all these books hosted via a Calibre web server for easy access but trying to weed out the books from the default structure left behind by automated downloads is a headache.

To alleviate this issue, I'm making this script that will organise my libraries with a click of a key. Duplicate items across different bundles will be ignored, all the books will be easily discovered via Calibre, and my sanity will be saved.

Features

  • Calculates number of tasks so that you're not left in the dark and can tell the progress.

  • A crude way of tracking files being corrupted via a cancelled transfer by logging what is being operated upon and clearing it once complete. If it doesn't get cleared, chances are it was corrupted.

  • Skips copying of duplicate files by checking for its existence first (although there is a chance it may skip newer files such as updated editions of books (see issue 6)).

Immediate roadmap

The immediate goal is to put out something working. To keep development more direct I'll outline pressing matters below:

  • Cut down on operation times
    • Organising thousands of files in one go is very time-consuming - especially when working with game bundles. Speeding this up will save millions of hours of collective time over the years via optimisation.

Future plans

Longer term goals than those outlined above will be put here:

  • Abstract all the things
    • Quite a few values are hard-coded at the moment. To make it more convenient for others, this should be changed to allow for more options.
  • Abstract them even further
    • Why does this have to be limited to Humble Bundles? All its doing is moving one category of files from one place to another. This could be useful in other situations such as organising music.

Metadata

Release files for hb-organiser 1.0.9

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hb-organiser 1.0.9
File Size Uploaded Provenance
hb_organiser-1.0.9.tar.gz 9.8 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for hb-organiser 1.0.9
File Interpreter ABI Platform
hb_organiser-1.0.9-py3-none-any.whl Python 3 none any Details

Total release size: 21.5 kB

Release files / hb_organiser-1.0.9.tar.gz

Download URL hb_organiser-1.0.9.tar.gz
Size 9.8 kB
Tags Source
SHA-256 checksum
How to use checksums
3e69410df159546fbb3329755a6e0ea97e7af38370038cf22d8d944a0ff164a9
BLAKE2b-256 checksum
How to use checksums
b48a6d5973c0a4fd37915efd3e080b68fd9d5f25820f4a6d578c5c279823f16f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.3.0 pkginfo/1.6.1 requests/2.25.1 setuptools/44.0.0 requests-toolbelt/0.9.1 tqdm/4.55.2 CPython/3.8.5

Release files / hb_organiser-1.0.9-py3-none-any.whl

Download URL hb_organiser-1.0.9-py3-none-any.whl
Size 11.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3028c78a099d68967138d28d0d17d9171b4e05d8ee8d933c004e1d1ec1e71d37
BLAKE2b-256 checksum
How to use checksums
0214a37a36fe105ea6bd3abddb023bb8604d069262795f4299d3860e83338b2b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.3.0 pkginfo/1.6.1 requests/2.25.1 setuptools/44.0.0 requests-toolbelt/0.9.1 tqdm/4.55.2 CPython/3.8.5

Security for hb-organiser 1.0.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page