Skip to content

Commit

Permalink
Prep for release
Browse files Browse the repository at this point in the history
  • Loading branch information
amykyta3 committed Nov 7, 2018
1 parent 54a7490 commit ad3b7b3
Show file tree
Hide file tree
Showing 3 changed files with 54 additions and 3 deletions.
51 changes: 51 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,53 @@
# RALBot-ipxact
Convert compiled SystemRDL input into IP-XACT XML

## Installing
Install from [PyPi](https://pypi.org/project/ralbot-ipxact) using pip:

python3 -m pip install ralbot-ipxact


## Usage
Pass the elaborated output of the [SystemRDL Compiler](http://systemrdl-compiler.readthedocs.io)
into the exporter.

Assuming `root` is the elaborated top-level node, or an internal `AddrmapNode`:

```python
from ralbot.ipxact import IPXACTExporter

exporter = IPXACTExporter()

exporter.export(root, "path/to/output.xml")
```


## Reference

### `IPXACTExporter(**kwargs)`
Constructor for the HTML exporter class

**Optional Parameters**

* `vendor`
* Vendor url string. Defaults to "example.org"
* `library`
* library name string. Defaults to "mylibrary"
* `version`
* Version string. Defaults to "1.0"
* `standard`
* IP-XACT Standard to use. Currently only supports `ralbot.ipxact.Standard.IEEE_1685_2014`
* `xml_indent`
* String to use for each indent level. Defaults to 2 spaces.
* `xml_newline`
* String to use for line breaks. Defaults to newline.

### `IPXACTExporter.export(node, path)`
Perform the export!

**Parameters**

* `node`
* Top-level node to export. Can be the top-level `RootNode` or any internal `AddrmapNode`.
* `path`
* Output file.
2 changes: 1 addition & 1 deletion ralbot/ipxact/__about__.py
Original file line number Diff line number Diff line change
@@ -1 +1 @@
__version__ = "0.1.0"
__version__ = "1.0.0"
4 changes: 2 additions & 2 deletions setup.py
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@
packages=['ralbot.ipxact'],
include_package_data=True,
install_requires=[
"systemrdl-compiler",
"systemrdl-compiler>=1.2.0",
],
classifiers=(
"Development Status :: 5 - Production/Stable",
Expand All @@ -32,7 +32,7 @@
"Programming Language :: Python :: 3.6",
"Programming Language :: Python :: 3 :: Only",
"Intended Audience :: Developers",
"License :: OSI Approved :: GNU General Public License v3 (GPLv3) e",
"License :: OSI Approved :: GNU General Public License v3 (GPLv3)",
"Operating System :: OS Independent",
"Topic :: Scientific/Engineering :: Electronic Design Automation (EDA)",
),
Expand Down

0 comments on commit ad3b7b3

Please sign in to comment.