generate_tables.py

#!/usr/bin/env python3
# -*- coding: utf-8 -*-

DEBUG = False

if __name__ == "__main__" and not DEBUG:
    print("Suppressing output of generate_tables.py")

def debug(*args, **kwargs):
    if DEBUG:
        print(*args, **kwargs)

import os
import sys
import re
import urllib.request
import urllib.error
import math
from collections import namedtuple

sys.path.append(os.path.join(os.path.split(__file__)[0], '../generators'))
from device_infos import DeviceInfo, brick_infos, bricklet_infos

lang = 'en'

ToolInfo = namedtuple('ToolInfo', 'display_name url_part')

tool_infos = \
[
    ToolInfo('Brick Daemon', 'brickd'),
    ToolInfo('Brick Viewer', 'brickv'),
    ToolInfo('Brick Flash', 'brick_flash'),
    ToolInfo('Brick Logger', 'brick_logger')
]

BindingsInfo = namedtuple('BindingsInfo', 'display_name url_part software_doc_suffix is_programming_language is_released has_authentication_example has_download misc_docs tutorial is_hardware_supported')

MiscDoc = namedtuple('miscdoc', 'html_link rst_link name_dict has_examples show_in_api_table')

bindings_infos = \
[
    BindingsInfo(display_name={'en': 'C/C++', 'de': 'C/C++'},
                 url_part='c',
                 software_doc_suffix='C',
                 is_programming_language=True,
                 is_released=True,
                 has_authentication_example=True,
                 has_download=True,
                 misc_docs=[
                     MiscDoc('IPConnection_{suffix}', 'ip_connection_{suffix}', {'en': 'IP Connection', 'de': 'IP Connection'}, True, True),
                     MiscDoc('API_Bindings_{suffix}', 'api_bindings_{suffix}',  {'en': 'Usage', 'de': 'Benutzung'}, False, False),
                     MiscDoc('API_Bindings_{suffix}_iOS', 'api_bindings_{suffix}_ios', {'en': 'Usage (iOS)', 'de': 'Benutzung (iOS)'}, False, False)
                 ],
                 tutorial={'en': 'https://www.cprogramming.com/',
                           'de': 'https://www.cprogramming.com/'}, # http://www.c-howto.de/
                 is_hardware_supported=lambda device_info: True),
    BindingsInfo(display_name={'en': 'C/C++ for Microcontrollers', 'de': u'C/C++ für Mikrocontroller'},
                 url_part='uc',
                 software_doc_suffix='uC',
                 is_programming_language=True,
                 is_released=True,
                 has_authentication_example=False,
                 has_download=True,
                 misc_docs=[
                     MiscDoc('API_Bindings_{suffix}', 'api_bindings_{suffix}',  {'en': 'Usage', 'de': 'Benutzung'}, False, False),
                     MiscDoc('API_Bindings_{suffix}_HAL_Arduino', 'api_bindings_{suffix}_hal_arduino', {'en': 'HAL Arduino', 'de': 'HAL Arduino'}, True, True),
                     MiscDoc('API_Bindings_{suffix}_HAL_Arduino_ESP32', 'api_bindings_{suffix}_hal_arduino_esp32', {'en': 'HAL Arduino ESP32', 'de': 'HAL Arduino ESP32'}, True, True),
                     MiscDoc('API_Bindings_{suffix}_HAL_Arduino_ESP32_Brick', 'api_bindings_{suffix}_hal_arduino_esp32_brick', {'en': 'HAL Arduino ESP32 Brick', 'de': 'HAL Arduino ESP32 Brick'}, True, True),
                     MiscDoc('API_Bindings_{suffix}_HAL_Arduino_ESP32_Ethernet_Brick', 'api_bindings_{suffix}_hal_arduino_esp32_ethernet_brick', {'en': 'HAL Arduino ESP32 Ethernet Brick', 'de': 'HAL Arduino ESP32 Ethernet Brick'}, True, True),
                     MiscDoc('API_Bindings_{suffix}_HAL_Linux', 'api_bindings_{suffix}_hal_linux', {'en': 'HAL Linux', 'de': 'HAL Linux'}, True, True),
                     MiscDoc('API_Bindings_{suffix}_HAL_Raspberry_Pi', 'api_bindings_{suffix}_hal_raspberry_pi', {'en': 'HAL Raspberry Pi', 'de': 'HAL Raspberry Pi'}, True, True),
                     #MiscDoc('API_Bindings_{suffix}_HAL_STM32F0', 'api_bindings_{suffix}_hal_stm32f0', {'en': 'HAL STM32F0', 'de': 'HAL STM32F0'}, True, True),
                 ],
                 tutorial={'en': 'https://www.cprogramming.com/',
                           'de': 'https://www.cprogramming.com/'}, # http://www.c-howto.de/
                 is_hardware_supported=lambda device_info: device_info.has_comcu),
    BindingsInfo(display_name={'en': 'C#', 'de': 'C#'},
                 url_part='csharp',
                 software_doc_suffix='CSharp',
                 is_programming_language=True,
                 is_released=True,
                 has_authentication_example=True,
                 has_download=True,
                 misc_docs=[
                     MiscDoc('IPConnection_{suffix}', 'ip_connection_{suffix}', {'en': 'IP Connection', 'de': 'IP Connection'}, True, True),
                     MiscDoc('API_Bindings_{suffix}', 'api_bindings_{suffix}',  {'en': 'Usage', 'de': 'Benutzung'}, False, False),
                     MiscDoc('API_Bindings_{suffix}_Windows_Phone', 'api_bindings_{suffix}_windows_phone', {'en': 'Usage (Windows Phone)', 'de': 'Benutzung (Win Phone)'}, False, False)
                 ],
                 tutorial={'en': 'https://csharp.net-tutorials.com/',
                           'de': 'https://csharp.net-tutorials.com/'},
                 is_hardware_supported=lambda device_info: True),
    BindingsInfo(display_name={'en': 'Delphi/Lazarus', 'de': 'Delphi/Lazarus'},
                 url_part='delphi',
                 software_doc_suffix='Delphi',
                 is_programming_language=True,
                 is_released=True,
                 has_authentication_example=True,
                 has_download=True,
                 misc_docs=[
                     MiscDoc('IPConnection_{suffix}', 'ip_connection_{suffix}', {'en': 'IP Connection', 'de': 'IP Connection'}, True, True),
                     MiscDoc('API_Bindings_{suffix}', 'api_bindings_{suffix}',  {'en': 'Usage', 'de': 'Benutzung'}, False, False)
                 ],
                 tutorial={'en': 'http://www.delphibasics.co.uk/',
                           'de': 'https://www.delphi-treff.de/tutorials/grundlagen-tutorials/'},
                 is_hardware_supported=lambda device_info: True),
    BindingsInfo(display_name={'en': 'Go', 'de': 'Go'},
                 url_part='go',
                 software_doc_suffix='Go',
                 is_programming_language=True,
                 is_released=True,
                 has_authentication_example=True,
                 has_download=True,
                 misc_docs=[
                     MiscDoc('IPConnection_{suffix}', 'ip_connection_{suffix}', {'en': 'IP Connection', 'de': 'IP Connection'}, True, True),
                     MiscDoc('API_Bindings_{suffix}', 'api_bindings_{suffix}',  {'en': 'Usage', 'de': 'Benutzung'}, False, False)
                 ],
                 tutorial={'en': 'https://tour.golang.org',
                           'de': 'https://tour.golang.org'},
                 is_hardware_supported=lambda device_info: True),
    BindingsInfo(display_name={'en': 'Java', 'de': 'Java'},
                 url_part='java',
                 software_doc_suffix='Java',
                 is_programming_language=True,
                 is_released=True,
                 has_authentication_example=True,
                 has_download=True,
                 misc_docs=[
                     MiscDoc('IPConnection_{suffix}', 'ip_connection_{suffix}', {'en': 'IP Connection', 'de': 'IP Connection'}, True, True),
                     MiscDoc('API_Bindings_{suffix}', 'api_bindings_{suffix}',  {'en': 'Usage', 'de': 'Benutzung'}, False, False),
                     MiscDoc('API_Bindings_{suffix}_Android', 'api_bindings_{suffix}_android', {'en': 'Usage (Android)', 'de': 'Benutzung (Android)'}, False, False)
                 ],
                 tutorial={'en': 'https://docs.oracle.com/javase/tutorial/',
                           'de': 'https://docs.oracle.com/javase/tutorial/'}, # http://openbook.galileocomputing.de/javainsel/
                 is_hardware_supported=lambda device_info: True),
    BindingsInfo(display_name={'en': 'JavaScript', 'de': 'JavaScript'},
                 url_part='javascript',
                 software_doc_suffix='JavaScript',
                 is_programming_language=True,
                 is_released=True,
                 has_authentication_example=True,
                 has_download=True,
                 misc_docs=[
                     MiscDoc('IPConnection_{suffix}', 'ip_connection_{suffix}', {'en': 'IP Connection', 'de': 'IP Connection'}, True, True),
                     MiscDoc('API_Bindings_{suffix}', 'api_bindings_{suffix}',  {'en': 'Usage', 'de': 'Benutzung'}, False, False)
                 ],
                 tutorial={'en': 'FIXME',
                           'de': 'FIXME'},
                 is_hardware_supported=lambda device_info: True),
    BindingsInfo(display_name={'en': 'LabVIEW', 'de': 'LabVIEW'},
                 url_part='labview',
                 software_doc_suffix='LabVIEW',
                 is_programming_language=True,
                 is_released=True,
                 has_authentication_example=True,
                 has_download=True,
                 misc_docs=[
                     MiscDoc('IPConnection_{suffix}', 'ip_connection_{suffix}', {'en': 'IP Connection', 'de': 'IP Connection'}, True, True),
                     MiscDoc('API_Bindings_{suffix}', 'api_bindings_{suffix}',  {'en': 'Usage', 'de': 'Benutzung'}, False, False)
                 ],
                 tutorial={'en': 'FIXME',
                           'de': 'FIXME'},
                 is_hardware_supported=lambda device_info: True),
    BindingsInfo(display_name={'en': 'Mathematica', 'de': 'Mathematica'},
                 url_part='mathematica',
                 software_doc_suffix='Mathematica',
                 is_programming_language=True,
                 is_released=True,
                 has_authentication_example=True,
                 has_download=True,
                 misc_docs=[
                     MiscDoc('IPConnection_{suffix}', 'ip_connection_{suffix}', {'en': 'IP Connection', 'de': 'IP Connection'}, True, True),
                     MiscDoc('API_Bindings_{suffix}', 'api_bindings_{suffix}',  {'en': 'Usage', 'de': 'Benutzung'}, False, False)
                 ],
                 tutorial={'en': 'FIXME',
                           'de': 'FIXME'},
                 is_hardware_supported=lambda device_info: True),
    BindingsInfo(display_name={'en': 'MATLAB/Octave', 'de': 'MATLAB/Octave'},
                 url_part='matlab',
                 software_doc_suffix='MATLAB',
                 is_programming_language=True,
                 is_released=True,
                 has_authentication_example=True,
                 has_download=True,
                 misc_docs=[
                     MiscDoc('IPConnection_{suffix}', 'ip_connection_{suffix}', {'en': 'IP Connection', 'de': 'IP Connection'}, True, True),
                     MiscDoc('API_Bindings_{suffix}', 'api_bindings_{suffix}',  {'en': 'Usage', 'de': 'Benutzung'}, False, False)
                 ],
                 tutorial={'en': 'FIXME',
                           'de': 'FIXME'},
                 is_hardware_supported=lambda device_info: True),
    BindingsInfo(display_name={'en': 'MQTT', 'de': 'MQTT'},
                 url_part='mqtt',
                 software_doc_suffix='MQTT',
                 is_programming_language=True,
                 is_released=True,
                 has_authentication_example=True,
                 has_download=True,
                 misc_docs=[
                     MiscDoc('IPConnection_{suffix}', 'ip_connection_{suffix}', {'en': 'IP Connection', 'de': 'IP Connection'}, True, True),
                     MiscDoc('API_Bindings_{suffix}', 'api_bindings_{suffix}',  {'en': 'Usage', 'de': 'Benutzung'}, False, False)
                 ],
                 tutorial={'en': 'FIXME',
                           'de': 'FIXME'},
                 is_hardware_supported=lambda device_info: True),
    BindingsInfo(display_name={'en': 'openHAB', 'de': 'openHAB'},
                 url_part='openhab',
                 software_doc_suffix='openHAB',
                 is_programming_language=True,
                 is_released=True,
                 has_authentication_example=False,
                 has_download=False, # FIXME
                 misc_docs=[
                     MiscDoc('API_Bindings_{suffix}', 'api_bindings_{suffix}',  {'en': 'Usage', 'de': 'Benutzung'}, False, False)
                 ],
                 tutorial={'en': 'FIXME',
                           'de': 'FIXME'},
                 is_hardware_supported=lambda device_info: device_info.has_openhab),
    BindingsInfo(display_name={'en': 'Perl', 'de': 'Perl'},
                 url_part='perl',
                 software_doc_suffix='Perl',
                 is_programming_language=True,
                 is_released=True,
                 has_authentication_example=True,
                 has_download=True,
                 misc_docs=[
                     MiscDoc('IPConnection_{suffix}', 'ip_connection_{suffix}', {'en': 'IP Connection', 'de': 'IP Connection'}, True, True),
                     MiscDoc('API_Bindings_{suffix}', 'api_bindings_{suffix}',  {'en': 'Usage', 'de': 'Benutzung'}, False, False)
                 ],
                 tutorial={'en': 'FIXME',
                           'de': 'FIXME'},
                 is_hardware_supported=lambda device_info: True),
    BindingsInfo(display_name={'en': 'PHP', 'de': 'PHP'},
                 url_part='php',
                 software_doc_suffix='PHP',
                 is_programming_language=True,
                 is_released=True,
                 has_authentication_example=True,
                 has_download=True,
                 misc_docs=[
                     MiscDoc('IPConnection_{suffix}', 'ip_connection_{suffix}', {'en': 'IP Connection', 'de': 'IP Connection'}, True, True),
                     MiscDoc('API_Bindings_{suffix}', 'api_bindings_{suffix}',  {'en': 'Usage', 'de': 'Benutzung'}, False, False)
                 ],
                 tutorial={'en': 'https://www.php.net/manual/en/getting-started.php',
                           'de': 'https://www.php.net/manual/de/getting-started.php'},
                 is_hardware_supported=lambda device_info: True),
    BindingsInfo(display_name={'en': 'Python', 'de': 'Python'},
                 url_part='python',
                 software_doc_suffix='Python',
                 is_programming_language=True,
                 is_released=True,
                 has_authentication_example=True,
                 has_download=True,
                 misc_docs=[
                     MiscDoc('IPConnection_{suffix}', 'ip_connection_{suffix}', {'en': 'IP Connection', 'de': 'IP Connection'}, True, True),
                     MiscDoc('API_Bindings_{suffix}', 'api_bindings_{suffix}',  {'en': 'Usage', 'de': 'Benutzung'}, False, False)
                 ],
                 tutorial={'en': 'https://www.python.org/about/gettingstarted/', # http://getpython3.com/diveintopython3/
                           'de': 'https://www.python.org/about/gettingstarted/'},
                 is_hardware_supported=lambda device_info: True),
    BindingsInfo(display_name={'en': 'Ruby', 'de': 'Ruby'},
                 url_part='ruby',
                 software_doc_suffix='Ruby',
                 is_programming_language=True,
                 is_released=True,
                 has_authentication_example=True,
                 has_download=True,
                 misc_docs=[
                     MiscDoc('IPConnection_{suffix}', 'ip_connection_{suffix}', {'en': 'IP Connection', 'de': 'IP Connection'}, True, True),
                     MiscDoc('API_Bindings_{suffix}', 'api_bindings_{suffix}',  {'en': 'Usage', 'de': 'Benutzung'}, False, False)
                 ],
                 tutorial={'en': 'https://www.ruby-lang.org/en/documentation/quickstart/',
                           'de': 'https://www.ruby-lang.org/de/documentation/quickstart/'},
                 is_hardware_supported=lambda device_info: True),
    BindingsInfo(display_name={'en': 'Rust', 'de': 'Rust'},
                 url_part='rust',
                 software_doc_suffix='Rust',
                 is_programming_language=True,
                 is_released=True,
                 has_authentication_example=True,
                 has_download=True,
                 misc_docs=[
                     MiscDoc('IPConnection_{suffix}', 'ip_connection_{suffix}', {'en': 'IP Connection', 'de': 'IP Connection'}, True, True),
                     MiscDoc('API_Bindings_{suffix}', 'api_bindings_{suffix}',  {'en': 'Usage', 'de': 'Benutzung'}, False, False)
                 ],
                 tutorial={'en': 'https://doc.rust-lang.org/tutorial.html',
                           'de': 'https://doc.rust-lang.org/tutorial.html'},
                 is_hardware_supported=lambda device_info: True),
    BindingsInfo(display_name={'en': 'Shell', 'de': 'Shell'},
                 url_part='shell',
                 software_doc_suffix='Shell',
                 is_programming_language=True,
                 is_released=True,
                 has_authentication_example=True,
                 has_download=True,
                 misc_docs=[
                     MiscDoc('IPConnection_{suffix}', 'ip_connection_{suffix}', {'en': 'IP Connection', 'de': 'IP Connection'}, True, True),
                     MiscDoc('API_Bindings_{suffix}', 'api_bindings_{suffix}',  {'en': 'Usage', 'de': 'Benutzung'}, False, False)
                 ],
                 tutorial={'en': 'FIXME',
                           'de': 'FIXME'},
                 is_hardware_supported=lambda device_info: True),
    #BindingsInfo(display_name={'en': 'Tinkerforge Visual Programming Language (TVPL)', 'de': 'Tinkerforge Visual Programming Language (TVPL)'},
    #             url_part='tvpl',
    #             software_doc_suffix='TVPL',
    #             is_programming_language=True,
    #             is_released=False,
    #             has_authentication_example=False,
    #             has_download=True,
    #             misc_docs=[
    #                 ('IPConnection_{suffix}', 'ip_connection_{suffix}', {'en': 'IP Connection', 'de': 'IP Connection'}),
    #                 ('API_Bindings_{suffix}', 'api_bindings_{suffix}',  {'en': 'Usage', 'de': 'Benutzung'})
    #             ],
    #             tutorial={'en': 'FIXME',
    #                       'de': 'FIXME'}),
    BindingsInfo(display_name={'en': 'Visual Basic .NET', 'de': 'Visual Basic .NET'},
                 url_part='vbnet',
                 software_doc_suffix='VBNET',
                 is_programming_language=True,
                 is_released=True,
                 has_authentication_example=True,
                 has_download=True,
                 misc_docs=[
                     MiscDoc('IPConnection_{suffix}', 'ip_connection_{suffix}', {'en': 'IP Connection', 'de': 'IP Connection'}, True, True),
                     MiscDoc('API_Bindings_{suffix}', 'api_bindings_{suffix}',  {'en': 'Usage', 'de': 'Benutzung'}, False, False)
                 ],
                 tutorial={'en': 'http://howtostartprogramming.com/vb-net/',
                           'de': 'http://howtostartprogramming.com/vb-net/'}, # http://openbook.galileocomputing.de/vb_net/index.htm
                 is_hardware_supported=lambda device_info: True),
    BindingsInfo(display_name={'en': 'TCP/IP', 'de': 'TCP/IP'},
                 url_part='tcpip',
                 software_doc_suffix='TCPIP',
                 is_programming_language=False,
                 is_released=True,
                 has_authentication_example=False,
                 has_download=False,
                 misc_docs=[
                     MiscDoc('IPConnection_{suffix}', 'ip_connection_{suffix}', {'en': 'IP Connection', 'de': 'IP Connection'}, True, True),
                     MiscDoc('API_Bindings_{suffix}', 'api_bindings_{suffix}',  {'en': 'Usage', 'de': 'Benutzung'}, False, False)
                 ],
                 tutorial={'en': 'FIXME',
                           'de': 'FIXME'},
                 is_hardware_supported=lambda device_info: True),
    BindingsInfo(display_name={'en': 'Modbus', 'de': 'Modbus'},
                 url_part='modbus',
                 software_doc_suffix='Modbus',
                 is_programming_language=False,
                 is_released=True,
                 has_authentication_example=False,
                 has_download=False,
                 misc_docs=[
                     MiscDoc('IPConnection_{suffix}', 'ip_connection_{suffix}', {'en': 'IP Connection', 'de': 'IP Connection'}, True, True),
                     MiscDoc('API_Bindings_{suffix}', 'api_bindings_{suffix}',  {'en': 'Usage', 'de': 'Benutzung'}, False, False)
                 ],
                 tutorial={'en': 'FIXME',
                           'de': 'FIXME'},
                 is_hardware_supported=lambda device_info: True),
]

