Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

A Python library for SVG network switch configuration rendering.

Project description

# switch-config-render

switch-config-render is a python module that can be used to create an SVG depiction of the internal configuration of an FPGA-based network switch product.

The module renders: * Front panel interfaces in use, together with their optional alias and description * FPGA application interfaces with their optional alias and description * Applications configured on the FPGA devices and the ports that they are connected to * Cross-connect connections between the front panel and application interfaces which can be colour-coded depending on the connection type(s) as defined in the interface definitions

Example output:

![](example_output.png)

Install by running pip install switch-config-render. directory.

## Generating an SVG

The SVG can be generated by calling the generate_system_svg function:

`python generate_system_svg('svg_file.svg', interfaces, connections, fpga_apps, app_shapes, onchip_connections) `

Where: * svg_file.svg is the name of the destination .svg file * interfaces is a dict specifying all the front panel and FPGA application interfaces * connections is a dict of key: value pairs, where the key defines the destination and the value the source of a connection * fpga_apps is a dict that specifies the applications that are configured on the given FPGA * app_shapes defines the vertices of the shapes to be used for the applications defined in fpga_apps * onchip_connections specifies internal connectivity within the FPGA and between FPGAs, between ap interfaces and FPGA applications

Refer to the example code in switch_config_render.__main__.py for more information.

## Example Application

An example application is provided and can be run by calling:

`bash python -m switch_config_render `

from the project root. The example runs switch_config_render.__main__.py which runs two examples: one that calls the high-level generate_system_svg function and one low-level example that manually creates objects for fine-grained placement control. These examples produce the high_level_example.svg and low_level_example.svg files respectively.

## License

switch-config-render is:

Copyright [2018] [Optiver]

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for switch-config-render, version 0.1.1
Filename, size File type Python version Upload date Hashes
Filename, size switch_config_render-0.1.1-py3-none-any.whl (17.7 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size switch-config-render-0.1.1.tar.gz (12.1 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page