{"id":19426608,"url":"https://github.com/oscaro/maximator","last_synced_at":"2025-04-24T17:31:09.440Z","repository":{"id":21153982,"uuid":"24456423","full_name":"oscaro/maximator","owner":"oscaro","description":"Thin Clojure wrapper around MaxMind GeoIP2 for IP geolocalization","archived":false,"fork":false,"pushed_at":"2023-07-06T13:16:33.000Z","size":16,"stargazers_count":14,"open_issues_count":0,"forks_count":10,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-03T08:37:19.959Z","etag":null,"topics":["library"],"latest_commit_sha":null,"homepage":"","language":"Clojure","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"epl-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oscaro.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-09-25T12:03:14.000Z","updated_at":"2025-02-17T12:26:42.000Z","dependencies_parsed_at":"2022-07-29T18:40:01.144Z","dependency_job_id":null,"html_url":"https://github.com/oscaro/maximator","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oscaro%2Fmaximator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oscaro%2Fmaximator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oscaro%2Fmaximator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oscaro%2Fmaximator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oscaro","download_url":"https://codeload.github.com/oscaro/maximator/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250580723,"owners_count":21453531,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["library"],"created_at":"2024-11-10T14:08:19.628Z","updated_at":"2025-04-24T17:31:09.190Z","avatar_url":"https://github.com/oscaro.png","language":"Clojure","funding_links":[],"categories":[],"sub_categories":[],"readme":"# maximator\n\nThin Clojure wrapper around [MaxMind GeoIP2](http://dev.maxmind.com/geoip/#GeoIP2) for IP geolocalization.\n\nDocumentation can be found on [cljdoc](https://cljdoc.org/d/com.oscaro/maximator/CURRENT).\n\n## Installation\n\n`maximator` is available as a Maven artifact from\n[Clojars](http://clojars.org/com.oscaro/maximator):\n\n[![Clojars Project](http://clojars.org/com.oscaro/maximator/latest-version.svg)](http://clojars.org/com.oscaro/maximator)\n\n\n## Usage\n\nFirst you need to download one of MaxMind GeoIP2 databases. You can find the free Geolite2 City [here](http://dev.maxmind.com/geoip/geoip2/geolite2/).\n\n```clojure\n(use 'com.oscaro.maximator)\n(use 'clojure.java.io)\n\n;; you can load db from a path easily\n;; there are a couple of options to select default language and file-mode, see docstring\n(def loc (make-locator \"GeoLite2-City.mmdb\"))\n\n;; You can also load your db from resources in a jar\n(def loc (-\u003e \"GeoLite2-City.mmdb\"\n             (resource)\n             (input-stream)\n             (make-locator)))\n\n;; then you use lookup-country or lookup-city on any IP as string\n(lookup-country loc \"8.8.8.8\")\n=\u003e\n{:country {:confidence nil, :iso-code \"US\", :in-european-union? false,\n           :geo-name-id 6252001, :name \"USA\",\n           :names {:de \"USA\", :ru \"США\", :pt-BR \"Estados Unidos\",\n                   :ja \"アメリカ合衆国\", :en \"United States\", :fr \"États-Unis\",\n                   :zh-CN \"美国\", :es \"Estados Unidos\"}},\n           :max-mind {:queries-remaining nil},\n           :represented-country {:confidence nil, :type nil, :iso-code nil,\n                                :in-european-union? false, :geo-name-id nil,\n                                :name nil, :names {}},\n           :traits {:user-type nil, :hosting-provider? false, :static-ip-score nil,\n                   :organization nil, :isp nil, :satellite-provider? false,\n                   :anonymous-vpn? false, :tor-exit-node? false, :user-count nil,\n                   :legitimate-proxy? false, :anonymous? false, :anonymous-proxy? false,\n                   :connection-type nil, :autonomous-system-number nil, :domain nil,\n                   :autonomous-system-organization nil, :public-proxy? false,\n                   :ip-address \"8.8.8.8\"},\n           :registered-country {:confidence nil, :iso-code \"US\", :in-european-union? false,\n                               :geo-name-id 6252001, :name \"USA\",\n                               :names {:de \"USA\", :ru \"США\", :pt-BR \"Estados Unidos\",\n                               :ja \"アメリカ合衆国\", :en \"United States\", :fr \"États-Unis\",\n                               :zh-CN \"美国\", :es \"Estados Unidos\"}},\n           :continent {:code \"NA\", :geo-name-id 6255149, :name \"Nordamerika\",\n                       :names {:de \"Nordamerika\", :ru \"Северная Америка\",\n                               :pt-BR \"América do Norte\", :ja \"北アメリカ\",\n                               :en \"North America\", :fr \"Amérique du Nord\",\n                               :zh-CN \"北美洲\", :es \"Norteamérica\"}}}\n```\n\n## TODO\n\n - Wrap WebAPI client\n\n## License\n\nCopyright © 2014 Oscaro.com\n\nDistributed under the Eclipse Public License either version 1.0 or (at\nyour option) any later version.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foscaro%2Fmaximator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foscaro%2Fmaximator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foscaro%2Fmaximator/lists"}