extension_infos = \
[
    DeviceInfo(None, 'Extension', 'Chibi Extension', 'Chibi', 'chibi_extension', 'Chibi_Extension', None, 'chibi-extension', None, False, False, True, True, True, False, None,
               {'en': 'Wireless Chibi connection between stacks',
                'de': 'Drahtlose Chibi Verbindung zwischen Stapeln'}),
    DeviceInfo(None, 'Extension', 'Ethernet Extension', 'Ethernet', 'ethernet_extension', 'Ethernet_Extension', None, 'ethernet-extension', None, False, False, True, True, False, False, None,
               {'en': 'Cable based Ethernet connection between stack and PC',
                'de': 'Kabelgebundene Ethernet Verbindung zwischen Stapel und PC'}),
    DeviceInfo(None, 'Extension', 'RS485 Extension', 'RS485', 'rs485_extension', 'RS485_Extension', None, 'rs485-extension', None, False, False, True, True, False, False, None,
               {'en': 'Cable based RS485 connection between stacks',
                'de': 'Kabelgebundene RS485 Verbindung zwischen Stapeln'}),
    DeviceInfo(None, 'Extension', 'WIFI Extension', 'WIFI', 'wifi_extension', 'WIFI_Extension', None, 'wifi-extension', None, False, False, True, True, False, False, None,
               {'en': 'Wireless Wi-Fi connection between stack and PC',
                'de': 'Drahtlose WLAN Verbindung zwischen Stapel und PC'}),
    DeviceInfo(None, 'Extension', 'WIFI Extension 2.0', 'WIFI 2.0', 'wifi_v2_extension', 'WIFI_V2_Extension', None, 'wifi-v2-extension', 'wifi_v2', False, False, True, True, False, False, None,
               {'en': 'Wireless Wi-Fi connection between stack and PC',
                'de': 'Drahtlose WLAN Verbindung zwischen Stapel und PC'})
]

