file_rename_util.py

### Written by Laura Jones ####
### 10/10/2025             ####
### Find me on GitHub :  github.com/LJones-alt

### I offer no guarentee of safety or accuracy of this software ###



## import all packages
import os

## create a class - this means we can reuse it later
class RenameUtil:
    ## init the class and run some functions automatically
    def __init__(self, folder_path: str = "", new_names : str = ""):
        self.dir = folder_path
        self.nameFile = new_names
        self.newNames = self._loadNewNames()
        self.files: list[str] = self._listFiles()

        ## private / internal function that finds
        ## all the files in your folder
    def _listFiles(self)-> list[str]:
        files =os.listdir(self.dir) 
        return files

        ## private / internal function that finds
        ## the index of the filename
    def _findIndex(self, filename : str):
        data = filename.split("_") 
        index  = int(data[2])
        return index
        
        ## internal function that loads all the new filenames
    def _loadNewNames(self):
        names = []
        with open(self.nameFile) as f:
            for line in f:
                names.append(line[:-2])
        return names
    
        ## public function that renames all files in the directory
    def rename(self):
        for file in self.files:
            index = self._findIndex(file)
            os.rename(f"{self.dir}/{file}", f"{self.dir}/{self.newNames[index]}.raw")


### To use : 

## 'rename_files = RenameUtils("<folder location>", "<text file with new names>")
## rename.rename()

## example: 
rename = RenameUtil("/home/laura/Documents/repos/misc_python/test_files", "new_names.txt")
rename.rename()

## then in the terminal you run "python3 file_rename_util.py"