Metadata-Version: 2.1
Name: requests-counter
Version: 1.1.1
Summary: A tool to monitor the number of HTTP requests through an _apiKey_ in the HTTP Header.
Home-page: https://github.com/Arfius/requests-counter
License: MIT
Keywords: monitor,api,request,api_key
Author: Alfonso Farruggia
Requires-Python: >=3.7,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: aioredis (>=1.3.1,<2.0.0)
Requires-Dist: asyncio (>=3.4.3,<4.0.0)
Requires-Dist: fastapi (>=0.63.0,<0.64.0)
Requires-Dist: flake8 (>=3.8.4,<4.0.0)
Requires-Dist: pytest (>=6.2.2,<7.0.0)
Requires-Dist: pytest-asyncio (>=0.14.0,<0.15.0)
Project-URL: Repository, https://github.com/Arfius/requests-counter
Description-Content-Type: text/markdown

# requests-counter

A tool to monitor the number of HTTP requests through an _apiKey_ in the HTTP Header.

![ci/cd](https://github.com/Arfius/requests-counter/actions/workflows/request-counter.yml/badge.svg)

#### Use cases

Scenario: A Company that sell a Service that is limited by a max amount of requests.

- As a Company, I would set a request limit for an _api_key_.
- As a Company, I would update/destroy/inspect the status of subscription via api.

### Installation

#### Requirement

 Install *redis* or run a docker container as below

```bash
$> docker run --name test-redis -p6379:6379 -ti redis redis-server --appendonly yes
```

### Package Installation

```bash
$> pip install requests-counter
```

## Usage

### As request counter for fastapi

```python
from fastapi import Depends, FastAPI, HTTPException,Header

#1. Import the library
from requests_counter.reqcounter import ReqCounter

import asyncio
app = FastAPI()

#2. Create an ReqCounter object with the url to redis instance as parameter
cl = ReqCounter("redis://localhost")

#3. populate the Object with a list of tuple (key, max_value)
asyncio.create_task(cl.setup([("my-api-key-test",10)]))

#4. Declare a function to inject to Depends module. It will decrease the max_value for each request. It will raise a 429 HTTPException when max_value is 0.
async def check_key(apiKey: str = Header(None)):
    res = await cl.decrease(apiKey)
    if res == False:
        raise HTTPException(429, "Too Many Requests", headers={"Retry-After": "renew subscription"})
    return apiKey

#5. Inject the check_key function to endpoint
@app.get("/consume")
async def consume_key(apiKey = Depends(check_key)):
    return {"job": "done", "apiKey":apiKey}
```
To run this example
```bash
$> uvicorn requests_counter.example:app --reload --port 8080
```

### As endpoint 

Command below run the server to interact with your redis instance for

- Destroy a key
- Update the value (i.e. renewal)
- Get the status of all keys


```bash
$> uvicorn requests_counter.api:app --reload --port 8080
```

Run `http://locahost:8080/docs` for documentation.