power_supply_infos = \
[
    DeviceInfo(None, 'PowerSupply', 'Step-Down Power Supply', 'Step-Down', 'step_down_power_supply', 'Step_Down', None, 'step-down-powersupply', None, False, False, True, True, False, False, None,
               {'en': 'Powers a stack of Bricks with 5V',
                'de': 'Versorgt einen Stapel von Bricks mit 5V'}),
    DeviceInfo(None, 'PowerSupply', 'ESP32 Power Supply', 'ESP32', 'esp32_power_supply', 'ESP32', None, 'esp32-power-supply', None, False, False, True, True, False, False, None,
               {'en': 'Powers a ESP32 Brick or ESP32 Ethernet Brick with 5V',
                'de': 'Versorgt einen ESP32 Brick oder ESP32 Ethernet Brick mit 5V'})
]

KitInfo = namedtuple('KitInfo', 'display_name url_part prefix released')

kit_infos = \
[
    KitInfo({'en': 'Starter Kit: Blinkenlights', 'de': 'Starterkit: Blinkenlights'}, 'blinkenlights', 'starter_kit_', True),
    KitInfo({'en': 'Starter Kit: Camera Slider', 'de': 'Starterkit: Kameraschlitten'}, 'camera_slider', 'starter_kit_', True),
    KitInfo({'en': 'Tabletop Weather Station', 'de': 'Tisch-Wetterstation'}, 'tabletop_weather_station', '', True),
    KitInfo({'en': 'Starter Kit: Weather Station', 'de': 'Starterkit: Wetterstation'}, 'weather_station', 'starter_kit_', True)
]

LATEST_VERSIONS_URL = 'https://download.tinkerforge.com/latest_versions.txt'

tool_versions = {}
bindings_versions = {}
firmware_versions = {}
plugin_versions = {}
extension_versions = {}
kit_versions = {}
red_image_versions = {}

has_examples = {}

def collect_latest_version_info():
    debug('Discovering latest versions on tinkerforge.com')

    local_file_path = '/var/www/download/latest_versions.txt'

    if os.path.exists(local_file_path):
        try:
            with open(local_file_path, 'r') as f:
                latest_versions_data = f.read()
        except Exception as e:
            raise Exception(f'Could not read local latest versions file: {e}')
    else:
        try:
            response = urllib.request.urlopen(LATEST_VERSIONS_URL)
            latest_versions_data = response.read().decode('utf-8')
        except urllib.error.URLError:
            raise Exception('Latest version information on tinkerforge.com is not available (error code 1)')

    for line in latest_versions_data.split('\n'):
        line = line.strip()

        if len(line) < 1:
            continue

        parts = line.split(':')

        if len(parts) != 3:
            raise Exception('Latest version information on tinkerforge.com is malformed (error code 2)')

        latest_version_parts = parts[2].split('.')

        if len(latest_version_parts) != 3:
            raise Exception('Latest version information on tinkerforge.com is malformed (error code 3)')

        try:
            latest_version = int(latest_version_parts[0]), int(latest_version_parts[1]), int(latest_version_parts[2])
        except:
            raise Exception('Latest version information on tinkerforge.com is malformed (error code 4)')

        if parts[0] == 'tools':
            tool_versions[parts[1]] = latest_version
        elif parts[0] == 'bindings':
            bindings_versions[parts[1]] = latest_version
        elif parts[0] == 'bricks':
            firmware_versions[parts[1]] = latest_version
        elif parts[0] == 'bricklets':
            plugin_versions[parts[1]] = latest_version
        elif parts[0] == 'extensions':
            extension_versions[parts[1]] = latest_version
        elif parts[0] == 'kits':
            kit_versions[parts[1]] = latest_version
        elif parts[0] == 'red_images':
            red_image_versions[parts[1]] = latest_version

def collect_example_info(path):
    for device_info in brick_infos + bricklet_infos:
        if not device_info.has_bindings:
            continue

        assert device_info.identifier != None, device_info

        has_examples[device_info.identifier] = {}

        for bindings_info in bindings_infos:
            if not bindings_info.is_programming_language:
                continue
            if not bindings_info.is_hardware_supported(device_info):
                continue

            assert bindings_info.url_part != None, bindings_info

            category = device_info.category

            if category.startswith('Brick'):
                category += 's'

            examples_label = '_{0}_{1}_examples'.format(device_info.ref_name, bindings_info.url_part)

            doc_path = os.path.join(path, 'source', 'Software', category, '{0}_{1}.rst'.format(device_info.software_doc_prefix, bindings_info.software_doc_suffix))

            if not os.path.exists(doc_path):
                has_examples[device_info.identifier][bindings_info.url_part] = False
            else:
                with open(doc_path, 'r') as f:
                    has_examples[device_info.identifier][bindings_info.url_part] = examples_label in f.read()

def make_primer_table(device_infos):
    table_head = {
    'en': """
.. csv-table::
   :header: "Name", "Description"
   :widths: 25, 75

""",
    'de': """
.. csv-table::
   :header: "Name", "Beschreibung"
   :widths: 25, 75

"""
}
    row = '   ":ref:`{0} <{1}>`", "{2}"'
    rows = []

    for device_info in sorted(device_infos, key=lambda x: x.short_display_name.lower()):
        if device_info.is_documented and not device_info.is_discontinued:
            rows.append(row.format(device_info.short_display_name, device_info.ref_name, device_info.description[lang].replace('"', "inch")))

    return table_head[lang] + '\n'.join(rows) + '\n'

def make_discontinued_products_table():
    table_head = {
    'en': """
.. csv-table::
 :header: Name, Description
 :delim: |
 :widths: 25, 75

 **Bricks** |
{0}
 |
 **Bricklets** |
{1}
 |
 **Master Extensions** |
{2}
""",
# FIXME
#"""
# |
# **Power Supplies** |
#{3}
# |
# **Accessories** |
#{4}
#"""
    'de': """
.. csv-table::
 :header: Name, Beschreibung
 :delim: |
 :widths: 25, 75

 **Bricks** |
{0}
 |
 **Bricklets** |
{1}
 |
 **Master Extensions** |
{2}
"""
# FIXME
#"""
# |
# **Stromversorgungen** |
#{3}
# |
# **Zubehör** |
#{4}
#"""
    }
    row = ' :ref:`{0} <{1}>` | {2}'
    brick_rows = []
    bricklet_rows = []
    extension_rows = []
    power_supply_rows = []

    for brick_info in sorted(brick_infos, key=lambda x: x.short_display_name.lower()):
        if brick_info.is_documented and brick_info.is_discontinued:
            brick_rows.append(row.format(brick_info.short_display_name, brick_info.ref_name, brick_info.description[lang].replace('"', "inch")))

    for bricklet_info in sorted(bricklet_infos, key=lambda x: x.short_display_name.lower()):
        if bricklet_info.is_documented and bricklet_info.is_discontinued:
            bricklet_rows.append(row.format(bricklet_info.short_display_name, bricklet_info.ref_name, bricklet_info.description[lang].replace('"', "inch")))

    for extension_info in sorted(extension_infos, key=lambda x: x.short_display_name.lower()):
        if extension_info.is_documented and extension_info.is_discontinued:
            extension_rows.append(row.format(extension_info.short_display_name, extension_info.ref_name, extension_info.description[lang].replace('"', "inch")))

    for power_supply_info in sorted(power_supply_infos, key=lambda x: x.short_display_name.lower()):
        if power_supply_info.is_documented and power_supply_info.is_discontinued:
            power_supply_rows.append(row.format(power_supply_info.short_display_name, power_supply_info.ref_name, power_supply_info.description[lang].replace('"', "inch")))

    return table_head[lang].format('\n'.join(brick_rows),
                                   '\n'.join(bricklet_rows),
                                   '\n'.join(extension_rows),
                                   '\n'.join(power_supply_rows))

def make_download_tools_table():
    source_code = {
    'en': 'Source Code',
    'de': 'Quelltext'
    }

    archive = {
    'en': 'Archive',
    'de': 'Archiv'
    }

    table_head = {
    'en': """.. csv-table::
 :header: Tool, Downloads, Version, Archive, Changelog
 :delim: |
 :widths: 22, 55, 7, 7, 9

""",
    'de': """.. csv-table::
 :header: Tool, Downloads, Version, Archiv, Changelog
 :delim: |
 :widths: 22, 55, 7, 7, 9

"""
    }

    row_brickd = ' :ref:`{0} <{1}>` | Linux (`amd64 <https://download.tinkerforge.com/tools/{1}/linux/{1}-{4}.{5}.{6}_amd64.deb>`__, `i386 <https://download.tinkerforge.com/tools/{1}/linux/{1}-{4}.{5}.{6}_i386.deb>`__, `armhf <https://download.tinkerforge.com/tools/{1}/linux/{1}-{4}.{5}.{6}_armhf.deb>`__, `arm64 <https://download.tinkerforge.com/tools/{1}/linux/{1}-{4}.{5}.{6}_arm64.deb>`__, `RED Brick <https://download.tinkerforge.com/tools/{1}/linux/{1}-{4}.{5}.{6}+redbrick_armhf.deb>`__), `Windows <https://download.tinkerforge.com/tools/{1}/windows/{1}_windows_{4}_{5}_{6}.exe>`__, `macOS <https://download.tinkerforge.com/tools/{1}/macos/{1}_macos_{4}_{5}_{6}.dmg>`__, `{2} <https://github.com/Tinkerforge/{1}/archive/v{4}.{5}.{6}.zip>`__ | {4}.{5}.{6} | `{3} <https://download.tinkerforge.com/tools/{1}/>`__ | `Changelog <https://raw.githubusercontent.com/Tinkerforge/{1}/master/src/changelog>`__'
    row_brick_flash = ' :ref:`{0} <{1}>` | `Linux <https://download.tinkerforge.com/tools/{1}/linux/{1}-{4}.{5}.{6}_all.deb>`__, `{2} <https://github.com/Tinkerforge/brickv/archive/brick-flash-{4}.{5}.{6}.zip>`__ | {4}.{5}.{6} | `{3} <https://download.tinkerforge.com/tools/{1}/>`__ | `Changelog <https://raw.githubusercontent.com/Tinkerforge/brickv/master/src/changelog.brick-flash>`__'
    row_brick_logger = ' :ref:`{0} <{1}>` | `Linux, Windows, macOS <https://download.tinkerforge.com/tools/{1}/{1}_{4}_{5}_{6}.zip>`__, `RED Brick <https://download.tinkerforge.com/tools/{1}/{1}_{4}_{5}_{6}.tfrba>`__, `{2} <https://github.com/Tinkerforge/brickv/archive/brick-logger-{4}.{5}.{6}.zip>`__ | {4}.{5}.{6} | `{3} <https://download.tinkerforge.com/tools/{1}/>`__ | `Changelog <https://raw.githubusercontent.com/Tinkerforge/brickv/master/src/changelog.brick-logger>`__'
    row_other = ' :ref:`{0} <{1}>` | `Linux <https://download.tinkerforge.com/tools/{1}/linux/{1}-{4}.{5}.{6}_all.deb>`__, `Windows <https://download.tinkerforge.com/tools/{1}/windows/{1}_windows_{4}_{5}_{6}.exe>`__, `macOS <https://download.tinkerforge.com/tools/{1}/macos/{1}_macos_{4}_{5}_{6}.dmg>`__, `{2} <https://github.com/Tinkerforge/{1}/archive/v{4}.{5}.{6}.zip>`__ | {4}.{5}.{6} | `{3} <https://download.tinkerforge.com/tools/{1}/>`__ | `Changelog <https://raw.githubusercontent.com/Tinkerforge/{1}/master/src/changelog>`__'
    rows = []

    for tool_info in tool_infos:
        if tool_info.url_part == 'brickd':
            row = row_brickd
        elif tool_info.url_part == 'brick_flash':
            row = row_brick_flash
        elif tool_info.url_part == 'brick_logger':
            row = row_brick_logger
        else:
            row = row_other

        rows.append(row.format(tool_info.display_name,
                               tool_info.url_part,
                               source_code[lang],
                               archive[lang],
                               *tool_versions[tool_info.url_part]))

    return table_head[lang] + '\n'.join(rows) + '\n'

