SymbiFlow RR Graph libraries
Project description
SymbiFlow Routing Resources Graph (rr-graph
) Python Libraries
This repository contains a Python library and utilities for working with
"Routing Resource Graph" (rr-graph
) files
used by SymbiFlow and
Verilog to Routing.
It supports both the XML and
Cap'n'Proto formats of rr-graph
files.
The Cap'n'Proto schema is generated from the
XML schema @ vtr-verilog-to-routing/vpr/src/route/rr_graph.xsd
using the uxsdcxx tool.
For information on the schema generation can be found in the
SCHEMA_GENERATOR.md
file in Verilog to Routing.
Contributing
A full contribution guide can be found in docs/contributing.md
.
A few important points;
-
All contributions should be sent as GitHub Pull requests.
-
By contributing you agree to the code of conduct.
-
All commits are required to include a DCO sign off line.
License
All software (code, associated documentation, support files, etc) in this repository is licensed under the very permissive ISC Licence.
A copy can be found in the LICENSE
file.
All new contributions must also be released under this license.
Installing
From PyPI
pip install rr-graph
FYI: Builds are automatically published to GitHub on every push to this repository.
Direct from GitHub
pip install git+https://github.com/SymbiFlow/symbiflow-rr-graph.git#egg=rr-graph
Direct from checkout
python setup.py install
or python setup.py develop
Developing
To setup a local development environment use the make venv
target which will
build you a Python virtualenv (in the
venv
directory) with the needed packages and tools.
The make version
target will output the current version of the rr-graph
library.
Running tests
To run the tests, run make test
.
If you have an issue with the CI disagreeing with the output of your local
make test
output, you can also try the make test-like-ci
target to closer
match how the CI system runs the tests.
Formatting
To run automated formatting over the repository, use make format
.
Updating GitHub Actions
The make format-gha
target will update the GitHub Actions under
.github/workflows
with the latest version of the
included tasks.
It is recommended that you commit these updates separately from your other changes.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Hashes for rr_graph-0.0.1.post22-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e083d4053eb93c825eb7a66d3cd4847e0e475b568f77bfd1ca1be94f6bd1cc92 |
|
MD5 | 6c3f059e0ff7d2f3bb56608f0768507a |
|
BLAKE2b-256 | 8f13f5c9e1de53e3933a90e712af3a8d8ea72f00bdc5848a770e7aa19ebd12b3 |
Hashes for rr_graph-0.0.1.post22-py2-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1a53d0f03bcd6bb797cc31be2f3185b111cb4eeaf209d7dd1a3db33ef1612011 |
|
MD5 | 956469e8373b2e376d57cb62d024bb8a |
|
BLAKE2b-256 | 4ea28edd742444aa8e983a6a2273829e657e6869d31759e317f00f5b53913b11 |