easy-gateway 0.1.7

Simple to use and fast Gateway for python developers

Easy-Gateway Documentation

Overview

Easy-Gateway — lightweight API Gateway for microservices architecture.

Features

• Simple YAML configuration
• CLI interface
• Middleware system
• Prefix-based routing
• Rate limiting
• Logging
• Caching

Requirements

• Python ≥ 3.7
• No external dependencies

Version

v0.1.7

---

Installation

pip install easy-gateway

---

Configuration (config.yaml)

1. Server Settings

server:
    host: "0.0.0.0"
    port: 8000

2. Cache Settings

redis:
    enabled: true  # or false for InMemory Cache
    url: "redis://localhost:6379"
    expire_time: 500  # cache TTL in seconds (default 180)

To run Redis, you can use Docker:

docker run -d --name my-redis -p 6379:6379 redis

3. Routes

routes:
  - path: "/bin/*"
    target: "https://httpbin.org/"
    description: "Echo Server"

Important:

• path: "/user/*" — for URLs with any prefix after user
• path: "/user/" — for exact URL match

4. Middleware

Available middleware:

• LoggingMiddleware — request logging
• RateLimitMiddleware — request rate limiting

middlewares:
  - name: "LoggingMiddleware"
    enabled: true

  - name: "RateLimitMiddleware"
    enabled: true
    requests_per_minute: 5

5. CORS

cors:
  allow_origins:
    - "myfront.com"
    - "testreact.space"

---

Running

easy-gateway -c PATH-TO-YOUR-CONFIG
# or
easy-gateway --config
# or simply
easy-gateway  (if config is in root directory)

---

Project Structure

easy-gateway-docs/
├── index.html    # HTML documentation page
├── script.js     # JavaScript for navigation and code copying
├── styles.css    # Styles (dark theme)
└── README.md     # This file

---

Links

• GitHub: https://github.com/MarkLevkovich/easy_gateway