Merge pull request #36 from galacticfan/master

Python3 compatibility

Author: ladyada

Adafruit_Thermal.py

@@ -32,11 +32,10 @@
 # - Trap errors properly.  Some stuff just falls through right now.
 # - Add docstrings throughout!
 
-# Python 2.X code using the library usu. needs to include the next line:
-from __future__ import print_function
 from serial import Serial
 import time
 import sys
+import math
 
 class Adafruit_Thermal(Serial):
 
@@ -181,12 +180,12 @@ def setTimes(self, p, f):
 	def writeBytes(self, *args):
 		if self.writeToStdout:
 			for arg in args:
-				sys.stdout.write(chr(arg))
+				sys.stdout.write(bytes([arg]))
 		else:
-			self.timeoutWait()
-			self.timeoutSet(len(args) * self.byteTime)
 			for arg in args:
-				super(Adafruit_Thermal, self).write(chr(arg))
+				self.timeoutWait()
+				self.timeoutSet(len(args) * self.byteTime)
+				super(Adafruit_Thermal, self).write(bytes([arg]))
 
 	# Override write() method to keep track of paper feed.
 	def write(self, *data):
@@ -262,7 +261,7 @@ def setDefault(self):
 		self.setCodePage()
 
 	def test(self):
-		self.write("Hello world!")
+		self.write("Hello world!".encode('cp437', 'ignore'))
 		self.feed(2)
 
 	def testPage(self):
@@ -341,20 +340,20 @@ def printBarcode(self, text, type):
 			n = len(text)
 			if n > 255: n = 255
 			if self.writeToStdout:
-				sys.stdout.write(chr(n))
+				sys.stdout.write((chr(n)).encode('cp437', 'ignore'))
 				for i in range(n):
-					sys.stdout.write(text[i])
+					sys.stdout.write(text[i].encode('utf-8', 'ignore'))
 			else:
-				super(Adafruit_Thermal, self).write(chr(n))
+				super(Adafruit_Thermal, self).write((chr(n)).encode('utf-8', 'ignore'))
 				for i in range(n):
 					super(Adafruit_Thermal,
-					  self).write(text[i])
+					  self).write(text[i].encode('utf-8', 'ignore'))
 		else:
 			# Older firmware: write string + NUL
 			if self.writeToStdout:
-				sys.stdout.write(text)
+				sys.stdout.write(text.encode('utf-8', 'ignore'))
 			else:
-				super(Adafruit_Thermal, self).write(text)
+				super(Adafruit_Thermal, self).write(text.encode('utf-8', 'ignore'))
 		self.prevByte = '\n'
 
 	# === Character commands ===
@@ -461,7 +460,7 @@ def feed(self, x=1):
 			# datasheet claims sending bytes 27, 100, <x> works,
 			# but it feeds much more than that.  So, manually:
 			while x > 0:
-				self.write('\n')
+				self.write('\n'.encode('cp437', 'ignore'))
 				x -= 1
 
 	# Feeds by the specified number of individual pixel rows
@@ -504,7 +503,7 @@ def underlineOff(self):
 		self.writeBytes(27, 45, 0)
 
 	def printBitmap(self, w, h, bitmap, LaaT=False):
-		rowBytes = (w + 7) / 8  # Round up to next byte boundary
+		rowBytes = math.floor((w + 7) / 8)  # Round up to next byte boundary
 		if rowBytes >= 48:
 			rowBytesClipped = 48  # 384 pixels max width
 		else:
@@ -531,11 +530,10 @@ def printBitmap(self, w, h, bitmap, LaaT=False):
 			for y in range(chunkHeight):
 				for x in range(rowBytesClipped):
 					if self.writeToStdout:
-						sys.stdout.write(
-						  chr(bitmap[i]))
+						sys.stdout.write(bytes([bitmap[i]]))
 					else:
 						super(Adafruit_Thermal,
-						  self).write(chr(bitmap[i]))
+						  self).write(bytes([bitmap[i]]))
 					i += 1
 				i += rowBytes - rowBytesClipped
 			self.timeoutSet(chunkHeight * self.dotPrintTime)
@@ -549,17 +547,17 @@ def printBitmap(self, w, h, bitmap, LaaT=False):
 	# For any other behavior (scale, B&W threshold, etc.), use
 	# the Imaging Library to perform such operations before
 	# passing the result to this function.
-	def printImage(self, image, LaaT=False):
+	def printImage(self, image_file, LaaT=False):
 		from PIL import Image
-
+		image = Image.open(image_file)
 		if image.mode != '1':
 			image = image.convert('1')
 
 		width  = image.size[0]
 		height = image.size[1]
 		if width > 384:
 			width = 384
-		rowBytes = (width + 7) / 8
+		rowBytes = math.floor((width + 7) / 8)
 		bitmap   = bytearray(rowBytes * height)
 		pixels   = image.load()
 
@@ -726,11 +724,11 @@ def setCharSpacing(self, spacing):
 	# with existing code written for the Arduino library.
 	def print(self, *args, **kwargs):
 		for arg in args:
-			self.write(str(arg))
+			self.write((str(arg)).encode('cp437', 'ignore'))
 
 	# For Arduino code compatibility again
 	def println(self, *args, **kwargs):
 		for arg in args:
-			self.write(str(arg))
-		self.write('\n')
+			self.write((str(arg)).encode('cp437', 'ignore'))
+		self.write('\n'.encode('cp437', 'ignore'))
 

README.md

@@ -1,2 +1,49 @@
-Python-Thermal-Printer
-======================
+# Python-Thermal-Printer Module
+
+Python3 port of the original Adafruit [Python-Thermal-Printer](https://github.com/adafruit/Python-Thermal-Printer) library.
+
+## Getting Started
+
+Install Raspbian Buster and Wire the printer according to [this](https://learn.adafruit.com/networked-thermal-printer-using-cups-and-raspberry-pi/connect-and-configure-printer). I powered the printer with the GPIO pins as well.
+
+Run a test to see if the printer is working by punching in these commands into the terminal.
+
+```
+stty -F /dev/serial0 19200
+echo -e "This is a test.\\n\\n\\n" > /dev/serial0
+```
+
+### Installing
+
+Update the system and install prequisities.
+
+```
+sudo apt-get update
+sudo apt-get install git cups wiringpi build-essential libcups2-dev libcupsimage2-dev python-serial python-pil python-unidecode
+```
+
+Install the printer driver. Don't worry about the warnings that g++ gives.
+
+```
+git clone https://github.com/adafruit/zj-58
+cd zj-58
+make
+sudo ./install
+```
+
+Make the printer the default printer. This is useful if you are going to be doing other things with it.
+
+```
+sudo lpadmin -p ZJ-58 -E -v serial:/dev/serial0?baud=19200 -m zjiang/ZJ-58.ppd
+sudo lpoptions -d ZJ-58
+```
+
+Restart the system. Clone this repository and try to run *printertest.py*.
+
+```
+git clone https://github.com/galacticfan/Python-Thermal-Printer/
+cd Python-Thermal-Printer
+python3 printertest.py
+```
+
+Let me know if you have any issues.