def make_download_bindings_table():
    bindings_and_examples = {
    'en': 'Bindings and Examples',
    'de': 'Bindings und Beispiele'
    }

    archive = {
    'en': 'Archive',
    'de': 'Archiv'
    }

    table_head = {
    'en': """.. csv-table::
 :header: Language, Downloads, Version, Archive, Changelog
 :delim: |
 :widths: 22, 55, 7, 7, 9

""",
    'de': """.. csv-table::
 :header: Sprache, Downloads, Version, Archiv, Changelog
 :delim: |
 :widths: 22, 55, 7, 7, 9

"""
    }

    row = ' :ref:`{0} <api_bindings_{1}>` | `{3} <https://download.tinkerforge.com/bindings/{1}/tinkerforge_{1}_bindings_{4}_{5}_{6}.zip>`__ | {4}.{5}.{6} | `{2} <https://download.tinkerforge.com/bindings/{1}/>`__ | `Changelog <https://raw.githubusercontent.com/Tinkerforge/generators/master/{1}/changelog.txt>`__'
    rows = []

    for bindings_info in bindings_infos:
        if not bindings_info.is_released or not bindings_info.has_download:
            continue

        rows.append(row.format(bindings_info.display_name[lang],
                               bindings_info.url_part,
                               archive[lang],
                               bindings_and_examples[lang],
                               *bindings_versions[bindings_info.url_part]))

    return table_head[lang] + '\n'.join(rows) + '\n'

def make_download_red_images_table():
    archive = {
    'en': 'Archive',
    'de': 'Archiv'
    }

    table_head = {
    'en': """.. csv-table::
 :header: Type, Downloads, Version, Archive, Changelog
 :delim: |
 :widths: 22, 55, 7, 7, 9

""",
    'de': """.. csv-table::
 :header: Typ, Downloads, Version, Archiv, Changelog
 :delim: |
 :widths: 22, 55, 7, 7, 9

"""
    }

    row = ' RED Brick Image | `Image <https://download.tinkerforge.com/red_images/{0}/red_image_{2}_{3}_{0}.img.7z>`__ | {2}.{3} | `{1} <https://download.tinkerforge.com/red_images/{0}/>`__ | `Changelog <https://raw.githubusercontent.com/Tinkerforge/red-brick/master/image/changelog_{0}>`__'
    rows = []

    for image in ['full']:
        rows.append(row.format(image,
                               archive[lang],
                               *red_image_versions[image]))

    return table_head[lang] + '\n'.join(rows) + '\n'

def make_download_brick_firmwares_table():
    archive = {
    'en': 'Archive',
    'de': 'Archiv'
    }

    source_code = {
    'en': 'Source Code',
    'de': 'Quelltext'
    }

    table_head = {
    'en': """.. csv-table::
 :header: Brick, Downloads, Version, Archive, Changelog
 :delim: |
 :widths: 22, 55, 7, 7, 9

""",
    'de': """.. csv-table::
 :header: Brick, Downloads, Version, Archiv, Changelog
 :delim: |
 :widths: 22, 55, 7, 7, 9

"""
    }

    row = ' :ref:`{0} <{1}>` | `Firmware <https://download.tinkerforge.com/firmwares/{6}s/{2}/{6}_{2}_firmware_{8}_{9}_{10}.{7}>`__, `{3} <https://github.com/Tinkerforge/{4}/archive/{11}{8}.{9}.{10}.zip>`__ | {8}.{9}.{10} | `{5} <https://download.tinkerforge.com/firmwares/{6}s/{2}/>`__ | `Changelog <https://raw.githubusercontent.com/Tinkerforge/{4}/master/software/changelog{12}>`__'
    rows = []

    for brick_info in sorted(brick_infos, key=lambda x: x.short_display_name.lower()):
        if brick_info.firmware_url_part != None and brick_info.is_documented:
            if brick_info.has_comcu:
                firmware_version = plugin_versions.get(brick_info.firmware_url_part, (0,0,0))
                category = 'bricklet'
                extension = 'zbin'
            else:
                firmware_version = firmware_versions.get(brick_info.firmware_url_part, (0,0,0))
                category = 'brick'
                extension = 'bin'

            if brick_info.esp32_firmware != None:
                git_name = 'esp32-firmware'
                git_tag_prefix = brick_info.esp32_firmware + '-'
                changelog_suffix = '_' + brick_info.esp32_firmware + '.txt'
            else:
                git_name = brick_info.git_name
                git_tag_prefix = 'v'
                changelog_suffix = ''

            rows.append(row.format(brick_info.short_display_name,
                                   brick_info.ref_name,
                                   brick_info.firmware_url_part,
                                   source_code[lang],
                                   git_name,
                                   archive[lang],
                                   category,
                                   extension,
                                   firmware_version[0],
                                   firmware_version[1],
                                   firmware_version[2],
                                   git_tag_prefix,
                                   changelog_suffix))

    return table_head[lang] + '\n'.join(rows) + '\n'

def make_download_bricklet_plugins_table():
    archive = {
    'en': 'Archive',
    'de': 'Archiv'
    }

    source_code = {
    'en': 'Source Code',
    'de': 'Quelltext'
    }

    table_head = {
    'en': """.. csv-table::
 :header: Bricklet, Downloads, Version, Archive, Changelog
 :delim: |
 :widths: 22, 55, 7, 7, 9

""",
    'de': """.. csv-table::
 :header: Bricklet, Downloads, Version, Archiv, Changelog
 :delim: |
 :widths: 22, 55, 7, 7, 9

"""
    }

    row = ' :ref:`{0} <{1}>` | `Plugin <https://download.tinkerforge.com/firmwares/bricklets/{2}/bricklet_{2}_firmware_{7}_{8}_{9}.{6}>`__, `{3} <https://github.com/Tinkerforge/{4}/archive/{10}{7}.{8}.{9}.zip>`__ | {7}.{8}.{9} | `{5} <https://download.tinkerforge.com/firmwares/bricklets/{2}/>`__ | `Changelog <https://raw.githubusercontent.com/Tinkerforge/{4}/master/software/changelog{11}>`__'
    rows = []

    for bricklet_info in sorted(bricklet_infos, key=lambda x: x.short_display_name.lower()):
        if bricklet_info.firmware_url_part != None and bricklet_info.is_documented:
            subversion = []

            if bricklet_info.firmware_url_part == 'lcd_20x4':
                subversion.append((bricklet_info.short_display_name + ' 1.1', bricklet_info.firmware_url_part + '_v11'))
                subversion.append((bricklet_info.short_display_name + ' 1.2', bricklet_info.firmware_url_part + '_v12'))
            else:
                subversion.append((bricklet_info.short_display_name, bricklet_info.firmware_url_part))

            if bricklet_info.esp32_firmware != None:
                git_name = 'esp32-firmware'
                git_tag_prefix = bricklet_info.esp32_firmware + '-'
                changelog_suffix = '_' + bricklet_info.esp32_firmware + '.txt'
            else:
                git_name = bricklet_info.git_name
                git_tag_prefix = 'v'
                changelog_suffix = ''

            for short_display_name, firmware_url_part in subversion:
                plugin_version = plugin_versions.get(firmware_url_part, (0, 0, 0))

                rows.append(row.format(short_display_name,
                                       bricklet_info.ref_name,
                                       firmware_url_part,
                                       source_code[lang],
                                       git_name,
                                       archive[lang],
                                       'zbin' if bricklet_info.has_comcu else 'bin',
                                       plugin_version[0],
                                       plugin_version[1],
                                       plugin_version[2],
                                       git_tag_prefix,
                                       changelog_suffix))

    return table_head[lang] + '\n'.join(rows) + '\n'

def make_download_extension_firmwares_table():
    archive = {
    'en': 'Archive',
    'de': 'Archiv'
    }

    source_code = {
    'en': 'Source Code',
    'de': 'Quelltext'
    }

    table_head = {
    'en': """.. csv-table::
 :header: Extension, Downloads, Version, Archive, Changelog
 :delim: |
 :widths: 22, 55, 7, 7, 9

""",
    'de': """.. csv-table::
 :header: Extension, Downloads, Version, Archiv, Changelog
 :delim: |
 :widths: 22, 55, 7, 7, 9

"""
    }

    row = ' :ref:`{0} <{1}>` | `Firmware <https://download.tinkerforge.com/firmwares/extensions/{2}/extension_{2}_firmware_{6}_{7}_{8}.zbin>`__, `{3} <https://github.com/Tinkerforge/{4}/archive/v{6}.{7}.{8}.zip>`__ | {6}.{7}.{8} | `{5} <https://download.tinkerforge.com/firmwares/extensions/{2}/>`__ | `Changelog <https://raw.githubusercontent.com/Tinkerforge/{4}/master/software/changelog>`__'
    rows = []

    for extension_info in sorted(extension_infos, key=lambda x: x.short_display_name.lower()):
        if extension_info.firmware_url_part != None and extension_info.is_documented:
            extension_version = extension_versions.get(extension_info.firmware_url_part, (0,0,0))

            rows.append(row.format(extension_info.short_display_name,
                                   extension_info.ref_name,
                                   extension_info.firmware_url_part,
                                   source_code[lang],
                                   extension_info.git_name,
                                   archive[lang],
                                   *extension_version))

    return table_head[lang] + '\n'.join(rows) + '\n'

