Minor fixes: coding style in 3d-viewer and minor code cleanup, and some fixes in bom python scripts, which did not work when a non ascii char (but a valid utf8 symbol) was found in xml netlist. Add comments.

scripts/bom-in-python/bom_csv_grouped_by_value.py

@@ -3,6 +3,13 @@
 #
 # Example: Sorted and Grouped CSV BOM
 #
+"""
+    @package
+    Generate a csv BOM list.
+    Components are sorted by ref and grouped by value
+    Fields are (if exist)
+    Item, Qty, Reference(s), Value, LibPart, Footprint, Datasheet
+"""
 
 from __future__ import print_function
 
@@ -11,6 +18,29 @@ import kicad_netlist_reader
 import csv
 import sys
 
+def myEqu(self, other):
+    """myEqu is a more advanced equivalence function for components which is
+    used by component grouping. Normal operation is to group components based
+    on their value and footprint.
+
+    In this example of a custom equivalency operator we compare the
+    value, the part name and the footprint.
+
+    """
+    result = True
+    if self.getValue() != other.getValue():
+        result = False
+    elif self.getPartName() != other.getPartName():
+        result = False
+    elif self.getFootprint() != other.getFootprint():
+        result = False
+
+    return result
+
+# Override the component equivalence operator - it is important to do this
+# before loading the netlist, otherwise all components will have the original
+# equivalency operator.
+kicad_netlist_reader.comp.__eq__ = myEqu
 
 if len(sys.argv) != 3:
     print("Usage ", __file__, "<generic_netlist.xml> <output.csv>", file=sys.stderr)
