GitLocker: The Coding Marketplace

Description:

fastapigeolocation 1.0.1

FastAPI Geolocation
fastapi-geolocation is a simple middleware package for FastAPI that provides geolocation features by integrating IP-based location lookup. This package is particularly useful for FastAPI applications that need to determine the geographical location of their users.
Features

Easy integration with FastAPI applications.
Utilizes the GeoIP class from Django for location lookup.
Provides an easy-to-use middleware that enriches requests with geolocation data.

Installation
To install fastapi-geolocation, run the following command:
pip install fastapi-geolocation

Quick Start
Here is a simple example of how to use fastapi-geolocation in a FastAPI application:
import aioredis
from fastapi import FastAPI, Request
from fastapi_geolocation import GeoIPMiddleware

app = FastAPI()
redis_client = aioredis.from_url("redis://localhost", encoding="utf-8", decode_responses=True)
app.add_middleware(GeoIPMiddleware, redis_client=redis_client, license_key="mykey")

@app.get('/')
async def index(request: Request):
geo_data = request.state.geo
return {
'country': geo_data.country.name if geo_data else 'Unknown',
}

Configuration
To set up the middleware, you need to add it to your FastAPI application with the necessary parameters:
redis_client: An instance of aioredis client for caching purpose.
license_key: Your MaxMind license key for the GeoIP database.
Usage
After adding the middleware to your FastAPI application, you can access the geolocation data in your route handlers using the request.state.geo property.
Contributing
Contributions are welcome! If you would like to contribute to the project, please follow these steps:
Fork the repository.
Create a new branch for your feature or fix.
Write your code and add tests if applicable.
Submit a pull request with a clear description of your changes.
License
fastapi-geolocation is open source software licensed as MIT.
Credits
This project was inspired by the GeoIP functionality in Django and has been adapted for use in FastAPI applications.