Maxmind database parser for lua
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
mmdb Merge branch 'dont-throw' Nov 24, 2017
spec spec/MaxMind-DB: Update submodule Nov 23, 2016
.gitignore Add example Jan 20, 2015
.gitmodules Add test using official test suite from MaxMind Jan 20, 2015
.luacov .luacov: Add luacov configuration file Dec 19, 2016 LICENSE: Add MIT license Jul 14, 2016
NEWS Merge branch 'dont-throw' Nov 24, 2017 README: Add compat-5.3 dependency Dec 22, 2016
example.lua deprecate 'open' constructor Dec 28, 2016
mmdblua-scm-0.rockspec mmdb: Make bit library optional Dec 19, 2016


A Lua library for reading MaxMind's Geolocation database format.

This project had it's initial development sprint done in a hotel room during the Lua Workshop 2013.


mmdblua is available from luarocks.

$ luarocks install mmdblua


If using lua < 5.3 you will need


Getting started

  • Clone the repo:

    $ git clone --recursive
    $ cd mmdblua

    Note that mmdblua has a git submodule for test data.

  • Lint the code (check for common programming errors)

    $ luacheck .
  • Run tests

    $ busted
  • Install your local copy:

    $ luarocks make mmdblua-scm-0.rockspec