def make_download_kits_table():
    source_code = {
    'en': 'Source Code',
    'de': 'Quelltext'
    }

    archive = {
    'en': 'Archive',
    'de': 'Archiv'
    }

    table_head = {
    'en': """.. csv-table::
 :header: Kit, Downloads, Version, Archive, Changelog
 :delim: |
 :widths: 22, 55, 7, 7, 9

""",
    'de': """.. csv-table::
 :header: Kit, Downloads, Version, Archiv, Changelog
 :delim: |
 :widths: 22, 55, 7, 7, 9

"""
    }

    row = ' :ref:`{0} <{5}{1}>` | `Linux <https://download.tinkerforge.com/kits/{1}/linux/{6}{2}-demo-{7}.{8}.{9}_all.deb>`__, `Windows <https://download.tinkerforge.com/kits/{1}/windows/{5}{1}_demo_windows_{7}_{8}_{9}.exe>`__, `macOS <https://download.tinkerforge.com/kits/{1}/macos/{5}{1}_demo_macos_{7}_{8}_{9}.dmg>`__, `{3} <https://github.com/Tinkerforge/{2}/archive/demo-{7}.{8}.{9}.zip>`__ | {7}.{8}.{9} | `{4} <https://download.tinkerforge.com/kits/{1}/>`__ | `Changelog <https://raw.githubusercontent.com/Tinkerforge/{2}/master/demo/changelog>`__'
    rows = []

    for kit_info in kit_infos:
        if not kit_info.released:
            continue

        rows.append(row.format(kit_info.display_name[lang],
                               kit_info.url_part,
                               kit_info.url_part.replace('_', '-'),
                               source_code[lang],
                               archive[lang],
                               kit_info.prefix,
                               kit_info.prefix.replace('_', '-'),
                               *kit_versions[kit_info.url_part]))

    return table_head[lang] + '\n'.join(rows) + '\n'

def make_api_bindings_links_table(bindings_info):
    table_head = {
    'en': """.. csv-table::
 :header: Name, API, Examples
 :delim: |
 :widths: 20, 10, 10

{0}
""",
    'de': """.. csv-table::
 :header: , API, Beispiele
 :delim: |
 :widths: 20, 10, 10

{0}
"""
    }

    misc_with_examples_row = {
    'en': ' :ref:`{0} <{1}>` | :ref:`API <{1}_api>` | :ref:`Examples <{1}_examples>`',
    'de': ' :ref:`{0} <{1}>` | :ref:`API <{1}_api>` | :ref:`Beispiele <{1}_examples>`'
    }

    misc_without_examples_row = {
    'en': ' :ref:`{0} <{1}>` | :ref:`API <{1}_api>` |',
    'de': ' :ref:`{0} <{1}>` | :ref:`API <{1}_api>` |'
    }

    device_with_examples_row = {
    'en': ' :ref:`{2} <{0}>` | :ref:`API <{0}_{1}_api>` | :ref:`Examples <{0}_{1}_examples>`',
    'de': ' :ref:`{2} <{0}>` | :ref:`API <{0}_{1}_api>` | :ref:`Beispiele <{0}_{1}_examples>`'
    }

    device_without_examples_row = {
    'en': ' :ref:`{2} <{0}>` | :ref:`API <{0}_{1}_api>` |',
    'de': ' :ref:`{2} <{0}>` | :ref:`API <{0}_{1}_api>` |'
    }

    brick_lines = [[], []]
    for brick_info in sorted(brick_infos, key=lambda x: x.short_display_name.lower()):
        if not brick_info.is_documented or not brick_info.has_bindings:
            continue

        if not bindings_info.is_hardware_supported(brick_info):
            continue

        if has_examples[brick_info.identifier][bindings_info.url_part]:
            device_row = device_with_examples_row
        else:
            device_row = device_without_examples_row

        line = device_row[lang].format(brick_info.ref_name, bindings_info.url_part, brick_info.short_display_name)

        if not brick_info.is_discontinued:
            brick_lines[0].append(line)
        else:
            brick_lines[1].append(line)

    bricklet_lines = [[], []]
    for bricklet_info in sorted(bricklet_infos, key=lambda x: x.short_display_name.lower()):
        if not bricklet_info.is_documented or not bricklet_info.has_bindings:
            continue

        if not bindings_info.is_hardware_supported(bricklet_info):
            continue

        if has_examples[bricklet_info.identifier][bindings_info.url_part]:
            device_row = device_with_examples_row
        else:
            device_row = device_without_examples_row

        line = device_row[lang].format(bricklet_info.ref_name, bindings_info.url_part, bricklet_info.short_display_name)

        if not bricklet_info.is_discontinued:
            bricklet_lines[0].append(line)
        else:
            bricklet_lines[1].append(line)

    misc_lines = []
    for m in bindings_info.misc_docs:
        if not m.show_in_api_table:
            continue
        if m.has_examples:
            misc_lines.append(misc_with_examples_row[lang].format(m.name_dict[lang], m.rst_link.format(suffix=bindings_info.software_doc_suffix)))
        else:
            misc_lines.append(misc_without_examples_row[lang].format(m.name_dict[lang], m.rst_link.format(suffix=bindings_info.software_doc_suffix)))

    subtables = []
    for name, subtable in [
                     ({'en': 'Miscellaneous', 'de': 'Sonstiges'}, misc_lines),
                     ({'en': 'Bricks', 'de': 'Bricks'}, brick_lines[0]),
                     ({'en': 'Bricks (Discontinued)', 'de': 'Bricks (Abgekündigt)'}, brick_lines[1]),
                     ({'en': 'Bricklets', 'de': 'Bricklets'}, bricklet_lines[0]),
                     ({'en': 'Bricklets (Discontinued)', 'de': 'Bricklets (Abgekündigt)'}, bricklet_lines[1]),
                     ]:
        if len(subtable) > 0:
            template = """ **{name}** | |
{lines}"""
            subtables.append(template.format(name=name[lang], lines='\n'.join(subtable)))

    return table_head[lang].format('\n | |\n'.join(subtables))

def make_llproto_links_table(bindings_info):
    table_head = {
    'en': """.. csv-table::
 :header: , API
 :delim: |
 :widths: 20, 20

{0}
""",
    'de': """.. csv-table::
 :header: , API
 :delim: |
 :widths: 20, 20

{0}
"""
    }

    device_row = {
    'en': ' :ref:`{2} <{0}>` | :ref:`API <{0}_{1}_api>`',
    'de': ' :ref:`{2} <{0}>` | :ref:`API <{0}_{1}_api>`'
    }

    brick_lines = []
    for brick_info in sorted(brick_infos, key=lambda x: x.short_display_name.lower()):
        if brick_info.is_documented and brick_info.has_bindings and bindings_info.is_hardware_supported(brick_info):
            brick_lines.append(device_row[lang].format(brick_info.ref_name, bindings_info.url_part, brick_info.short_display_name))

    bricklet_lines = []
    for bricklet_info in sorted(bricklet_infos, key=lambda x: x.short_display_name.lower()):
        if bricklet_info.is_documented and bricklet_info.has_bindings and bindings_info.is_hardware_supported(bricklet_info):
            bricklet_lines.append(device_row[lang].format(bricklet_info.ref_name, bindings_info.url_part, bricklet_info.short_display_name))

    subtables = []
    for name, subtable in [({'en': 'Bricks', 'de': 'Bricks'}, brick_lines),
                     ({'en': 'Bricklets', 'de': 'Bricklets'}, bricklet_lines),
                     ]:
        if len(subtable) > 0:
            template = """ **{name}** |
{lines}"""
            subtables.append(template.format(name=name[lang], lines='\n'.join(subtable)))

    return table_head[lang].format('\n |\n'.join(subtables))

def make_api_bindings_devices_table(bindings_info, device_infos, category, discontinued):
    table_head = {
    'en': """.. csv-table::
 :header: {0}, API, Examples
 :delim: |
 :widths: 20, 10, 10

{1}
""",
    'de': """.. csv-table::
 :header: {0}, API, Beispiele
 :delim: |
 :widths: 20, 10, 10

{1}
"""
    }

    device_with_examples_row = {
    'en': ' :ref:`{2} <{0}>` | :ref:`API <{0}_{1}_api>` | :ref:`Examples <{0}_{1}_examples>`',
    'de': ' :ref:`{2} <{0}>` | :ref:`API <{0}_{1}_api>` | :ref:`Beispiele <{0}_{1}_examples>`'
    }

    device_without_examples_row = {
    'en': ' :ref:`{2} <{0}>` | :ref:`API <{0}_{1}_api>` |',
    'de': ' :ref:`{2} <{0}>` | :ref:`API <{0}_{1}_api>` |'
    }

    lines = []
    for device_info in sorted(device_infos, key=lambda x: x.short_display_name.lower()):
        if not bindings_info.is_hardware_supported(device_info):
            continue
        if device_info.is_documented and device_info.has_bindings and device_info.is_discontinued == discontinued:
            if has_examples[device_info.identifier][bindings_info.url_part]:
                device_row = device_with_examples_row
            else:
                device_row = device_without_examples_row

            lines.append(device_row[lang].format(device_info.ref_name, bindings_info.url_part, device_info.short_display_name))

    if len(lines) > 0:
        return table_head[lang].format(category, '\n'.join(lines))
    return ''

def make_llproto_devices_table(bindings_info, device_infos, category, discontinued):
    table_head = {
    'en': """.. csv-table::
 :header: {0}, API
 :delim: |
 :widths: 20, 20

{1}
""",
    'de': """.. csv-table::
 :header: {0}, API
 :delim: |
 :widths: 20, 20

{1}
"""
    }

    device_row = {
    'en': ' :ref:`{2} <{0}>` | :ref:`API <{0}_{1}_api>`',
    'de': ' :ref:`{2} <{0}>` | :ref:`API <{0}_{1}_api>`'
    }

    lines = []
    for device_info in sorted(device_infos, key=lambda x: x.short_display_name.lower()):
        if not bindings_info.is_hardware_supported(device_info):
            continue
        if device_info.is_documented and device_info.has_bindings and device_info.is_discontinued == discontinued:
            lines.append(device_row[lang].format(device_info.ref_name, bindings_info.url_part, device_info.short_display_name))

    if len(lines) > 0:
        return table_head[lang].format(category, '\n'.join(lines))
    return ''

def make_source_code_gits_table():
    table_head = {
    'en': """.. csv-table::
 :header: Name, Repository, Bug Tracking
 :delim: |
 :widths: 20, 23, 12

 **Tools** | |
 Brick Daemon | `brickd.git <https://github.com/Tinkerforge/brickd/>`__ | `Report Bug <https://github.com/Tinkerforge/brickd/issues>`__
 Brick Viewer | `brickv.git <https://github.com/Tinkerforge/brickv/>`__ | `Report Bug <https://github.com/Tinkerforge/brickv/issues>`__
 Brick Bootloader | `brickboot.git <https://github.com/Tinkerforge/brickboot/>`__ | `Report Bug <https://github.com/Tinkerforge/brickboot/issues>`__
 Brick Library | `bricklib.git <https://github.com/Tinkerforge/bricklib/>`__ | `Report Bug <https://github.com/Tinkerforge/bricklib/issues>`__
 Bricklet Library | `brickletlib.git <https://github.com/Tinkerforge/brickletlib/>`__ | `Report Bug <https://github.com/Tinkerforge/brickletlib/issues>`__
 API Generator | `generators.git <https://github.com/Tinkerforge/generators/>`__ | `Report Bug <https://github.com/Tinkerforge/generators/issues>`__
 KiCad Libraries | `kicad-libraries.git <https://github.com/Tinkerforge/kicad-libraries/>`__ | `Report Bug <https://github.com/Tinkerforge/kicad-libraries/issues>`__
 | |
 **Bricks** | |
{0}
 | |
 **Bricklets** | |
{1}
 | |
 **Master Extensions** | |
{2}
 | |
 **Power Supplies** | |
{3}

""",
    'de': """.. csv-table::
 :header: , Repository, Bug Tracking
 :delim: |
 :widths: 20, 23, 12

 **Tools** | |
 Brick Daemon | `brickd.git <https://github.com/Tinkerforge/brickd/>`__ | `Problem melden <https://github.com/Tinkerforge/brickd/issues>`__
 Brick Viewer | `brickv.git <https://github.com/Tinkerforge/brickv/>`__ | `Problem melden <https://github.com/Tinkerforge/brickv/issues>`__
 Brick Bootloader | `brickboot.git <https://github.com/Tinkerforge/brickboot/>`__ | `Problem melden <https://github.com/Tinkerforge/brickboot/issues>`__
 Brick Library | `bricklib.git <https://github.com/Tinkerforge/bricklib/>`__ | `Problem melden <https://github.com/Tinkerforge/bricklib/issues>`__
 Bricklet Library | `brickletlib.git <https://github.com/Tinkerforge/brickletlib/>`__ | `Problem melden <https://github.com/Tinkerforge/brickletlib/issues>`__
 API Generator | `generators.git <https://github.com/Tinkerforge/generators/>`__ | `Problem melden <https://github.com/Tinkerforge/generators/issues>`__
 KiCad Libraries | `kicad-libraries.git <https://github.com/Tinkerforge/kicad-libraries/>`__ | `Problem melden <https://github.com/Tinkerforge/kicad-libraries/issues>`__
 | |
 **Bricks** | |
{0}
 | |
 **Bricklets** | |
{1}
 | |
 **Master Extensions** | |
{2}
 | |
 **Stromversorgungen** | |
{3}

"""
    }

    row = {
    'en': ' {0} | `{1}.git <https://github.com/Tinkerforge/{1}/>`__ | `Report Bug <https://github.com/Tinkerforge/{1}/issues>`__',
    'de': ' {0} | `{1}.git <https://github.com/Tinkerforge/{1}/>`__ | `Problem melden <https://github.com/Tinkerforge/{1}/issues>`__',
    }

    brick_rows = []
    bricklet_rows = []
    extension_rows = []
    power_supply_rows = []

    for brick_info in sorted(brick_infos, key=lambda x: x.short_display_name.lower()):
        if brick_info.is_documented:
            brick_rows.append(row[lang].format(brick_info.short_display_name, brick_info.git_name))

    for bricklet_info in sorted(bricklet_infos, key=lambda x: x.short_display_name.lower()):
        if bricklet_info.is_documented:
            bricklet_rows.append(row[lang].format(bricklet_info.short_display_name, bricklet_info.git_name))

    for extension_info in sorted(extension_infos, key=lambda x: x.short_display_name.lower()):
        if extension_info.is_documented:
            extension_rows.append(row[lang].format(extension_info.short_display_name, extension_info.git_name))

    for power_supply_info in sorted(power_supply_infos, key=lambda x: x.short_display_name.lower()):
        if power_supply_info.is_documented:
            power_supply_rows.append(row[lang].format(power_supply_info.short_display_name, power_supply_info.git_name))

    return table_head[lang].format('\n'.join(brick_rows),
                                   '\n'.join(bricklet_rows),
                                   '\n'.join(extension_rows),
                                   '\n'.join(power_supply_rows))

def make_index_hardware_device(device_infos, category):
    hardware_li = """<li><a class="reference internal" href="Hardware/{1}/{2}.html">{0}</a></li>"""
    lis = []

    for device_info in sorted(device_infos, key=lambda x: x.short_display_name.lower()):
        if device_info.is_documented and not device_info.is_discontinued:
            lis.append(hardware_li.format(device_info.short_display_name, category, device_info.hardware_doc_name))

    if category == 'Bricklets':
        split = int(math.ceil(len(lis) / 3.0))
    else:
        split = 15

    ret = ''

    while len(lis) > 0:
        if category in ['Bricks', 'Bricklets']:
            ret += '\n<div class="category_content_inner">\n<ul>' +'\n'.join(lis[:split]) + '</ul>\n</div>'
        else:
            ret += '\n<ul>' +'\n'.join(lis[:split]) + '</ul>\n'

        lis = lis[split:]

    return ret

def make_index_hardware():
    index_html_en = """
<div class="category_hardware_outer">
    <div class="category_body">
        <div class="category_content">
            <h3>Bricks</h3>
            {0}
        </div>
        <div class="category_content">
            <h3>Bricklets</h3>
            {1}
        </div>
        <div class="category_content">
            <h3>Master Extensions</h3>
            {2}
            <h3>Power Supplies</h3>
            {3}
        </div>
    </div>
</div>
<div style="clear: both;"></div>
"""

    index_html = {
    'en': index_html_en,
    'de': index_html_en.replace('Power Supplies', 'Stromversorgungen')
    }

    return index_html[lang].format(make_index_hardware_device(brick_infos, 'Bricks'),
                                   make_index_hardware_device(bricklet_infos, 'Bricklets'),
                                   make_index_hardware_device(extension_infos, 'Master_Extensions'),
                                   make_index_hardware_device(power_supply_infos, 'Power_Supplies'))

def make_index_api_device(device_infos, category, language):
    li = '<li><a class="reference internal" href="Software/{1}/{2}_{3}.html">{0}</a></li>'
    lis = []

    for device_info in sorted(device_infos, key=lambda x: x.short_display_name.lower()):
        if device_info.is_documented and device_info.has_bindings and not device_info.is_discontinued:
            lis.append(li.format(device_info.short_display_name, category, device_info.software_doc_prefix, language))

    if category == 'Bricklets':
        split = int(math.ceil(len(lis) / 4.0))
    else:
        split = 15

    ret = ''
    while len(lis) > 0:
        if category == 'Bricklets':
            ret += '\n<div class="category_content_inner">\n<ul>' +'\n'.join(lis[:split]) + '</ul>\n</div>'
        else:
            ret += '\n<ul>' +'\n'.join(lis[:split]) + '</ul>\n'

        lis = lis[split:]

    return ret

def make_index_api_misc(binding, lang):
    misc_html = """
<ul>
    {0}
</ul>
"""
    llp_html_en = """
<ul>
    <li><a class="reference internal" href="Low_Level_Protocols/{0}.html">Specification</a></li>
</ul>
"""
    misc_li = '<li><a class="reference internal" href="Software/{0}.html">{1}</a></li>'

    llp_html = {
    'en': llp_html_en,
    'de': llp_html_en.replace('Specification', 'Spezifikation')
    }

    if not binding.is_programming_language:
        return llp_html[lang].format(binding.software_doc_suffix)
    else:
        misc_lis = []

        for misc_doc in binding.misc_docs:
            misc_lis.append(misc_li.format(misc_doc.html_link.format(suffix=binding.software_doc_suffix), misc_doc.name_dict[lang]))

        return misc_html.format('\n'.join(misc_lis))

    return ''

def make_index_api():
    index_html = """
<div class="category_api">
    <div class="category_head tf-btn-more tf-btn-more-down">
        <a name="software-{4}"></a>
        {3}
    </div>
    <div class="category_body" {5}>
        <div class="category_content">
            <h3>Bricks</h3>
            {0}
            <h3>{6}</h3>
            {1}
        </div>
        <div class="category_content">
            <h3>Bricklets</h3>
            {2}
        </div>

        <p>{7}</p>
    </div>
</div>
<div style="clear: both;"></div>
"""

    script_html = r"""
<script type="text/javascript">
    var togglingContent = false;

    $(document).ready(function () {
        $(".category_head").click(function() {
            toggleContent($(this).parent(), 100);
        });

        updateContent(0);
    });

    $(window).on("hashchange", function () {
        if (!togglingContent) {
            updateContent(100);
        }
    });

    function updateContent(duration) {
        anchorName = location.hash.replace(/^[^#]*#/, '').replace(/^#+|#+$/, '').replace(/^\/*/, '').replace(/-open$/, '')

        if (anchorName.length > 0 && anchorName.substring(0, 9) === "software-" && anchorName !== "software-none") {
            a = $("a[name="+anchorName+"]")

            if (a.length > 0) {
                toggleContent(a.parent().parent(), duration, true);
                return;
            }
        }

        $(".tf-btn-more").parent().find(".category_body").slideUp(duration);
        $(".tf-btn-more").removeClass("tf-btn-more-up").addClass("tf-btn-more-down");
    }

    function toggleContent(parent, duration, forceShow) {
        togglingContent = true;

        categoryBody = parent.find(".category_body")
        btnMore = parent.find(".tf-btn-more")

        if (categoryBody.is(":hidden") || forceShow === true) {
            anchorName = categoryBody.parent().find(".category_head a").attr("name")

            // only set hash, if it doesn't point to the current category already
            if (location.hash.indexOf(anchorName) < 0) {
                location.hash = "/" + anchorName + "-open";
            }

            $(".tf-btn-more").parent().find(".category_body").slideUp(duration);
            $(".tf-btn-more").removeClass("tf-btn-more-up").addClass("tf-btn-more-down");

            btnMore.removeClass("tf-btn-more-down").addClass("tf-btn-more-up");

            // this has to be the last line and after the hash change
            categoryBody.slideDown(duration, function() { togglingContent = false });
        }
        else {
            btnMore.removeClass("tf-btn-more-up").addClass("tf-btn-more-down");

            if (/software-/.test(location.hash)) {
                location.hash = "/software-none-open";
            }

            // this has to be the last line and after the hash change
            categoryBody.slideUp(duration, function() { togglingContent = false });
        }
    }
</script>
"""

    misc = {
    'en': 'Miscellaneous',
    'de': 'Sonstiges'
    }

    discontinued_p = {
    'en': 'There is an extra section for discontinued {0} and {1}.',
    'de': 'Es gibt einen extra Abschnitt für abgekündigte {0} und {1}.'
    }

    discontinued_a = '<a class="reference internal" href="{0}/{1}_{2}_Discontinued.html">{1}</a>'

    html = '<div class="category_api_outer">'
    first = True

    for bindings_info in bindings_infos:
        if bindings_info.is_released:
            if first:
                first = False
                style = ''
            else:
                style = ' style="display: none;"'

            if bindings_info.is_programming_language:
                directory = 'Software'
            else:
                directory = 'Low_Level_Protocols'

            html += index_html.format(make_index_api_device([x for x in brick_infos if bindings_info.is_hardware_supported(x)], 'Bricks', bindings_info.software_doc_suffix),
                                      make_index_api_misc(bindings_info, lang),
                                      make_index_api_device([x for x in bricklet_infos if bindings_info.is_hardware_supported(x)], 'Bricklets', bindings_info.software_doc_suffix),
                                      bindings_info.display_name[lang],
                                      bindings_info.url_part,
                                      style,
                                      misc[lang],
                                      discontinued_p[lang].format(discontinued_a.format(directory, 'Bricks', bindings_info.software_doc_suffix),
                                                                  discontinued_a.format(directory, 'Bricklets', bindings_info.software_doc_suffix)))

    return html + '</div>' + script_html

