A robust, cross-platform inventory utility that generates a QR code containing system hardware specs.
Перейти к файлу
Eric Hanko adb246f3f3 add icon path; license variable 2017-05-18 15:09:12 -07:00
.idea Update integration tests; fix interpreter name 2017-05-11 09:32:20 -07:00
docs add another screenshot; more updates to README 2017-05-16 19:28:54 -07:00
icon rename icon files; update README accordingly 2017-04-25 23:45:37 -07:00
inqry continued modifications to setup.py 2017-05-18 15:03:54 -07:00
tests Fix wmi import 2017-05-16 00:18:30 -07:00
.gitignore PyCharm project files / edit gitignore 2017-04-14 17:17:09 -07:00
Info.plist update setup.py / Info.plist 2017-05-18 14:32:18 -07:00
LICENSE.md add MIT license 2017-02-17 18:08:41 -08:00
README.md fix typo in README 2017-05-17 22:56:44 -07:00
pytest.ini add pytest.ini for testing/coverage 2017-02-25 01:55:30 -08:00
setup.py add icon path; license variable 2017-05-18 15:09:12 -07:00

README.md

InQRy

A robust, cross-platform utility that generates a QR code containing hardware specs of the target machine or device.

Supported platforms

  • OS X 10.10 or later
  • Windows 10
  • Windows Server 2012 R2

About

Written in pure Python, InQRy is designed to obtain asset information both quickly and accurately, without having to rely on data imports or asset-owner participation during physical inventory. The QR code contains detailed information about the client machine or device, which can then be scanned to quickly add the asset into a web-based inventory system, such as Snipe-IT.

Though originally designed to work on only laptop and desktop computers, it is now capable of obtaining the hardware specs of any number of attached iOS devices, pending that Apple's command-line utility cfgutil is installed via Apple Configurator 2.

Installing and running

$ pip install inqry
$ python -m inqry

Building from source

macOS

Requirements

  • OS X 10.10 or later
  • Homebrew-installed version of Python 3.4 or later
  • Xcode Command Line Tools
  • py2app>=0.12

Instructions

$ python setup.py py2app --iconfile icon/inqry.icns
  • InQRy.app is in dist/

Windows

Requirements

  • Windows 10
  • Python 3.4 or Python 3.5
  • pyinstaller>=3.2.1

Instructions

$ pyinstaller --onefile --icon icon/inqry.ico inqry
  • InQRy.exe is in dist/

How it works

InQRy obtains hardware specs using platform-specific shell commands and Python modules. Data is parsed and given to SystemSpecs object, where it is homogenized and passed to the FormInstructions class, where even more data is added and manipulated to work with the Snipe-IT inventory system. Instructions containing that data are used to create a python-qrcode-generated code, which is displayed on the screen for scanning.

InQRy determines which instructions to follow based on a combination of user input and the machine itself. Those instructions contain other important information that allow it to move fluidly through different types of fields in the Snipe-IT asset entry form.

Usage:

Example usage of an InQRy SystemSpecs object:

>>> from inqry.system_specs import systemspecs
>>> ss = systemspecs.SystemSpecs()
>>> ss.os_type
'Darwin'
>>> ss.memory
'8 GB'
>>> ss.storage
{'Drive 1': '251.0 GB SSD (APPLE SSD AP0256J)'}

Screenshot

InQRy GUI

Limitations

  • The CR1400 series QR code reader is required to use the QR code with an entry form. See the barcode scanner README for more information.

  • Provided you have a working barcode scanner, the FormInstructions class is written to work only with our own custom fields in our instance of Snipe-IT. The FormInstructions class would need to be modified to use in your own Snipe-IT environment or inventory system. However, most of its attributes should be completely capable of working with other types of asset-entry forms.

  • Obtaining mobile device hardware specs is limited to iOS devices, and contigent upon having installed cfgutil via Apple Configurator 2.

Issues

Microsoft Internal Only: