major refactors and improvements

docs

• README examples
• added extensive typing for missing modules doorway.x._proxy, doorway._shard and many more

added

• added ctx_do_undo, pass in do fn and undo fn as part of a context manager
• additional SI/IEC units ronna R and quetta Q (coming after yotta) for fmt_bytes_to_human
• added progress: bool to io_download
• added new proxy scraper for proxylist.geonode.com
• added support for python 3.9 through python 3.13

breaking

• renamed sharded_and_grouped to sharded_weighted to better reflect the nature of this API
• renamed sharded_weighted param from group_sizes to shard_weights
• re-write the EnvVar system
• changed default mode for AtomicFile from x to r
• replaced overwrite_existing in io_download with exists_mode
• fixed io_download should not require tqdm
• fixed ProxyDownloader.download_threaded should allow iterator instead of sequence
• renamed various proxy functions and classes to start with [Pp]roxy as the prefix
• drop support for python 3.8

fixed

• kB instead of KB in fmt_bytes_to_human
• added support for pathlib.Path to proxies and other APIs
• use None for return type instead of NoReturn which signals exit

CI

• upgraded CI steps
• added CI for ruff linting and formatting
• added CI version bump
• added local pre-commit hooks

What's Changed

• improvements #minor by @nmichlo in #1

Full Changelog: v0.5.0...v0.6.0