Sage

sage-directory is a python package that offers a detailed overview of folder contents and streamlines the process of copying and managing directories. It is designed to enhance productivity and simplify file management. It provides details of folder contents, including the file types, size, and subfolder structures, enabling quick insights into the organization of your directory.

Beyond analysis, the tool offers robust functionality for copying entire folders, ensuring seamless management and replication of data environments. Whether you're organizing complex project files, backing up critical datasets, or duplicating environments, this tool is built to optimize your workflow.

Installation

pip install sage-directory

Usage

Main Features

Comprehensive Folder Overview

Generate detailed summaries of folder contents, including file types, sizes, and subfolder structures,

import sage

sage.get_folder_overview('.')

Selective Copying

Choose a specific file to overwrite another in multiple directories

import sage

# overwrites the entered filename (basement.png) in the renovated_kitchen folder with the file in kitchen_catelog folder

sage.batch_file_overwrite(./kitchen_catelog, ./renovated_kitchen, "basement.png")

Batch Operations

Perform operations on multiple directories

import sage

# only copies 10 folders that are in the kitchen_catelog that share the same folder names as those in the old_kitchen folder in the renovated_kitchen folder

sage.copy_num_folders(./old_kitchen, ./kitchen_catelog, ./renovated_kitchen, 10)

# only copies folders that are in the kitchen_catelog that share the same folder names as those in the old_kitchen folder in the renovated_kitchen folder

sage.copy_folders(./old_kitchen, ./kitchen_catelog, ./renovated_kitchen)