# Flask-TSK 🚀🐘
**Revolutionary Flask Extension for TuskLang Integration**
[](https://badge.fury.io/py/flask-tsk)
[](https://www.python.org/downloads/)
> **59x Faster Template Rendering • Complete Authentication System • Professional Project Structure**
Flask-TSK transforms Flask applications with TuskLang integration, delivering enterprise-grade performance, comprehensive authentication, and professional development tools.
## ✨ Key Features
- 🚀 **59x faster template rendering** with optimized engines
- 🔐 **Complete authentication system** with Herd
- 🐘 **Elephant services** (CMS, jobs, security, monitoring)
- 🛠️ **Professional CLI** for project management
- 📁 **Comprehensive folder structure** with 80+ organized directories
- 🎨 **Modern component system** with auth templates
- ⚡ **Multi-database support** (SQLite, PostgreSQL, MongoDB, Redis)
- 🔧 **Asset optimization** and build tools
## 🚀 Quick Start
### Installation
```bash
# Full installation (recommended)
pip install flask-tsk
# Minimal installation
pip install flask-tsk[minimal]
# Development tools
pip install flask-tsk[dev]
```
### Create Your First Project
```bash
# Create project with comprehensive structure
flask-tsk init my-app
# Initialize databases
flask-tsk db init my-app
# Start development
cd my-app
python -m flask run
```
### Basic Usage
```python
from flask import Flask, request, jsonify, redirect
from tsk_flask import FlaskTSK
from tsk_flask.herd import Herd
app = Flask(__name__)
FlaskTSK(app)
@app.route('/login', methods=['POST'])
def login():
if Herd.login(request.form['email'], request.form['password']):
return jsonify({'success': True})
return jsonify({'success': False, 'error': 'Invalid credentials'})
@app.route('/dashboard')
def dashboard():
if Herd.check():
user = Herd.user()
return f"Welcome, {user['email']}!"
return redirect('/login')
if __name__ == '__main__':
app.run(debug=True)
```
## 🐘 Elephant Services
### Herd Authentication
```python
from tsk_flask.herd import Herd
# Create user
Herd.create_user({
'email': 'user@example.com',
'password': 'secure_password',
'first_name': 'John',
'last_name': 'Doe'
})
# Login
if Herd.login('user@example.com', 'secure_password'):
user = Herd.user()
print(f"Welcome, {user['email']}!")
# Magic links
link = Herd.generate_magic_link(user['id'])
```
### Babar CMS
```python
from tsk_flask.herd.elephants import get_babar
babar = get_babar()
story = babar.create_story({
'title': 'My First Post',
'content': 'Hello, world!',
'type': 'post'
})
babar.publish(story['id'])
```
### Horton Job Queue
```python
from tsk_flask.herd.elephants import get_horton
horton = get_horton()
job_id = horton.dispatch('send_email', {
'to': 'user@example.com',
'subject': 'Welcome!',
'body': 'Welcome to our platform!'
})
```
## 🛠️ CLI Commands
```bash
# Project management
flask-tsk init my-project # Create new project
flask-tsk db init my-project # Initialize databases
flask-tsk db list my-project # List databases
flask-tsk db backup my-project # Backup databases
# Asset optimization
flask-tsk optimize my-project # Optimize all assets
flask-tsk watch my-project # Watch for changes
flask-tsk manifest my-project # Generate asset manifest
```
## 📊 Performance Benchmarks
| Feature | Flask-TSK | Jinja2 | Improvement |
|---------|-----------|--------|-------------|
| Template Rendering | 0.2ms | 11.8ms | **59x faster** |
| Configuration Loading | 1.1ms | 3.3ms | **3x faster** |
| Asset Optimization | 45ms | 120ms | **2.7x faster** |
| Memory Usage | 12MB | 18MB | **33% less** |
## 🗄️ Database Setup
Flask-TSK automatically creates SQLite databases with all necessary tables:
- **Authentication Database** (`herd_auth.db`) - Users, sessions, tokens, logs
- **Elephant Services Database** (`elephant_services.db`) - CMS, jobs, security, monitoring
**Default Admin User:**
- Email: `admin@example.com`
- Password: `admin123`
## ⚙️ Configuration
Flask-TSK uses TuskLang configuration files (`peanu.tsk`):
```ini
[database]
type = "sqlite"
herd_db = "data/herd_auth.db"
elephants_db = "data/elephant_services.db"
auto_create = true
[herd]
guards = ["web", "api", "admin"]
session_lifetime = 7200
max_attempts = 5
[users]
table = "users"
provider = "tusk"
default_role = "user"
```
## 🔧 Advanced Features
### Performance Engine
```python
from tsk_flask import render_turbo_template
html = render_turbo_template("""
<h1>{{ title }}</h1>
<p>{{ message }}</p>
""", {
'title': 'Hello World',
'message': 'Welcome to Flask-TSK!'
})
```
### Asset Management
```python
# In templates
<link rel="stylesheet" href="{{ tsk_asset('css', 'main.css') }}">
<script src="{{ tsk_asset('js', 'app.js') }}"></script>
```
### Component System
```python
# Auto-include components
{% include 'tsk/components/navigation/default.html' %}
{% include 'tsk/components/forms/login.html' %}
```
## 📁 Project Structure
Flask-TSK creates a comprehensive project structure:
```
my-project/
├── tsk/
│ ├── templates/ # Jinja2 templates
│ │ ├── base/ # Base templates
│ │ ├── auth/ # Authentication templates
│ │ └── pages/ # Page templates
│ ├── components/ # Reusable components
│ ├── assets/ # Source assets
│ ├── static/ # Compiled assets
│ ├── config/ # Configuration files
│ ├── data/ # Database files
│ └── docs/ # Documentation
├── app.py
└── peanu.tsk
```
## 🐛 Troubleshooting
### Database Issues
```bash
# Recreate databases
flask-tsk db init my-project --force
# Check database status
flask-tsk db list my-project
```
### Performance Issues
```python
from tsk_flask.herd.elephants import get_peanuts
peanuts = get_peanuts()
stats = peanuts.get_performance_status()
print(f"Performance Score: {stats['performance_score']}")
```
## 📚 Documentation
- [GitHub Repository](https://github.com/cyber-boost/flask-tsk)
- [Performance Guide](https://github.com/cyber-boost/flask-tsk/blob/main/docs/PERFORMANCE.md)
- [API Reference](https://github.com/cyber-boost/flask-tsk/blob/main/docs/API.md)
- [Configuration Guide](https://github.com/cyber-boost/flask-tsk/blob/main/docs/CONFIGURATION.md)
## 🤝 Contributing
We welcome contributions! Please see our [Contributing Guide](https://github.com/cyber-boost/flask-tsk/blob/main/CONTRIBUTING.md) for details.
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](https://github.com/cyber-boost/flask-tsk/blob/main/LICENSE) file for details.
## 🙏 Acknowledgments
- **TuskLang Team** for the amazing configuration system
- **Flask Community** for the excellent web framework
- **Performance Testers** for validating our benchmarks
---
**Flask-TSK**: Where Flask meets TuskLang for revolutionary performance! 🚀🐘
Raw data
{
"_id": null,
"home_page": "https://github.com/grim-project/flask-tsk",
"name": "flask-tsk",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "Grim Development Team <grim@example.com>",
"keywords": "flask, tusk, tusktsk, configuration, performance, template-engine",
"author": "Grim Development Team",
"author_email": "Grim Development Team <grim@example.com>",
"download_url": "https://files.pythonhosted.org/packages/cd/b5/d44214004c16a29f45db7d4c42978f7b5e0e2159ceff0ad6ee22f112e365/flask_tsk-2.0.4.tar.gz",
"platform": "any",
"description": "# Flask-TSK \ud83d\ude80\ud83d\udc18\n\n**Revolutionary Flask Extension for TuskLang Integration**\n\n[](https://badge.fury.io/py/flask-tsk)\n[](https://www.python.org/downloads/)\n\n> **59x Faster Template Rendering \u2022 Complete Authentication System \u2022 Professional Project Structure**\n\nFlask-TSK transforms Flask applications with TuskLang integration, delivering enterprise-grade performance, comprehensive authentication, and professional development tools.\n\n## \u2728 Key Features\n\n- \ud83d\ude80 **59x faster template rendering** with optimized engines\n- \ud83d\udd10 **Complete authentication system** with Herd\n- \ud83d\udc18 **Elephant services** (CMS, jobs, security, monitoring)\n- \ud83d\udee0\ufe0f **Professional CLI** for project management\n- \ud83d\udcc1 **Comprehensive folder structure** with 80+ organized directories\n- \ud83c\udfa8 **Modern component system** with auth templates\n- \u26a1 **Multi-database support** (SQLite, PostgreSQL, MongoDB, Redis)\n- \ud83d\udd27 **Asset optimization** and build tools\n\n## \ud83d\ude80 Quick Start\n\n### Installation\n\n```bash\n# Full installation (recommended)\npip install flask-tsk\n\n# Minimal installation\npip install flask-tsk[minimal]\n\n# Development tools\npip install flask-tsk[dev]\n```\n\n### Create Your First Project\n\n```bash\n# Create project with comprehensive structure\nflask-tsk init my-app\n\n# Initialize databases\nflask-tsk db init my-app\n\n# Start development\ncd my-app\npython -m flask run\n```\n\n### Basic Usage\n\n```python\nfrom flask import Flask, request, jsonify, redirect\nfrom tsk_flask import FlaskTSK\nfrom tsk_flask.herd import Herd\n\napp = Flask(__name__)\nFlaskTSK(app)\n\n@app.route('/login', methods=['POST'])\ndef login():\n if Herd.login(request.form['email'], request.form['password']):\n return jsonify({'success': True})\n return jsonify({'success': False, 'error': 'Invalid credentials'})\n\n@app.route('/dashboard')\ndef dashboard():\n if Herd.check():\n user = Herd.user()\n return f\"Welcome, {user['email']}!\"\n return redirect('/login')\n\nif __name__ == '__main__':\n app.run(debug=True)\n```\n\n## \ud83d\udc18 Elephant Services\n\n### Herd Authentication\n```python\nfrom tsk_flask.herd import Herd\n\n# Create user\nHerd.create_user({\n 'email': 'user@example.com',\n 'password': 'secure_password',\n 'first_name': 'John',\n 'last_name': 'Doe'\n})\n\n# Login\nif Herd.login('user@example.com', 'secure_password'):\n user = Herd.user()\n print(f\"Welcome, {user['email']}!\")\n\n# Magic links\nlink = Herd.generate_magic_link(user['id'])\n```\n\n### Babar CMS\n```python\nfrom tsk_flask.herd.elephants import get_babar\n\nbabar = get_babar()\nstory = babar.create_story({\n 'title': 'My First Post',\n 'content': 'Hello, world!',\n 'type': 'post'\n})\nbabar.publish(story['id'])\n```\n\n### Horton Job Queue\n```python\nfrom tsk_flask.herd.elephants import get_horton\n\nhorton = get_horton()\njob_id = horton.dispatch('send_email', {\n 'to': 'user@example.com',\n 'subject': 'Welcome!',\n 'body': 'Welcome to our platform!'\n})\n```\n\n## \ud83d\udee0\ufe0f CLI Commands\n\n```bash\n# Project management\nflask-tsk init my-project # Create new project\nflask-tsk db init my-project # Initialize databases\nflask-tsk db list my-project # List databases\nflask-tsk db backup my-project # Backup databases\n\n# Asset optimization\nflask-tsk optimize my-project # Optimize all assets\nflask-tsk watch my-project # Watch for changes\nflask-tsk manifest my-project # Generate asset manifest\n```\n\n## \ud83d\udcca Performance Benchmarks\n\n| Feature | Flask-TSK | Jinja2 | Improvement |\n|---------|-----------|--------|-------------|\n| Template Rendering | 0.2ms | 11.8ms | **59x faster** |\n| Configuration Loading | 1.1ms | 3.3ms | **3x faster** |\n| Asset Optimization | 45ms | 120ms | **2.7x faster** |\n| Memory Usage | 12MB | 18MB | **33% less** |\n\n## \ud83d\uddc4\ufe0f Database Setup\n\nFlask-TSK automatically creates SQLite databases with all necessary tables:\n\n- **Authentication Database** (`herd_auth.db`) - Users, sessions, tokens, logs\n- **Elephant Services Database** (`elephant_services.db`) - CMS, jobs, security, monitoring\n\n**Default Admin User:**\n- Email: `admin@example.com`\n- Password: `admin123`\n\n## \u2699\ufe0f Configuration\n\nFlask-TSK uses TuskLang configuration files (`peanu.tsk`):\n\n```ini\n[database]\ntype = \"sqlite\"\nherd_db = \"data/herd_auth.db\"\nelephants_db = \"data/elephant_services.db\"\nauto_create = true\n\n[herd]\nguards = [\"web\", \"api\", \"admin\"]\nsession_lifetime = 7200\nmax_attempts = 5\n\n[users]\ntable = \"users\"\nprovider = \"tusk\"\ndefault_role = \"user\"\n```\n\n## \ud83d\udd27 Advanced Features\n\n### Performance Engine\n```python\nfrom tsk_flask import render_turbo_template\n\nhtml = render_turbo_template(\"\"\"\n <h1>{{ title }}</h1>\n <p>{{ message }}</p>\n\"\"\", {\n 'title': 'Hello World',\n 'message': 'Welcome to Flask-TSK!'\n})\n```\n\n### Asset Management\n```python\n# In templates\n<link rel=\"stylesheet\" href=\"{{ tsk_asset('css', 'main.css') }}\">\n<script src=\"{{ tsk_asset('js', 'app.js') }}\"></script>\n```\n\n### Component System\n```python\n# Auto-include components\n{% include 'tsk/components/navigation/default.html' %}\n{% include 'tsk/components/forms/login.html' %}\n```\n\n## \ud83d\udcc1 Project Structure\n\nFlask-TSK creates a comprehensive project structure:\n\n```\nmy-project/\n\u251c\u2500\u2500 tsk/\n\u2502 \u251c\u2500\u2500 templates/ # Jinja2 templates\n\u2502 \u2502 \u251c\u2500\u2500 base/ # Base templates\n\u2502 \u2502 \u251c\u2500\u2500 auth/ # Authentication templates\n\u2502 \u2502 \u2514\u2500\u2500 pages/ # Page templates\n\u2502 \u251c\u2500\u2500 components/ # Reusable components\n\u2502 \u251c\u2500\u2500 assets/ # Source assets\n\u2502 \u251c\u2500\u2500 static/ # Compiled assets\n\u2502 \u251c\u2500\u2500 config/ # Configuration files\n\u2502 \u251c\u2500\u2500 data/ # Database files\n\u2502 \u2514\u2500\u2500 docs/ # Documentation\n\u251c\u2500\u2500 app.py\n\u2514\u2500\u2500 peanu.tsk\n```\n\n## \ud83d\udc1b Troubleshooting\n\n### Database Issues\n```bash\n# Recreate databases\nflask-tsk db init my-project --force\n\n# Check database status\nflask-tsk db list my-project\n```\n\n### Performance Issues\n```python\nfrom tsk_flask.herd.elephants import get_peanuts\n\npeanuts = get_peanuts()\nstats = peanuts.get_performance_status()\nprint(f\"Performance Score: {stats['performance_score']}\")\n```\n\n## \ud83d\udcda Documentation\n\n- [GitHub Repository](https://github.com/cyber-boost/flask-tsk)\n- [Performance Guide](https://github.com/cyber-boost/flask-tsk/blob/main/docs/PERFORMANCE.md)\n- [API Reference](https://github.com/cyber-boost/flask-tsk/blob/main/docs/API.md)\n- [Configuration Guide](https://github.com/cyber-boost/flask-tsk/blob/main/docs/CONFIGURATION.md)\n\n## \ud83e\udd1d Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](https://github.com/cyber-boost/flask-tsk/blob/main/CONTRIBUTING.md) for details.\n\n## \ud83d\udcc4 License\n\nThis project is licensed under the MIT License - see the [LICENSE](https://github.com/cyber-boost/flask-tsk/blob/main/LICENSE) file for details.\n\n## \ud83d\ude4f Acknowledgments\n\n- **TuskLang Team** for the amazing configuration system\n- **Flask Community** for the excellent web framework\n- **Performance Testers** for validating our benchmarks\n\n---\n\n**Flask-TSK**: Where Flask meets TuskLang for revolutionary performance! \ud83d\ude80\ud83d\udc18 \n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Flask Extension for TuskLang Integration - Up to 59x Faster Template Rendering (Verified)",
"version": "2.0.4",
"project_urls": {
"Bug Tracker": "https://github.com/grim-project/flask-tsk/issues",
"Documentation": "https://flask-tsk.readthedocs.io/",
"Homepage": "https://github.com/grim-project/flask-tsk",
"Performance Guide": "https://github.com/grim-project/flask-tsk/blob/main/PERFORMANCE_REVOLUTION.md",
"Repository": "https://github.com/grim-project/flask-tsk"
},
"split_keywords": [
"flask",
" tusk",
" tusktsk",
" configuration",
" performance",
" template-engine"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "0758cac8fe2ec03c45798b412962322b26bf8dc833885c0aabac9e3859418f5e",
"md5": "6695970e4df0b6f382a62bfad47640e0",
"sha256": "ace03b8b00657c3aa055cdbf098b79676264fa966ea74aa2faccb43c775f2b5f"
},
"downloads": -1,
"filename": "flask_tsk-2.0.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6695970e4df0b6f382a62bfad47640e0",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 274089,
"upload_time": "2025-07-25T12:37:44",
"upload_time_iso_8601": "2025-07-25T12:37:44.321496Z",
"url": "https://files.pythonhosted.org/packages/07/58/cac8fe2ec03c45798b412962322b26bf8dc833885c0aabac9e3859418f5e/flask_tsk-2.0.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "cdb5d44214004c16a29f45db7d4c42978f7b5e0e2159ceff0ad6ee22f112e365",
"md5": "1d9ded8cc238e563f04e38ffe9d3a6c7",
"sha256": "7691c37411877345bab1fdcdd0f7b1b2c30f7c03f505edc2908b0ec8aaa077ed"
},
"downloads": -1,
"filename": "flask_tsk-2.0.4.tar.gz",
"has_sig": false,
"md5_digest": "1d9ded8cc238e563f04e38ffe9d3a6c7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 230133,
"upload_time": "2025-07-25T12:37:45",
"upload_time_iso_8601": "2025-07-25T12:37:45.375360Z",
"url": "https://files.pythonhosted.org/packages/cd/b5/d44214004c16a29f45db7d4c42978f7b5e0e2159ceff0ad6ee22f112e365/flask_tsk-2.0.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-25 12:37:45",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "grim-project",
"github_project": "flask-tsk",
"github_not_found": true,
"lcname": "flask-tsk"
}
JSON
