Technologies Used
Project Screenshots
Case Study
The objective of this project was to create a reusable Django application to track clicks on any link such as Affiliate Link, File Downloads, Social Link. The application should be easy to integrate into existing Django projects and provide useful features like rate limiting, IP filtering, and geolocation.
Key Goals:
- Log every click on a tracked link with IP address, user agent, and timestamp.
- Enrich click logs with geolocation data.
- Prevent abuse with rate limiting.
- Allow IP filtering through allowlists and blocklists.
- Provide both a Django template tag and a DRF API view for flexible integration.
Supporting both Traditional Django and Headless Setups
Implemented two separate integration methods: a template tag (`track_url`) for traditional Django templates and a DRF API view (`TrackClickAPIView`) for JavaScript-based frontends.
Making Features Optional
Used Django's `INSTALLED_APPS` and optional dependencies in `pyproject.toml` (`extras`) to allow users to install and enable only the features they need, such as DRF and rate limiting support.
Handling Rate Limiting Gracefully
For template-based views, the Django messages framework is used to display an error to the user. For the DRF API, a custom exception (`RateLimited`) is raised and handled by a DRF exception handler to return a `429 Too Many Requests` response.
Frontend
- N/A
Backend
- Django
- Django REST Framework
- django-ratelimit
Deployment
- PyPI
Tools
- Git
- GitHub
- Pytest
- Ruff
- pre-commit
Key Achievements:
- Successfully published to PyPI.
- A fully functional and reusable Django app.
- Comprehensive test suite with pytest.
- Clean and maintainable code with the help of Ruff and pre-commit hooks.