{"id":23520377,"url":"https://github.com/sstelfox/louis","last_synced_at":"2025-07-17T07:36:51.735Z","repository":{"id":56882276,"uuid":"173825564","full_name":"sstelfox/louis","owner":"sstelfox","description":"A MAC vendor lookup gem","archived":false,"fork":false,"pushed_at":"2023-02-17T15:27:26.000Z","size":3830,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-07-02T20:43:56.171Z","etag":null,"topics":["library","network","tool"],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sstelfox.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-03-04T21:38:56.000Z","updated_at":"2024-07-04T15:45:13.000Z","dependencies_parsed_at":"2024-12-25T16:12:59.854Z","dependency_job_id":"7c88240d-3460-463f-bcef-90b3a019cf4b","html_url":"https://github.com/sstelfox/louis","commit_stats":{"total_commits":88,"total_committers":3,"mean_commits":"29.333333333333332","dds":0.07954545454545459,"last_synced_commit":"12e5c77e1f4e5fdc1653a04b48c246644375f79e"},"previous_names":[],"tags_count":38,"template":false,"template_full_name":null,"purl":"pkg:github/sstelfox/louis","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sstelfox%2Flouis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sstelfox%2Flouis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sstelfox%2Flouis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sstelfox%2Flouis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sstelfox","download_url":"https://codeload.github.com/sstelfox/louis/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sstelfox%2Flouis/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265578088,"owners_count":23791290,"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","network","tool"],"created_at":"2024-12-25T16:12:55.723Z","updated_at":"2025-07-17T07:36:51.718Z","avatar_url":"https://github.com/sstelfox.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Louis\n\n[![Gem Version](https://badge.fury.io/rb/louis.svg)](http://badge.fury.io/rb/louis)\n[![Build Status](https://travis-ci.org/sstelfox/louis.svg?branch=master)](https://travis-ci.org/sstelfox/louis)\n[![Coverage Status](https://coveralls.io/repos/github/sstelfox/louis/badge.svg?branch=master)](https://coveralls.io/github/sstelfox/louis?branch=master)\n[![Code Climate](https://codeclimate.com/github/sstelfox/louis/badges/gpa.svg)](https://codeclimate.com/github/sstelfox/louis)\n\nThere is a public registry maintained by the IANA that is required to be used\nby all vendors operating in certains spaces. Ethernet, Bluetooth, and Wireless\ndevice manufacturers are all assigned unique prefixes. This database is\navailable publicly online and can be used to identify the manufacturer of these\ndevices. This library provides an easy mechanism to perform these lookups.\n\nIt is important to note that the way the lookup occur in this gem right now is\non the slower side, especially the first time a lookup is done as it doesn't\nload it's database until then. This will improve over time as I already have\nideas on how to make the performance better.\n\n## Installation\n\nAdd this line to your application's Gemfile:\n\n```ruby\ngem 'louis'\n```\n\nAnd then execute:\n\n    $ bundle\n\nOr install it yourself as:\n\n    $ gem install louis\n\n## Usage\n\n```ruby\nLouis.lookup('84:3a:4b:49:bc:f0')\n=\u003e {\"short_vendor\"=\u003e\"IntelCor\", \"long_vendor\"=\u003e\"Intel Corporate\"}\n```\n\nWhen the Vendor information isn't known it will instead return:\n\n```ruby\n=\u003e {\"long_vendor\"=\u003e\"Unknown\", \"short_vendor\"=\u003e\"Unknown\"}\n```\n\n## OUI Database\n\nThe textual database in this gem is from the [Wireshark][1] project,\nspecifically sourced [from their source][2]. The file itself is licensed under\nGPLv2 on it's own and subsequent use needs to conform to it's licensing terms.\n\n## Contributing\n\n1. Fork it ( https://github.com/pwnieexpress/louis/fork )\n2. Create your feature branch (`git checkout -b my-new-feature`)\n3. Commit your changes (`git commit -am 'Add some feature'`)\n4. Push to the branch (`git push origin my-new-feature`)\n5. Create a new Pull Request\n\n[1]: https://wireshark.org/\n[2]: https://code.wireshark.org/review/gitweb?p=wireshark.git;a=blob_plain;f=manuf\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsstelfox%2Flouis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsstelfox%2Flouis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsstelfox%2Flouis/lists"}