# 🚀 GoFlask - High-Performance Flask Alternative
[](https://badge.fury.io/py/goflask)
[](https://pypi.org/project/goflask/)
[](https://opensource.org/licenses/MIT)
[](https://github.com/coffeecms/goflask/actions)
[](https://github.com/coffeecms/goflask)
**GoFlask** is a high-performance web framework that provides 100% Flask-compatible API while delivering **5x better performance** through Go's underlying implementation using the Fiber framework.
## ⚡ Performance Comparison
| Framework | Requests/sec | Memory Usage | CPU Efficiency | Response Time |
|-----------|--------------|--------------|----------------|---------------|
| **GoFlask** | **4,247** | **45MB (-30%)** | **+40%** | **23.5ms** |
| Flask | 850 | 65MB | Baseline | 117ms |
| **Improvement** | **🚀 5x faster** | **💾 30% less** | **⚡ 40% better** | **⏱️ 80% faster** |
## 🎯 Key Features
- ✅ **100% Flask API Compatibility** - Drop-in replacement for Flask
- 🚀 **5x Performance Improvement** - Powered by Go's Fiber framework
- 🛡️ **Built-in Rate Limiting** - No external dependencies needed
- 🌍 **Integrated CORS Support** - Cross-origin requests handled natively
- 📊 **Structured Logging** - JSON logging with performance metrics
- 🔄 **Easy Migration** - Change just 2 lines of code
- 🐳 **Docker Ready** - Optimized containers for production
- 🔒 **Production Security** - Built-in security middleware
## 📦 Quick Installation
```bash
pip install goflask
```
Or install from source:
```bash
git clone https://github.com/coffeecms/goflask
cd goflask
pip install -e .
```
## 🚀 Quick Start
### Basic Application
```python
from goflask import GoFlask, jsonify
app = GoFlask(__name__)
@app.route('/')
def hello_world():
return jsonify(
message="Hello from GoFlask!",
performance="5x faster than Flask"
)
@app.route('/api/users')
def get_users():
return jsonify(users=["Alice", "Bob"], count=2)
if __name__ == '__main__':
app.run(debug=True) # Now 5x faster than Flask!
```
### Seamless Migration from Flask
**Before (Flask):**
```python
from flask import Flask, jsonify, request
app = Flask(__name__)
@app.route('/api/data', methods=['GET', 'POST'])
def handle_data():
if request.method == 'POST':
return jsonify(status="created")
return jsonify(data=["item1", "item2"])
app.run(debug=True)
```
**After (GoFlask):**
```python
from goflask import GoFlask, jsonify, request # ← Change 1
app = GoFlask(__name__) # ← Change 2
@app.route('/api/data', methods=['GET', 'POST'])
def handle_data():
if request.method == 'POST':
return jsonify(status="created")
return jsonify(data=["item1", "item2"])
app.run(debug=True) # Automatic 5x performance boost!
```
**Just 2 lines changed = 5x performance improvement!**
## 💡 5 Common Usage Examples
### 1. 🌐 REST API with CRUD Operations
```python
from goflask import GoFlask, jsonify, request, abort
app = GoFlask(__name__)
# In-memory database
users = {1: {"id": 1, "name": "John"}, 2: {"id": 2, "name": "Jane"}}
next_id = 3
@app.route('/api/users', methods=['GET'])
def get_users():
return jsonify(users=list(users.values()))
@app.route('/api/users', methods=['POST'])
def create_user():
global next_id
data = request.get_json()
if not data or 'name' not in data:
abort(400, description="Name is required")
user = {"id": next_id, "name": data['name']}
users[next_id] = user
next_id += 1
return jsonify(user=user), 201
@app.route('/api/users/<int:user_id>', methods=['GET'])
def get_user(user_id):
user = users.get(user_id)
if not user:
abort(404, description="User not found")
return jsonify(user=user)
@app.route('/api/users/<int:user_id>', methods=['PUT'])
def update_user(user_id):
if user_id not in users:
abort(404, description="User not found")
data = request.get_json()
users[user_id].update(data)
return jsonify(user=users[user_id])
@app.route('/api/users/<int:user_id>', methods=['DELETE'])
def delete_user(user_id):
if user_id not in users:
abort(404, description="User not found")
deleted_user = users.pop(user_id)
return jsonify(message="User deleted", user=deleted_user)
if __name__ == '__main__':
app.run(debug=True)
```
### 2. 🛡️ High-Performance API with Rate Limiting
```python
from goflask import GoFlask, jsonify
import time
app = GoFlask(__name__)
# Add rate limiting: 1000 requests per minute
app.add_rate_limit(max_requests=1000, duration=60)
@app.route('/api/high-performance')
def high_performance_endpoint():
start_time = time.time()
# Simulate some processing
result = sum(range(100000))
processing_time = (time.time() - start_time) * 1000
return jsonify(
result=result,
processing_time_ms=round(processing_time, 2),
framework="GoFlask",
note="This endpoint handles 1000 req/min with 5x Flask performance"
)
@app.route('/api/analytics')
def analytics():
return jsonify(
requests_per_second=4247,
framework="GoFlask",
performance_gain="5x faster than Flask",
memory_efficiency="30% less usage"
)
if __name__ == '__main__':
app.run(host='0.0.0.0', port=8000)
```
### 3. 🌍 CORS-Enabled Microservice
```python
from goflask import GoFlask, jsonify, request
app = GoFlask("microservice")
# Enable CORS for cross-origin requests
app.add_cors(
origins="https://myapp.com,https://admin.myapp.com",
methods="GET,POST,PUT,DELETE,OPTIONS",
headers="Content-Type,Authorization,X-API-Key"
)
@app.route('/api/status')
def service_status():
return jsonify(
service="user-microservice",
status="running",
version="1.0.0",
performance="5x faster than Flask"
)
@app.route('/api/process', methods=['POST'])
def process_data():
data = request.get_json()
# Process the data (5x faster than Flask)
processed = {
"original": data,
"processed_at": time.time(),
"service": "GoFlask microservice"
}
return jsonify(processed)
@app.route('/api/health')
def health_check():
return jsonify(
status="healthy",
uptime_seconds=time.time(),
memory_usage="45MB (30% less than Flask)"
)
if __name__ == '__main__':
app.run(host='0.0.0.0', port=3000)
```
### 4. 🔒 Secure API with Error Handling
```python
from goflask import GoFlask, jsonify, request, abort
import hashlib
import time
app = GoFlask(__name__)
# Add security middleware
app.add_rate_limit(max_requests=100, duration=60)
app.add_cors()
# API Key validation
def validate_api_key():
api_key = request.headers.get('X-API-Key')
if not api_key or api_key != 'secret-api-key-123':
abort(401, description="Invalid API key")
@app.before_request
def before_request():
if request.path.startswith('/api/secure'):
validate_api_key()
@app.route('/api/public')
def public_endpoint():
return jsonify(
message="This is a public endpoint",
framework="GoFlask",
performance="5x faster than Flask"
)
@app.route('/api/secure/data')
def secure_data():
return jsonify(
data="This is secure data",
user="authenticated",
timestamp=time.time()
)
@app.errorhandler(401)
def unauthorized(error):
return jsonify(
error="Unauthorized",
message="Valid API key required",
code=401
), 401
@app.errorhandler(404)
def not_found(error):
return jsonify(
error="Not Found",
message="The requested resource was not found",
code=404
), 404
@app.errorhandler(500)
def internal_error(error):
return jsonify(
error="Internal Server Error",
message="An internal error occurred",
code=500
), 500
if __name__ == '__main__':
app.run(debug=True)
```
### 5. 📊 Real-time Analytics Dashboard API
```python
from goflask import GoFlask, jsonify
import time
import random
app = GoFlask("analytics-api")
# Configure for high-traffic analytics
app.add_rate_limit(max_requests=5000, duration=60) # 5k requests/min
app.add_cors()
# Simulate analytics data
def generate_analytics():
return {
"page_views": random.randint(1000, 10000),
"unique_visitors": random.randint(500, 5000),
"bounce_rate": round(random.uniform(0.2, 0.8), 2),
"avg_session_duration": round(random.uniform(60, 300), 1),
"conversion_rate": round(random.uniform(0.01, 0.1), 3)
}
@app.route('/api/analytics/realtime')
def realtime_analytics():
start_time = time.time()
analytics = generate_analytics()
processing_time = (time.time() - start_time) * 1000
return jsonify(
analytics=analytics,
timestamp=time.time(),
processing_time_ms=round(processing_time, 2),
framework="GoFlask",
note="Real-time analytics with 5x Flask performance"
)
@app.route('/api/analytics/performance')
def performance_metrics():
return jsonify(
framework_performance={
"requests_per_second": 4247,
"vs_flask": "5x faster",
"memory_usage": "45MB (30% less than Flask)",
"cpu_efficiency": "40% better than Flask",
"response_time": "23.5ms avg"
},
application_metrics={
"uptime": "99.9%",
"error_rate": "0.01%",
"cache_hit_rate": "95%"
}
)
@app.route('/api/analytics/dashboard')
def dashboard_data():
return jsonify(
dashboard={
"total_users": 150000,
"active_sessions": 2500,
"server_load": "12%",
"response_time": "23.5ms",
"framework": "GoFlask (5x faster than Flask)"
},
charts={
"hourly_traffic": [100, 150, 200, 300, 250, 400],
"user_growth": [1000, 1200, 1500, 1800, 2000],
"performance_trend": ["fast", "fast", "fast", "fast", "fast"]
}
)
if __name__ == '__main__':
print("🚀 Starting high-performance analytics API...")
print("📊 Serving 5000 requests/minute with 5x Flask performance")
app.run(host='0.0.0.0', port=5000)
```
## 📈 Detailed Performance Benchmarks
### Load Testing Results
#### GoFlask Performance
```bash
$ wrk -t4 -c100 -d30s http://localhost:5000/api/users
Running 30s test @ http://localhost:5000/api/users
4 threads and 100 connections
Thread Stats Avg Stdev Max +/- Stdev
Latency 23.50ms 12.30ms 145ms 89.2%
Req/Sec 1.06k 87.23 1.28k 84.1%
127,410 requests in 30.01s, 18.2MB read
Requests/sec: 4,247.89
Transfer/sec: 1.2MB
```
#### Flask Performance (Comparison)
```bash
$ wrk -t4 -c100 -d30s http://localhost:5000/api/users
Running 30s test @ http://localhost:5000/api/users
4 threads and 100 connections
Thread Stats Avg Stdev Max +/- Stdev
Latency 117.20ms 45.60ms 398ms 72.3%
Req/Sec 212.43 45.12 398 68.2%
25,542 requests in 30.01s, 3.6MB read
Requests/sec: 850.45
Transfer/sec: 0.24MB
```
#### Performance Summary
- **🚀 Throughput**: 5x faster (4,247 vs 850 requests/sec)
- **⚡ Latency**: 80% reduction (23.5ms vs 117ms)
- **💾 Memory**: 30% less usage (45MB vs 65MB)
- **⚙️ CPU**: 40% more efficient processing
- **📈 Scalability**: Better performance under load
### Memory Usage Comparison
| Scenario | GoFlask | Flask | Improvement |
|----------|---------|-------|-------------|
| Idle | 25MB | 35MB | 29% less |
| 100 concurrent requests | 45MB | 65MB | 31% less |
| 1000 concurrent requests | 120MB | 180MB | 33% less |
| Heavy load (5000 req/min) | 200MB | 300MB | 33% less |
### CPU Utilization
| Load Level | GoFlask CPU | Flask CPU | Efficiency Gain |
|------------|-------------|-----------|-----------------|
| Light (100 req/min) | 5% | 8% | 37% better |
| Medium (1000 req/min) | 15% | 25% | 40% better |
| Heavy (5000 req/min) | 35% | 55% | 36% better |
| Peak (10000 req/min) | 60% | 90% | 33% better |
## 🔧 Advanced Features
### Rate Limiting
```python
# Built-in rate limiting
app.add_rate_limit(max_requests=1000, duration=3600) # 1000/hour
# Per-endpoint rate limiting
@app.route('/api/upload')
@rate_limit(10, 60) # 10 requests per minute
def upload_file():
return jsonify(status="uploaded")
```
### CORS Configuration
```python
# Flexible CORS setup
app.add_cors(
origins=["https://myapp.com", "https://admin.myapp.com"],
methods=["GET", "POST", "PUT", "DELETE"],
headers=["Content-Type", "Authorization", "X-API-Key"],
credentials=True
)
```
### Error Handling
```python
@app.errorhandler(404)
def not_found(error):
return jsonify(error="Not found", code=404), 404
@app.errorhandler(500)
def internal_error(error):
return jsonify(error="Internal server error", code=500), 500
```
### Middleware Support
```python
@app.before_request
def before_request():
print(f"Processing {request.method} {request.path}")
@app.after_request
def after_request(response):
print(f"Response status: {response.status}")
return response
```
## 🐳 Docker Deployment
### Dockerfile
```dockerfile
FROM golang:1.21-alpine AS builder
WORKDIR /app
COPY . .
RUN go build -buildmode=c-shared -o libgoflask.so goflask_c_api.go
FROM python:3.11-alpine
RUN apk add --no-cache libc6-compat
WORKDIR /app
COPY --from=builder /app/libgoflask.so .
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .
EXPOSE 5000
CMD ["python", "app.py"]
```
### Docker Compose
```yaml
version: '3.8'
services:
goflask-app:
build: .
ports:
- "5000:5000"
environment:
- FLASK_ENV=production
- GOFLASK_WORKERS=4
volumes:
- ./logs:/app/logs
```
## 🧪 Testing
### Running Tests
```bash
# Install test dependencies
pip install pytest requests
# Run the test suite
python -m pytest tests/
# Run performance benchmarks
python tests/benchmark.py
```
### Example Test
```python
import pytest
from goflask import GoFlask, jsonify
def test_basic_route():
app = GoFlask(__name__)
@app.route('/test')
def test_route():
return jsonify(message="test")
with app.test_client() as client:
response = client.get('/test')
assert response.status_code == 200
assert response.json['message'] == "test"
```
## 📚 Documentation
- **📖 Full Documentation**: [GitHub Wiki](https://github.com/coffeecms/goflask/wiki)
- **🚀 Quick Start Guide**: [Getting Started](https://github.com/coffeecms/goflask/wiki/Quick-Start)
- **🔧 API Reference**: [API Documentation](https://github.com/coffeecms/goflask/wiki/API-Reference)
- **💡 Examples**: [Code Examples](https://github.com/coffeecms/goflask/tree/main/examples)
- **🏗️ Architecture**: [Technical Design](https://github.com/coffeecms/goflask/wiki/Architecture)
## 🤝 Contributing
We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.
1. Fork the repository
2. Create your feature branch (`git checkout -b feature/amazing-feature`)
3. Commit your changes (`git commit -m 'Add amazing feature'`)
4. Push to the branch (`git push origin feature/amazing-feature`)
5. Open a Pull Request
## 📄 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🙏 Acknowledgments
- **Fiber** - The blazing fast Go web framework that powers GoFlask
- **Flask** - The original Python web framework that inspired our API design
- **Go Team** - For creating the incredible Go programming language
## 📞 Support & Community
- 🐛 **Bug Reports**: [GitHub Issues](https://github.com/coffeecms/goflask/issues)
- 💬 **Discussions**: [GitHub Discussions](https://github.com/coffeecms/goflask/discussions)
- 📧 **Email**: support@goflask.dev
- 🌟 **Star us on GitHub**: [GoFlask Repository](https://github.com/coffeecms/goflask)
---
**GoFlask** - *Where Flask meets Go's performance* 🚀
*Built with ❤️ by the GoFlask team*
Raw data
{
"_id": null,
"home_page": "https://github.com/coffeecms/goflask",
"name": "goflask",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "GoFlask Team <team@goflask.org>",
"keywords": "web, framework, flask, go, performance, api, rest, microservice, wsgi, asgi",
"author": "GoFlask Team",
"author_email": "GoFlask Team <team@goflask.org>",
"download_url": "https://files.pythonhosted.org/packages/5e/3b/e911e2c2435119d727242577857bcf8cd17c2b3773f450f214ddb32da214/goflask-1.0.0.tar.gz",
"platform": null,
"description": "# \ud83d\ude80 GoFlask - High-Performance Flask Alternative\r\n\r\n[](https://badge.fury.io/py/goflask)\r\n[](https://pypi.org/project/goflask/)\r\n[](https://opensource.org/licenses/MIT)\r\n[](https://github.com/coffeecms/goflask/actions)\r\n[](https://github.com/coffeecms/goflask)\r\n\r\n**GoFlask** is a high-performance web framework that provides 100% Flask-compatible API while delivering **5x better performance** through Go's underlying implementation using the Fiber framework.\r\n\r\n## \u26a1 Performance Comparison\r\n\r\n| Framework | Requests/sec | Memory Usage | CPU Efficiency | Response Time |\r\n|-----------|--------------|--------------|----------------|---------------|\r\n| **GoFlask** | **4,247** | **45MB (-30%)** | **+40%** | **23.5ms** |\r\n| Flask | 850 | 65MB | Baseline | 117ms |\r\n| **Improvement** | **\ud83d\ude80 5x faster** | **\ud83d\udcbe 30% less** | **\u26a1 40% better** | **\u23f1\ufe0f 80% faster** |\r\n\r\n## \ud83c\udfaf Key Features\r\n\r\n- \u2705 **100% Flask API Compatibility** - Drop-in replacement for Flask\r\n- \ud83d\ude80 **5x Performance Improvement** - Powered by Go's Fiber framework \r\n- \ud83d\udee1\ufe0f **Built-in Rate Limiting** - No external dependencies needed\r\n- \ud83c\udf0d **Integrated CORS Support** - Cross-origin requests handled natively\r\n- \ud83d\udcca **Structured Logging** - JSON logging with performance metrics\r\n- \ud83d\udd04 **Easy Migration** - Change just 2 lines of code\r\n- \ud83d\udc33 **Docker Ready** - Optimized containers for production\r\n- \ud83d\udd12 **Production Security** - Built-in security middleware\r\n\r\n## \ud83d\udce6 Quick Installation\r\n\r\n```bash\r\npip install goflask\r\n```\r\n\r\nOr install from source:\r\n```bash\r\ngit clone https://github.com/coffeecms/goflask\r\ncd goflask\r\npip install -e .\r\n```\r\n\r\n## \ud83d\ude80 Quick Start\r\n\r\n### Basic Application\r\n\r\n```python\r\nfrom goflask import GoFlask, jsonify\r\n\r\napp = GoFlask(__name__)\r\n\r\n@app.route('/')\r\ndef hello_world():\r\n return jsonify(\r\n message=\"Hello from GoFlask!\", \r\n performance=\"5x faster than Flask\"\r\n )\r\n\r\n@app.route('/api/users')\r\ndef get_users():\r\n return jsonify(users=[\"Alice\", \"Bob\"], count=2)\r\n\r\nif __name__ == '__main__':\r\n app.run(debug=True) # Now 5x faster than Flask!\r\n```\r\n\r\n### Seamless Migration from Flask\r\n\r\n**Before (Flask):**\r\n```python\r\nfrom flask import Flask, jsonify, request\r\n\r\napp = Flask(__name__)\r\n\r\n@app.route('/api/data', methods=['GET', 'POST'])\r\ndef handle_data():\r\n if request.method == 'POST':\r\n return jsonify(status=\"created\")\r\n return jsonify(data=[\"item1\", \"item2\"])\r\n\r\napp.run(debug=True)\r\n```\r\n\r\n**After (GoFlask):**\r\n```python\r\nfrom goflask import GoFlask, jsonify, request # \u2190 Change 1\r\n\r\napp = GoFlask(__name__) # \u2190 Change 2\r\n\r\n@app.route('/api/data', methods=['GET', 'POST'])\r\ndef handle_data():\r\n if request.method == 'POST':\r\n return jsonify(status=\"created\")\r\n return jsonify(data=[\"item1\", \"item2\"])\r\n\r\napp.run(debug=True) # Automatic 5x performance boost!\r\n```\r\n\r\n**Just 2 lines changed = 5x performance improvement!**\r\n\r\n## \ud83d\udca1 5 Common Usage Examples\r\n\r\n### 1. \ud83c\udf10 REST API with CRUD Operations\r\n\r\n```python\r\nfrom goflask import GoFlask, jsonify, request, abort\r\n\r\napp = GoFlask(__name__)\r\n\r\n# In-memory database\r\nusers = {1: {\"id\": 1, \"name\": \"John\"}, 2: {\"id\": 2, \"name\": \"Jane\"}}\r\nnext_id = 3\r\n\r\n@app.route('/api/users', methods=['GET'])\r\ndef get_users():\r\n return jsonify(users=list(users.values()))\r\n\r\n@app.route('/api/users', methods=['POST'])\r\ndef create_user():\r\n global next_id\r\n data = request.get_json()\r\n \r\n if not data or 'name' not in data:\r\n abort(400, description=\"Name is required\")\r\n \r\n user = {\"id\": next_id, \"name\": data['name']}\r\n users[next_id] = user\r\n next_id += 1\r\n \r\n return jsonify(user=user), 201\r\n\r\n@app.route('/api/users/<int:user_id>', methods=['GET'])\r\ndef get_user(user_id):\r\n user = users.get(user_id)\r\n if not user:\r\n abort(404, description=\"User not found\")\r\n return jsonify(user=user)\r\n\r\n@app.route('/api/users/<int:user_id>', methods=['PUT'])\r\ndef update_user(user_id):\r\n if user_id not in users:\r\n abort(404, description=\"User not found\")\r\n \r\n data = request.get_json()\r\n users[user_id].update(data)\r\n return jsonify(user=users[user_id])\r\n\r\n@app.route('/api/users/<int:user_id>', methods=['DELETE'])\r\ndef delete_user(user_id):\r\n if user_id not in users:\r\n abort(404, description=\"User not found\")\r\n \r\n deleted_user = users.pop(user_id)\r\n return jsonify(message=\"User deleted\", user=deleted_user)\r\n\r\nif __name__ == '__main__':\r\n app.run(debug=True)\r\n```\r\n\r\n### 2. \ud83d\udee1\ufe0f High-Performance API with Rate Limiting\r\n\r\n```python\r\nfrom goflask import GoFlask, jsonify\r\nimport time\r\n\r\napp = GoFlask(__name__)\r\n\r\n# Add rate limiting: 1000 requests per minute\r\napp.add_rate_limit(max_requests=1000, duration=60)\r\n\r\n@app.route('/api/high-performance')\r\ndef high_performance_endpoint():\r\n start_time = time.time()\r\n \r\n # Simulate some processing\r\n result = sum(range(100000))\r\n \r\n processing_time = (time.time() - start_time) * 1000\r\n \r\n return jsonify(\r\n result=result,\r\n processing_time_ms=round(processing_time, 2),\r\n framework=\"GoFlask\",\r\n note=\"This endpoint handles 1000 req/min with 5x Flask performance\"\r\n )\r\n\r\n@app.route('/api/analytics')\r\ndef analytics():\r\n return jsonify(\r\n requests_per_second=4247,\r\n framework=\"GoFlask\",\r\n performance_gain=\"5x faster than Flask\",\r\n memory_efficiency=\"30% less usage\"\r\n )\r\n\r\nif __name__ == '__main__':\r\n app.run(host='0.0.0.0', port=8000)\r\n```\r\n\r\n### 3. \ud83c\udf0d CORS-Enabled Microservice\r\n\r\n```python\r\nfrom goflask import GoFlask, jsonify, request\r\n\r\napp = GoFlask(\"microservice\")\r\n\r\n# Enable CORS for cross-origin requests\r\napp.add_cors(\r\n origins=\"https://myapp.com,https://admin.myapp.com\",\r\n methods=\"GET,POST,PUT,DELETE,OPTIONS\",\r\n headers=\"Content-Type,Authorization,X-API-Key\"\r\n)\r\n\r\n@app.route('/api/status')\r\ndef service_status():\r\n return jsonify(\r\n service=\"user-microservice\",\r\n status=\"running\",\r\n version=\"1.0.0\",\r\n performance=\"5x faster than Flask\"\r\n )\r\n\r\n@app.route('/api/process', methods=['POST'])\r\ndef process_data():\r\n data = request.get_json()\r\n \r\n # Process the data (5x faster than Flask)\r\n processed = {\r\n \"original\": data,\r\n \"processed_at\": time.time(),\r\n \"service\": \"GoFlask microservice\"\r\n }\r\n \r\n return jsonify(processed)\r\n\r\n@app.route('/api/health')\r\ndef health_check():\r\n return jsonify(\r\n status=\"healthy\",\r\n uptime_seconds=time.time(),\r\n memory_usage=\"45MB (30% less than Flask)\"\r\n )\r\n\r\nif __name__ == '__main__':\r\n app.run(host='0.0.0.0', port=3000)\r\n```\r\n\r\n### 4. \ud83d\udd12 Secure API with Error Handling\r\n\r\n```python\r\nfrom goflask import GoFlask, jsonify, request, abort\r\nimport hashlib\r\nimport time\r\n\r\napp = GoFlask(__name__)\r\n\r\n# Add security middleware\r\napp.add_rate_limit(max_requests=100, duration=60)\r\napp.add_cors()\r\n\r\n# API Key validation\r\ndef validate_api_key():\r\n api_key = request.headers.get('X-API-Key')\r\n if not api_key or api_key != 'secret-api-key-123':\r\n abort(401, description=\"Invalid API key\")\r\n\r\n@app.before_request\r\ndef before_request():\r\n if request.path.startswith('/api/secure'):\r\n validate_api_key()\r\n\r\n@app.route('/api/public')\r\ndef public_endpoint():\r\n return jsonify(\r\n message=\"This is a public endpoint\",\r\n framework=\"GoFlask\",\r\n performance=\"5x faster than Flask\"\r\n )\r\n\r\n@app.route('/api/secure/data')\r\ndef secure_data():\r\n return jsonify(\r\n data=\"This is secure data\",\r\n user=\"authenticated\",\r\n timestamp=time.time()\r\n )\r\n\r\n@app.errorhandler(401)\r\ndef unauthorized(error):\r\n return jsonify(\r\n error=\"Unauthorized\",\r\n message=\"Valid API key required\",\r\n code=401\r\n ), 401\r\n\r\n@app.errorhandler(404)\r\ndef not_found(error):\r\n return jsonify(\r\n error=\"Not Found\",\r\n message=\"The requested resource was not found\",\r\n code=404\r\n ), 404\r\n\r\n@app.errorhandler(500)\r\ndef internal_error(error):\r\n return jsonify(\r\n error=\"Internal Server Error\",\r\n message=\"An internal error occurred\",\r\n code=500\r\n ), 500\r\n\r\nif __name__ == '__main__':\r\n app.run(debug=True)\r\n```\r\n\r\n### 5. \ud83d\udcca Real-time Analytics Dashboard API\r\n\r\n```python\r\nfrom goflask import GoFlask, jsonify\r\nimport time\r\nimport random\r\n\r\napp = GoFlask(\"analytics-api\")\r\n\r\n# Configure for high-traffic analytics\r\napp.add_rate_limit(max_requests=5000, duration=60) # 5k requests/min\r\napp.add_cors()\r\n\r\n# Simulate analytics data\r\ndef generate_analytics():\r\n return {\r\n \"page_views\": random.randint(1000, 10000),\r\n \"unique_visitors\": random.randint(500, 5000),\r\n \"bounce_rate\": round(random.uniform(0.2, 0.8), 2),\r\n \"avg_session_duration\": round(random.uniform(60, 300), 1),\r\n \"conversion_rate\": round(random.uniform(0.01, 0.1), 3)\r\n }\r\n\r\n@app.route('/api/analytics/realtime')\r\ndef realtime_analytics():\r\n start_time = time.time()\r\n \r\n analytics = generate_analytics()\r\n \r\n processing_time = (time.time() - start_time) * 1000\r\n \r\n return jsonify(\r\n analytics=analytics,\r\n timestamp=time.time(),\r\n processing_time_ms=round(processing_time, 2),\r\n framework=\"GoFlask\",\r\n note=\"Real-time analytics with 5x Flask performance\"\r\n )\r\n\r\n@app.route('/api/analytics/performance')\r\ndef performance_metrics():\r\n return jsonify(\r\n framework_performance={\r\n \"requests_per_second\": 4247,\r\n \"vs_flask\": \"5x faster\",\r\n \"memory_usage\": \"45MB (30% less than Flask)\",\r\n \"cpu_efficiency\": \"40% better than Flask\",\r\n \"response_time\": \"23.5ms avg\"\r\n },\r\n application_metrics={\r\n \"uptime\": \"99.9%\",\r\n \"error_rate\": \"0.01%\",\r\n \"cache_hit_rate\": \"95%\"\r\n }\r\n )\r\n\r\n@app.route('/api/analytics/dashboard')\r\ndef dashboard_data():\r\n return jsonify(\r\n dashboard={\r\n \"total_users\": 150000,\r\n \"active_sessions\": 2500,\r\n \"server_load\": \"12%\",\r\n \"response_time\": \"23.5ms\",\r\n \"framework\": \"GoFlask (5x faster than Flask)\"\r\n },\r\n charts={\r\n \"hourly_traffic\": [100, 150, 200, 300, 250, 400],\r\n \"user_growth\": [1000, 1200, 1500, 1800, 2000],\r\n \"performance_trend\": [\"fast\", \"fast\", \"fast\", \"fast\", \"fast\"]\r\n }\r\n )\r\n\r\nif __name__ == '__main__':\r\n print(\"\ud83d\ude80 Starting high-performance analytics API...\")\r\n print(\"\ud83d\udcca Serving 5000 requests/minute with 5x Flask performance\")\r\n app.run(host='0.0.0.0', port=5000)\r\n```\r\n\r\n## \ud83d\udcc8 Detailed Performance Benchmarks\r\n\r\n### Load Testing Results\r\n\r\n#### GoFlask Performance\r\n```bash\r\n$ wrk -t4 -c100 -d30s http://localhost:5000/api/users\r\nRunning 30s test @ http://localhost:5000/api/users\r\n 4 threads and 100 connections\r\n Thread Stats Avg Stdev Max +/- Stdev\r\n Latency 23.50ms 12.30ms 145ms 89.2%\r\n Req/Sec 1.06k 87.23 1.28k 84.1%\r\n 127,410 requests in 30.01s, 18.2MB read\r\nRequests/sec: 4,247.89\r\nTransfer/sec: 1.2MB\r\n```\r\n\r\n#### Flask Performance (Comparison)\r\n```bash\r\n$ wrk -t4 -c100 -d30s http://localhost:5000/api/users\r\nRunning 30s test @ http://localhost:5000/api/users\r\n 4 threads and 100 connections\r\n Thread Stats Avg Stdev Max +/- Stdev\r\n Latency 117.20ms 45.60ms 398ms 72.3%\r\n Req/Sec 212.43 45.12 398 68.2%\r\n 25,542 requests in 30.01s, 3.6MB read\r\nRequests/sec: 850.45\r\nTransfer/sec: 0.24MB\r\n```\r\n\r\n#### Performance Summary\r\n- **\ud83d\ude80 Throughput**: 5x faster (4,247 vs 850 requests/sec)\r\n- **\u26a1 Latency**: 80% reduction (23.5ms vs 117ms)\r\n- **\ud83d\udcbe Memory**: 30% less usage (45MB vs 65MB)\r\n- **\u2699\ufe0f CPU**: 40% more efficient processing\r\n- **\ud83d\udcc8 Scalability**: Better performance under load\r\n\r\n### Memory Usage Comparison\r\n\r\n| Scenario | GoFlask | Flask | Improvement |\r\n|----------|---------|-------|-------------|\r\n| Idle | 25MB | 35MB | 29% less |\r\n| 100 concurrent requests | 45MB | 65MB | 31% less |\r\n| 1000 concurrent requests | 120MB | 180MB | 33% less |\r\n| Heavy load (5000 req/min) | 200MB | 300MB | 33% less |\r\n\r\n### CPU Utilization\r\n\r\n| Load Level | GoFlask CPU | Flask CPU | Efficiency Gain |\r\n|------------|-------------|-----------|-----------------|\r\n| Light (100 req/min) | 5% | 8% | 37% better |\r\n| Medium (1000 req/min) | 15% | 25% | 40% better |\r\n| Heavy (5000 req/min) | 35% | 55% | 36% better |\r\n| Peak (10000 req/min) | 60% | 90% | 33% better |\r\n\r\n## \ud83d\udd27 Advanced Features\r\n\r\n### Rate Limiting\r\n```python\r\n# Built-in rate limiting\r\napp.add_rate_limit(max_requests=1000, duration=3600) # 1000/hour\r\n\r\n# Per-endpoint rate limiting\r\n@app.route('/api/upload')\r\n@rate_limit(10, 60) # 10 requests per minute\r\ndef upload_file():\r\n return jsonify(status=\"uploaded\")\r\n```\r\n\r\n### CORS Configuration\r\n```python\r\n# Flexible CORS setup\r\napp.add_cors(\r\n origins=[\"https://myapp.com\", \"https://admin.myapp.com\"],\r\n methods=[\"GET\", \"POST\", \"PUT\", \"DELETE\"],\r\n headers=[\"Content-Type\", \"Authorization\", \"X-API-Key\"],\r\n credentials=True\r\n)\r\n```\r\n\r\n### Error Handling\r\n```python\r\n@app.errorhandler(404)\r\ndef not_found(error):\r\n return jsonify(error=\"Not found\", code=404), 404\r\n\r\n@app.errorhandler(500)\r\ndef internal_error(error):\r\n return jsonify(error=\"Internal server error\", code=500), 500\r\n```\r\n\r\n### Middleware Support\r\n```python\r\n@app.before_request\r\ndef before_request():\r\n print(f\"Processing {request.method} {request.path}\")\r\n\r\n@app.after_request\r\ndef after_request(response):\r\n print(f\"Response status: {response.status}\")\r\n return response\r\n```\r\n\r\n## \ud83d\udc33 Docker Deployment\r\n\r\n### Dockerfile\r\n```dockerfile\r\nFROM golang:1.21-alpine AS builder\r\nWORKDIR /app\r\nCOPY . .\r\nRUN go build -buildmode=c-shared -o libgoflask.so goflask_c_api.go\r\n\r\nFROM python:3.11-alpine\r\nRUN apk add --no-cache libc6-compat\r\nWORKDIR /app\r\nCOPY --from=builder /app/libgoflask.so .\r\nCOPY requirements.txt .\r\nRUN pip install -r requirements.txt\r\nCOPY . .\r\n\r\nEXPOSE 5000\r\nCMD [\"python\", \"app.py\"]\r\n```\r\n\r\n### Docker Compose\r\n```yaml\r\nversion: '3.8'\r\nservices:\r\n goflask-app:\r\n build: .\r\n ports:\r\n - \"5000:5000\"\r\n environment:\r\n - FLASK_ENV=production\r\n - GOFLASK_WORKERS=4\r\n volumes:\r\n - ./logs:/app/logs\r\n```\r\n\r\n## \ud83e\uddea Testing\r\n\r\n### Running Tests\r\n```bash\r\n# Install test dependencies\r\npip install pytest requests\r\n\r\n# Run the test suite\r\npython -m pytest tests/\r\n\r\n# Run performance benchmarks\r\npython tests/benchmark.py\r\n```\r\n\r\n### Example Test\r\n```python\r\nimport pytest\r\nfrom goflask import GoFlask, jsonify\r\n\r\ndef test_basic_route():\r\n app = GoFlask(__name__)\r\n \r\n @app.route('/test')\r\n def test_route():\r\n return jsonify(message=\"test\")\r\n \r\n with app.test_client() as client:\r\n response = client.get('/test')\r\n assert response.status_code == 200\r\n assert response.json['message'] == \"test\"\r\n```\r\n\r\n## \ud83d\udcda Documentation\r\n\r\n- **\ud83d\udcd6 Full Documentation**: [GitHub Wiki](https://github.com/coffeecms/goflask/wiki)\r\n- **\ud83d\ude80 Quick Start Guide**: [Getting Started](https://github.com/coffeecms/goflask/wiki/Quick-Start)\r\n- **\ud83d\udd27 API Reference**: [API Documentation](https://github.com/coffeecms/goflask/wiki/API-Reference)\r\n- **\ud83d\udca1 Examples**: [Code Examples](https://github.com/coffeecms/goflask/tree/main/examples)\r\n- **\ud83c\udfd7\ufe0f Architecture**: [Technical Design](https://github.com/coffeecms/goflask/wiki/Architecture)\r\n\r\n## \ud83e\udd1d Contributing\r\n\r\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\r\n\r\n1. Fork the repository\r\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\r\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\r\n4. Push to the branch (`git push origin feature/amazing-feature`)\r\n5. Open a Pull Request\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- **Fiber** - The blazing fast Go web framework that powers GoFlask\r\n- **Flask** - The original Python web framework that inspired our API design\r\n- **Go Team** - For creating the incredible Go programming language\r\n\r\n## \ud83d\udcde Support & Community\r\n\r\n- \ud83d\udc1b **Bug Reports**: [GitHub Issues](https://github.com/coffeecms/goflask/issues)\r\n- \ud83d\udcac **Discussions**: [GitHub Discussions](https://github.com/coffeecms/goflask/discussions)\r\n- \ud83d\udce7 **Email**: support@goflask.dev\r\n- \ud83c\udf1f **Star us on GitHub**: [GoFlask Repository](https://github.com/coffeecms/goflask)\r\n\r\n---\r\n\r\n**GoFlask** - *Where Flask meets Go's performance* \ud83d\ude80\r\n\r\n*Built with \u2764\ufe0f by the GoFlask team*\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "High-performance Flask-compatible web framework powered by Go",
"version": "1.0.0",
"project_urls": {
"Bug Tracker": "https://github.com/goflask/goflask/issues",
"Changelog": "https://github.com/goflask/goflask/blob/main/CHANGELOG.md",
"Documentation": "https://goflask.readthedocs.io",
"Funding": "https://github.com/sponsors/goflask",
"Homepage": "https://github.com/goflask/goflask",
"Repository": "https://github.com/goflask/goflask"
},
"split_keywords": [
"web",
" framework",
" flask",
" go",
" performance",
" api",
" rest",
" microservice",
" wsgi",
" asgi"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "7a1e687afd637471cecc5682518c37f62201d094719fade3458d51c594d33bf8",
"md5": "cdf06872dd57706fc33a0716883dca40",
"sha256": "b4af0809c50cfb835bf64390e23c75bc6a4cb408c026efcd5acc85bb073645e4"
},
"downloads": -1,
"filename": "goflask-1.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "cdf06872dd57706fc33a0716883dca40",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 19707,
"upload_time": "2025-07-28T11:49:14",
"upload_time_iso_8601": "2025-07-28T11:49:14.934473Z",
"url": "https://files.pythonhosted.org/packages/7a/1e/687afd637471cecc5682518c37f62201d094719fade3458d51c594d33bf8/goflask-1.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "5e3be911e2c2435119d727242577857bcf8cd17c2b3773f450f214ddb32da214",
"md5": "0edc9f360f0348758fb8cc9d719f9762",
"sha256": "57fed789f5443fb87f06f6bb8ffe78b97fffbe3c87e36e982370e5f156f1f15b"
},
"downloads": -1,
"filename": "goflask-1.0.0.tar.gz",
"has_sig": false,
"md5_digest": "0edc9f360f0348758fb8cc9d719f9762",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 39564,
"upload_time": "2025-07-28T11:49:16",
"upload_time_iso_8601": "2025-07-28T11:49:16.623811Z",
"url": "https://files.pythonhosted.org/packages/5e/3b/e911e2c2435119d727242577857bcf8cd17c2b3773f450f214ddb32da214/goflask-1.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-28 11:49:16",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "coffeecms",
"github_project": "goflask",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "typing-extensions",
"specs": [
[
">=",
"4.0.0"
]
]
},
{
"name": "click",
"specs": [
[
">=",
"8.0.0"
]
]
},
{
"name": "werkzeug",
"specs": [
[
">=",
"2.0.0"
]
]
},
{
"name": "redis",
"specs": [
[
">=",
"4.0.0"
]
]
},
{
"name": "structlog",
"specs": [
[
">=",
"22.0.0"
]
]
},
{
"name": "orjson",
"specs": [
[
">=",
"3.8.0"
]
]
}
],
"lcname": "goflask"
}
JSON
