Skip to content

smart-file-organizer v0.1.0

Choose a tag to compare

View all tags
@gcomneno gcomneno released this 09 Jun 17:33
v0.1.0
02bfca4
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

smart-file-organizer v0.1.0

Initial public release of Smart File Organizer.

This release provides a safe Python CLI for planning and applying file organization workflows.

Highlights

  • Builds an organization plan before moving files.
  • Uses dry-run behavior by default.
  • Moves files only when --apply is explicitly passed.
  • Supports explicit source files and direct files from a source directory.
  • Classifies files by extension and semantic filename/path rules.
  • Supports opt-in document content inspection with --inspect-content.
  • Extracts text from supported .txt and selectable-text .pdf files.
  • Refuses destination conflicts.
  • Refuses to overwrite existing destination files.
  • Includes project-local tooling with uv, ruff, and pytest.
  • Includes GitHub Actions CI.
  • Includes MIT license.

Current limitations

  • Directory scanning is not recursive yet.
  • PDF content inspection works only for PDFs with extractable text.
  • OCR for scanned documents is not implemented yet.
  • There is no configuration file yet.
  • Existing destination files are never overwritten.
  • There is no rename strategy for conflicts yet.

Privacy boundary

The repository is intentionally built with synthetic examples and must not contain private backup data, real document contents, or real manual-run outputs.

Assets 2
Loading