def make_hlpi_table(device_info):
    table_head = {
    'en': """
.. csv-table::
   :header: "Language", "API", "Examples", "Installation"
   :widths: 25, 10, 10, 10

""",
    'de': """
.. csv-table::
   :header: "Sprache", "API", "Beispiele", "Installation"
   :widths: 25, 10, 10, 10

"""
    }

    row_with_examples_source = {
    'en': '   "{0}", ":ref:`API <{1}_{2}_api>`", ":ref:`Examples <{1}_{2}_examples>`", ":ref:`Installation <api_bindings_{2}_install>`"',
    'de': '   "{0}", ":ref:`API <{1}_{2}_api>`", ":ref:`Beispiele <{1}_{2}_examples>`", ":ref:`Installation <api_bindings_{2}_install>`"'
    }

    row_without_examples_source = {
    'en': '   "{0}", ":ref:`API <{1}_{2}_api>`", , ":ref:`Installation <api_bindings_{2}_install>`"',
    'de': '   "{0}", ":ref:`API <{1}_{2}_api>`", , ":ref:`Installation <api_bindings_{2}_install>`"'
    }

    row = '   "{0}", ":ref:`API <{1}_{2}_api>`"'
    rows = []

    for bindings_info in bindings_infos:
        if not bindings_info.is_released:
            continue

        if not bindings_info.is_hardware_supported(device_info):
            continue

        if bindings_info.is_programming_language:
            if has_examples[device_info.identifier][bindings_info.url_part]:
                row_source = row_with_examples_source
            else:
                row_source = row_without_examples_source

            rows.append(row_source[lang].format(bindings_info.display_name[lang], device_info.ref_name, bindings_info.url_part))
        else:
            rows.append(row.format(bindings_info.display_name[lang], device_info.ref_name, bindings_info.url_part))

    return table_head[lang] + '\n'.join(rows) + '\n'

def make_device_identifier_table():
    table_head = {
    'en': """
.. csv-table::
   :header: "Device Identifier", "Device"
   :widths: 30, 100

""",
    'de': """
.. csv-table::
   :header: "Device Identifier", "Device"
   :widths: 30, 100

"""
    }

    row = '   "{0}", ":ref:`{1} <{2}>`"'
    rows = []

    for device_info in sorted(brick_infos + bricklet_infos, key=lambda x: x.identifier if x.identifier != None else -1):
        if device_info.is_documented and device_info.identifier != None:
            rows.append(row.format(device_info.identifier, device_info.long_display_name, device_info.ref_name))

    return table_head[lang] + '\n'.join(rows) + '\n'

def make_authentication_tutorial_examples_table():
    row = '* :ref:`{0} <ip_connection_{1}_examples>`'
    rows = []

    for bindings_info in bindings_infos:
        if bindings_info.has_authentication_example and bindings_info.is_released:
            rows.append(row.format(bindings_info.display_name[lang], bindings_info.url_part))

    return '\n'.join(rows) + '\n'

def make_hardware_devices_toctree(device_infos, discontinued):
    prefix = """
.. toctree::
   :hidden:

"""
    line = '   {0} <{1}>'
    lines = []

    for device_info in sorted(device_infos, key=lambda x: x.long_display_name.lower()):
        long_display_name = device_info.long_display_name

        if not device_info.is_documented:
            long_display_name = '~' + long_display_name

        if device_info.is_discontinued == discontinued:
            lines.append(line.format(long_display_name, device_info.hardware_doc_name))

    return prefix + '\n'.join(lines) + '\n'

def make_hardware_devices_table(device_infos, discontinued):
    table_head = {
    'en': """
.. csv-table::
   :header: "Name", "Description"
   :widths: 25, 75

""",
    'de': """
.. csv-table::
   :header: "Name", "Beschreibung"
   :widths: 25, 75

"""
}
    row = '   ":ref:`{0} <{1}>`", "{2}"'
    rows = []

    for device_info in sorted(device_infos, key=lambda x: x.short_display_name.lower()):
        if device_info.is_documented and device_info.is_discontinued == discontinued:
            rows.append(row.format(device_info.short_display_name, device_info.ref_name, device_info.description[lang].replace('"', "inch")))

    return table_head[lang] + '\n'.join(rows) + '\n'

def make_software_devices_toctree(bindings_info, device_infos, category, ref_prefix, discontinued):
    prefix = """
.. toctree::
   :hidden:

"""
    line = '   {0} <{1}{2}/{3}_{4}>'
    lines = []

    for device_info in sorted(device_infos, key=lambda x: x.short_display_name.lower()):
        if not bindings_info.is_hardware_supported(device_info):
            continue

        long_display_name = device_info.long_display_name

        if not device_info.is_documented:
            long_display_name = '~' + long_display_name

        if device_info.has_bindings and device_info.is_discontinued == discontinued:
            lines.append(line.format(long_display_name, ref_prefix, category, device_info.software_doc_prefix, bindings_info.software_doc_suffix))

    return prefix + '\n'.join(lines) + '\n'

def write_if_changed(path, content):
    if os.path.exists(path):
        with open(path, 'r') as f:
            existing = f.read()

        if existing == content:
            return

    with open(path, 'w') as f:
        f.write(content)

