# SmartTest - Intelligent Code Testing Library
[](https://python.org)
[](LICENSE)
[](https://pypi.org/project/smarttest)
[](https://pypi.org/project/smarttest)
## đ Overview
**SmartTest** is an intelligent Python code testing library that automatically detects errors, warnings, and potential issues in your code. It provides real-time monitoring with instant error detection and automatic error hiding when issues are resolved.
## ⨠Features
- **đ Real-time Error Detection** - Instantly detects errors as you code
- **⥠Ultra Fast Performance** - Checks files every 0.1 seconds
- **đ¯ Smart Analysis** - Finds syntax errors, typos, and potential issues
- **đ Auto-hide Errors** - Errors disappear automatically when fixed
- **đ Multi-file Support** - Monitors all Python files in your project
- **đ¨ Beautiful Terminal Interface** - Colorful, easy-to-read output
- **đ Zero Configuration** - Works out of the box
## đĻ Installation
```bash
pip install smarttest
```
## đ¯ Quick Start
### Auto-Launch Application
```python
import smarttest
# đ SmartTest application launches automatically!
# No need to do anything else - it starts monitoring immediately
```
### Command Line
```bash
# Start monitoring
smarttest
# Launch desktop app
smarttest-app
```
### Manual Usage
```python
from smarttest import SmartTest
# Create instance manually
smarttest = SmartTest()
smarttest.start()
```
## đ§ How It Works
1. **Auto Launch** - SmartTest starts automatically when imported
2. **File Scanning** - Scans all `.py` files in your project
3. **Real-time Monitoring** - Watches for file changes every 0.1 seconds
4. **Error Detection** - Instantly detects and displays errors
5. **Auto-hide** - Errors disappear when fixed
## đ Error Types Detected
### Syntax Errors
- Invalid characters and corrupted text
- Mismatched parentheses
- Missing closing brackets
- Indentation errors
### Code Quality Issues
- Typos in variable names
- Unused semicolons
- Long lines (over 79 characters)
- Security risks (eval, exec)
### Performance Warnings
- Too many print statements
- Inefficient loops
- Import * usage
## đ¨ Terminal Output
```
đ§ SmartTest - Simple Error Detection
=====================================
đ Watching for errors...
đ Edit any .py file to see errors
âšī¸ Press Ctrl+C to stop
đ Scanning all Python files...
â test_file.py: 4 errors
âĸ Line 25: Invalid characters
âĸ Line 30: Typo - "resut" should be "result"
... 2 more
â
Fixed: test_file.py
đ No more errors!
```
## đ ī¸ Advanced Usage
### Custom Error Detection
```python
from smarttest import SmartTest
# Create custom instance
smarttest = SmartTest()
# Check specific file
results = smarttest.check_file('my_file.py')
# Stop monitoring
smarttest.stop()
```
### Error Types
```python
# Syntax errors
if line.count('(') != line.count(')'):
errors.append('Mismatched parentheses')
# Typos
if 'resut' in line and 'result' not in line:
errors.append('Typo detected')
# Invalid characters
if any(char in line for char in ['ØŗØ¤', 'Ø¤Øŗ', 'Ø´']):
errors.append('Invalid characters')
```
## đ Project Structure
```
smarttest/
âââ __init__.py # Main library
âââ auto_import.py # Auto dependency installer
âââ terminal_interface.py # Beautiful terminal output
âââ tester.py # Core testing engine
âââ reporter.py # Report generation
```
## đ§ Configuration
SmartTest works with minimal configuration:
```python
# Auto-installs required packages
requirements = ['colorama']
# Monitors all Python files
patterns = ['*.py', '**/*.py']
# Fast checking interval
check_interval = 0.1 # seconds
```
## đ Performance
- **⥠Ultra Fast** - 0.1 second check interval
- **đž Lightweight** - Only 1 dependency (colorama)
- **đ Efficient** - Only checks modified files
- **đ Smart** - Avoids duplicate error reporting
## đ¯ Use Cases
### Development
- Real-time error detection during coding
- Code quality monitoring
- Team development standards
### Code Review
- Pre-commit error checking
- Automated quality assurance
- Continuous integration
### Learning
- Educational tool for Python beginners
- Error pattern recognition
- Best practices enforcement
### Development Setup
```bash
git clone https://github.com/En-Hussain/smarttest.git
cd smarttest
pip install -e .
python demo_smarttest.py
```
## đ License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## đ Acknowledgments
- Inspired by modern code analysis tools
- Built for the Python community
- Designed for simplicity and performance
## đ Support
- **Issues**: [GitHub Issues](https://github.com/En-Hussain/smarttest/issues)
- **Discussions**: [GitHub Discussions](https://github.com/En-Hussain/smarttest/discussions)
- **Email**: hsn.nati3@gmail.com
## đŽ Roadmap
- [ ] Web interface
- [ ] IDE integration
- [ ] Custom rule engine
- [ ] Team collaboration features
- [ ] Advanced reporting
---
**Made with â¤ī¸ for Python developers**
*SmartTest v1.0.1 - Making code better, one error at a time*
Raw data
{
"_id": null,
"home_page": "https://github.com/smarttest/smarttest",
"name": "smarttest",
"maintainer": "SmartTest Team",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "SmartTest Team <team@smarttest.dev>",
"keywords": "python, testing, code-quality, error-detection, real-time, monitoring, development, tools, linter, static-analysis",
"author": "SmartTest Team",
"author_email": "SmartTest Team <team@smarttest.dev>",
"download_url": "https://files.pythonhosted.org/packages/99/17/bf15f568a5bef473f487cbb1dead513dd7c13645e768291e1b916bc5a15a/smarttest-1.0.1.tar.gz",
"platform": "any",
"description": "# SmartTest - Intelligent Code Testing Library\r\n\r\n[](https://python.org)\r\n[](LICENSE)\r\n[](https://pypi.org/project/smarttest)\r\n[](https://pypi.org/project/smarttest)\r\n\r\n## \ud83d\ude80 Overview\r\n\r\n**SmartTest** is an intelligent Python code testing library that automatically detects errors, warnings, and potential issues in your code. It provides real-time monitoring with instant error detection and automatic error hiding when issues are resolved.\r\n\r\n## \u2728 Features\r\n\r\n- **\ud83d\udd0d Real-time Error Detection** - Instantly detects errors as you code\r\n- **\u26a1 Ultra Fast Performance** - Checks files every 0.1 seconds\r\n- **\ud83c\udfaf Smart Analysis** - Finds syntax errors, typos, and potential issues\r\n- **\ud83d\udd04 Auto-hide Errors** - Errors disappear automatically when fixed\r\n- **\ud83d\udcc1 Multi-file Support** - Monitors all Python files in your project\r\n- **\ud83c\udfa8 Beautiful Terminal Interface** - Colorful, easy-to-read output\r\n- **\ud83d\ude80 Zero Configuration** - Works out of the box\r\n\r\n## \ud83d\udce6 Installation\r\n\r\n```bash\r\npip install smarttest\r\n```\r\n\r\n## \ud83c\udfaf Quick Start\r\n\r\n### Auto-Launch Application\r\n\r\n```python\r\nimport smarttest\r\n# \ud83d\ude80 SmartTest application launches automatically!\r\n# No need to do anything else - it starts monitoring immediately\r\n```\r\n\r\n### Command Line\r\n\r\n```bash\r\n# Start monitoring\r\nsmarttest\r\n\r\n# Launch desktop app\r\nsmarttest-app\r\n```\r\n\r\n### Manual Usage\r\n\r\n```python\r\nfrom smarttest import SmartTest\r\n\r\n# Create instance manually\r\nsmarttest = SmartTest()\r\nsmarttest.start()\r\n```\r\n\r\n## \ud83d\udd27 How It Works\r\n\r\n1. **Auto Launch** - SmartTest starts automatically when imported\r\n2. **File Scanning** - Scans all `.py` files in your project\r\n3. **Real-time Monitoring** - Watches for file changes every 0.1 seconds\r\n4. **Error Detection** - Instantly detects and displays errors\r\n5. **Auto-hide** - Errors disappear when fixed\r\n\r\n## \ud83d\udcca Error Types Detected\r\n\r\n### Syntax Errors\r\n- Invalid characters and corrupted text\r\n- Mismatched parentheses\r\n- Missing closing brackets\r\n- Indentation errors\r\n\r\n### Code Quality Issues\r\n- Typos in variable names\r\n- Unused semicolons\r\n- Long lines (over 79 characters)\r\n- Security risks (eval, exec)\r\n\r\n### Performance Warnings\r\n- Too many print statements\r\n- Inefficient loops\r\n- Import * usage\r\n\r\n## \ud83c\udfa8 Terminal Output\r\n\r\n```\r\n\ud83e\udde0 SmartTest - Simple Error Detection\r\n=====================================\r\n\ud83d\udc40 Watching for errors...\r\n\ud83d\udcdd Edit any .py file to see errors\r\n\u23f9\ufe0f Press Ctrl+C to stop\r\n\ud83d\udd0d Scanning all Python files...\r\n\r\n\u274c test_file.py: 4 errors\r\n \u2022 Line 25: Invalid characters\r\n \u2022 Line 30: Typo - \"resut\" should be \"result\"\r\n ... 2 more\r\n\r\n\u2705 Fixed: test_file.py\r\n\ud83c\udf89 No more errors!\r\n```\r\n\r\n## \ud83d\udee0\ufe0f Advanced Usage\r\n\r\n### Custom Error Detection\r\n\r\n```python\r\nfrom smarttest import SmartTest\r\n\r\n# Create custom instance\r\nsmarttest = SmartTest()\r\n\r\n# Check specific file\r\nresults = smarttest.check_file('my_file.py')\r\n\r\n# Stop monitoring\r\nsmarttest.stop()\r\n```\r\n\r\n### Error Types\r\n\r\n```python\r\n# Syntax errors\r\nif line.count('(') != line.count(')'):\r\n errors.append('Mismatched parentheses')\r\n\r\n# Typos\r\nif 'resut' in line and 'result' not in line:\r\n errors.append('Typo detected')\r\n\r\n# Invalid characters\r\nif any(char in line for char in ['\u0633\u0624', '\u0624\u0633', '\u0634']):\r\n errors.append('Invalid characters')\r\n```\r\n\r\n## \ud83d\udcc1 Project Structure\r\n\r\n```\r\nsmarttest/\r\n\u251c\u2500\u2500 __init__.py # Main library\r\n\u251c\u2500\u2500 auto_import.py # Auto dependency installer\r\n\u251c\u2500\u2500 terminal_interface.py # Beautiful terminal output\r\n\u251c\u2500\u2500 tester.py # Core testing engine\r\n\u2514\u2500\u2500 reporter.py # Report generation\r\n```\r\n\r\n## \ud83d\udd27 Configuration\r\n\r\nSmartTest works with minimal configuration:\r\n\r\n```python\r\n# Auto-installs required packages\r\nrequirements = ['colorama']\r\n\r\n# Monitors all Python files\r\npatterns = ['*.py', '**/*.py']\r\n\r\n# Fast checking interval\r\ncheck_interval = 0.1 # seconds\r\n```\r\n\r\n## \ud83d\ude80 Performance\r\n\r\n- **\u26a1 Ultra Fast** - 0.1 second check interval\r\n- **\ud83d\udcbe Lightweight** - Only 1 dependency (colorama)\r\n- **\ud83d\udd04 Efficient** - Only checks modified files\r\n- **\ud83d\udcca Smart** - Avoids duplicate error reporting\r\n\r\n## \ud83c\udfaf Use Cases\r\n\r\n### Development\r\n- Real-time error detection during coding\r\n- Code quality monitoring\r\n- Team development standards\r\n\r\n### Code Review\r\n- Pre-commit error checking\r\n- Automated quality assurance\r\n- Continuous integration\r\n\r\n### Learning\r\n- Educational tool for Python beginners\r\n- Error pattern recognition\r\n- Best practices enforcement\r\n\r\n\r\n\r\n### Development Setup\r\n\r\n```bash\r\ngit clone https://github.com/En-Hussain/smarttest.git\r\ncd smarttest\r\npip install -e .\r\npython demo_smarttest.py\r\n```\r\n\r\n## \ud83d\udcc4 License\r\n\r\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\r\n\r\n## \ud83d\ude4f Acknowledgments\r\n\r\n- Inspired by modern code analysis tools\r\n- Built for the Python community\r\n- Designed for simplicity and performance\r\n\r\n## \ud83d\udcde Support\r\n\r\n- **Issues**: [GitHub Issues](https://github.com/En-Hussain/smarttest/issues)\r\n- **Discussions**: [GitHub Discussions](https://github.com/En-Hussain/smarttest/discussions)\r\n- **Email**: hsn.nati3@gmail.com\r\n\r\n## \ud83d\udd2e Roadmap\r\n\r\n- [ ] Web interface\r\n- [ ] IDE integration\r\n- [ ] Custom rule engine\r\n- [ ] Team collaboration features\r\n- [ ] Advanced reporting\r\n\r\n---\r\n\r\n**Made with \u2764\ufe0f for Python developers**\r\n\r\n*SmartTest v1.0.1 - Making code better, one error at a time*\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Intelligent Python code testing library with real-time error detection",
"version": "1.0.1",
"project_urls": {
"Bug Tracker": "https://github.com/smarttest/smarttest/issues",
"Documentation": "https://smarttest.readthedocs.io/",
"Homepage": "https://github.com/smarttest/smarttest",
"Repository": "https://github.com/smarttest/smarttest.git",
"Source Code": "https://github.com/smarttest/smarttest"
},
"split_keywords": [
"python",
" testing",
" code-quality",
" error-detection",
" real-time",
" monitoring",
" development",
" tools",
" linter",
" static-analysis"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "c4f4409ab9a8faf559c4e199a56f3624e32361b48180dad1c4d944de55036a2f",
"md5": "bd9221f9ce7c285181318721db418064",
"sha256": "59193aaf814c92c54bc7c54d6fe27460c99294b83320097c62a4f0e17ac80244"
},
"downloads": -1,
"filename": "smarttest-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "bd9221f9ce7c285181318721db418064",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 17386,
"upload_time": "2025-09-08T07:17:30",
"upload_time_iso_8601": "2025-09-08T07:17:30.230530Z",
"url": "https://files.pythonhosted.org/packages/c4/f4/409ab9a8faf559c4e199a56f3624e32361b48180dad1c4d944de55036a2f/smarttest-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "9917bf15f568a5bef473f487cbb1dead513dd7c13645e768291e1b916bc5a15a",
"md5": "7f523f1e8a221610d70e3a4b649f2704",
"sha256": "9c7534036a74eac15bf414845a3a45a1660d2b79bb0b67e4f5035109309c4599"
},
"downloads": -1,
"filename": "smarttest-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "7f523f1e8a221610d70e3a4b649f2704",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 17475,
"upload_time": "2025-09-08T07:17:31",
"upload_time_iso_8601": "2025-09-08T07:17:31.467377Z",
"url": "https://files.pythonhosted.org/packages/99/17/bf15f568a5bef473f487cbb1dead513dd7c13645e768291e1b916bc5a15a/smarttest-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-08 07:17:31",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "smarttest",
"github_project": "smarttest",
"github_not_found": true,
"lcname": "smarttest"
}