"""
This page is in the table of contents.
Gcode_small is an export plugin to remove the comments and the redundant z and feed rate parameters from a gcode file.

An export plugin is a script in the export_plugins folder which has the getOutput function, the globalIsReplaceable variable and if it's output is not replaceable, the writeOutput function.  It is meant to be run from the export tool.  To ensure that the plugin works on platforms which do not handle file capitalization properly, give the plugin a lower case name.

The getOutput function of this script takes a gcode text and returns that text without comments and redundant z and feed rate parameters.  The writeOutput function of this script takes a gcode text and writes that text without comments and redundant z and feed rate parameters to a file.

Many of the functions in this script are copied from gcodec in skeinforge_utilities.  They are copied rather than imported so developers making new plugins do not have to learn about gcodec, the code here is all they need to learn.

"""

from __future__ import absolute_import
import cStringIO
import os


__author__ = 'Enrique Perez (perez_enrique@yahoo.com)'
__date__ = '$Date: 2008/21/04 $'
__license__ = 'GPL 3.0'


# This is true if the output is text and false if it is binary."
globalIsReplaceable = True


def getOutput(gcodeText):
	'Get the exported version of a gcode file.'
	return GcodeSmallSkein().getCraftedGcode(gcodeText)

def getSplitLineBeforeBracketSemicolon(line):
	"Get the split line before a bracket or semicolon."
	bracketSemicolonIndex = min( line.find(';'), line.find('(') )
	if bracketSemicolonIndex < 0:
		return line.split()
	return line[ : bracketSemicolonIndex ].split()

def getStringFromCharacterSplitLine(character, splitLine):
	"Get the string after the first occurence of the character in the split line."
	indexOfCharacter = indexOfStartingWithSecond(character, splitLine)
	if indexOfCharacter < 0:
		return None
	return splitLine[indexOfCharacter][1 :]

def getSummarizedFileName(fileName):
	"Get the fileName basename if the file is in the current working directory, otherwise return the original full name."
	if os.getcwd() == os.path.dirname(fileName):
		return os.path.basename(fileName)
	return fileName

def getTextLines(text):
	"Get the all the lines of text of a text."
	return text.replace('\r', '\n').split('\n')

def indexOfStartingWithSecond(letter, splitLine):
	"Get index of the first occurence of the given letter in the split line, starting with the second word.  Return - 1 if letter is not found"
	for wordIndex in xrange( 1, len(splitLine) ):
		word = splitLine[ wordIndex ]
		firstLetter = word[0]
		if firstLetter == letter:
			return wordIndex
	return - 1


class GcodeSmallSkein:
	"A class to remove redundant z and feed rate parameters from a skein of extrusions."
	def __init__(self):
		self.lastFeedRateString = None
		self.lastZString = None
		self.output = cStringIO.StringIO()

	def getCraftedGcode( self, gcodeText ):
		"Parse gcode text and store the gcode."
		lines = getTextLines(gcodeText)
		for line in lines:
			self.parseLine(line)
		return self.output.getvalue()

	def parseLine(self, line):
		"Parse a gcode line."
		splitLine = getSplitLineBeforeBracketSemicolon(line)
		if len(splitLine) < 1:
			return
		firstWord = splitLine[0]
		if len(firstWord) < 1:
			return
		if firstWord[0] == '(':
			return
		if firstWord != 'G1':
			self.output.write(line + '\n')
			return
		eString = getStringFromCharacterSplitLine('E', splitLine )
		xString = getStringFromCharacterSplitLine('X', splitLine )
		yString = getStringFromCharacterSplitLine('Y', splitLine )
		zString = getStringFromCharacterSplitLine('Z', splitLine )
		feedRateString = getStringFromCharacterSplitLine('F', splitLine )
		self.output.write('G1')
		if xString != None:
			self.output.write(' X' + xString )
		if yString != None:
			self.output.write(' Y' + yString )
		if zString != None and zString != self.lastZString:
			self.output.write(' Z' + zString )
		if feedRateString != None and feedRateString != self.lastFeedRateString:
			self.output.write(' F' + feedRateString )
		if eString != None:
			self.output.write(' E' + eString )
		self.lastFeedRateString = feedRateString
		self.lastZString = zString
		self.output.write('\n')
