https://github.com/kalekseev/django-geoipdb-loader

Helps download and keep updated maxmind's geoip db required for django GeoIP
https://github.com/kalekseev/django-geoipdb-loader

Last synced: 4 months ago
JSON representation

Helps download and keep updated maxmind's geoip db required for django GeoIP

• Host: GitHub
• URL: https://github.com/kalekseev/django-geoipdb-loader
• Owner: kalekseev
• License: other
• Created: 2016-11-07T20:57:32.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2019-12-31T08:57:47.000Z (about 5 years ago)
• Last Synced: 2024-09-17T08:34:44.366Z (5 months ago)
• Language: Python
• Size: 31.3 KB
• Stars: 2
• Watchers: 4
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

• stars - kalekseev/django-geoipdb-loader - Helps download and keep updated maxmind's geoip db required for django GeoIP (Python)
• stars - kalekseev/django-geoipdb-loader - Helps download and keep updated maxmind's geoip db required for django GeoIP (Python)

README

        
======================

Django GeoIP DB Loader

======================

.. start-badges

.. list-table::

    :stub-columns: 1

    * - tests

      - | |travis| |coveralls|

.. |travis| image:: https://travis-ci.org/kalekseev/django-geoipdb-loader.svg?branch=master

    :alt: Travis-Ci Build Status

    :target: https://travis-ci.org/kalekseev/django-geoipdb-loader

.. |coveralls| image:: https://coveralls.io/repos/github/kalekseev/django-geoipdb-loader/badge.svg?branch=master

    :alt: Coverage Status

    :target: https://coveralls.io/repos/github/kalekseev/django-geoipdb-loader

.. end-badges

Helps download and keep updated maxmind's geoip db required for `django GeoIP `_

For Django 2.2+ and python 3.6+. For older versions use `pip install django-geoipdb-loader<1.0`.

Why and when to use?

====================

If you don't mind installing and configuring

`official geoipupdate `_ on your server

then I'd recommend to use it.

If you want a simple method to download db files via django command or schedule

updates using celery then this app is the way to go.

Installation

============

Using pip::

    pip install django-geoipdb-loader

Add the app to INSTALLED_APPS and configure GEOIP_PATH::

    INSTALLED_APPS = [

        ...

        geoipdb_loader,

        ...

    ]

    GEOIP_PATH = '/myproject/geoip'

    MAXMIND_LICENSE_KEY = 'your license key'

Usage

=====

Run :code:`manage.py download_geoipdb` to download geoip files.

In order to automatically update the geoip files you can use provided celery task::

    CELERYBEAT_SCHEDULE = {

        'update-geoipdb': {

            'task': 'geoipdb_loader.tasks.update_geoipdb',

            'schedule': crontab(day_of_week=6),

        },

    }

or crontab::

    * * * * 6 manage.py download_geoipdb