DEV Community

Cover image for πŸš€ I Published My First Python Package β€” bulk-file-organizer πŸŽ‰
Shravan Bobade
Shravan Bobade

Posted on

πŸš€ I Published My First Python Package β€” bulk-file-organizer πŸŽ‰

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
Enter fullscreen mode Exit fullscreen mode

🧠 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)