# ouilookup
[](https://pypi.python.org/pypi/ouilookup/)
[](https://github.com/ndejong/ouilookup/)
[](https://github.com/ndejong/ouilookup/actions/workflows/build-tests.yml)
[](https://github.com/ndejong/ouilookup)
A CLI tool and Python module for looking up hardware MAC addresses from the published OUI source list at ieee.org.
## Project
* https://github.com/ndejong/ouilookup/
## Install
#### via PyPi
```bash
pip3 install ouilookup
```
## Versions
Legacy versions based on year-date (eg v2018.2) have been hard-deprecated in favour of a backward incompatible
standard versioning scheme (eg v0.2.0).
## CLI usage
```text
usage: ouilookup [-h] [-q [<hwaddr> ...] | -s | -u | -ul <filename>] [-d] [-df <data-file>]
ouilookup v0.3.0
options:
-h, --help show this help message and exit
-q [<hwaddr> ...], --query [<hwaddr> ...]
Query to locate matching MAC hardware address(es) from
the oui ouilookup.json data file. Addresses may be
expressed in formats with or without ':' or '-'
separators. Use a space or comma between addresses to
query for more than one item in a single query.
-s, --status Return status metadata about the ouilookup.json data
file.
-u, --update Download the latest from
https://standards-oui.ieee.org/oui/oui.txt then parse
and save as a ouilookup.json data file.
-ul <filename>, --update-local <filename>
Supply a local oui.txt then parse and save as a
ouilookup.json data file.
-d, --debug Enable debug logging
-df <data-file>, --data-file <data-file>
Use a data file that is not in the default data file
search paths: /home/<user>/.local/ouilookup,
<package-path>/ouilookup/data, /var/lib/ouilookup
A CLI tool for interfacing with the OuiLookup module that provides CLI access
the query(), update() and status() functions. Outputs at the CLI are JSON
formatted allowing for easy chaining with other toolchains. The update()
function updates directly from "standards-oui.ieee.org".
```
## Python3 Module usage
```console
>>> from OuiLookup import OuiLookup
>>> OuiLookup().query('00:00:aa:00:00:00')
[{'0000AA000000': 'XEROX CORPORATION'}]
>>> OuiLookup().query(['00:00:01:00:00:00','00-00-10-00-00-00','000011000000'])
[{'000001000000': 'XEROX CORPORATION'}, {'000010000000': 'SYTEK INC.'}, {'000011000000': 'NORMEREL SYSTEMES'}]
>>> OuiLookup().update()
{'timestamp': '2023-05-13T14:11:17+00:00', 'source_url': 'https://standards-oui.ieee.org/oui/oui.txt', 'source_data_file': '/tmp/ouilookup-qm5aq0dk/oui.txt', 'source_bytes': '5468392', 'source_md5': '55a434f90da0c24c1a4fcfefe5b2b64b', 'source_sha1': 'dd5e8849ab8c65b2fb12c4b5aef290afee6bbfcd', 'source_sha256': 'af7e4bb1394109f4faad814074d3a6d5b792078074549a5d554c0904612c0bfc', 'vendor_count': '33808', 'data_file': '~/.local/ouilookup/ouilookup.json'}
>>> OuiLookup().status()
{'timestamp': '2023-05-13T14:11:17+00:00', 'source_url': 'https://standards-oui.ieee.org/oui/oui.txt', 'source_data_file': '/tmp/ouilookup-qm5aq0dk/oui.txt', 'source_bytes': '5468392', 'source_md5': '55a434f90da0c24c1a4fcfefe5b2b64b', 'source_sha1': 'dd5e8849ab8c65b2fb12c4b5aef290afee6bbfcd', 'source_sha256': 'af7e4bb1394109f4faad814074d3a6d5b792078074549a5d554c0904612c0bfc', 'vendor_count': '33808', 'data_file': '~/.local/ouilookup/ouilookup.json'}
```
## Authors
* [Nicholas de Jong](https://nicholasdejong.com)
## License
BSD-2-Clause - see LICENSE file for full details.
NB: License change from Apache-2.0 to BSD-2-Clause in February 2020 at version 0.2.0
Raw data
{
"_id": null,
"home_page": "",
"name": "ouilookup",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6,<4.0",
"maintainer_email": "",
"keywords": "ouilookup,oui,mac,mac-address,hw-address,ether,ethernet",
"author": "Nicholas de Jong",
"author_email": "contact@nicholasdejong.com",
"download_url": "https://files.pythonhosted.org/packages/ce/7f/1d8ceacbe04d5f369d15fd3221884509edf23593a6c29ade81e83f2bc43b/ouilookup-0.3.1.tar.gz",
"platform": null,
"description": "# ouilookup\n\n[](https://pypi.python.org/pypi/ouilookup/)\n[](https://github.com/ndejong/ouilookup/)\n[](https://github.com/ndejong/ouilookup/actions/workflows/build-tests.yml)\n[](https://github.com/ndejong/ouilookup)\n\nA CLI tool and Python module for looking up hardware MAC addresses from the published OUI source list at ieee.org.\n\n## Project\n* https://github.com/ndejong/ouilookup/\n\n## Install\n#### via PyPi\n```bash\npip3 install ouilookup\n```\n\n## Versions\nLegacy versions based on year-date (eg v2018.2) have been hard-deprecated in favour of a backward incompatible \nstandard versioning scheme (eg v0.2.0).\n\n## CLI usage\n```text\nusage: ouilookup [-h] [-q [<hwaddr> ...] | -s | -u | -ul <filename>] [-d] [-df <data-file>]\n\nouilookup v0.3.0\n\noptions:\n -h, --help show this help message and exit\n -q [<hwaddr> ...], --query [<hwaddr> ...]\n Query to locate matching MAC hardware address(es) from \n the oui ouilookup.json data file. Addresses may be \n expressed in formats with or without ':' or '-' \n separators. Use a space or comma between addresses to \n query for more than one item in a single query.\n -s, --status Return status metadata about the ouilookup.json data \n file.\n -u, --update Download the latest from \n https://standards-oui.ieee.org/oui/oui.txt then parse \n and save as a ouilookup.json data file.\n -ul <filename>, --update-local <filename>\n Supply a local oui.txt then parse and save as a \n ouilookup.json data file.\n\n -d, --debug Enable debug logging\n -df <data-file>, --data-file <data-file>\n Use a data file that is not in the default data file \n search paths: /home/<user>/.local/ouilookup, \n <package-path>/ouilookup/data, /var/lib/ouilookup\n\nA CLI tool for interfacing with the OuiLookup module that provides CLI access \nthe query(), update() and status() functions. Outputs at the CLI are JSON \nformatted allowing for easy chaining with other toolchains. The update() \nfunction updates directly from \"standards-oui.ieee.org\".\n```\n\n## Python3 Module usage\n\n```console\n>>> from OuiLookup import OuiLookup\n\n>>> OuiLookup().query('00:00:aa:00:00:00')\n[{'0000AA000000': 'XEROX CORPORATION'}]\n\n>>> OuiLookup().query(['00:00:01:00:00:00','00-00-10-00-00-00','000011000000'])\n[{'000001000000': 'XEROX CORPORATION'}, {'000010000000': 'SYTEK INC.'}, {'000011000000': 'NORMEREL SYSTEMES'}]\n\n>>> OuiLookup().update()\n{'timestamp': '2023-05-13T14:11:17+00:00', 'source_url': 'https://standards-oui.ieee.org/oui/oui.txt', 'source_data_file': '/tmp/ouilookup-qm5aq0dk/oui.txt', 'source_bytes': '5468392', 'source_md5': '55a434f90da0c24c1a4fcfefe5b2b64b', 'source_sha1': 'dd5e8849ab8c65b2fb12c4b5aef290afee6bbfcd', 'source_sha256': 'af7e4bb1394109f4faad814074d3a6d5b792078074549a5d554c0904612c0bfc', 'vendor_count': '33808', 'data_file': '~/.local/ouilookup/ouilookup.json'}\n>>> OuiLookup().status()\n{'timestamp': '2023-05-13T14:11:17+00:00', 'source_url': 'https://standards-oui.ieee.org/oui/oui.txt', 'source_data_file': '/tmp/ouilookup-qm5aq0dk/oui.txt', 'source_bytes': '5468392', 'source_md5': '55a434f90da0c24c1a4fcfefe5b2b64b', 'source_sha1': 'dd5e8849ab8c65b2fb12c4b5aef290afee6bbfcd', 'source_sha256': 'af7e4bb1394109f4faad814074d3a6d5b792078074549a5d554c0904612c0bfc', 'vendor_count': '33808', 'data_file': '~/.local/ouilookup/ouilookup.json'}\n```\n\n## Authors\n* [Nicholas de Jong](https://nicholasdejong.com)\n\n## License\nBSD-2-Clause - see LICENSE file for full details.\n\nNB: License change from Apache-2.0 to BSD-2-Clause in February 2020 at version 0.2.0\n\n",
"bugtrack_url": null,
"license": "BSD-2-Clause",
"summary": "A Python module (and CLI tool) for looking up hardware MAC addresses from the OUI source at ieee.org.",
"version": "0.3.1",
"project_urls": {
"Bug Tracker": "https://github.com/ndejong/ouilookup/issues",
"Documentation": "https://github.com/ndejong/ouilookup",
"Homepage": "https://pypi.org/project/ouilookup/",
"Repository": "https://github.com/ndejong/ouilookup"
},
"split_keywords": [
"ouilookup",
"oui",
"mac",
"mac-address",
"hw-address",
"ether",
"ethernet"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "83a72365180f5001403a39138fcff7e062dedf450513becb44222c9c8dd1b5e3",
"md5": "9cacaa6bd8d2ff9d661a8c9a7472edbd",
"sha256": "55dad8477b1bc04d1f8c6b900b32899509ce10eab10be15886425432932baeb7"
},
"downloads": -1,
"filename": "ouilookup-0.3.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9cacaa6bd8d2ff9d661a8c9a7472edbd",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6,<4.0",
"size": 373002,
"upload_time": "2023-05-13T15:51:34",
"upload_time_iso_8601": "2023-05-13T15:51:34.287460Z",
"url": "https://files.pythonhosted.org/packages/83/a7/2365180f5001403a39138fcff7e062dedf450513becb44222c9c8dd1b5e3/ouilookup-0.3.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ce7f1d8ceacbe04d5f369d15fd3221884509edf23593a6c29ade81e83f2bc43b",
"md5": "41aaca168845b0316f623086ff10de10",
"sha256": "815010906bc34aa153b8ac7c76aaa831349a37d5abd15837bc408e69cd5f1766"
},
"downloads": -1,
"filename": "ouilookup-0.3.1.tar.gz",
"has_sig": false,
"md5_digest": "41aaca168845b0316f623086ff10de10",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6,<4.0",
"size": 368051,
"upload_time": "2023-05-13T15:51:37",
"upload_time_iso_8601": "2023-05-13T15:51:37.387910Z",
"url": "https://files.pythonhosted.org/packages/ce/7f/1d8ceacbe04d5f369d15fd3221884509edf23593a6c29ade81e83f2bc43b/ouilookup-0.3.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-05-13 15:51:37",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ndejong",
"github_project": "ouilookup",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "ouilookup"
}
JSON
