File explorer in python with a simple gui.

@WHY This is a school project from the beginning, and serves to be a start of a larger project in the future. We need to prove that python is capable of many things, including file exploration. Since the author uses the terminal emulator kitty on a daily basis, which is written in python, we need to also use python. It just makes sense, note that we also use python in school and is fitting for the project thesis.

@prerequisites Python 3.13 or newer. (python 2.* can be used, but change dependencies accordingly!) pip install requests Tested on both linux and windows.

@install

1. (linux) python -m ensurepip --upgrade && python -m venv env
   (windows) python -m ensurepip --upgrade (then) python -m venv env
   
2. (linux) source env/bin/activate && git clone https://github.com/ffdiracex/fileExplorer.git
   (windows) .\env\Scripts\activate && git clone https://github.com/ffdiracex/fileExplorer.git
   
3. cd fileExplorer/src
4. in src, run: python main.py, to inspect priveleged file (s) or directories, run as root

@pylint in virtual environment, download pylint. Note that I have disabled some warnings in main.py, with good reason.

@debugging the file explorer can be run with debug mode ON, with this mode toggled you will get messages in the terminal in which you are executing the python file in, main.py. If using an IDE, upon running the file, it will open up a terminal window and you will be met with debug messages. You can decide the level of verbosity of these, and their details.

@future In the future, I hope to improve this file explorer to make it production ready.