Skip to content

Node.js reader for MaxMind DB (.mmdb) files for IP address data

License

Notifications You must be signed in to change notification settings

gosquared/mmdb-reader

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

50 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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?

About

Node.js reader for MaxMind DB (.mmdb) files for IP address data

Resources

License

Stars

Watchers

Forks

Packages

No packages published