README.md

temper

Go library to communicate with a TEMPer USB temperature monitors.

Installation

$ go get github.com/gotmc/temper

Dependencies

• libusb C library — Library for USB device access
  • OS X: $ brew install libusb
  • Debian/Ubuntu: $ sudo apt-get install -y libusb-1.0-0 libusb-1.0-0-dev
• Go libusb — Go bindings for the libusb C library
  • Add require github.com/gotmc/libusb v1.0.22 to your go.mod

Documentation

Documentation can be found at either:

• https://godoc.org/github.com/gotmc/temper
• http://localhost:6060/pkg/github.com/gotmc/temper/ after running $ godoc -http=:6060

Contributing

Contributions are welcome! To contribute please:

1. Fork the repository
2. Create a feature branch
3. Code
4. Submit a pull request

Testing

Prior to submitting a pull request, please run:

$ make check
$ make lint

To update and view the test coverage report:

$ make cover

Prior Art

Below are projects written in other languages:

• https://github.com/elpeo/rbtemper — Ruby TEMPer library
• https://github.com/bitplane/temper — Command line sensor logger for Temper1 devices
• https://github.com/padelt/temper-python — libusb/PyUSB-based driver to read TEMPer USB HID devices (USB ID 0x0C45:0x7401) and serve as a NewSNMP passpersist module

License

temper is released under the MIT license. Please see the LICENSE.txt file for more information.