Merge dev into main: all tests passing, clean build, .gitignore updated

Author: AlexTkDev

.gitignore

@@ -1,7 +1,11 @@
 # Byte-compiled / optimized / DLL files
 __pycache__/
+**/__pycache__/
 *.py[cod]
 *$py.class
+*.pyc
+*.pyo
+*.pyd
 
 # C extensions
 *.so
@@ -160,3 +164,33 @@ cython_debug/
 #  and can be added to the global gitignore or merged into this file.  For a more nuclear
 #  option (not recommended) you can uncomment the following to ignore the entire idea folder.
 .idea/
+
+# macOS system files
+.DS_Store
+
+# Project-specific files
+.pylintrc
+test_history.json
+
+# VSCode and JetBrains IDEs
+.vscode/
+
+# Local virtual environments
+.venv/
+.venv_tmp/
+venv/
+env/
+ENV/
+
+# PyInstaller and build
+build/
+dist/
+*.spec
+
+# Jupyter and IPython
+.ipynb_checkpoints/
+profile_default/
+
+# Coverage and test cache
+.pytest_cache/
+.mypy_cache/

.pylintrc

@@ -1,2 +1,59 @@
+[MASTER]
+# Python version to use for features
+py-version=3.8
+
+# Specify a score threshold to be exceeded before program exits with error.
+fail-under=7.0
+
 [MESSAGES CONTROL]
-disable=C0114, W0718, W0613, E0401, E1101
+# Disable the following pylint messages
+disable=
+    C0114, # missing-module-docstring
+    C0115, # missing-class-docstring
+    C0116, # missing-function-docstring
+    W0718, # broad-exception-caught
+    W0613, # unused-argument
+    E0401, # import-error
+    E1101, # no-member
+    R0903, # too-few-public-methods
+    R0914, # too-many-locals
+    R0913, # too-many-arguments
+    R0915, # too-many-statements
+    W0703, # broad-except
+
+[FORMAT]
+# Maximum number of characters on a single line.
+max-line-length=100
+
+[DESIGN]
+# Maximum number of arguments for function / method
+max-args=8
+
+# Minimum number of public methods for a class
+min-public-methods=1
+
+# Maximum number of public methods for a class
+max-public-methods=20
+
+[SIMILARITIES]
+# Minimum lines number of a similarity.
+min-similarity-lines=6
+
+# Ignore imports when computing similarities.
+ignore-imports=yes
+
+[TYPECHECK]
+# List of module names for which member attributes should not be checked
+ignored-modules=
+    matplotlib,
+    tkinter
+
+[REPORTS]
+# Set the output format.
+output-format=text
+
+# Tells whether to display a full report or only the messages
+reports=yes
+
+# Python expression which should return a note less than 10
+evaluation=10.0 - ((float(5 * error + warning + refactor + convention) / statement) * 10)

README.md

@@ -1,97 +1,115 @@
+### On development stage. 
 ## Documentation for macOS_application_speedtest_for_python
 
 ### Project Description