@@ -48,17 +78,18 @@ columns = ['Item', 'Qty', 'Reference(s)', 'Value', 'LibPart', 'Footprint', 'Data
 # Create a new csv writer object to use as the output formatter
 out = csv.writer( f, lineterminator='\n', delimiter=',', quotechar='\"', quoting=csv.QUOTE_MINIMAL )
 
-# override csv.writer's writerow() to support utf8 encoding:
+# override csv.writer's writerow() to support encoding conversion (initial encoding is utf8):
 def writerow( acsvwriter, columns ):
     utf8row = []
     for col in columns:
-        utf8row.append( str(col).encode('utf8') )
+        utf8row.append( str(col) )  # currently, no change
     acsvwriter.writerow( utf8row )
 
 # Output a set of rows as a header providing general information
 writerow( out, ['Source:', net.getSource()] )
 writerow( out, ['Date:', net.getDate()] )
 writerow( out, ['Tool:', net.getTool()] )
+writerow( out, ['Generator:', sys.argv[0]] )
 writerow( out, ['Component Count:', len(components)] )
 writerow( out, [] )
 writerow( out, ['Individual Components:'] )
@@ -129,6 +160,6 @@ for group in grouped:
     for field in columns[7:]:
         row.append( net.getGroupField(group, field) );
 
-    writerow( out,  row  )
+    writerow( out, row  )
 
 f.close()

scripts/bom-in-python/bom_csv_grouped_by_value_with_fp.py

@@ -7,9 +7,9 @@
 """
     @package
     Generate a Tab delimited list (csv file type).
-    Components are sorted by ref and grouped by value
+    Components are sorted by ref and grouped by value with same footprint
     Fields are (if exist)
-    'Ref', 'Qnty', 'Value', 'Sch lib name', 'footprint', 'Description', 'Vendor'
+    'Ref', 'Qnty', 'Value', 'Cmp name', 'Footprint', 'Description', 'Vendor'
 """
 
 # Import the KiCad python helper module and the csv formatter
@@ -37,8 +37,9 @@ out = csv.writer(f, lineterminator='\n', delimiter=',', quotechar='\"', quoting=
 out.writerow(['Source:', net.getSource()])
 out.writerow(['Date:', net.getDate()])
 out.writerow(['Tool:', net.getTool()])
+out.writerow( ['Generator:', sys.argv[0]] )
 out.writerow(['Component Count:', len(net.components)])
-out.writerow(['Ref', 'Qnty', 'Value', 'Sch lib name', 'footprint', 'Description', 'Vendor'])
+out.writerow(['Ref', 'Qnty', 'Value', 'Cmp name', 'Footprint', 'Description', 'Vendor'])
 
 # Get all of the components in groups of matching parts + values
 # (see ky_generic_netlist_reader.py)
@@ -55,7 +56,7 @@ for group in grouped:
         c = component
 
     # Fill in the component groups common data
-    out.writerow([refs, len(group), c.getValue(), c.getLibName() + "/" + c.getPartName(), c.getFootprint(),
+    out.writerow([refs, len(group), c.getValue(), c.getPartName(), c.getFootprint(),
         c.getDescription(), c.getField("Vendor")])
 
 

scripts/bom-in-python/bom_html_with_advanced_grouping.py

@@ -9,7 +9,7 @@
     Generate a HTML BOM list.
     Components are sorted and grouped by value
     Fields are (if exist)
-    Ref, Quantity, Value, Part, Datasheet, Description, Vendor
+    Ref, Quantity, Value, Part, Footprint, Description, Vendor
 """
 
 
@@ -43,7 +43,7 @@ html = """
 def myEqu(self, other):
     """myEqu is a more advanced equivalence function for components which is
     used by component grouping. Normal operation is to group components based
-    on their Value, Library source, and Library part.
+    on their Value and Footprint.
 
     In this example of a more advanced equivalency operator we also compare the
     custom fields Voltage, Tolerance and Manufacturer as well as the assigned
@@ -54,8 +54,6 @@ def myEqu(self, other):
     result = True
     if self.getValue() != other.getValue():
         result = False
-    elif self.getLibName() != other.getLibName():
-        result = False
     elif self.getPartName() != other.getPartName():
         result = False
     elif self.getFootprint() != other.getFootprint():
@@ -72,7 +70,7 @@ def myEqu(self, other):
 # Override the component equivalence operator - it is important to do this
 # before loading the netlist, otherwise all components will have the original
 # equivalency operator.
-kicad_netlist_reader.comp.__equ__ = myEqu
+kicad_netlist_reader.comp.__eq__ = myEqu
 
 # Generate an instance of a generic netlist, and load the netlist tree from
 # <file>.tmp. If the file doesn't exist, execution will stop
@@ -95,7 +93,7 @@ html = html.replace('<!--COMPCOUNT-->', "<b>Component Count:</b>" + \
     str(len(net.components)))
 
 row  = "<tr><th style='width:640px'>Ref</th>" + "<th>Qnty</th>"
-row += "<th>Value</th>" + "<th>Part</th>" + "<th>Datasheet</th>"
+row += "<th>Value</th>" + "<th>Part</th>" + "<th>Footprint</th>"
 row += "<th>Description</th>" + "<th>Vendor</th></tr>"
 
 html = html.replace('<!--TABLEROW-->', row + "<!--TABLEROW-->")
@@ -121,7 +119,7 @@ for group in grouped:
     row = "\n    "
     row += "<tr><td>" + refs +"</td><td>" + str(len(group))
     row += "</td><td>" + c.getValue() + "</td><td>" + c.getLibName() + ":"
-    row += c.getPartName() + "</td><td>" + c.getDatasheet() + "</td><td>"
+    row += c.getPartName() + "</td><td>" + c.getFootprint() + "</td><td>"
     row += c.getDescription() + "</td><td>" + c.getField("Vendor")
     row += "</td></tr>"
 

scripts/bom-in-python/kicad_netlist_reader.py

@@ -2,6 +2,8 @@
 # KiCad python module for interpreting generic netlists which can be used
 # to generate Bills of materials, etc.
 #
+# Remember these files use UTF8 encoding
+#
 # No string formatting is used on purpose as the only string formatting that
 # is current compatible with python 2.4+ to 3.0+ is the '%' method, and that
 # is due to be deprecated in 3.0+ soon
@@ -304,12 +306,24 @@ class comp():
         self.grouped = False
 
     def __eq__(self, other):
-        """Equlivalency operator, remember this can be easily overloaded"""
+        """ Equivalency operator, remember this can be easily overloaded
+            2 components are equivalent ( i.e. can be grouped
+            if they have same value and same footprint
+
+            Override the component equivalence operator must be done before
+            loading the netlist, otherwise all components will have the original
+            equivalency operator.
+
+            You have to define a comparison module (for instance named myEqu)
+            and add the line;
+                kicad_netlist_reader.comp.__eq__ = myEqu
+            in your bom generator script before calling the netliste reader by something like:
+                net = kicad_netlist_reader.netlist(sys.argv[1])
+        """
         result = False
         if self.getValue() == other.getValue():
-            if self.getLibName() == other.getLibName():
-                if self.getPartName() == other.getPartName():
-                    result = True
+            if self.getFootprint() == other.getFootprint():
+                result = True
         return result
 
     def setLibPart(self, part):
@@ -331,7 +345,7 @@ class comp():
             v.setChars(value)
 
     def getValue(self):
-        return self.element.get("value")
+        return self.element.get("value").encode( "utf-8" )
 
     def getField(self, name, libraryToo=True):
         """Return the value of a field named name. The component is first
@@ -347,7 +361,7 @@ class comp():
 
         field = self.element.get("field", "name", name)
         if field == "" and libraryToo:
-            field = self.libpart.getField(name)
+            field = self.libpart.getField(name).encode( "utf-8" )
         return field
 
     def getFieldNames(self):
@@ -360,7 +374,7 @@ class comp():
         fields = self.element.getChild('fields')
         if fields:
             for f in fields.getChildren():
-                fieldNames.append( f.get('field','name') )
+                fieldNames.append( f.get('field','name').encode( "utf-8" ) )
         return fieldNames
 
     def getRef(self):
@@ -382,7 +396,7 @@ class comp():
         return self.element.get("tstamp")
 
     def getDescription(self):
-        return self.libpart.getDescription()
+        return self.libpart.getDescription().encode( "utf-8" )
 
 
 class netlist():