Skip to content

Smart File Organizer v0.3.0

Choose a tag to compare

@gcomneno gcomneno released this 04 Jul 16:04

Smart File Organizer v0.3.0

Highlights:

  • User TOML semantic rules now extend built-in rules instead of replacing them (#25).
  • Added optional recursive directory scanning with --recursive (#22).
  • Added JSON plan preview output with --format json (#24).
  • Added opt-in destination conflict resolution with --conflict-strategy rename (#23).
  • Improved built-in filename rules for utilities, health, banking, INPS, and programming books (#28).
  • Reduced false positives in --inspect-content matching (#26).
  • Suppressed third-party PDF parser warnings by default; use --verbose to show them (#27).

Compatibility:

  • Default behavior remains a safe dry run.
  • Files are moved only with --apply.
  • Text plan output remains the default preview format.
  • Destination conflicts still fail by default unless --conflict-strategy rename is passed.

Real-world validation:

  • Tested on a personal backup dataset (~125 files, recursive scan).
  • Name-only classification: ~81% of files routed to semantic folders.
  • With --inspect-content: ~89% classified, 14 files remaining in generic documents/.

Validation:

  • ruff format check
  • ruff lint
  • ty check
  • pytest (120 tests)

Privacy boundary:

  • Real/private files, local configuration, manual-run data, and private document contents are not included in the repository.