-`macOS_application_speedtest_for_python` is a macOS application designed to test your internet connection 
-speed using Python. The program provides a convenient interface for measuring download, upload, and ping speeds, 
-and also supports retesting and viewing test history.
-The project is built based on another one of my applications, which you can check out on GitHub:
-[Internet Speed Test](https://github.com/AlexTkDev/different_mini-apps/tree/main/check_internrt_speed)
+`macOS_application_speedtest_for_python` is a modern macOS application for testing your internet connection speed using Python. The app features a beautiful dark UI (ttkbootstrap), asynchronous and thread-based architecture for maximum responsiveness, and advanced UX with toast notifications and smooth progress animations.
+
+### What's New in Version 4.0.0
+- Fully asynchronous and thread-based architecture: all heavy operations (speedtest, network info, plotting) run in background threads.
+- Modern, dark, and airy UI using ttkbootstrap.
+- Toast notifications for test completion and errors.
+- Smooth progress bar animations and non-blocking interface.
+- Improved error handling and logging.
+- Refactored codebase: all comments and docstrings in English, modular structure.
+- Enhanced test history and export features.
+- More robust PyInstaller build and troubleshooting section.
 
 ### Installation
 
 #### System Requirements
 - macOS (version 10.14 or later)
-- Python 3.6 or higher
-- Installed dependencies listed in `requirements.txt`
+- Python 3.8 or higher (with Tkinter support)
+- All dependencies from `requirements.txt`
 
 #### Installing Dependencies
-To install the dependencies, execute the following commands:
-
 ```bash
 # Clone repository
 git clone https://github.com/AlexTkDev/macOS_application_speedtest_for_python.git
-# Create a virtual environment (recommended)
-python -m venv .venv
+cd macOS_application_speedtest_for_python
+python3 -m venv .venv
 source .venv/bin/activate
-# Install dependencies
 pip install -r requirements.txt
 ```
 
 ### Usage
-After installation, you can run the application by executing:
+Run the application:
 ```bash
-python alexs_speedtest.py
+python main.py
 ```
-
-#### Features
-- **Internet Speed Measurement**: The app allows you to test download and upload speeds, as well as ping (latency) of your internet connection.
-- **Graphical Display**: After completing a test, users can view the test results and optionally plot the test history.
-- **Repeat Test**: After a test is completed, users can repeat the test without needing to restart the application.
-- **Test History**: The app saves the results of previous tests, allowing users to view the test history and visualize changes in speed.
-
-#### Key Components
-- **Tkinter**: Used for creating the graphical user interface (GUI), which includes buttons for starting tests, viewing results, and plotting graphs.
-- **Speedtest-cli**: A library for performing internet speed tests, which powers the app's functionality.
-- **Matplotlib**: A library for visualizing the test history by plotting graphs.
-- **JSON**: A library for reading and writing test results stored in JSON format.
-
-#### How It Works
-1. When the app is launched, users can click the **"Start Speed Test"** button to initiate the test.
-2. The app runs a speed test using the **speedtest-cli** library, measuring download speed, upload speed, and ping.
-3. Once the test is completed, the results are displayed in the app's interface.
-4. Users can save the test results to the **history.json** file and visualize the data using **matplotlib**.
-5. For a repeat test, users can simply click the **"Repeat Speed Test"** button, which hides the history buttons until the new test is finished.
-
-
-#### Building the Application
-To build the application in `.app` format, run the following command:
+Or build the .app:
 ```bash
 pyinstaller main.spec
+open dist/Alex_SpeedTest.app
 ```
-After building, the application will be located in the `dist` directory, and you can launch it by double-clicking the icon.
-
-### Configuration
-The project include a `alexs_speedtest.py` file, where you can find settings such as 
-parameters for speed testing. Feel free to modify these parameters according to your needs.
 
-### License
-This project is licensed under the MIT License. Please refer to the `LICENSE` file for more detailed information.
+#### Features
+- **Asynchronous Speed Test**: Download, upload, and ping tests run in a background thread.
+- **Modern Dark UI**: Built with ttkbootstrap for a beautiful, modern look.
+- **Toast Notifications**: Non-blocking popups for test completion and errors.
+- **Network Adapter Info**: Asynchronously fetches and displays active network adapter details.
+- **Interactive History & Graphs**: View and export your test history, plot interactive graphs.
+- **Export to CSV**: Export your test history for further analysis.
+- **Logging**: All actions are logged for troubleshooting.
+
+#### Project Structure
+```
+macOS_application_speedtest_for_python/
+├── speedtest_app/             # Main package
+│   ├── __init__.py            # Package initialization
+│   ├── alexs_speedtest.py     # Main application module (async, threads)
+│   ├── network_adapter_information.py   # Async network info
+│   ├── test_history.py        # Async history and plotting
+│   ├── gui/                   # GUI components (ttkbootstrap)
+│   │   └── __init__.py
+│   ├── utils/                 # Utility functions
+│   │   └── __init__.py
+│   └── tests/                 # Unit tests
+│       ├── __init__.py
+│       ├── test_network_adapter.py
+│       └── test_test_history.py
+├── main.py                    # Entry point
+├── main.spec                  # PyInstaller config
+├── requirements.txt           # Dependencies
+├── setup.py                   # Installation script
+├── README.md                  # This documentation
+```
 
-### Code Analysis with Pylint
-This project uses **Pylint** for static code analysis to ensure that code adheres to Python's 
-best practices and follows PEP 8 style guidelines. Pylint checks for errors, potential issues,
-and enforces consistent coding style, making it a valuable tool for maintaining code quality.
+### How It Works
+1. Click **Start Speed Test** to run a speed test in a background thread.
+2. The app finds the best server, runs the test, and updates the UI with smooth progress.
+3. Results are shown instantly; you can repeat the test, view/export history, or plot interactive graphs.
+4. All network info and history operations are also asynchronous.
+5. Toast notifications inform you of completion or errors.
 
-### How to Install Pylint
-To install Pylint, use the following command in your terminal:
+### Building the Application
+To build the application in `.app` format:
 ```bash
-pip install pylint
-```
-### Running Pylint
-Once installed, you can run Pylint on a specific Python file with:
-```bash
-pylint your_file.py
+pyinstaller main.spec
 ```
-Or, to analyze all Python files in the project, run:
+The `.app` will appear in the `dist` directory.
+
+#### Troubleshooting PyInstaller/macOS
+- If the app does not open, run the binary from terminal to see errors:
+  ```bash
+  dist/Alex_SpeedTest.app/Contents/MacOS/alexs_speedtest
+  ```
+- If you see `ModuleNotFoundError: No module named '_tkinter'`, ensure your Python has Tkinter support and rebuild the venv.
+- If macOS blocks the app, run:
+  ```bash
+  xattr -dr com.apple.quarantine dist/Alex_SpeedTest.app
+  ```
+- For other issues, check the log file in `~/Documents/SpeedTest_Logs/speedtest_log.log`.
+
+### Running Tests
 ```bash
- pylint *.py
+python -m unittest discover
 ```
-This setup is also configured to run automatically within GitHub Actions on every code push, 
-checking the code with multiple Python versions for compatibility.
- 
+
+### License
+MIT License. See `LICENSE` for details.
+
 ### Contribution
-If you would like to contribute to the project, please create a fork of the repository and submit a Pull Request with your changes.
+Pull requests are welcome! See CONTRIBUTING section in the old README for workflow.
 
 ### Contact
-For questions or suggestions, you can reach out to me via [GitHub](https://github.com/AlexTkDev).
-
+For questions or suggestions, reach out via [GitHub](https://github.com/AlexTkDev).