Hey folks π
After days of tinkering, testing, breaking things (and fixing them again), I finally published my first ever Python package to PyPI!
π‘ What It Does
bulk-file-organizer
is a simple CLI tool that helps you automatically organize messy folders by file type.
Whether itβs your Downloads folder that looks like a digital jungle π΄ or your project assets scattered all overβthis little tool tidies everything up into clean folders in one command.
Installation & Usage
pip install bulk-file-organizer
bulk-organizer --help
π§ What I Learned
This was my first deep dive into:
-
Python packaging with
setuptools
-
pyproject.toml
configuration - Testing builds using TestPyPI
- Creating and using command-line entry points
- Managing metadata and dependencies
Honestly, I went through the whole loopβconfusion β research β errors β debugging β triumph π and thatβs what made it fun.
π οΈ Open Source & Contributions
The project is open-source on GitHub:
π github.com/Shravan250/bulk-file-organizer
If you try it out, Iβd love your feedback! You can:
- βοΈ Star it if you like it
- π Open issues for bugs
- π‘ Suggest features
- π§ Create pull requests
Every contribution counts and helps it evolve.
π₯ The Story Behind It
I also recorded a short video sharing my journeyβfrom idea to publishing it on PyPI. It captures all the tiny details, moments of doubt, and that final βYES, it worked!β moment π
π± Final Thoughts
It might not be the biggest or most complex project, but itβs mineβbuilt from curiosity, persistence, and a ton of trial & error.
And that, I think, is the real joy of being a developer. The small steps that make you go, βHuh, I can actually do this!β
Hereβs to more experiments, small wins, and open-source adventures ahead β¨
Top comments (0)