Nauseating Packaged Meat
    Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

    mmdb-readerpublic

    mmdb-reader

    Travis Dependencies Join the chat at https://gitter.im/gosquared/mmdb-reader

    NPM

    Pure-JS reader for MaxMind DB (.mmdb) files, for looking up data indexed by IP address.

    Inspired by node-maxmind-db, but faster.

    Installation

    npm install mmdb-reader

    Usage

    var MMDBReader = require('mmdb-reader');
     
    // Load synchronously
    var reader = new MMDBReader('path/to/data.mmdb');
     
    reader.lookup('8.8.8.8'); // { city: { ... }, continent: { ... } }
     

    Async Loading

    var MMDBReader = require('mmdb-reader');
     
    MMDBReader.open('path/to/data.mmdb', function(err, reader){
     
      if(err){
        // something went wrong. Handle it somehow
      }
     
      reader.lookup('8.8.8.8'); // { city: { ... }, continent: { ... } }
     
    });

    Assumptions

    mmdb-reader loads the entire database file into memory as a single node Buffer. It also uses an in-memory cache when reading complex data structures out of this buffer in the interests of performance. So very roughly speaking, you should assume this module will consume size_of_mmdb_file * 1.25 of memory.

    The default behaviour is to load the database file synchronously. This assumes that CPU and I/O are less important to you when your process is starting than when it's booted and you need to look up IPs quickly. If you want to load the file asynchronously then obviously you don't have a reader until it's finished.

    Results are returned directly from the in-memory cache by reference, so if you're going to be modifying data, you should copy it first. That is, don't do this:

    var record = reader.lookup('1.2.3.4');
    record.something = 'foo';
     
    // elsewhere:
    var anotherRecord = reader.lookup('2.3.4.5');
    // anotherRecord.something might be 'foo'. Or it might not. Who knows?

    install

    npm i mmdb-reader

    Downloadsweekly downloads

    1,217

    version

    1.1.0

    license

    MIT

    repository

    githubgithub

    last publish

    collaborators

    • avatar
    • avatar