Metadata-Version: 1.1
Name: microscan
Version: 0.0.1
Summary: Python driver from Microscan barcode readers
Home-page: https://github.com/jonemo/microscan-driver
Author: Jonas Neubert
Author-email: jn@jonasneubert.com
License: MIT
Description: # microscan-driver
        
        [![Build Status](https://travis-ci.org/jonemo/microscan-driver.svg?branch=master)](https://travis-ci.org/jonemo/microscan-driver)
        
        Python driver for Microscan barcode readers
        
        The author of this software is not affiliated with Microscan Systems Inc.
        
        "Microscan" and "MS3" are trademarks of Microscan Systems Inc. and are used in this software and its accompanying documentation to the benefit of the trademark owner, with no intention of infringement.
        
        
        ## How to install
        
        Clone this git repository or download the repository as a [zip package](https://github.com/jonemo/microscan-driver/archive/master.zip) and extract.
        Then, from the root folder of the repository, run
        
        ```
        $ python setup.py install
        ```
        
        Depending on your setup and environment, you might want to consider doing so inside a [virtualenv](https://virtualenv.pypa.io/).
        
        This package only has a single requirement (which is automatically installed when running the above command):
        The [`pyserial` library](https://pythonhosted.org/pyserial/) provides access to the serial port and is implemented in pure Python.
        In other words: This driver does not use any C extensions and should work in many Python implementations.
        
        
        ## How to run unit tests
        
        From the root folder of the repo, run:
        
        ```
        $ python -m unittest
        ```
        
        No additional dependencies are required.
        
        
        ## Supported devices
        
        Currently, this library aims to implement all features documented in the MS3device user manual (with exceptions listed below).
        
        
        ## Not (yet) supported features
        
        ### Specific Settings
        
        The configuration settings listed below are not currently implemented in this library:
        
        * For the Host Port Protocol setting, the values "Multidrop", "User Defined", and "User Defined Multidrop"
        * Matchcode (all functionality described in chapter 7 of the user manual)
        * Configuration settings for the Codabar, Interleaved2Of5, and Pharmacode symbologies
        
        A workaround for applications that require these features, is to send the corresponding configuration strings directly using the `MicroscanDriver.write()` method, for example, to only output symbol data on match, but as soon as data is available:
        
        ```
        driver = MicroscanDriver('COM3')
        driver.write(b'<K705,1,0>')
        driver.close()
        ```
        
        ### General Functionality
        
        No sanity checking is performed on the combinations of settings in a configuration. Only individual settings and their subsettings are (to limited degree) validated against the specification.
        
Platform: UNKNOWN
Classifier: Development Status :: 1 - Planning
Classifier: Environment :: No Input/Output (Daemon)
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Topic :: System :: Hardware :: Hardware Drivers