def generate(path):
    global lang

    if path.endswith('/en'):
        lang = 'en'
    elif path.endswith('/de'):
        lang = 'de'
    else:
        debug('Wrong working directory')
        sys.exit(1)

    collect_latest_version_info()
    collect_example_info(path)

    debug('Generating index_hardware.html')
    write_if_changed(os.path.join(path, 'source', 'index_hardware.html'), make_index_hardware())

    debug('Generating index_api.html')
    write_if_changed(os.path.join(path, 'source', 'index_api.html'), make_index_api())

    debug('Generating Primer_bricks.table')
    write_if_changed(os.path.join(path, 'source', 'Primer_bricks.table'), make_primer_table(brick_infos))

    debug('Generating Primer_bricklets.table')
    write_if_changed(os.path.join(path, 'source', 'Primer_bricklets.table'), make_primer_table(bricklet_infos))

    debug('Generating Primer_extensions.table')
    write_if_changed(os.path.join(path, 'source', 'Primer_extensions.table'), make_primer_table(extension_infos))

    debug('Generating Primer_power_supplies.table')
    write_if_changed(os.path.join(path, 'source', 'Primer_power_supplies.table'), make_primer_table(power_supply_infos))

    debug('Generating Downloads_tools.table')
    write_if_changed(os.path.join(path, 'source', 'Downloads_tools.table'), make_download_tools_table())

    debug('Generating Downloads_bindings.table')
    write_if_changed(os.path.join(path, 'source', 'Downloads_bindings.table'), make_download_bindings_table())

    debug('Generating Downloads_red_images.table')
    write_if_changed(os.path.join(path, 'source', 'Downloads_red_images.table'), make_download_red_images_table())

    debug('Generating Downloads_brick_firmwares.table')
    write_if_changed(os.path.join(path, 'source', 'Downloads_brick_firmwares.table'), make_download_brick_firmwares_table())

    debug('Generating Downloads_bricklet_plugins.table')
    write_if_changed(os.path.join(path, 'source', 'Downloads_bricklet_plugins.table'), make_download_bricklet_plugins_table())

    debug('Generating Downloads_extension_firmwares.table')
    write_if_changed(os.path.join(path, 'source', 'Downloads_extension_firmwares.table'), make_download_extension_firmwares_table())

    debug('Generating Downloads_kits.table')
    write_if_changed(os.path.join(path, 'source', 'Downloads_kits.table'), make_download_kits_table())

    debug('Generating Source_Code_gits.table')
    write_if_changed(os.path.join(path, 'source', 'Source_Code_gits.table'), make_source_code_gits_table())

    debug('Generating Bricks.toctree')
    write_if_changed(os.path.join(path, 'source', 'Hardware', 'Bricks', 'Bricks.toctree'), make_hardware_devices_toctree(brick_infos, False))

    debug('Generating Bricks_Discontinued.toctree')
    write_if_changed(os.path.join(path, 'source', 'Hardware', 'Bricks', 'Bricks_Discontinued.toctree'), make_hardware_devices_toctree(brick_infos, True))

    debug('Generating Bricklets.toctree')
    write_if_changed(os.path.join(path, 'source', 'Hardware', 'Bricklets', 'Bricklets.toctree'), make_hardware_devices_toctree(bricklet_infos, False))

    debug('Generating Bricklets_Discontinued.toctree')
    write_if_changed(os.path.join(path, 'source', 'Hardware', 'Bricklets', 'Bricklets_Discontinued.toctree'), make_hardware_devices_toctree(bricklet_infos, True))

    debug('Generating Master_Extensions.toctree')
    write_if_changed(os.path.join(path, 'source', 'Hardware', 'Master_Extensions', 'Master_Extensions.toctree'), make_hardware_devices_toctree(extension_infos, False))

    debug('Generating Master_Extensions_Discontinued.toctree')
    write_if_changed(os.path.join(path, 'source', 'Hardware', 'Master_Extensions', 'Master_Extensions_Discontinued.toctree'), make_hardware_devices_toctree(extension_infos, True))

    debug('Generating Power_Supplies.toctree')
    write_if_changed(os.path.join(path, 'source', 'Hardware', 'Power_Supplies', 'Power_Supplies.toctree'), make_hardware_devices_toctree(power_supply_infos, False))

    debug('Generating Power_Supplies_Discontinued.toctree')
    write_if_changed(os.path.join(path, 'source', 'Hardware', 'Power_Supplies', 'Power_Supplies_Discontinued.toctree'), make_hardware_devices_toctree(power_supply_infos, True))

    debug('Generating Bricks.table')
    write_if_changed(os.path.join(path, 'source', 'Hardware', 'Bricks', 'Bricks.table'), make_hardware_devices_table(brick_infos, False))

    debug('Generating Bricks_Discontinued.table')
    write_if_changed(os.path.join(path, 'source', 'Hardware', 'Bricks', 'Bricks_Discontinued.table'), make_hardware_devices_table(brick_infos, True))

    debug('Generating Bricklets.table')
    write_if_changed(os.path.join(path, 'source', 'Hardware', 'Bricklets', 'Bricklets.table'), make_hardware_devices_table(bricklet_infos, False))

    debug('Generating Bricklets_Discontinued.table')
    write_if_changed(os.path.join(path, 'source', 'Hardware', 'Bricklets', 'Bricklets_Discontinued.table'), make_hardware_devices_table(bricklet_infos, True))

    debug('Generating Master_Extensions.table')
    write_if_changed(os.path.join(path, 'source', 'Hardware', 'Master_Extensions', 'Master_Extensions.table'), make_hardware_devices_table(extension_infos, False))

    debug('Generating Master_Extensions_Discontinued.table')
    write_if_changed(os.path.join(path, 'source', 'Hardware', 'Master_Extensions', 'Master_Extensions_Discontinued.table'), make_hardware_devices_table(extension_infos, True))

    debug('Generating Power_Supplies.table')
    write_if_changed(os.path.join(path, 'source', 'Hardware', 'Power_Supplies', 'Power_Supplies.table'), make_hardware_devices_table(power_supply_infos, False))

    debug('Generating Power_Supplies_Discontinued.table')
    write_if_changed(os.path.join(path, 'source', 'Hardware', 'Power_Supplies', 'Power_Supplies_Discontinued.table'), make_hardware_devices_table(power_supply_infos, True))

    debug('Generating Discontinued_Products_table')
    write_if_changed(os.path.join(path, 'source', 'Hardware', 'Discontinued_Products.table'), make_discontinued_products_table())

    for brick_info in brick_infos:
        if not brick_info.has_bindings:
            continue

        debug('Generating {0}_hlpi.table'.format(brick_info.hardware_doc_name))
        write_if_changed(os.path.join(path, 'source', 'Hardware', 'Bricks', brick_info.hardware_doc_name + '_hlpi.table'), make_hlpi_table(brick_info))

    for bricklet_info in bricklet_infos:
        if not bricklet_info.has_bindings:
            continue

        debug('Generating {0}_hlpi.table'.format(bricklet_info.hardware_doc_name))
        write_if_changed(os.path.join(path, 'source', 'Hardware', 'Bricklets', bricklet_info.hardware_doc_name + '_hlpi.table'), make_hlpi_table(bricklet_info))

    debug('Generating Device_Identifier.table')
    write_if_changed(os.path.join(path, 'source', 'Software', 'Device_Identifier.table'), make_device_identifier_table())

    debug('Generating Tutorial_authenticate_examples.table')
    write_if_changed(os.path.join(path, 'source', 'Tutorials', 'Tutorial_Authentication', 'Tutorial_authenticate_examples.table'), make_authentication_tutorial_examples_table())

    for bindings_info in bindings_infos:
        if bindings_info.is_programming_language:
            debug('Generating API_Bindings_{0}_links.table'.format(bindings_info.software_doc_suffix))
            write_if_changed(os.path.join(path, 'source', 'Software', 'API_Bindings_{0}_links.table'.format(bindings_info.software_doc_suffix)), make_api_bindings_links_table(bindings_info))
        else:
            debug('Generating {0}_links.table'.format(bindings_info.software_doc_suffix))
            write_if_changed(os.path.join(path, 'source', 'Low_Level_Protocols', '{0}_links.table'.format(bindings_info.software_doc_suffix)), make_llproto_links_table(bindings_info))

    for bindings_info in bindings_infos:
        if not bindings_info.is_programming_language:
            continue

        template = {'en': u"""
{lang} - {device_type}{discontinued_title_parenthesis}
{equal_signs}

Links to the API reference for the {discontinued}{device_type} as
well as the examples from the ZIP file of the bindings are listed in the
following table. Further project descriptions can be found in the
:ref:`Kits <index_kits>` section.

.. include:: {device_type}_{lang_path}{discontinued_title_underscore}.table

.. include:: {device_type}_{lang_path}{discontinued_title_underscore}.toctree
""",
'de': u"""
{lang} - {device_type}{discontinued_title_parenthesis}
{equal_signs}

Links zur API Referenz der {discontinued}{device_type} sowie den
Beispiele aus der ZIP Datei der Bindings sind in der folgenden Tabelle
aufgelistet. Anleitungen für weiterführende Projekte finden sich im Abschnitt
über :ref:`Kits <index_kits>`.

.. include:: {device_type}_{lang_path}{discontinued_title_underscore}.table

.. include:: {device_type}_{lang_path}{discontinued_title_underscore}.toctree
""" }
        disc_title_par = {'en': u" (Discontinued)", 'de': u" (Abgekündigt)"}
        disc = {'en': u"discontinued ", 'de': u"abgekündigten "}
        disp_name = bindings_info.display_name[lang]
        lang_path = bindings_info.software_doc_suffix
        for dev in [u"Bricks", u"Bricklets"]:
            debug('Generating {dev}_{lang}_Discontinued.rst'.format(dev=dev, lang=lang_path))
            discontinued = template[lang].format(lang=disp_name,
                                                    lang_path = lang_path,
                                                    device_type=dev,
                                                    discontinued=disc[lang],
                                                    discontinued_title_parenthesis=disc_title_par[lang],
                                                    equal_signs="="*(len(disp_name) + 3 + len(dev) + len(disc_title_par[lang])),
                                                    discontinued_title_underscore="_Discontinued")
            write_if_changed(os.path.join(path, 'source', 'Software', "{dev}_{lang}_Discontinued.rst".format(dev=dev, lang=lang_path)), discontinued)

            debug('Generating {dev}_{lang}.rst'.format(dev=dev, lang=lang_path))
            normal = template[lang].format(lang=disp_name,
                                            lang_path = lang_path,
                                            device_type=dev,
                                            discontinued="",
                                            discontinued_title_parenthesis="",
                                            equal_signs="="*(len(disp_name) + 3 + len(dev)),
                                            discontinued_title_underscore="")
            write_if_changed(os.path.join(path, 'source', 'Software', "{dev}_{lang}.rst".format(dev=dev, lang=lang_path)), normal)

    for bindings_info in bindings_infos:
        if bindings_info.is_programming_language:
            debug('Generating Bricks_{0}.toctree'.format(bindings_info.software_doc_suffix))
            write_if_changed(os.path.join(path, 'source', 'Software', 'Bricks_{0}.toctree'.format(bindings_info.software_doc_suffix)), make_software_devices_toctree(bindings_info, brick_infos, 'Bricks', '', False))

            debug('Generating Bricks_{0}_Discontinued.toctree'.format(bindings_info.software_doc_suffix))
            write_if_changed(os.path.join(path, 'source', 'Software', 'Bricks_{0}_Discontinued.toctree'.format(bindings_info.software_doc_suffix)), make_software_devices_toctree(bindings_info, brick_infos, 'Bricks', '', True))

            debug('Generating Bricks_{0}.table'.format(bindings_info.software_doc_suffix))
            write_if_changed(os.path.join(path, 'source', 'Software', 'Bricks_{0}.table'.format(bindings_info.software_doc_suffix)), make_api_bindings_devices_table(bindings_info, brick_infos, 'Brick', False))

            debug('Generating Bricks_{0}_Discontinued.table'.format(bindings_info.software_doc_suffix))
            write_if_changed(os.path.join(path, 'source', 'Software', 'Bricks_{0}_Discontinued.table'.format(bindings_info.software_doc_suffix)), make_api_bindings_devices_table(bindings_info, brick_infos, 'Brick', True))
        else:
            debug('Generating Bricks_{0}.toctree'.format(bindings_info.software_doc_suffix))
            write_if_changed(os.path.join(path, 'source', 'Low_Level_Protocols', 'Bricks_{0}.toctree'.format(bindings_info.software_doc_suffix)), make_software_devices_toctree(bindings_info, brick_infos, 'Bricks', '../Software/', False))

            debug('Generating Bricks_{0}_Discontinued.toctree'.format(bindings_info.software_doc_suffix))
            write_if_changed(os.path.join(path, 'source', 'Low_Level_Protocols', 'Bricks_{0}_Discontinued.toctree'.format(bindings_info.software_doc_suffix)), make_software_devices_toctree(bindings_info, brick_infos, 'Bricks', '../Software/', True))

            debug('Generating Bricks_{0}.table'.format(bindings_info.software_doc_suffix))
            write_if_changed(os.path.join(path, 'source', 'Low_Level_Protocols', 'Bricks_{0}.table'.format(bindings_info.software_doc_suffix)), make_llproto_devices_table(bindings_info, brick_infos, 'Brick', False))

            debug('Generating Bricks_{0}_Discontinued.table'.format(bindings_info.software_doc_suffix))
            write_if_changed(os.path.join(path, 'source', 'Low_Level_Protocols', 'Bricks_{0}_Discontinued.table'.format(bindings_info.software_doc_suffix)), make_llproto_devices_table(bindings_info, brick_infos, 'Brick', True))

    for bindings_info in bindings_infos:
        if bindings_info.is_programming_language:
            debug('Generating Bricklets_{0}.toctree'.format(bindings_info.software_doc_suffix))
            write_if_changed(os.path.join(path, 'source', 'Software', 'Bricklets_{0}.toctree'.format(bindings_info.software_doc_suffix)), make_software_devices_toctree(bindings_info, bricklet_infos, 'Bricklets', '', False))

            debug('Generating Bricklets_{0}_Discontinued.toctree'.format(bindings_info.software_doc_suffix))
            write_if_changed(os.path.join(path, 'source', 'Software', 'Bricklets_{0}_Discontinued.toctree'.format(bindings_info.software_doc_suffix)), make_software_devices_toctree(bindings_info, bricklet_infos, 'Bricklets', '', True))

            debug('Generating Bricklets_{0}.table'.format(bindings_info.software_doc_suffix))
            write_if_changed(os.path.join(path, 'source', 'Software', 'Bricklets_{0}.table'.format(bindings_info.software_doc_suffix)), make_api_bindings_devices_table(bindings_info, bricklet_infos, 'Bricklet', False))

            debug('Generating Bricklets_{0}_Discontinued.table'.format(bindings_info.software_doc_suffix))
            write_if_changed(os.path.join(path, 'source', 'Software', 'Bricklets_{0}_Discontinued.table'.format(bindings_info.software_doc_suffix)), make_api_bindings_devices_table(bindings_info, bricklet_infos, 'Bricklet', True))
        else:
            debug('Generating Bricklets_{0}.toctree'.format(bindings_info.software_doc_suffix))
            write_if_changed(os.path.join(path, 'source', 'Low_Level_Protocols', 'Bricklets_{0}.toctree'.format(bindings_info.software_doc_suffix)), make_software_devices_toctree(bindings_info, bricklet_infos, 'Bricklets', '../Software/', False))

            debug('Generating Bricklets_{0}_Discontinued.toctree'.format(bindings_info.software_doc_suffix))
            write_if_changed(os.path.join(path, 'source', 'Low_Level_Protocols', 'Bricklets_{0}_Discontinued.toctree'.format(bindings_info.software_doc_suffix)), make_software_devices_toctree(bindings_info, bricklet_infos, 'Bricklets', '../Software/', True))

            debug('Generating Bricklets_{0}.table'.format(bindings_info.software_doc_suffix))
            write_if_changed(os.path.join(path, 'source', 'Low_Level_Protocols', 'Bricklets_{0}.table'.format(bindings_info.software_doc_suffix)), make_llproto_devices_table(bindings_info, bricklet_infos, 'Bricklet', False))

            debug('Generating Bricklets_{0}_Discontinued.table'.format(bindings_info.software_doc_suffix))
            write_if_changed(os.path.join(path, 'source', 'Low_Level_Protocols', 'Bricklets_{0}_Discontinued.table'.format(bindings_info.software_doc_suffix)), make_llproto_devices_table(bindings_info, bricklet_infos, 'Bricklet', True))

if __name__ == "__main__":
    generate(os.getcwd())