NAME

Alien::libmaxminddb - Find or download and install libmaxminddb

VERSION

version 1.005

SYNOPSIS

Add the library to your dist.ini if you use Dist::Zilla.

[@Filter]
-bundle = @Basic
-remove = MakeMaker

[Prereqs / ConfigureRequires]
Alien::libmaxminddb = 0

[MakeMaker::Awesome]
header = use Config;
header = use Alien::libmaxminddb;
WriteMakefile_arg = CCFLAGS => Alien::libmaxminddb->cflags . ' ' . $Config{ccflags}
WriteMakefile_arg = LIBS => [ Alien::libmaxminddb->libs ]

[Prereqs / DevelopRequires]
Dist::Zilla = 0
Dist::Zilla::Plugin::MakeMaker::Awesome = 0

DESCRIPTION

MaxMind and DP-IP.com provide geolocation databases in the MaxMind DB file format format. This Perl module finds or downloads and installs the C library libmaxminddb, which can read MaxMind DB files.

SUBROUTINES/METHODS

All methods are inherited from Alien::Base.

DIAGNOSTICS

None.

CONFIGURATION AND ENVIRONMENT

None.

DEPENDENCIES

Requires Alien::Build from CPAN. On Windows, Alien::MSYS needs to be installed manually.

Install the package libmaxminddb-devel or libmaxminddb-dev if you would like to use your operating system's libmaxminddb library.

INCOMPATIBILITIES

None.

SEE ALSO

Alien::Base, IP::Geolocation::MMDB

AUTHOR

Andreas Vögele <voegelas@cpan.org>

BUGS AND LIMITATIONS

If libmaxminddb and its development files aren't present, the library is fetched from GitHub and built with Alien::Build, which requires the build tools from Alien::MSYS on Windows. If Alien::Build fails to build libmaxminddb, make sure that you have a clean build environment with nothing but Perl and the build tools in your path.

LICENSE AND COPYRIGHT

Copyright 2022 Andreas Vögele

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

The libmaxminddb library is licensed under the Apache License, Version 2.0.