#
# Example python script to generate a BOM from a KiCad generic netlist
# The KiCad generic xml netlist is expected to be encoded UTF-8
#
# Example: Sorted and Grouped HTML BOM
#
"""
@package
Output: HTML
Grouped By: Value, DNP
Sorted By: Ref
Fields: Ref, Qnty, Value, Part, Datasheet, Description, Vendor, DNP
Command line:
python "pathToFile/bom_html_grouped_by_value.py" "%I" "%O.html"
"""
from __future__ import print_function
# Import the KiCad python helper module and the csv formatter
import kicad_netlist_reader
import kicad_utils
import sys
# Start with a basic html template
html = """
"""
# Generate an instance of a generic netlist, and load the netlist tree from
# the command line option. If the file doesn't exist, execution will stop
net = kicad_netlist_reader.netlist(sys.argv[1])
# Open a file to write to, if the file cannot be opened output to stdout
# instead
try:
f = kicad_utils.open_file_write(sys.argv[2], 'wb')
except IOError:
e = "Can't open output file for writing: " + sys.argv[2]
print(__file__, ":", e, file=sys.stderr)
f = sys.stdout
components = net.getInterestingComponents( excludeBOM=True )
# Output a set of rows for a header providing general information
html = html.replace('', net.getSource())
html = html.replace('', net.getDate())
html = html.replace('', net.getTool())
html = html.replace('', "Component Count:" + \
str(len(components)))
row =""
row += "Ref | "
row += "Qnty | "
row += "Value | " + "Part | " + "Datasheet | "
row += "Description | " + "Vendor | " + "DNP |
"
html = html.replace('', row + "")
# Get all of the components in groups of matching parts + values
# (see kicad_netlist_reader.py)
grouped = net.groupComponents(components)
# Output all of the component information
for group in grouped:
refs = ""
# Add the reference of every component in the group and keep a reference
# to the component so that the other data can be filled in once per group
for component in group:
if len(refs) > 0:
refs += ", "
refs += component.getRef()
c = component
row = "" + refs +" | " + str(len(group))
row += " | " + c.getValue()
row += " | " + c.getLibName() + ":" + c.getPartName()
row += " | " + c.getDatasheet()
row += " | " + c.getDescription()
row += " | " + c.getField("Vendor")
row += " | " + c.getDNPString() + " |
"
row += "\n"
html = html.replace('', row + "")
# Write the formatted html to the file
if sys.version_info[0] < 3:
f.write(html)
else:
f.write(html.encode('utf-8'))
f.close()