add appveyor configuration

The changes done in this commit should help with the open issues:
#5, #27 and #161.
The old implementation lacked the NUL char at the end of the command, as
defined on the Epson ESC/POS Reference Guide (see
https://reference.epson-biz.com/modules/ref_escpos/index.php?content_id=53
). Also, the horizontal tab control character (CTL_HT) shouldn't be
there.

This implementation allows setting up to 32 tabs with a given tab width.
Both values are checked to be in the valid ranges defined on the guide.
Also, the TabPosError exception text has been rewritten to define the
stated above.

.gitignore

@@ -23,3 +23,8 @@ src/escpos/version.py
 
 # testing temporary directories
 test/test-cli-output/
+
+# vim swap files
+*.swp
+*.swn
+*.swo

.mailmap

@@ -0,0 +1,11 @@
+<dev@pkanzler.de>                                    <patrick.kanzler@fablab.fau.de>
+<manpaz@gmail.com>                                   <manpaz@bashlinux.com>
+Manuel F Martinez <manpaz@gmail.com>                 manpaz <manpaz@bashlinux.com>
+<emailofdavis@gmail.com>                             <davis.goglin@oregonicecream.com>
+Davis Goglin <emailofdavis@gmail.com>                davisgoglin <emailofdavis@gmail.com>
+Michael Billington <michael.billington@gmail.com>    Michael <michael.billington@gmail.com>
+Cody (Quantified Code Bot) <cody@quantifiedcode.com> Cody <cody@quantifiedcode.com>
+Renato Lorenzi <renato.lorenzi@senior.com.br>        Renato.Lorenzi <renato.lorenzi@senior.com.br>
+Ahmed Tahri <nyuubi.10@gmail.com>                    TAHRI Ahmed <nyuubi.10@gmail.com>
+Michael Elsdörfer <michael@elsdoerfer.com>           Michael Elsdörfer <michael@elsdoerfer.info>
+csoft2k <csoft2k@hotmail.com>

.travis.yml

@@ -1,6 +1,8 @@
 language: python
 sudo: false
 cache: pip
+git:
+  depth: 100000
 addons:
   apt:
     packages:
@@ -29,7 +31,7 @@ matrix:
       env: TOXENV=docs
     - python: 2.7
       env: TOXENV=flake8
-    - python: 3.5
+    - python: 3.6
       env: TOXENV=flake8
   allow_failures:
     - python: 3.6-dev
@@ -37,6 +39,7 @@ matrix:
     - python: pypy3
 before_install:
     - pip install tox codecov 'sphinx>=1.5.1'
+    - ./doc/generate_authors.sh --check
 script:
     - tox
     - codecov
@@ -44,3 +47,16 @@ notifications:
   email:
     on_success: never
     on_failure: change
+deploy:
+# Github deployment
+  - provider: releases
+    api_key:
+      secure: oiR3r5AIx9ENIRtbUKIxorRx8GMv4BxgVIZcieXbgSTN4DBZdRWdzs1Xxngu/90Xf79G0X+XGxZyXrYN7eFFNp0kUYj8kwZ1aS/dyR88scskumERWi1Hv5WUJrYGrDe7PcjNGsJ2jw0nNnRPKG87Y84aR4lQygyGBSlDcdrOBnBv0sHYJMxRvHSRkGgWpur06QIOGOk4oOipTXR/7E9cg3YQC5nvZAf2QiprwTa8IcOSFlZQPykEVRYSiAgXrgqBYcZzpX0hAGuIBv7DmPI2ORTF+t79Wbhxhnho3gGJleDv7Z96//sf1vQNCG6qOgeIc9ZY08Jm1AwXQoW0p6F1/XcEPxeyPDkXJzlojE9rjYNLCPL4gxb/LESEuUafm0U4JGMsZ6hnsBOw583yTuAdfQuJ9M+QaSyem6OVNkky3+DKAD3z0WJnl9jmGXIXigNSIxD25XhpvY+j9P0XTLBG1GT2Q+wXCIjSYJc2XnYcdgVJcLoxSWk1fKj/KPi7buAWtqwnL3tjeldpMMOZMliPUTWMM14zoGskHztt0JCkAtcotm9AQtvL8eZ2LHLDK/jyLzjv0wAwU5vzSVp14XHLZl7Q0AIoNc20p1EYGa9C/gSPd9CkrWZoG4lMOiAu3tp2PRLVrdXH3ZWSPQq4Ek5MczrUTkmB82XErNbOa8QB1Dw=
+    file: .tox/dist/python-escpos*.zip
+    file_glob: true
+    skip_cleanup: true
+    on:
+      tags: true
+      repo: python-escpos/python-escpos
+      branch: master
+      condition: $TRAVIS_PYTHON_VERSION = "3.5"

AUTHORS

@@ -0,0 +1,27 @@
+Ahmed Tahri
+Asuki Kono
+belono
+Christoph Heuel
+Cody (Quantified Code Bot)
+csoft2k
+Curtis // mashedkeyboard
+Davis Goglin
+Dean Rispin
+Dmytro Katyukha
+Hark
+Joel Lehtonen
+Kristi
+ldos
+Manuel F Martinez
+Michael Billington
+Michael Elsdörfer
+Nathan Bookham
+Patrick Kanzler
+Qian Linfeng
+Renato Lorenzi
+Romain Porte
+Sam Cheng
+Stephan Sokolow
+Thijs Triemstra
+Thomas van den Berg
+ysuolmai

CHANGELOG.rst

@@ -2,6 +2,24 @@
 Changelog
 *********
 
+2017-03-29 - Version 3.0a1 - "Headcrash"
+----------------------------------------
+This release is the second alpha release of the new version 3.0. Please
+be aware that the API will still change until v3.0 is released.
+
+changes
+^^^^^^^
+- automatically upload releases to GitHub
+- add environment variable ESCPOS_CAPABILITIES_FILE
+- automatically handle cases where full cut or partial cut is not available
+- add print_and_feed
+
+contributors
+^^^^^^^^^^^^
+- Sam Cheng
+- Patrick Kanzler
+- Dmytro Katyukha
+
 2017-01-31 - Version 3.0a - "Grey Area"
 ---------------------------------------
 This release is the first alpha release of the new version 3.0. Please

CONTRIBUTING.rst

@@ -12,6 +12,15 @@ The pull requests and issues will be prefilled with templates. Please fill in yo
 This project uses `semantic versioning <http://semver.org/>`_ and tries to adhere to the proposed rules as
 well as possible.
 
+Author-list
+-----------
+
+This project keeps a list of authors. This can be auto-generated by calling `./doc/generate-authors.sh`.
+When contributing the first time, please include a commit with the output of this script in place.
+Otherwise the integration-check will fail.
+
+When you change your username or mail-address, please also update the `.mailmap` and the authors-list.
+
 Style-Guide
 -----------
 

README.rst

@@ -47,10 +47,11 @@ Dependencies
 
 This library makes use of:
 
-    * pyusb for USB-printers
-    * Pillow for image printing
-    * qrcode for the generation of QR-codes
-    * pyserial for serial printers
+* `pyusb <https://github.com/walac/pyusb>`_ for USB-printers
+* `Pillow <https://github.com/python-pillow/Pillow>`_ for image printing
+* `qrcode <https://github.com/lincolnloop/python-qrcode>`_ for the generation of QR-codes
+* `pyserial <https://github.com/pyserial/pyserial>`_ for serial printers
+* `viivakoodi <https://github.com/kxepal/viivakoodi>`_ for the generation of barcodes
 
 Documentation and Usage
 -----------------------

appveyor.yml

