Skip to content

PatzEdi/FinderZ

Repository files navigation

FinderZ

Full File Management Library for Python. And growing (V2 is out!)

logo-color

IMPORTANT:

V2 is finally out! To check out the details, go to the readthedocs documentation under the update v2 section! Documentation: FinderZ

If you want to use the Synchronization and Backup classes, please read the documentation linked above in order to prevent data loss

AND: Huge thank you to @mvandermeulen, @wxxb789, @pvergain, @RichardDally , @Wahtes, @coolslutguy420, @kyzsuukii, @mikudae , and @fablau for starring FinderZ.

Written in python, this library provides you with different file operation commands as well as info gathering commands on directories as well as files.


CHANGELOG: V2.0.0

Check out the changelog (Starting 2.1.2 Onward): CHANGELOG

Latest Version: 2.1.2 (December 27, 2023)

To check out the details of V2, go to the documentation. This is a big update with many new things!

Usage

Installation:

pip3 install FinderZ

Importing:

import FinderZ

Features

  • Consists of five classes: GatherInfo, fileOperands, Synchronize, Backup, and callBash.
  • Advanced file operations, already built for you (including many options to choose from!)
  • Supports regex operations for some functions, as well as specific filters and multiple other choices to choose from. Options such as exact search or something even just containing a keyword, or even having the option to choose to search recursively, are all included.
  • Includes full-featured, reliable synchronization and backup classes (beta). Both include optional and detailed logging.
  • Full set of info gathering tools under the GatherInfo class.
  • Full-featured documentation to guide you through each function in detail.
  • In case of functionality restrictions, callBash is a function that calls a bash script in order to expand functionality at its peak.
  • Easy to use.
  • You no longer have to take your time in making those file management algorithms that take a while to complete.
  • Fast and efficient, includes a plethora of other features.

Why?

  • FinderZ is a way to easily expand on the file system of many operating systems. It supports, MacOS, Windows, Linux, and Android.
  • Who wouldn't want a tool to manage their files easily in their python scripts? This will save time!

How?

  • FinderZ is composed of many iterating techniques and parametric options. Based on these options, the core of each function deals with a user's choice of what to do or what not to do.
  • More info under the documentation!

User notice

  • I am not responsible for any damage or data lost using the FinderZ library.
  • If using the Synchronize class, make sure renaming files or directories is never the last thing you do before synchronization, unless it is the only thing you did do (no adding, removing, copying, etc. files before)
  • This project has just been released to version 2! It has grown so much, but it is still growing and improving.

Services used (Credits):


Make sure to leave a star!

  • If you like this project, leaving a star is what motivates me in doing more. Thank you, and I hope this is useful to all.