Running tests ‐ Building Temp_Cleaner GUI from source

Must know before you continue

• Source file is the file that includes the source code of the main program window, that is the window that spawns immediately when you start the program, this is the window that contains all the buttons and other widgets used to start and control a cleaning process.
• cmd is the Terminal of the Windows operating system, usually called Windows Command Prompt, Command Processor, or simply Command Prompt.

Running tests before building Temp_Cleaner GUI from source

This step will teach you how to run the script for running tests, fix errors if they arise, modify the script when needed, and know when your environment is completely ready to begin the building process.

1.Check if the tests are executed against the latest source file

Every source file I make for every single release (or update) is named under this syntax: temp_cleaner_gui_r[version_number].py

• while replacing [version_number] with the correct version number, like 8, for example: temp_cleaner_gui_r8.py
• I used to have dots in the file name but thats no longer the case now because it causes issues with the new testing script.

What you need to do is modifying the value of the constant SOURCE_FILE_NAME (see Line #42 in file run_tests.py) to represent the correct source file name.

For example: as of the day this guide was written, the latest source file is temp_cleaner_gui_r8.py, so the file name is temp_cleaner_gui_r8 (without the .py file extension), which means you have to modify the Line #42 in file run_tests.py to be:

SOURCE_FILE_NAME = "temp_cleaner_gui_r8"

Processed to the next step after you modify that variable, or if it is already set to the latest source file

2.Launch a new terminal (cmd) window, and run the script

This should be easy to do, in case you have followed all the previous steps precisely you already have all the source code of this repository cloned into the folder named tcg_src, so run all these commands in consecutive order (from top to bottom):

C:
cd \
cd tcg_src
py run_tests.py

and keep an eye on the output of the last command (py run_tests.py), or simply what you will see on the console window, this should give an output identical or equavilent to this if all tests have been successfully passed and you are ready to continue to the next steps:

Greetings from the Temp_Cleaner GUI Project.
By Ziad Ahmed aka. Insertx2k Dev (Mr.X)
Github : https://github.com/insertx2k/temp_cleaner_gui
Twitter : https://twitter.com/insertplayztw

Powered by Minimal Accessibility Pack v1.0 by Insertx2k Dev (Mr.X)

[DEBUG]: Temp_Cleaner GUI is installed in: C:\tcg_src
[DEBUG]: Temp_Cleaner GUI is installed in: C:\tcg_src
[DEBUG]: Current version is:8.0.0
[DEBUG]: Tips module located at: C:\tcg_src
[DEBUG]: connection_window module located at: C:\tcg_src\android_cleaner
[DEBUG]: connection_window module located at: C:\tcg_src\android_cleaner
=============================================
Temp_Cleaner GUI before building test script.
Version 1.0 
Copyright (C) 2025 - Ziad (Mr.X)'s Software
Licensed under the same license as Temp_Cleaner GUI.

Environment information:
    * Python version: 3.11.9 (tags/v3.11.9:de54cf5, Apr  2 2024, 10:12:12) [MSC v.1938 64 bit (AMD64)]
    * Script full path: C:\tcg_src
    * Running as user pc , Process with ID: 2960
    * OS type: Windows, version: 10.0.26100 (AMD64)
    * Temp_Cleaner GUI source file: temp_cleaner_gui_r8
    * Pyinstaller is installed, version: 5.12.0
=============================================
import[1/30] success: module error has been successfully imported!
import[2/30] success: module os has been successfully imported!
import[3/30] success: module sys has been successfully imported!
import[4/30] success: module shutil has been successfully imported!
import[5/30] success: module tkinter has been successfully imported!
import[6/30] success: module PIL has been successfully imported!
import[7/30] success: module configparser has been successfully imported!
import[8/30] success: module subprocess has been successfully imported!
import[9/30] success: module awesometkinter has been successfully imported!
import[10/30] success: module threading has been successfully imported!
import[11/30] success: module translations has been successfully imported!
import[12/30] success: module customtkinter has been successfully imported!
import[13/30] success: module webbrowser has been successfully imported!
import[14/30] success: module updater has been successfully imported!
import[15/30] success: module ctypes has been successfully imported!
import[16/30] success: module donators has been successfully imported!
import[17/30] success: module psutil has been successfully imported!
import[18/30] success: module tips has been successfully imported!
import[19/30] success: module math has been successfully imported!
import[20/30] success: module platform has been successfully imported!
import[21/30] success: module android_cleaner has been successfully imported!
import[22/30] success: module infobanner has been successfully imported!
import[23/30] success: module time has been successfully imported!
import[24/30] success: module msgbox has been successfully imported!
import[25/30] success: module tkinterweb has been successfully imported!
import[26/30] success: module random has been successfully imported!
import[27/30] success: module oobe has been successfully imported!
import[28/30] success: module urllib has been successfully imported!
import[29/30] success: module urllib.request has been successfully imported!
import[30/30] success: module colorama has been successfully imported!
success [30/30] modules imported successfully!, module import tests passed!
=============================================
success: importing temp_cleaner_gui_r8 has sucessed!
success window[1/11]: successfully loaded window MainWindowLightMode from module temp_cleaner_gui_r8!
success window[2/11]: successfully loaded window SettingsWindow from module temp_cleaner_gui_r8!
success window[3/11]: successfully loaded window LicenseWindow from module temp_cleaner_gui_r8!
success window[4/11]: successfully loaded window AboutWindow from module temp_cleaner_gui_r8!
success window[5/11]: successfully loaded window TipsWindow from module tips!
success window[6/11]: successfully loaded window updaterProgramUI from module updater!
success window[7/11]: successfully loaded window DonatorsWindow from module donators!
success window[8/11]: successfully loaded window OOBEWindow from module oobe.window!
success window[9/11]: successfully loaded window ConnectPhoneToPCWindow from module android_cleaner.connection_window!
success window[10/11]: successfully loaded window ConnectPhoneToPCViaWiFiWindow from module android_cleaner.connection_window!
success window[11/11]: successfully loaded window ChooseADeviceWindow from module android_cleaner.connection_window!
windows[11/11] successfully loaded!, all windows have been loaded properly!
=============================================
success: all tests passed, now you can processed to building Temp_Cleaner GUI into an executable file!

Pay attention to the line that has * Pyinstaller is installed, version: 5.12.0, this should always say Pyinstaller is installed, despite what version it reports, if it doesn't, you will need to re-install Pyinstaller again or switch to use the correct Python version that has it installed.

The script should say

success: all tests passed, now you can processed to building Temp_Cleaner GUI into an executable file!

if all dependencies are properly installed, and all parts of the program can be executed successfully without any errors.

If it says:

import[<number>/30] failed: module <module name> could not be imported due to an error: <error>

this means that some module is not properly installed or is missing, and that you have to install it or download the source tarball and store it in the same folder as the source file.

3.Processed to the next steps

Now that you have successfully ensured that all tests are successfully passing, you can now start to actually build the program. Please navigate to the corresponding page (by clicking here) for the instructions to build the program