folder-manager

folder_manager

folder_manager is a Python package designed to manage folders and files. It provides functionalities to create, list, count, and delete files and folders, making it a versatile tool for file management. The package is designed to be OS-independent, ensuring compatibility with both Windows and Unix-based systems.

Features

• Create Folder: Create a new folder at a specified path.
• List Files: List all files in a specified folder.
• Count Files: Count the number of files in a specified folder.
• List Files with Specific Extension: List all files in a specified folder with a specific extension.
• Count Files with Specific Extension: Count the number of files in a specified folder with a specific extension.
• Create File: Create a new file with optional content.
• Delete File: Delete a specified file.
• Delete Folder: Delete a specified folder and all its contents.
• Check Folder Exists: Check if a specified folder exists.
• Check File Exists: Check if a specified file exists.

Requirements

• Python 3.x

Installation

Install the package via PyPI using pip:

pip install folder_manager

Usage

Importing the Package

To use the folder_manager package, import it into your Python script:

from folder_manager import Folder

Creating an Instance

To create an instance of the Folder class, provide the path to the folder you want to manage.

folder = Folder("/path/to/folder")

Examples

• Create a Folder:

  folder = Folder("/path/to/folder")
  try:
      result = folder.create_folder()
      print(result)  # Returns True if the folder was created successfully
  except FolderError as e:
      print(e)
  

• List Files in a Folder:

  folder = Folder("/path/to/folder")
  try:
      files = folder.list_files()
      print(files)  # Returns a list of filenames in the folder
  except FolderError as e:
      print(e)
  

• Count Files in a Folder:

  folder = Folder("/path/to/folder")
  try:
      file_count = folder.count_files()
      print(f"Number of files: {file_count}")  # Returns the number of files in the folder
  except FolderError as e:
      print(e)
  

• List Files with Specific Extension in a Folder:

  folder = Folder("/path/to/folder")
  extension = "txt"
  try:
      files_with_extension = folder.list_files_with_extension(extension)
      print(f"Files with extension .{extension}: {files_with_extension}")  # Returns a list of filenames with the specified extension
  except FolderError as e:
      print(e)
  

• Count Files with Specific Extension in a Folder:

  folder = Folder("/path/to/folder")
  extension = "txt"
  try:
      file_count_with_extension = folder.count_files_with_extension(extension)
      print(f"Number of files with extension .{extension}: {file_count_with_extension}")  # Returns the number of files with the specified extension
  except FolderError as e:
      print(e)
  

• Create a File:

  folder = Folder("/path/to/folder")
  try:
      result = folder.create_file("file.txt", "Hello, World!")
      print(result)  # Returns True if the file was created successfully
  except FolderError as e:
      print(e)
  

• Delete a File:

  folder = Folder("/path/to/folder")
  try:
      result = folder.delete_file("file.txt")
      print(result)  # Returns True if the file was deleted successfully
  except FolderError as e:
      print(e)
  

• Delete a Folder:

  folder = Folder("/path/to/folder")
  try:
      result = folder.delete_folder()
      print(result)  # Returns True if the folder was deleted successfully
  except FolderError as e:
      print(e)
  

• Check if a Folder Exists:

  folder = Folder("/path/to/folder")
  if folder.folder_exists():
      print("Folder exists.")
  else:
      print("Folder does not exist.")
  

• Check if a File Exists:

  folder = Folder("/path/to/folder")
  if folder.file_exists("file.txt"):
      print("File exists.")
  else:
      print("File does not exist.")
  

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions are welcome! Please open an issue or submit a pull request for any improvements or bug fixes.

Author

Javer Valino

Acknowledgments

• Thanks to the open-source community for providing the tools and inspiration for this project.
• Special thanks to all contributors and users of the package.