{"id":18345355,"url":"https://github.com/garrylachman/usb-human-name","last_synced_at":"2025-06-13T02:33:14.272Z","repository":{"id":95252624,"uuid":"324615016","full_name":"garrylachman/usb-human-name","owner":"garrylachman","description":"C++ Humanize USB vendor and product codes library","archived":false,"fork":false,"pushed_at":"2021-01-04T13:51:54.000Z","size":1270,"stargazers_count":3,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-09T22:42:47.279Z","etag":null,"topics":["cpp","library","usb","usb-devices","usbids"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/garrylachman.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2020-12-26T18:42:59.000Z","updated_at":"2022-12-01T14:08:51.000Z","dependencies_parsed_at":"2023-04-04T13:01:33.225Z","dependency_job_id":null,"html_url":"https://github.com/garrylachman/usb-human-name","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/garrylachman/usb-human-name","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garrylachman%2Fusb-human-name","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garrylachman%2Fusb-human-name/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garrylachman%2Fusb-human-name/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garrylachman%2Fusb-human-name/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/garrylachman","download_url":"https://codeload.github.com/garrylachman/usb-human-name/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/garrylachman%2Fusb-human-name/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259567102,"owners_count":22877642,"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":["cpp","library","usb","usb-devices","usbids"],"created_at":"2024-11-05T21:08:00.726Z","updated_at":"2025-06-13T02:33:14.264Z","avatar_url":"https://github.com/garrylachman.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"![CMake](https://github.com/garrylachman/usb-human-name/workflows/CMake/badge.svg)\n![Release](https://github.com/garrylachman/usb-human-name/workflows/Release/badge.svg)\n\n# USB Human Name\n### Humanize USB vendor and product codes library\n\nThis library uses usb.ids file to provide easy translate api from vendors and products codes provided by libs like libusb to real names.\n\nUSB Human Name is a minimal project that's kept deliberately very small. When you build it using CMake/make (see below) it generates:\n\n 1. A tiny **static library** `libusb_human_name`,\n 2. **An executable unit test** `Google_Tests_run`  using [Google Test library](https://github.com/google/googletest).\n\n## Usage\n\n### Prerequisites\n\nYou will need:\n\n * A modern C/C++ compiler\n * CMake 3.1+ installed (on a Mac, run `brew install cmake`)\n * If you prefer to code in a great IDE, I highly recommend [Jetbrains CLion](https://www.jetbrains.com/clion/). It is fully compatible with this project.\n\n### Building The Project\n\n#### Git Clone\n\nFirst we need to check out the git repo:\n\n```bash\n❯ mkdir ~/workspace\n❯ cd ~/workspace\n❯ git clone \\\n    https://github.com/garrylachman/usb-human-name \\\n    usb-human-name\n❯ cd usb-human-name\n❯ mkdir build\n❯ cd build\n❯ cmake ..\n❯ make\n```\n\u003cimg src=\"https://i.imgur.com/14Ltwbn.gif\" /\u003e\n\n\n#### Running the tests\n\n```bash\n❯ Google_tests/Google_Tests_run\n[==========] Running 4 tests from 1 test suite.\n[----------] Global test environment set-up.\n[----------] 4 tests from DBFileTestSuite\n[ RUN      ] DBFileTestSuite.ReadyTest\n[       OK ] DBFileTestSuite.ReadyTest (2 ms)\n[ RUN      ] DBFileTestSuite.FindVendorTest\n[       OK ] DBFileTestSuite.FindVendorTest (0 ms)\n[ RUN      ] DBFileTestSuite.FindProductTest\n[       OK ] DBFileTestSuite.FindProductTest (0 ms)\n[ RUN      ] DBFileTestSuite.FullDataTest\n[       OK ] DBFileTestSuite.FullDataTest (36181 ms)\n[----------] 4 tests from DBFileTestSuite (36184 ms total)\n\n[----------] Global test environment tear-down\n[==========] 4 tests from 1 test suite ran. (36184 ms total)\n[  PASSED  ] 4 tests.\n```\n\n## File Locations\n\n * `usb-human-name_lib/*` — C++ code that ultimately compiles into a library\n * `Google_tests/lib` — C++ libraries used for tests (eg, Google Test)\n * `Google_tests` — C++ test suite\n \n#### Contributing\n\n**Pull Requests are WELCOME!** Please submit any fixes or improvements, and I promise to review it as soon as I can at the project URL:\n\n * [Project Github Home](https://github.com/garrylachman/usb-human-name)\n * [Submit Issues](https://github.com/garrylachman/usb-human-name/issues)\n * [Pull Requests](https://github.com/garrylachman/usb-human-name/pulls)\n\n### License\n\n\u0026copy; 2020 Garry Lachman (garry@lachman.co).\n\nOpen sourced under MIT license, the terms of which can be read here — [MIT License](http://opensource.org/licenses/MIT).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgarrylachman%2Fusb-human-name","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgarrylachman%2Fusb-human-name","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgarrylachman%2Fusb-human-name/lists"}