@@ -0,0 +1,125 @@
+environment:
+  global:
+    # SDK v7.0 MSVC Express 2008's SetEnv.cmd script will fail if the
+    # /E:ON and /V:ON options are not enabled in the batch script intepreter
+    # See: http://stackoverflow.com/a/13751649/163740
+    CMD_IN_ENV: "cmd /E:ON /V:ON /C .\\appveyor\\run_with_env.cmd"
+
+  matrix:
+
+    # Python 2.7.10 is the latest version and is not pre-installed.
+
+    - PYTHON: "C:\\Python27.10"
+      PYTHON_VERSION: "2.7.10"
+      PYTHON_ARCH: "32"
+
+    - PYTHON: "C:\\Python27.10-x64"
+      PYTHON_VERSION: "2.7.10"
+      PYTHON_ARCH: "64"
+
+    # Pre-installed Python versions, which Appveyor may upgrade to
+    # a later point release.
+    # See: http://www.appveyor.com/docs/installed-software#python
+
+    - PYTHON: "C:\\Python27"
+      PYTHON_VERSION: "2.7.x" # currently 2.7.9
+      PYTHON_ARCH: "32"
+
+    - PYTHON: "C:\\Python27-x64"
+      PYTHON_VERSION: "2.7.x" # currently 2.7.9
+      PYTHON_ARCH: "64"
+
+    - PYTHON: "C:\\Python33"
+      PYTHON_VERSION: "3.3.x" # currently 3.3.5
+      PYTHON_ARCH: "32"
+
+    - PYTHON: "C:\\Python33-x64"
+      PYTHON_VERSION: "3.3.x" # currently 3.3.5
+      PYTHON_ARCH: "64"
+
+    - PYTHON: "C:\\Python34"
+      PYTHON_VERSION: "3.4.x" # currently 3.4.3
+      PYTHON_ARCH: "32"
+
+    - PYTHON: "C:\\Python34-x64"
+      PYTHON_VERSION: "3.4.x" # currently 3.4.3
+      PYTHON_ARCH: "64"
+
+    # Python versions not pre-installed
+
+    - PYTHON: "C:\\Python35"
+      PYTHON_VERSION: "3.5.0"
+      PYTHON_ARCH: "32"
+
+    - PYTHON: "C:\\Python35-x64"
+      PYTHON_VERSION: "3.5.0"
+      PYTHON_ARCH: "64"
+
+    # Major and minor releases (i.e x.0.0 and x.y.0) prior to 3.3.0 use
+    # a different naming scheme.
+
+    - PYTHON: "C:\\Python270"
+      PYTHON_VERSION: "2.7.0"
+      PYTHON_ARCH: "32"
+
+    - PYTHON: "C:\\Python270-x64"
+      PYTHON_VERSION: "2.7.0"
+      PYTHON_ARCH: "64"
+
+install:
+  # If there is a newer build queued for the same PR, cancel this one.
+  # The AppVeyor 'rollout builds' option is supposed to serve the same
+  # purpose but it is problematic because it tends to cancel builds pushed
+  # directly to master instead of just PR builds (or the converse).
+  # credits: JuliaLang developers.
+  - ps: if ($env:APPVEYOR_PULL_REQUEST_NUMBER -and $env:APPVEYOR_BUILD_NUMBER -ne ((Invoke-RestMethod `
+        https://ci.appveyor.com/api/projects/$env:APPVEYOR_ACCOUNT_NAME/$env:APPVEYOR_PROJECT_SLUG/history?recordsNumber=50).builds | `
+        Where-Object pullRequestId -eq $env:APPVEYOR_PULL_REQUEST_NUMBER)[0].buildNumber) { `
+          throw "There are newer queued builds for this pull request, failing early." }
+  - ECHO "Filesystem root:"
+  - ps: "ls \"C:/\""
+
+  - ECHO "Installed SDKs:"
+  - ps: "ls \"C:/Program Files/Microsoft SDKs/Windows\""
+
+  # Install Python (from the official .msi of http://python.org) and pip when
+  # not already installed.
+  - ps: if (-not(Test-Path($env:PYTHON))) { & appveyor\install.ps1 }
+
+  # Prepend newly installed Python to the PATH of this build (this cannot be
+  # done from inside the powershell script as it would require to restart
+  # the parent CMD process).
+  - "SET PATH=%PYTHON%;%PYTHON%\\Scripts;%PATH%"
+
+  # Check that we have the expected version and architecture for Python
+  - "python --version"
+  - "python -c \"import struct; print(struct.calcsize('P') * 8)\""
+
+  # Upgrade to the latest version of pip to avoid it displaying warnings
+  # about it being out of date.
+  - "pip install --disable-pip-version-check --user --upgrade pip"
+
+  # Install the build dependencies of the project. If some dependencies contain
+  # compiled extensions and are not provided as pre-built wheel packages,
+  # pip will build them from source using the MSVC compiler matching the
+  # target Python version and architecture
+  - "%CMD_IN_ENV% pip install -r requirements.txt"
+
+build_script:
+  # Build the compiled extension
+  - "%CMD_IN_ENV% python setup.py build"
+
+test_script:
+  # Run the project tests
+  - "%CMD_IN_ENV% python setup.py test"
+
+after_test:
+  # If tests are successful, create binary packages for the project.
+  - "%CMD_IN_ENV% python setup.py bdist_wheel"
+  - "%CMD_IN_ENV% python setup.py bdist_wininst"
+  - "%CMD_IN_ENV% python setup.py bdist_msi"
+  - ps: "ls dist"
+
+artifacts:
+  # Archive the generated packages in the ci.appveyor.com build report.
+  - path: dist\*

appveyor/install.ps1

@@ -0,0 +1,229 @@
+# Sample script to install Python and pip under Windows
+# Authors: Olivier Grisel, Jonathan Helmus, Kyle Kastner, and Alex Willmer
+# License: CC0 1.0 Universal: http://creativecommons.org/publicdomain/zero/1.0/
+
+$MINICONDA_URL = "http://repo.continuum.io/miniconda/"
+$BASE_URL = "https://www.python.org/ftp/python/"
+$GET_PIP_URL = "https://bootstrap.pypa.io/get-pip.py"
+$GET_PIP_PATH = "C:\get-pip.py"
+
+$PYTHON_PRERELEASE_REGEX = @"
+(?x)
+(?<major>\d+)
+\.
+(?<minor>\d+)
+\.
+(?<micro>\d+)
+(?<prerelease>[a-z]{1,2}\d+)
+"@
+
+
+function Download ($filename, $url) {
+    $webclient = New-Object System.Net.WebClient
+
+    $basedir = $pwd.Path + "\"
+    $filepath = $basedir + $filename
+    if (Test-Path $filename) {
+        Write-Host "Reusing" $filepath
+        return $filepath
+    }
+
+    # Download and retry up to 3 times in case of network transient errors.
+    Write-Host "Downloading" $filename "from" $url
+    $retry_attempts = 2
+    for ($i = 0; $i -lt $retry_attempts; $i++) {
+        try {
+            $webclient.DownloadFile($url, $filepath)
+            break
+        }
+        Catch [Exception]{
+            Start-Sleep 1
+        }
+    }
+    if (Test-Path $filepath) {
+        Write-Host "File saved at" $filepath
+    } else {
+        # Retry once to get the error message if any at the last try
+        $webclient.DownloadFile($url, $filepath)
+    }
+    return $filepath
+}
+
+
+function ParsePythonVersion ($python_version) {
+    if ($python_version -match $PYTHON_PRERELEASE_REGEX) {
+        return ([int]$matches.major, [int]$matches.minor, [int]$matches.micro,
+                $matches.prerelease)
+    }
+    $version_obj = [version]$python_version
+    return ($version_obj.major, $version_obj.minor, $version_obj.build, "")
+}
+
+
+function DownloadPython ($python_version, $platform_suffix) {
+    $major, $minor, $micro, $prerelease = ParsePythonVersion $python_version
+
+    if (($major -le 2 -and $micro -eq 0) `
+        -or ($major -eq 3 -and $minor -le 2 -and $micro -eq 0) `
+        ) {
+        $dir = "$major.$minor"
+        $python_version = "$major.$minor$prerelease"
+    } else {
+        $dir = "$major.$minor.$micro"
+    }
+
+    if ($prerelease) {
+        if (($major -le 2) `
+            -or ($major -eq 3 -and $minor -eq 1) `
+            -or ($major -eq 3 -and $minor -eq 2) `
+            -or ($major -eq 3 -and $minor -eq 3) `
+            ) {
+            $dir = "$dir/prev"
+        }
+    }
+
+    if (($major -le 2) -or ($major -le 3 -and $minor -le 4)) {
+        $ext = "msi"
+        if ($platform_suffix) {
+            $platform_suffix = ".$platform_suffix"
+        }
+    } else {
+        $ext = "exe"
+        if ($platform_suffix) {
+            $platform_suffix = "-$platform_suffix"
+        }
+    }
+
+    $filename = "python-$python_version$platform_suffix.$ext"
+    $url = "$BASE_URL$dir/$filename"
+    $filepath = Download $filename $url
+    return $filepath
+}
+
+
+function InstallPython ($python_version, $architecture, $python_home) {
+    Write-Host "Installing Python" $python_version "for" $architecture "bit architecture to" $python_home
+    if (Test-Path $python_home) {
+        Write-Host $python_home "already exists, skipping."
+        return $false
+    }
+    if ($architecture -eq "32") {
+        $platform_suffix = ""
+    } else {
+        $platform_suffix = "amd64"
+    }
+    $installer_path = DownloadPython $python_version $platform_suffix
+    $installer_ext = [System.IO.Path]::GetExtension($installer_path)
+    Write-Host "Installing $installer_path to $python_home"
+    $install_log = $python_home + ".log"
+    if ($installer_ext -eq '.msi') {
+        InstallPythonMSI $installer_path $python_home $install_log
+    } else {
+        InstallPythonEXE $installer_path $python_home $install_log
+    }
+    if (Test-Path $python_home) {
+        Write-Host "Python $python_version ($architecture) installation complete"
+    } else {
+        Write-Host "Failed to install Python in $python_home"
+        Get-Content -Path $install_log
+        Exit 1
+    }
+}
+
+
+function InstallPythonEXE ($exepath, $python_home, $install_log) {
+    $install_args = "/quiet InstallAllUsers=1 TargetDir=$python_home"
+    RunCommand $exepath $install_args
+}
+
+
+function InstallPythonMSI ($msipath, $python_home, $install_log) {
+    $install_args = "/qn /log $install_log /i $msipath TARGETDIR=$python_home"
+    $uninstall_args = "/qn /x $msipath"
+    RunCommand "msiexec.exe" $install_args
+    if (-not(Test-Path $python_home)) {
+        Write-Host "Python seems to be installed else-where, reinstalling."
+        RunCommand "msiexec.exe" $uninstall_args
+        RunCommand "msiexec.exe" $install_args
+    }
+}
+
+function RunCommand ($command, $command_args) {
+    Write-Host $command $command_args
+    Start-Process -FilePath $command -ArgumentList $command_args -Wait -Passthru
+}
+
+
+function InstallPip ($python_home) {
+    $pip_path = $python_home + "\Scripts\pip.exe"
+    $python_path = $python_home + "\python.exe"
+    if (-not(Test-Path $pip_path)) {
+        Write-Host "Installing pip..."
+        $webclient = New-Object System.Net.WebClient
+        $webclient.DownloadFile($GET_PIP_URL, $GET_PIP_PATH)
+        Write-Host "Executing:" $python_path $GET_PIP_PATH
+        & $python_path $GET_PIP_PATH
+    } else {
+        Write-Host "pip already installed."
+    }
+}
+
+
+function DownloadMiniconda ($python_version, $platform_suffix) {
+    if ($python_version -eq "3.4") {
+        $filename = "Miniconda3-3.5.5-Windows-" + $platform_suffix + ".exe"
+    } else {
+        $filename = "Miniconda-3.5.5-Windows-" + $platform_suffix + ".exe"
+    }
+    $url = $MINICONDA_URL + $filename
+    $filepath = Download $filename $url
+    return $filepath
+}
+
+
+function InstallMiniconda ($python_version, $architecture, $python_home) {
+    Write-Host "Installing Python" $python_version "for" $architecture "bit architecture to" $python_home
+    if (Test-Path $python_home) {
+        Write-Host $python_home "already exists, skipping."
+        return $false
+    }
+    if ($architecture -eq "32") {
+        $platform_suffix = "x86"
+    } else {
+        $platform_suffix = "x86_64"
+    }
+    $filepath = DownloadMiniconda $python_version $platform_suffix
+    Write-Host "Installing" $filepath "to" $python_home
+    $install_log = $python_home + ".log"
+    $args = "/S /D=$python_home"
+    Write-Host $filepath $args
+    Start-Process -FilePath $filepath -ArgumentList $args -Wait -Passthru
+    if (Test-Path $python_home) {
+        Write-Host "Python $python_version ($architecture) installation complete"
+    } else {
+        Write-Host "Failed to install Python in $python_home"
+        Get-Content -Path $install_log
+        Exit 1
+    }
+}
+
+
+function InstallMinicondaPip ($python_home) {
+    $pip_path = $python_home + "\Scripts\pip.exe"
+    $conda_path = $python_home + "\Scripts\conda.exe"
+    if (-not(Test-Path $pip_path)) {
+        Write-Host "Installing pip..."
+        $args = "install --yes pip"
+        Write-Host $conda_path $args
+        Start-Process -FilePath "$conda_path" -ArgumentList $args -Wait -Passthru
+    } else {
+        Write-Host "pip already installed."
+    }
+}
+
+function main () {
+    InstallPython $env:PYTHON_VERSION $env:PYTHON_ARCH $env:PYTHON
+    InstallPip $env:PYTHON
+}
+
+main

appveyor/run_with_env.cmd

@@ -0,0 +1,88 @@
+:: To build extensions for 64 bit Python 3, we need to configure environment
+:: variables to use the MSVC 2010 C++ compilers from GRMSDKX_EN_DVD.iso of:
+:: MS Windows SDK for Windows 7 and .NET Framework 4 (SDK v7.1)
+::
+:: To build extensions for 64 bit Python 2, we need to configure environment
+:: variables to use the MSVC 2008 C++ compilers from GRMSDKX_EN_DVD.iso of:
+:: MS Windows SDK for Windows 7 and .NET Framework 3.5 (SDK v7.0)
+::
+:: 32 bit builds, and 64-bit builds for 3.5 and beyond, do not require specific
+:: environment configurations.
+::
+:: Note: this script needs to be run with the /E:ON and /V:ON flags for the
+:: cmd interpreter, at least for (SDK v7.0)
+::
+:: More details at:
+:: https://github.com/cython/cython/wiki/64BitCythonExtensionsOnWindows
+:: http://stackoverflow.com/a/13751649/163740
+::
+:: Author: Olivier Grisel
+:: License: CC0 1.0 Universal: http://creativecommons.org/publicdomain/zero/1.0/
+::
+:: Notes about batch files for Python people:
+::
+:: Quotes in values are literally part of the values:
+::      SET FOO="bar"
+:: FOO is now five characters long: " b a r "
+:: If you don't want quotes, don't include them on the right-hand side.
+::
+:: The CALL lines at the end of this file look redundant, but if you move them
+:: outside of the IF clauses, they do not run properly in the SET_SDK_64==Y
+:: case, I don't know why.
+@ECHO OFF
+
+SET COMMAND_TO_RUN=%*
+SET WIN_SDK_ROOT=C:\Program Files\Microsoft SDKs\Windows
+SET WIN_WDK=c:\Program Files (x86)\Windows Kits\10\Include\wdf
+
+:: Extract the major and minor versions, and allow for the minor version to be
+:: more than 9.  This requires the version number to have two dots in it.
+SET MAJOR_PYTHON_VERSION=%PYTHON_VERSION:~0,1%
+IF "%PYTHON_VERSION:~3,1%" == "." (
+    SET MINOR_PYTHON_VERSION=%PYTHON_VERSION:~2,1%
+) ELSE (
+    SET MINOR_PYTHON_VERSION=%PYTHON_VERSION:~2,2%
+)
+
+:: Based on the Python version, determine what SDK version to use, and whether
+:: to set the SDK for 64-bit.
+IF %MAJOR_PYTHON_VERSION% == 2 (
+    SET WINDOWS_SDK_VERSION="v7.0"
+    SET SET_SDK_64=Y
+) ELSE (
+    IF %MAJOR_PYTHON_VERSION% == 3 (
+        SET WINDOWS_SDK_VERSION="v7.1"
+        IF %MINOR_PYTHON_VERSION% LEQ 4 (
+            SET SET_SDK_64=Y
+        ) ELSE (
+            SET SET_SDK_64=N
+            IF EXIST "%WIN_WDK%" (
+                :: See: https://connect.microsoft.com/VisualStudio/feedback/details/1610302/
+                REN "%WIN_WDK%" 0wdf
+            )
+        )
+    ) ELSE (
+        ECHO Unsupported Python version: "%MAJOR_PYTHON_VERSION%"
+        EXIT 1
+    )
+)
+
+IF %PYTHON_ARCH% == 64 (
+    IF %SET_SDK_64% == Y (
+        ECHO Configuring Windows SDK %WINDOWS_SDK_VERSION% for Python %MAJOR_PYTHON_VERSION% on a 64 bit architecture
+        SET DISTUTILS_USE_SDK=1
+        SET MSSdk=1
+        "%WIN_SDK_ROOT%\%WINDOWS_SDK_VERSION%\Setup\WindowsSdkVer.exe" -q -version:%WINDOWS_SDK_VERSION%
+        "%WIN_SDK_ROOT%\%WINDOWS_SDK_VERSION%\Bin\SetEnv.cmd" /x64 /release
+        ECHO Executing: %COMMAND_TO_RUN%
+        call %COMMAND_TO_RUN% || EXIT 1
+    ) ELSE (
+        ECHO Using default MSVC build environment for 64 bit architecture
+        ECHO Executing: %COMMAND_TO_RUN%
+        call %COMMAND_TO_RUN% || EXIT 1
+    )
+) ELSE (
+    ECHO Using default MSVC build environment for 32 bit architecture
+    ECHO Executing: %COMMAND_TO_RUN%
+    call %COMMAND_TO_RUN% || EXIT 1
+)

codecov.yml

@@ -7,10 +7,6 @@ coverage:
       default:  # status context
         target: auto
         threshold: "1%"
-    patch:
-      default:
-        target: auto
-        threshold: "1%"
   range: "60...100"
 
 comment: off

doc/generate_authors.sh

@@ -0,0 +1,19 @@
+#!/bin/sh
+
+GENLIST=$(git shortlog -s -n | cut -f2 | sort)
+AUTHORSFILE="$(dirname $0)/../AUTHORS"
+TEMPAUTHORSFILE="/tmp/python-escpos-authorsfile"
+
+if [ "$#" -eq 1 ]
+    then
+        echo "$GENLIST">$TEMPAUTHORSFILE
+	echo "\nAuthorsfile in version control:\n"
+	cat $AUTHORSFILE
+	echo "\nNew authorsfile:\n"
+	cat $TEMPAUTHORSFILE
+	echo "\nUsing diff on files...\n"
+        diff -q --from-file $AUTHORSFILE $TEMPAUTHORSFILE
+    else
+	echo "$GENLIST">$AUTHORSFILE
+fi
+

doc/user/usage.rst

@@ -1,6 +1,7 @@
 *****
 Usage
 *****
+:Last Reviewed: 2017-06-10
 
 Define your printer
 -------------------
@@ -133,13 +134,13 @@ format. For windows it is probably at::
 
 And for linux::
 
-        $HOME/.config/python-escpos/config.yaml
+    $HOME/.config/python-escpos/config.yaml
 
 If you aren't sure, run::
 
-        from escpos import config
-        c = config.Config()
-        c.load()
+    from escpos import config
+    c = config.Config()
+    c.load()
 
 If it can't find the configuration file in the default location, it will tell
 you where it's looking. You can always pass a path, or a list of paths, to
@@ -147,9 +148,9 @@ the ``load()`` method.
 
 To load the configured printer, run::
 
-        from escpos import config
-        c = config.Config()
-        printer = c.printer()
+    from escpos import config
+    c = config.Config()
+    printer = c.printer()
 
 
 The printer section
@@ -157,23 +158,34 @@ The printer section
 
 The ``printer`` configuration section defines a default printer to create.
 
-The only required paramter is ``type``. The value of this should be one of the
+The only required paramter is ``type``. The value of this has to be one of the
 printers defined in :doc:`/user/printers`.
 
-The rest of the parameters are whatever you want to pass to the printer.
+The rest of the given parameters will be passed on to the initialization of the printer class.
+Use these to overwrite the default values as specified in :doc:`/user/printers`.
+This implies that the parameters have to match the parameter-names of the respective printer class.
 
 An example file printer::
 
-        printer:
-                type: File
-                devfile: /dev/someprinter
+    printer:
+            type: File
+            devfile: /dev/someprinter
 
 And for a network printer::
 
-        printer:
-                type: network
-                host: 127.0.0.1
-                port: 9000
+    printer:
+            type: Network
+            host: 127.0.0.1
+            port: 9000
+
+An USB-printer could be defined by::
+
+    printer:
+            type: Usb
+            idVendor: 0x1234
+            idProduct: 0x5678
+            in_ep: 0x66
+            out_ep: 0x01
 
 Printing text right
 -------------------
@@ -216,6 +228,32 @@ Here you can download an example, that will print a set of common barcodes:
 
     * :download:`barcode.bin </download/barcode.bin>` by `@mike42 <https://github.com/mike42>`_
 
+Advanced Usage: change capabilities-profile
+-------------------------------------------
+
+Packaged together with the escpos-code is a capabilities-file. This file in
+JSON-format describes the capabilities of different printers. It is developed and hosted in
+`escpos-printer-db <https://github.com/receipt-print-hq/escpos-printer-db>`_.
+
+Certain applications like the usage of `cx_freeze <https://cx-freeze.readthedocs.io>`_ might change the
+packaging structure. This leads to the capabilities-profile not being found.
+In this case you can use the environment-variable `ESCPOS_CAPABILITIES_FILE`.
+The following code is an example.
+
+.. code-block:: shell
+
+   # use packaged capabilities-profile
+   python-escpos cut
+
+   # use capabilities-profile that you have put in /usr/python-escpos
+   export ESCPOS_CAPABILITIES_FILE=/usr/python-escpos/capabilities.json
+   python-escpos cut
+
+   # use packaged file again
+   unset ESCPOS_CAPABILITIES_FILE
+   python-escpos cut
+
+
 Hint: preprocess printing
 -------------------------
 

examples/qr_code.py

@@ -0,0 +1,19 @@
+import sys
+
+from escpos.printer import Usb
+
+
+def usage():
+    print("usage: qr_code.py <content>")
+
+
+if __name__ == '__main__':
+    if len(sys.argv) != 2:
+        usage()
+        sys.exit(1)
+
+    content = sys.argv[1]
+
+    # Adapt to your needs
+    p = Usb(0x0416, 0x5011, profile="POS-5890")
+    p.qr(content)

examples/software_barcode.py

@@ -0,0 +1,9 @@
+from escpos.printer import Usb
+
+
+# Adapt to your needs
+p = Usb(0x0416, 0x5011, profile="POS-5890")
+
+# Some software barcodes
+p.soft_barcode('code128', 'Hello')
+p.soft_barcode('code39', '123456')

setup.py

@@ -100,6 +100,8 @@ setup(
         'Programming Language :: Python :: 3.3',
         'Programming Language :: Python :: 3.4',
         'Programming Language :: Python :: 3.5',
+        'Programming Language :: Python :: 3.6',
+        'Programming Language :: Python :: 3.7',
         'Programming Language :: Python :: Implementation :: CPython',
         'Programming Language :: Python :: Implementation :: PyPy',
         'Topic :: Software Development :: Libraries :: Python Modules',
@@ -115,7 +117,8 @@ setup(
         'pyyaml',
         'argparse',
         'argcomplete',
-        'future'
+        'future',
+        'viivakoodi>=0.8'
     ],
     setup_requires=[
         'setuptools_scm',

src/escpos/capabilities.py

@@ -1,10 +1,15 @@
 import re
 import six
-from os import path
+from os import environ, path
 import yaml
 
 # Load external printer database
-with open(path.join(path.dirname(__file__), 'capabilities.json')) as f:
+if 'ESCPOS_CAPABILITIES_FILE' in environ:
+    file_path = environ['ESCPOS_CAPABILITIES_FILE']
+else:
+    file_path = path.join(path.dirname(__file__), 'capabilities.json')
+
+with open(file_path) as f:
     CAPABILITIES = yaml.load(f)
 
 PROFILES = CAPABILITIES['profiles']

src/escpos/cli.py

@@ -100,6 +100,12 @@ ESCPOS_COMMANDS = [
                 'option_strings': ('--content',),
                 'help': 'Text to print as a qr code',
                 'required': True,
+            },
+            {
+                'option_strings': ('--size',),
+                'help': 'QR code size (1-16) [default:3]',
+                'required': False,
+                'type': int,
             }
         ],
     },

src/escpos/constants.py

@@ -64,6 +64,11 @@ _PANEL_BUTTON = lambda n: ESC + b'c5' + six.int2byte(n)
 PANEL_BUTTON_ON = _PANEL_BUTTON(0)  # enable all panel buttons
 PANEL_BUTTON_OFF = _PANEL_BUTTON(1)  # disable all panel buttons
 
+# Line display printing
+LINE_DISPLAY_OPEN = ESC + b'\x3d\x02'
+LINE_DISPLAY_CLEAR = ESC + b'\x40'
+LINE_DISPLAY_CLOSE = ESC + b'\x3d\x01'
+
 # Sheet modes
 SHEET_SLIP_MODE = ESC + b'\x63\x30\x04'  # slip paper
 SHEET_ROLL_MODE = ESC + b'\x63\x30\x01'  # paper roll
@@ -71,51 +76,90 @@ SHEET_ROLL_MODE = ESC + b'\x63\x30\x01'  # paper roll
 # Text format
 # TODO: Acquire the "ESC/POS Application Programming Guide for Paper Roll
 #       Printers" and tidy up this stuff too.
-TXT_FLIP_ON    = ESC + b'\x7b\x01'
-TXT_FLIP_OFF   = ESC + b'\x7b\x00'
-TXT_SMOOTH_ON  = GS + b'\x62\x01'
-TXT_SMOOTH_OFF = GS + b'\x62\x00'
 TXT_SIZE       = GS + b'!'
-TXT_WIDTH      = {1: 0x00,
-                  2: 0x10,
-                  3: 0x20,
-                  4: 0x30,
-                  5: 0x40,
-                  6: 0x50,
-                  7: 0x60,
-                  8: 0x70}
-TXT_HEIGHT     = {1: 0x00,
-                  2: 0x01,
-                  3: 0x02,
-                  4: 0x03,
-                  5: 0x04,
-                  6: 0x05,
-                  7: 0x06,
-                  8: 0x07}
+
 TXT_NORMAL     = ESC + b'!\x00'     # Normal text
-TXT_2HEIGHT    = ESC + b'!\x10'     # Double height text
-TXT_2WIDTH     = ESC + b'!\x20'     # Double width text
-TXT_4SQUARE    = ESC + b'!\x30'     # Quad area text
-TXT_UNDERL_OFF = ESC + b'\x2d\x00'  # Underline font OFF
-TXT_UNDERL_ON  = ESC + b'\x2d\x01'  # Underline font 1-dot ON
-TXT_UNDERL2_ON = ESC + b'\x2d\x02'  # Underline font 2-dot ON
-TXT_BOLD_OFF   = ESC + b'\x45\x00'  # Bold font OFF
-TXT_BOLD_ON    = ESC + b'\x45\x01'  # Bold font ON
-TXT_ALIGN_LT   = ESC + b'\x61\x00'  # Left justification
-TXT_ALIGN_CT   = ESC + b'\x61\x01'  # Centering
-TXT_ALIGN_RT   = ESC + b'\x61\x02'  # Right justification
-TXT_INVERT_ON  = GS  + b'\x42\x01'  # Inverse Printing ON
-TXT_INVERT_OFF = GS  + b'\x42\x00'  # Inverse Printing OFF
+
+
+TXT_STYLE = {
+    'bold': {
+        False: ESC + b'\x45\x00',               # Bold font OFF
+        True: ESC + b'\x45\x01'                 # Bold font ON
+    },
+    'underline': {
+        0: ESC + b'\x2d\x00',                   # Underline font OFF
+        1: ESC + b'\x2d\x01',                   # Underline font 1-dot ON
+        2: ESC + b'\x2d\x02'                    # Underline font 2-dot ON
+    },
+    'size': {
+        'normal': TXT_NORMAL + ESC + b'!\x00',  # Normal text
+        '2h': TXT_NORMAL + ESC + b'!\x10',      # Double height text
+        '2w': TXT_NORMAL + ESC + b'!\x20',      # Double width text
+        '2x': TXT_NORMAL + ESC + b'!\x30'       # Quad area text
+    },
+    'font': {
+        'a': ESC + b'\x4d\x00',                 # Font type A
+        'b': ESC + b'\x4d\x00'                  # Font type B
+    },
+    'align': {
+        'left': ESC + b'\x61\x00',              # Left justification
+        'center': ESC + b'\x61\x01',            # Centering
+        'right': ESC + b'\x61\x02'              # Right justification
+    },
+    'invert': {
+        True: GS  + b'\x42\x01',                # Inverse Printing ON
+        False: GS  + b'\x42\x00'                # Inverse Printing OFF
+    },
+    'color': {
+        'black': ESC + b'\x72\x00',             # Default Color
+        'red': ESC + b'\x72\x01'                # Alternative Color, Usually Red
+    },
+    'flip': {
+        True: ESC + b'\x7b\x01',                # Flip ON
+        False: ESC + b'\x7b\x00'                # Flip OFF
+    },
+    'density': {
+        0: GS + b'\x7c\x00',                    # Printing Density -50%
+        1: GS + b'\x7c\x01',                    # Printing Density -37.5%
+        2: GS + b'\x7c\x02',                    # Printing Density -25%
+        3: GS + b'\x7c\x03',                    # Printing Density -12.5%
+        4: GS + b'\x7c\x04',                    # Printing Density  0%
+        5: GS + b'\x7c\x08',                    # Printing Density +50%
+        6: GS + b'\x7c\x07',                    # Printing Density +37.5%
+        7: GS + b'\x7c\x06',                    # Printing Density +25%
+        8: GS + b'\x7c\x05'                     # Printing Density +12.5%
+    },
+    'smooth': {
+        True: GS + b'\x62\x01',                 # Smooth ON
+        False: GS + b'\x62\x00'                 # Smooth OFF
+    },
+    'height': {                                 # Custom text height
+        1: 0x00,
+        2: 0x01,
+        3: 0x02,
+        4: 0x03,
+        5: 0x04,
+        6: 0x05,
+        7: 0x06,
+        8: 0x07
+    },
+    'width': {                                  # Custom text width
+        1: 0x00,
+        2: 0x10,
+        3: 0x20,
+        4: 0x30,
+        5: 0x40,
+        6: 0x50,
+        7: 0x60,
+        8: 0x70
+    }
+}
 
 # Fonts
 SET_FONT = lambda n: ESC + b'\x4d' + n
 TXT_FONT_A     = SET_FONT(b'\x00')  # Font type A
 TXT_FONT_B     = SET_FONT(b'\x01')  # Font type B
 
-# Text colors
-TXT_COLOR_BLACK = ESC + b'\x72\x00'  # Default Color
-TXT_COLOR_RED = ESC + b'\x72\x01'    # Alternative Color (Usually Red)
-
 # Spacing
 LINESPACING_RESET = ESC + b'2'
 LINESPACING_FUNCS = {
@@ -206,13 +250,6 @@ S_RASTER_2W = _PRINT_RASTER_IMG(b'\x01')  # Set raster image double width
 S_RASTER_2H = _PRINT_RASTER_IMG(b'\x02')  # Set raster image double height
 S_RASTER_Q  = _PRINT_RASTER_IMG(b'\x03')  # Set raster image quadruple
 
-# Printing Density
-PD_N50 = GS + b'\x7c\x00'  # Printing Density -50%
-PD_N37 = GS + b'\x7c\x01'  # Printing Density -37.5%
-PD_N25 = GS + b'\x7c\x02'  # Printing Density -25%
-PD_N12 = GS + b'\x7c\x03'  # Printing Density -12.5%
-PD_0   = GS + b'\x7c\x04'  # Printing Density  0%
-PD_P50 = GS + b'\x7c\x08'  # Printing Density +50%
-PD_P37 = GS + b'\x7c\x07'  # Printing Density +37.5%
-PD_P25 = GS + b'\x7c\x06'  # Printing Density +25%
-PD_P12 = GS + b'\x7c\x05'  # Printing Density +12.5%
+# Status Command
+RT_STATUS_ONLINE = DLE + EOT +  b'\x01';
+RT_MASK_ONLINE = 8;

src/escpos/escpos.py

@@ -18,22 +18,28 @@ from __future__ import unicode_literals
 import qrcode
 import textwrap
 import six
+import time
+
+import barcode
+from barcode.writer import ImageWriter
 
 from .constants import ESC, GS, NUL, QR_ECLEVEL_L, QR_ECLEVEL_M, QR_ECLEVEL_H, QR_ECLEVEL_Q
 from .constants import QR_MODEL_1, QR_MODEL_2, QR_MICRO, BARCODE_TYPES, BARCODE_HEIGHT, BARCODE_WIDTH
-from .constants import TXT_ALIGN_CT, TXT_ALIGN_LT, TXT_ALIGN_RT, BARCODE_FONT_A, BARCODE_FONT_B
+from .constants import BARCODE_FONT_A, BARCODE_FONT_B
 from .constants import BARCODE_TXT_OFF, BARCODE_TXT_BTH, BARCODE_TXT_ABV, BARCODE_TXT_BLW
-from .constants import TXT_HEIGHT, TXT_WIDTH, TXT_SIZE, TXT_NORMAL, TXT_SMOOTH_OFF, TXT_SMOOTH_ON
-from .constants import TXT_FLIP_OFF, TXT_FLIP_ON, TXT_2WIDTH, TXT_2HEIGHT, TXT_4SQUARE
-from .constants import TXT_UNDERL_OFF, TXT_UNDERL_ON, TXT_BOLD_OFF, TXT_BOLD_ON, SET_FONT, TXT_UNDERL2_ON
-from .constants import TXT_INVERT_OFF, TXT_INVERT_ON, LINESPACING_FUNCS, LINESPACING_RESET
-from .constants import PD_0, PD_N12, PD_N25, PD_N37, PD_N50, PD_P50, PD_P37, PD_P25, PD_P12
+from .constants import TXT_SIZE, TXT_NORMAL
+from .constants import SET_FONT
+from .constants import LINESPACING_FUNCS, LINESPACING_RESET
+from .constants import LINE_DISPLAY_OPEN, LINE_DISPLAY_CLEAR, LINE_DISPLAY_CLOSE
 from .constants import CD_KICK_DEC_SEQUENCE, CD_KICK_5, CD_KICK_2, PAPER_FULL_CUT, PAPER_PART_CUT
 from .constants import HW_RESET, HW_SELECT, HW_INIT
-from .constants import CTL_VT, CTL_HT, CTL_CR, CTL_FF, CTL_LF, CTL_SET_HT, PANEL_BUTTON_OFF, PANEL_BUTTON_ON
+from .constants import CTL_VT, CTL_CR, CTL_FF, CTL_LF, CTL_SET_HT, PANEL_BUTTON_OFF, PANEL_BUTTON_ON
+from .constants import TXT_STYLE
+from .constants import RT_STATUS_ONLINE, RT_MASK_ONLINE
 
 from .exceptions import BarcodeTypeError, BarcodeSizeError, TabPosError
 from .exceptions import CashDrawerError, SetVariableError, BarcodeCodeError
+from .exceptions import ImageWidthError
 
 from .magicencode import MagicEncode
 
@@ -73,6 +79,12 @@ class Escpos(object):
         """
         pass
 
+    def _read(self, msg):
+        """ Returns a NotImplementedError if the instance of the class doesn't override this method.
+        :raises NotImplementedError
+        """
+        raise NotImplementedError()
+
     def image(self, img_source, high_density_vertical=True, high_density_horizontal=True, impl="bitImageRaster",
               fragment_height=960):
         """ Print an image
@@ -99,6 +111,17 @@ class Escpos(object):
         """
         im = EscposImage(img_source)
 
+        try:
+            max_width = int(self.profile.profile_data['media']['width']['pixels'])
+            if im.width > max_width:
+                raise ImageWidthError('{} > {}'.format(im.width, max_width))
+        except KeyError:
+            # If the printer's pixel width is not known, print anyways...
+            pass
+        except ValueError:
+            # If the max_width cannot be converted to an int, print anyways...
+            pass
+
         if im.height > fragment_height:
             fragments = im.split(fragment_height)
             for fragment in fragments:
@@ -188,7 +211,10 @@ class Escpos(object):
             qr_img = qr_code.make_image()
             im = qr_img._img.convert("RGB")
             # Convert the RGB image in printable image
+            self.text('\n')
             self.image(im)
+            self.text('\n')
+            self.text('\n')
             return
         # Native 2D code printing
         cn = b'1'  # Code type for QR code
@@ -356,7 +382,7 @@ class Escpos(object):
 
         # Align Bar Code()
         if align_ct:
-            self._raw(TXT_ALIGN_CT)
+            self._raw(TXT_STYLE['align']['center'])
         # Height
         if 1 <= height <= 255:
             self._raw(BARCODE_HEIGHT + six.int2byte(height))
@@ -396,6 +422,31 @@ class Escpos(object):
         if function_type.upper() == "A":
             self._raw(NUL)
 
+    def soft_barcode(self, barcode_type, data, impl='bitImageColumn',
+                     module_height=5, module_width=0.2, text_distance=1):
+
+        image_writer = ImageWriter()
+
+        # Check if barcode type exists
+        if barcode_type not in barcode.PROVIDED_BARCODES:
+            raise BarcodeTypeError(
+                'Barcode type {} not supported by software barcode renderer'
+                .format(barcode_type))
+
+        # Render the barcode to a fake file
+        barcode_class = barcode.get_barcode_class(barcode_type)
+        my_code = barcode_class(data, writer=image_writer)
+
+        my_code.write("/dev/null", {
+            'module_height': module_height,
+            'module_width': module_width,
+            'text_distance': text_distance
+        })
+
+        # Retrieve the Pillow image and print it
+        image = my_code.writer._image
+        self.image(image, impl=impl)
+
     def text(self, txt):
         """ Print alpha-numeric text
 
@@ -414,126 +465,85 @@ class Escpos(object):
         Text has to be encoded in unicode.
 
         :param txt: text to be printed
-        :param font: font to be used, can be :code:`a` or :code`b`
+        :param font: font to be used, can be :code:`a` or :code:`b`
         :param columns: amount of columns
         :return: None
         """
         col_count = self.profile.get_columns(font) if columns is None else columns
         self.text(textwrap.fill(txt, col_count))
 
-    def set(self, align='left', font='a', text_type='normal', width=1,
-            height=1, density=9, invert=False, smooth=False, flip=False):
+    def set(self, align='left', font='a', bold=False, underline=0, width=1,
+            height=1, density=9, invert=False, smooth=False, flip=False,
+            double_width=False, double_height=False, custom_size=False):
         """ Set text properties by sending them to the printer
 
         :param align: horizontal position for text, possible values are:
 
-            * CENTER
-            * LEFT
-            * RIGHT
+            * 'center'
+            * 'left'
+            * 'right'
 
-            *default*: LEFT
+            *default*: 'left'
 
         :param font: font given as an index, a name, or one of the
-            special values 'a' or 'b', refering to fonts 0 and 1.
-        :param text_type: text type, possible values are:
-
-            * B for bold
-            * U for underlined
-            * U2 for underlined, version 2
-            * BU for bold and underlined
-            * BU2 for bold and underlined, version 2
-            * NORMAL for normal text
-
-            *default*: NORMAL
-        :param width: text width multiplier, decimal range 1-8,  *default*: 1
-        :param height: text height multiplier, decimal range 1-8, *default*: 1
+            special values 'a' or 'b', referring to fonts 0 and 1.
+        :param bold: text in bold, *default*: False
+        :param underline: underline mode for text, decimal range 0-2,  *default*: 0
+        :param double_height: doubles the height of the text
+        :param double_width: doubles the width of the text
+        :param custom_size: uses custom size specified by width and height
+            parameters. Cannot be used with double_width or double_height.
+        :param width: text width multiplier when custom_size is used, decimal range 1-8,  *default*: 1
+        :param height: text height multiplier when custom_size is used, decimal range 1-8, *default*: 1
         :param density: print density, value from 0-8, if something else is supplied the density remains unchanged
         :param invert: True enables white on black printing, *default*: False
         :param smooth: True enables text smoothing. Effective on 4x4 size text and larger, *default*: False
         :param flip: True enables upside-down printing, *default*: False
-        :type invert: bool
-        """
-        # Width
-        if height == 2 and width == 2:
-            self._raw(TXT_NORMAL)
-            self._raw(TXT_4SQUARE)
-        elif height == 2 and width == 1:
-            self._raw(TXT_NORMAL)
-            self._raw(TXT_2HEIGHT)
-        elif width == 2 and height == 1:
-            self._raw(TXT_NORMAL)
-            self._raw(TXT_2WIDTH)
-        elif width == 1 and height == 1:
-            self._raw(TXT_NORMAL)
-        elif 1 <= width <= 8 and 1 <= height <= 8 and isinstance(width, int) and isinstance(height, int):
-            self._raw(TXT_SIZE + six.int2byte(TXT_WIDTH[width] + TXT_HEIGHT[height]))
-        else:
-            raise SetVariableError()
-        # Upside down
-        if flip:
-            self._raw(TXT_FLIP_ON)
-        else:
-            self._raw(TXT_FLIP_OFF)
-        # Smoothing
-        if smooth:
-            self._raw(TXT_SMOOTH_ON)
-        else:
-            self._raw(TXT_SMOOTH_OFF)
-        # Type
-        if text_type.upper() == "B":
-            self._raw(TXT_BOLD_ON)
-            self._raw(TXT_UNDERL_OFF)
-        elif text_type.upper() == "U":
-            self._raw(TXT_BOLD_OFF)
-            self._raw(TXT_UNDERL_ON)
-        elif text_type.upper() == "U2":
-            self._raw(TXT_BOLD_OFF)
-            self._raw(TXT_UNDERL2_ON)
-        elif text_type.upper() == "BU":
-            self._raw(TXT_BOLD_ON)
-            self._raw(TXT_UNDERL_ON)
-        elif text_type.upper() == "BU2":
-            self._raw(TXT_BOLD_ON)
-            self._raw(TXT_UNDERL2_ON)
-        elif text_type.upper() == "NORMAL":
-            self._raw(TXT_BOLD_OFF)
-            self._raw(TXT_UNDERL_OFF)
-        # Font
-        self._raw(SET_FONT(six.int2byte(self.profile.get_font(font))))
 
-        # Align
-        if align.upper() == "CENTER":
-            self._raw(TXT_ALIGN_CT)
-        elif align.upper() == "RIGHT":
-            self._raw(TXT_ALIGN_RT)
-        elif align.upper() == "LEFT":
-            self._raw(TXT_ALIGN_LT)
-        # Density
-        if density == 0:
-            self._raw(PD_N50)
-        elif density == 1:
-            self._raw(PD_N37)
-        elif density == 2:
-            self._raw(PD_N25)
-        elif density == 3:
-            self._raw(PD_N12)
-        elif density == 4:
-            self._raw(PD_0)
-        elif density == 5:
-            self._raw(PD_P12)
-        elif density == 6:
-            self._raw(PD_P25)
-        elif density == 7:
-            self._raw(PD_P37)
-        elif density == 8:
-            self._raw(PD_P50)
-        else:  # DEFAULT: DOES NOTHING
-            pass
-        # Invert Printing
-        if invert:
-            self._raw(TXT_INVERT_ON)
+        :type font: str
+        :type invert: bool
+        :type bold: bool
+        :type underline: bool
+        :type smooth: bool
+        :type flip: bool
+        :type custom_size: bool
+        :type double_width: bool
+        :type double_height: bool
+        :type align: str
+        :type width: int
+        :type height: int
+        :type density: int
+        """
+
+        if custom_size:
+            if 1 <= width <= 8 and 1 <= height <= 8 and isinstance(width, int) and\
+              isinstance(height, int):
+                size_byte = TXT_STYLE['width'][width] + TXT_STYLE['height'][height]
+                self._raw(TXT_SIZE + six.int2byte(size_byte))
+            else:
+                raise SetVariableError()
         else:
-            self._raw(TXT_INVERT_OFF)
+            self._raw(TXT_NORMAL)
+            if double_width and double_height:
+                self._raw(TXT_STYLE['size']['2x'])
+            elif double_width:
+                self._raw(TXT_STYLE['size']['2w'])
+            elif double_height:
+                self._raw(TXT_STYLE['size']['2h'])
+            else:
+                self._raw(TXT_STYLE['size']['normal'])
+
+        self._raw(TXT_STYLE['flip'][flip])
+        self._raw(TXT_STYLE['smooth'][smooth])
+        self._raw(TXT_STYLE['bold'][bold])
+        self._raw(TXT_STYLE['underline'][underline])
+        self._raw(SET_FONT(six.int2byte(self.profile.get_font(font))))
+        self._raw(TXT_STYLE['align'][align])
+
+        if density != 9:
+            self._raw(TXT_STYLE['density'][density])
+
+        self._raw(TXT_STYLE['invert'][invert])
 
     def line_spacing(self, spacing=None, divisor=180):
         """ Set line character spacing.
@@ -564,7 +574,7 @@ class Escpos(object):
 
         self._raw(LINESPACING_FUNCS[divisor] + six.int2byte(spacing))
 
-    def cut(self, mode=''):
+    def cut(self, mode='FULL', feed=True):
         """ Cut paper.
 
         Without any arguments the paper will be cut completely. With 'mode=PART' a partial cut will
@@ -573,15 +583,31 @@ class Escpos(object):
 
         .. todo:: Check this function on TM-T88II.
 
-        :param mode: set to 'PART' for a partial cut
+        :param mode: set to 'PART' for a partial cut. default: 'FULL'
+        :param feed: print and feed before cutting. default: true
+        :raises ValueError: if mode not in ('FULL', 'PART')
         """
-        # Fix the size between last line and cut
-        # TODO: handle this with a line feed
-        self._raw(b"\n\n\n\n\n\n")
-        if mode.upper() == "PART":
-            self._raw(PAPER_PART_CUT)
-        else:  # DEFAULT MODE: FULL CUT
-            self._raw(PAPER_FULL_CUT)
+
+        if not feed:
+            self._raw(GS + b'V' + six.int2byte(66) + b'\x00')
+            return
+
+        self.print_and_feed(6)
+
+        mode = mode.upper()
+        if mode not in ('FULL', 'PART'):
+            raise ValueError("Mode must be one of ('FULL', 'PART')")
+
+        if mode == "PART":
+            if self.profile.supports('paperPartCut'):
+                self._raw(PAPER_PART_CUT)
+            elif self.profile.supports('paperFullCut'):
+                self._raw(PAPER_FULL_CUT)
+        elif mode == "FULL":
+            if self.profile.supports('paperFullCut'):
+                self._raw(PAPER_FULL_CUT)
+            elif self.profile.supports('paperPartCut'):
+                self._raw(PAPER_PART_CUT)
 
     def cashdraw(self, pin):
         """ Send pulse to kick the cash drawer
@@ -602,6 +628,41 @@ class Escpos(object):
             except:
                 raise CashDrawerError()
 
+    def linedisplay_select(self, select_display=False):
+        """ Selects the line display or the printer
+
+        This method is used for line displays that are daisy-chained between your computer and printer.
+        If you set `select_display` to true, only the display is selected and if you set it to false,
+        only the printer is selected.
+
+        :param select_display: whether the display should be selected or the printer
+        :type select_display: bool
+        """
+        if select_display:
+            self._raw(LINE_DISPLAY_OPEN)
+        else:
+            self._raw(LINE_DISPLAY_CLOSE)
+
+    def linedisplay_clear(self):
+        """ Clears the line display and resets the cursor
+
+        This method is used for line displays that are daisy-chained between your computer and printer.
+        """
+        self._raw(LINE_DISPLAY_CLEAR)
+
+    def linedisplay(self, text):
+        """
+        Display text on a line display connected to your printer
+
+        You should connect a line display to your printer. You can do this by daisy-chaining
+        the display between your computer and printer.
+        :param text: Text to display
+        """
+        self.linedisplay_select(select_display=True)
+        self.linedisplay_clear()
+        self.text(text)
+        self.linedisplay_select(select_display=False)
+
     def hw(self, hw):
         """ Hardware operations
 
@@ -620,7 +681,21 @@ class Escpos(object):
         else:  # DEFAULT: DOES NOTHING
             pass
 
-    def control(self, ctl, pos=4):
+    def print_and_feed(self, n=1):
+        """ Print data in print buffer and feed *n* lines
+
+            if n not in range (0, 255) then ValueError will be raised
+
+            :param n: number of n to feed. 0 <= n <= 255. default: 1
+            :raises ValueError: if not 0 <= n <= 255
+        """
+        if 0 <= n <= 255:
+            # ESC d n
+            self._raw(ESC + b"d" + six.int2byte(n))
+        else:
+            raise ValueError("n must be betwen 0 and 255")
+
+    def control(self, ctl, count=5, tab_size=8):
         """ Feed control sequences
 
         :param ctl: string for the following control sequences:
@@ -631,14 +706,10 @@ class Escpos(object):
             * HT *for Horizontal Tab*
             * VT *for Vertical Tab*
 
-        :param pos: integer between 1 and 16, controls the horizontal tab position
+        :param count: integer between 1 and 32, controls the horizontal tab count. Defaults to 5.
+        :param tab_size: integer between 1 and 255, controls the horizontal tab size in characters. Defaults to 8
         :raises: :py:exc:`~escpos.exceptions.TabPosError`
         """
-        # Set tab positions
-        if not (1 <= pos <= 16):
-            raise TabPosError()
-        else:
-            self._raw(CTL_SET_HT + six.int2byte(pos))
         # Set position
         if ctl.upper() == "LF":
             self._raw(CTL_LF)
@@ -647,7 +718,16 @@ class Escpos(object):
         elif ctl.upper() == "CR":
             self._raw(CTL_CR)
         elif ctl.upper() == "HT":
-            self._raw(CTL_HT)
+            if not (0 <= count <= 32 and
+                    1 <= tab_size <= 255 and
+                    count * tab_size < 256):
+                raise TabPosError()
+            else:
+                # Set tab positions
+                self._raw(CTL_SET_HT)
+                for iterator in range(1, count):
+                    self._raw(six.int2byte(iterator * tab_size))
+                self._raw(NUL)
         elif ctl.upper() == "VT":
             self._raw(CTL_VT)
 
@@ -674,6 +754,20 @@ class Escpos(object):
         else:
             self._raw(PANEL_BUTTON_OFF)
 
+    def query_status(self):
+        """ Queries the printer for its status, and returns an array of integers containing it.
+        :rtype: array(integer)"""
+        self._raw(RT_STATUS_ONLINE)
+        time.sleep(1)
+        status = self._read()
+        return status or [RT_MASK_ONLINE]
+
+    def is_online(self):
+        """ Queries the printer its online status.
+        When online, returns True; False otherwise.
+        :rtype: bool: True if online, False if offline."""
+        return not (self.query_status()[0] & RT_MASK_ONLINE)
+
 
 class EscposIO(object):
     """ESC/POS Printer IO object

src/escpos/exceptions.py

@@ -8,6 +8,7 @@ Result/Exit codes:
     - `20` = Barcode size values are out of range :py:exc:`~escpos.exceptions.BarcodeSizeError`
     - `30` = Barcode text not supplied :py:exc:`~escpos.exceptions.BarcodeCodeError`
     - `40` = Image height is too large :py:exc:`~escpos.exceptions.ImageSizeError`
+    - `41` = Image width is too large :py:exc:`~escpos.exceptions.ImageWidthError`
     - `50` = No string supplied to be printed :py:exc:`~escpos.exceptions.TextError`
     - `60` = Invalid pin to send Cash Drawer pulse :py:exc:`~escpos.exceptions.CashDrawerError`
     - `70` = Invalid number of tab positions :py:exc:`~escpos.exceptions.TabPosError`
@@ -104,6 +105,20 @@ class ImageSizeError(Error):
         return "Image height is longer than 255px and can't be printed ({msg})".format(msg=self.msg)
 
 
+class ImageWidthError(Error):
+    """ Image width is too large.
+
+    The return code for this exception is `41`.
+    """
+    def __init__(self, msg=""):
+        Error.__init__(self, msg)
+        self.msg = msg
+        self.resultcode = 41
+
+    def __str__(self):
+        return "Image width is too large ({msg})".format(msg=self.msg)
+
+
 class TextError(Error):
     """ Text string must be supplied to the `text()` method.
 
@@ -135,7 +150,8 @@ class CashDrawerError(Error):
 
 
 class TabPosError(Error):
-    """ Valid tab positions must be in the range 0 to 16.
+    """ Valid tab positions must be set by using from 1 to 32 tabs, and between 1 and 255 tab size values.
+    Both values multiplied must not exceed 255, since it is the maximum tab value.
 
     This exception is raised by :py:meth:`escpos.escpos.Escpos.control`.
     The returncode for this exception is `70`.

src/escpos/printer.py

@@ -84,6 +84,10 @@ class Usb(Escpos):
         """
         self.device.write(self.out_ep, msg, self.timeout)
 
+    def _read(self):
+        """ Reads a data buffer and returns it to the caller. """
+        return self.device.read(self.in_ep, 16)
+
     def close(self):
         """ Release USB interface """
         if self.device:
@@ -131,6 +135,8 @@ class Serial(Escpos):
 
     def open(self):
         """ Setup serial port and set is as escpos device """
+        if self.device is not None and self.device.is_open:
+            self.close()
         self.device = serial.Serial(port=self.devfile, baudrate=self.baudrate,
                                     bytesize=self.bytesize, parity=self.parity,
                                     stopbits=self.stopbits, timeout=self.timeout,
@@ -151,7 +157,7 @@ class Serial(Escpos):
 
     def close(self):
         """ Close Serial interface """
-        if self.device is not None:
+        if self.device is not None and self.device.is_open:
             self.device.flush()
             self.device.close()
 

test/test_function_cut.py

@@ -0,0 +1,17 @@
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import print_function
+from __future__ import unicode_literals
+
+import six
+
+import escpos.printer as printer
+from escpos.constants import GS
+
+
+def test_cut_without_feed():
+    """Test cut without feeding paper"""
+    instance = printer.Dummy()
+    instance.cut(feed=False)
+    expected = GS + b'V' + six.int2byte(66) + b'\x00'
+    assert(instance.output == expected)

test/test_function_image.py

@@ -12,9 +12,13 @@ from __future__ import division
 from __future__ import print_function
 from __future__ import unicode_literals
 
-import escpos.printer as printer
+import pytest
+
 from PIL import Image
 
+import escpos.printer as printer
+from escpos.exceptions import ImageWidthError
+
 
 # Raster format print
 def test_bit_image_black():
@@ -139,3 +143,22 @@ def test_large_graphics():
     instance = printer.Dummy()
     instance.image('test/resources/black_white.png', impl="bitImageRaster", fragment_height=1)
     assert(instance.output == b'\x1dv0\x00\x01\x00\x01\x00\xc0\x1dv0\x00\x01\x00\x01\x00\x00')
+
+
+def test_width_too_large():
+    """
+    Test printing an image that is too large in width.
+    """
+    instance = printer.Dummy()
+    instance.profile.profile_data = {
+        'media': {
+            'width': {
+                'pixels': 384
+            }
+        }
+    }
+
+    with pytest.raises(ImageWidthError):
+        instance.image(Image.new("RGB", (385, 200)))
+
+    instance.image(Image.new("RGB", (384, 200)))

test/test_function_linedisplay.py

@@ -0,0 +1,35 @@
+#!/usr/bin/python
+"""tests for line display
+
+:author: `Patrick Kanzler <patrick.kanzler@fablab.fau.de>`_
+:organization: `python-escpos <https://github.com/python-escpos>`_
+:copyright: Copyright (c) 2017 `python-escpos <https://github.com/python-escpos>`_
+:license: MIT
+"""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import print_function
+from __future__ import unicode_literals
+
+import escpos.printer as printer
+
+
+def test_function_linedisplay_select_on():
+    """test the linedisplay_select function (activate)"""
+    instance = printer.Dummy()
+    instance.linedisplay_select(select_display=True)
+    assert(instance.output == b'\x1B\x3D\x02')
+
+def test_function_linedisplay_select_off():
+    """test the linedisplay_select function (deactivate)"""
+    instance = printer.Dummy()
+    instance.linedisplay_select(select_display=False)
+    assert(instance.output == b'\x1B\x3D\x01')
+
+def test_function_linedisplay_clear():
+    """test the linedisplay_clear function"""
+    instance = printer.Dummy()
+    instance.linedisplay_clear()
+    assert(instance.output == b'\x1B\x40')
+

test/test_function_panel_button.py

@@ -12,43 +12,18 @@ from __future__ import division
 from __future__ import print_function
 from __future__ import unicode_literals
 
-from nose.tools import with_setup
-
 import escpos.printer as printer
-import os
-
-devfile = 'testfile'
 
 
-def setup_testfile():
-    """create a testfile as devfile"""
-    fhandle = open(devfile, 'a')
-    try:
-        os.utime(devfile, None)
-    finally:
-        fhandle.close()
-
-
-def teardown_testfile():
-    """destroy testfile again"""
-    os.remove(devfile)
-
-
-@with_setup(setup_testfile, teardown_testfile)
 def test_function_panel_button_on():
     """test the panel button function (enabling) by comparing output"""
-    instance = printer.File(devfile=devfile)
+    instance = printer.Dummy()
     instance.panel_buttons()
-    instance.flush()
-    with open(devfile, "rb") as f:
-        assert(f.read() == b'\x1B\x63\x35\x00')
+    assert(instance.output == b'\x1B\x63\x35\x00')
 
 
-@with_setup(setup_testfile, teardown_testfile)
 def test_function_panel_button_off():
     """test the panel button function (disabling) by comparing output"""
-    instance = printer.File(devfile=devfile)
+    instance = printer.Dummy()
     instance.panel_buttons(False)
-    instance.flush()
-    with open(devfile, "rb") as f:
-        assert(f.read() == b'\x1B\x63\x35\x01')
+    assert(instance.output == b'\x1B\x63\x35\x01')

test/test_function_qr_native.py

@@ -86,9 +86,11 @@ def test_image():
     instance = printer.Dummy()
     instance.qr("1", native=False, size=1)
     print(instance.output)
-    expected = b'\x1dv0\x00\x03\x00\x17\x00\x00\x00\x00\x7f]\xfcA\x19\x04]it]et' \
+    expected = b'\x1bt\x00\n' \
+        b'\x1dv0\x00\x03\x00\x17\x00\x00\x00\x00\x7f]\xfcA\x19\x04]it]et' \
         b']ItA=\x04\x7fU\xfc\x00\x0c\x00y~t4\x7f =\xa84j\xd9\xf0\x05\xd4\x90\x00' \
-        b'i(\x7f<\xa8A \xd8]\'\xc4]y\xf8]E\x80Ar\x94\x7fR@\x00\x00\x00'
+        b'i(\x7f<\xa8A \xd8]\'\xc4]y\xf8]E\x80Ar\x94\x7fR@\x00\x00\x00' \
+        b'\n\n'
     assert(instance.output == expected)
 
 

test/test_function_set.py

@@ -0,0 +1,280 @@
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import print_function
+from __future__ import unicode_literals
+
+import six
+
+import escpos.printer as printer
+from escpos.constants import TXT_NORMAL, TXT_STYLE, SET_FONT
+from escpos.constants import TXT_SIZE
+
+
+# Default test, please copy and paste this block to test set method calls
+
+def test_default_values():
+    instance = printer.Dummy()
+    instance.set()
+
+    expected_sequence = (
+        TXT_NORMAL, TXT_STYLE['size']['normal'],  # Normal text size
+        TXT_STYLE['flip'][False],  # Flip OFF
+        TXT_STYLE['smooth'][False],  # Smooth OFF
+        TXT_STYLE['bold'][False],  # Bold OFF
+        TXT_STYLE['underline'][0],  # Underline OFF
+        SET_FONT(b'\x00'),  # Default font
+        TXT_STYLE['align']['left'],  # Align left
+        TXT_STYLE['invert'][False]  # Inverted OFF
+    )
+
+    assert(instance.output == b''.join(expected_sequence))
+
+# Size tests
+
+def test_set_size_2h():
+    instance = printer.Dummy()
+    instance.set(double_height=True)
+
+    expected_sequence = (
+        TXT_NORMAL, TXT_STYLE['size']['2h'],  # Double height text size
+        TXT_STYLE['flip'][False],  # Flip OFF
+        TXT_STYLE['smooth'][False],  # Smooth OFF
+        TXT_STYLE['bold'][False],  # Bold OFF
+        TXT_STYLE['underline'][0],  # Underline OFF
+        SET_FONT(b'\x00'),  # Default font
+        TXT_STYLE['align']['left'],  # Align left
+        TXT_STYLE['invert'][False]  # Inverted OFF
+    )
+
+    assert (instance.output == b''.join(expected_sequence))
+
+
+def test_set_size_2w():
+    instance = printer.Dummy()
+    instance.set(double_width=True)
+
+    expected_sequence = (
+        TXT_NORMAL, TXT_STYLE['size']['2w'],  # Double width text size
+        TXT_STYLE['flip'][False],  # Flip OFF
+        TXT_STYLE['smooth'][False],  # Smooth OFF
+        TXT_STYLE['bold'][False],  # Bold OFF
+        TXT_STYLE['underline'][0],  # Underline OFF
+        SET_FONT(b'\x00'),  # Default font
+        TXT_STYLE['align']['left'],  # Align left
+        TXT_STYLE['invert'][False]  # Inverted OFF
+    )
+
+    assert (instance.output == b''.join(expected_sequence))
+
+
+def test_set_size_2x():
+    instance = printer.Dummy()
+    instance.set(double_height=True, double_width=True)
+
+    expected_sequence = (
+        TXT_NORMAL, TXT_STYLE['size']['2x'],  # Double text size
+        TXT_STYLE['flip'][False],  # Flip OFF
+        TXT_STYLE['smooth'][False],  # Smooth OFF
+        TXT_STYLE['bold'][False],  # Bold OFF
+        TXT_STYLE['underline'][0],  # Underline OFF
+        SET_FONT(b'\x00'),  # Default font
+        TXT_STYLE['align']['left'],  # Align left
+        TXT_STYLE['invert'][False]  # Inverted OFF
+    )
+
+    assert (instance.output == b''.join(expected_sequence))
+
+
+def test_set_size_custom():
+    instance = printer.Dummy()
+    instance.set(custom_size=True, width=8, height=7)
+
+    expected_sequence = (
+        TXT_SIZE,  # Custom text size, no normal reset
+        six.int2byte(TXT_STYLE['width'][8] + TXT_STYLE['height'][7]),
+        TXT_STYLE['flip'][False],  # Flip OFF
+        TXT_STYLE['smooth'][False],  # Smooth OFF
+        TXT_STYLE['bold'][False],  # Bold OFF
+        TXT_STYLE['underline'][0],  # Underline OFF
+        SET_FONT(b'\x00'),  # Default font
+        TXT_STYLE['align']['left'],  # Align left
+        TXT_STYLE['invert'][False]  # Inverted OFF
+    )
+
+    assert (instance.output == b''.join(expected_sequence))
+
+# Flip
+
+def test_set_flip():
+    instance = printer.Dummy()
+    instance.set(flip=True)
+
+    expected_sequence = (
+        TXT_NORMAL, TXT_STYLE['size']['normal'],  # Normal text size
+        TXT_STYLE['flip'][True],  # Flip ON
+        TXT_STYLE['smooth'][False],  # Smooth OFF
+        TXT_STYLE['bold'][False],  # Bold OFF
+        TXT_STYLE['underline'][0],  # Underline OFF
+        SET_FONT(b'\x00'),  # Default font
+        TXT_STYLE['align']['left'],  # Align left
+        TXT_STYLE['invert'][False]  # Inverted OFF
+    )
+
+    assert (instance.output == b''.join(expected_sequence))
+
+# Smooth
+
+def test_smooth():
+    instance = printer.Dummy()
+    instance.set(smooth=True)
+
+    expected_sequence = (
+        TXT_NORMAL, TXT_STYLE['size']['normal'],  # Normal text size
+        TXT_STYLE['flip'][False],  # Flip OFF
+        TXT_STYLE['smooth'][True],  # Smooth ON
+        TXT_STYLE['bold'][False],  # Bold OFF
+        TXT_STYLE['underline'][0],  # Underline OFF
+        SET_FONT(b'\x00'),  # Default font
+        TXT_STYLE['align']['left'],  # Align left
+        TXT_STYLE['invert'][False]  # Inverted OFF
+    )
+
+    assert(instance.output == b''.join(expected_sequence))
+
+
+# Type
+
+
+def test_set_bold():
+    instance = printer.Dummy()
+    instance.set(bold=True)
+
+    expected_sequence = (
+        TXT_NORMAL, TXT_STYLE['size']['normal'],  # Normal text size
+        TXT_STYLE['flip'][False],  # Flip OFF
+        TXT_STYLE['smooth'][False],  # Smooth OFF
+        TXT_STYLE['bold'][True],  # Bold ON
+        TXT_STYLE['underline'][0],  # Underline OFF
+        SET_FONT(b'\x00'),  # Default font
+        TXT_STYLE['align']['left'],  # Align left
+        TXT_STYLE['invert'][False]  # Inverted OFF
+    )
+
+    assert (instance.output == b''.join(expected_sequence))
+
+
+def test_set_underline():
+    instance = printer.Dummy()
+    instance.set(underline=1)
+
+    expected_sequence = (
+        TXT_NORMAL, TXT_STYLE['size']['normal'],  # Normal text size
+        TXT_STYLE['flip'][False],  # Flip OFF
+        TXT_STYLE['smooth'][False],  # Smooth OFF
+        TXT_STYLE['bold'][False],  # Bold OFF
+        TXT_STYLE['underline'][1],  # Underline ON, type 1
+        SET_FONT(b'\x00'),  # Default font
+        TXT_STYLE['align']['left'],  # Align left
+        TXT_STYLE['invert'][False]  # Inverted OFF
+    )
+
+    assert (instance.output == b''.join(expected_sequence))
+
+
+def test_set_underline2():
+    instance = printer.Dummy()
+    instance.set(underline=2)
+
+    expected_sequence = (
+        TXT_NORMAL, TXT_STYLE['size']['normal'],  # Normal text size
+        TXT_STYLE['flip'][False],  # Flip OFF
+        TXT_STYLE['smooth'][False],  # Smooth OFF
+        TXT_STYLE['bold'][False],  # Bold OFF
+        TXT_STYLE['underline'][2],  # Underline ON, type 2
+        SET_FONT(b'\x00'),  # Default font
+        TXT_STYLE['align']['left'],  # Align left
+        TXT_STYLE['invert'][False]  # Inverted OFF
+    )
+
+    assert (instance.output == b''.join(expected_sequence))
+
+
+# Align
+
+def test_align_center():
+    instance = printer.Dummy()
+    instance.set(align='center')
+
+    expected_sequence = (
+        TXT_NORMAL, TXT_STYLE['size']['normal'],  # Normal text size
+        TXT_STYLE['flip'][False],  # Flip OFF
+        TXT_STYLE['smooth'][False],  # Smooth OFF
+        TXT_STYLE['bold'][False],  # Bold OFF
+        TXT_STYLE['underline'][0],  # Underline OFF
+        SET_FONT(b'\x00'),  # Default font
+        TXT_STYLE['align']['center'],  # Align center
+        TXT_STYLE['invert'][False]  # Inverted OFF
+    )
+
+    assert(instance.output == b''.join(expected_sequence))
+
+
+def test_align_right():
+    instance = printer.Dummy()
+    instance.set(align='right')
+
+    expected_sequence = (
+        TXT_NORMAL, TXT_STYLE['size']['normal'],  # Normal text size
+        TXT_STYLE['flip'][False],  # Flip OFF
+        TXT_STYLE['smooth'][False],  # Smooth OFF
+        TXT_STYLE['bold'][False],  # Bold OFF
+        TXT_STYLE['underline'][0],  # Underline OFF
+        SET_FONT(b'\x00'),  # Default font
+        TXT_STYLE['align']['right'],  # Align right
+        TXT_STYLE['invert'][False]  # Inverted OFF
+    )
+
+    assert(instance.output == b''.join(expected_sequence))
+
+
+# Densities
+
+def test_densities():
+
+    for density in range(8):
+        instance = printer.Dummy()
+        instance.set(density=density)
+
+        expected_sequence = (
+            TXT_NORMAL, TXT_STYLE['size']['normal'],  # Normal text size
+            TXT_STYLE['flip'][False],  # Flip OFF
+            TXT_STYLE['smooth'][False],  # Smooth OFF
+            TXT_STYLE['bold'][False],  # Bold OFF
+            TXT_STYLE['underline'][0],  # Underline OFF
+            SET_FONT(b'\x00'),  # Default font
+            TXT_STYLE['align']['left'],  # Align left
+            TXT_STYLE['density'][density],  # Custom density from 0 to 8
+            TXT_STYLE['invert'][False]  # Inverted OFF
+        )
+
+        assert(instance.output == b''.join(expected_sequence))
+
+
+# Invert
+
+def test_invert():
+    instance = printer.Dummy()
+    instance.set(invert=True)
+
+    expected_sequence = (
+        TXT_NORMAL, TXT_STYLE['size']['normal'],  # Normal text size
+        TXT_STYLE['flip'][False],  # Flip OFF
+        TXT_STYLE['smooth'][False],  # Smooth OFF
+        TXT_STYLE['bold'][False],  # Bold OFF
+        TXT_STYLE['underline'][0],  # Underline OFF
+        SET_FONT(b'\x00'),  # Default font
+        TXT_STYLE['align']['left'],  # Align left
+        TXT_STYLE['invert'][True]  # Inverted ON
+    )
+
+    assert(instance.output == b''.join(expected_sequence))

test/test_load_module.py

@@ -12,30 +12,10 @@ from __future__ import division
 from __future__ import print_function
 from __future__ import unicode_literals
 
-from nose.tools import with_setup
-
 import escpos.printer as printer
-import os
-
-devfile = 'testfile'
 
 
-def setup_testfile():
-    """create a testfile as devfile"""
-    fhandle = open(devfile, 'a')
-    try:
-        os.utime(devfile, None)
-    finally:
-        fhandle.close()
-
-
-def teardown_testfile():
-    """destroy testfile again"""
-    os.remove(devfile)
-
-
-@with_setup(setup_testfile, teardown_testfile)
 def test_instantiation():
     """test the instantiation of a escpos-printer class and basic printing"""
-    instance = printer.File(devfile=devfile)
+    instance = printer.Dummy()
     instance.text('This is a test\n')