Metadata-Version: 2.1
Name: pythondata-cpu-vexriscv
Version: 1.0.1.post407
Summary: Python module containing verilog files for VexRISCV cpu.
Home-page: https://github.com/litex-hub/pythondata-cpu-vexriscv
Author: LiteX Authors
Author-email: litex@googlegroups.com
Project-URL: Bug Tracker, https://github.com/litex-hub/pythondata-cpu-vexriscv/issues
Project-URL: Source Code, https://github.com/litex-hub/pythondata-cpu-vexriscv
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.5
Description-Content-Type: text/markdown
License-File: LICENSE

# pythondata-cpu-vexriscv

Non-Python  files needed for the cpu vexriscv packaged
into a Python module so they can be used with Python libraries and tools.

This is useful for usage with tools like
[LiteX](https://github.com/enjoy-digital/litex.git).

The data files can be found under the Python module `pythondata_cpu_vexriscv`. The
`pythondata_cpu_vexriscv.data_location` value can be used to find the files on the file
system.

Example of getting the data file directly;
```python
import pythondata_cpu_vexriscv

my_data_file = "abc.txt"

with open(os.path.join(pythondata_cpu_vexriscv.data_location, my_data_file)) as f:
    print(f.read())
```

Example of getting the data file using `litex.data.find` API;
```python
from pythondata_cpu_vexriscv import data_file

my_data_file = "abc.txt"

with open(data_file(my_data_file)) as f:
    print(f.read())
```



The data files are generated from https://github.com/SpinalHDL/VexRISCV.git and place in the directory
[pythondata_cpu_vexriscv/verilog](pythondata_cpu_vexriscv/verilog).


# Installing

## Directly from git repository

### Manually

You can install the package manually, however this is **not** recommended.

```
git clone https://github.com/litex-hub/pythondata-cpu-vexriscv.git
cd pythondata-cpu-vexriscv
sudo python setup.py install
```

### Using [pip](https://pip.pypa.io/) with git repository

You can use [pip](https://pip.pypa.io/) to install the data package directly
from github using;

```
pip install --user git+https://github.com/litex-hub/pythondata-cpu-vexriscv.git
```

If you want to install for the whole system rather than just the current user,
you need to remove the `--user` argument and run as sudo like so;

```
sudo pip install git+https://github.com/litex-hub/pythondata-cpu-vexriscv.git
```

You can install a specific revision of the repository using;
```
pip install --user git+https://github.com/litex-hub/pythondata-cpu-vexriscv.git@<tag>
pip install --user git+https://github.com/litex-hub/pythondata-cpu-vexriscv.git@<branch>
pip install --user git+https://github.com/litex-hub/pythondata-cpu-vexriscv.git@<hash>
```

### With `requirements.txt` file

Add to your Python `requirements.txt` file using;
```
-e git+https://github.com/litex-hub/pythondata-cpu-vexriscv.git
```

To use a specific revision of the repository, use the following;
```
-e https://github.com/litex-hub/pythondata-cpu-vexriscv.git@<hash>
```

## Via [PyPi](https://pypi.org/project/pythondata-cpu-vexriscv/)

### Using [pip](https://pip.pypa.io/)

```
pip install --user pythondata-cpu-vexriscv
```

### With `requirements.txt` file

Add to your Python `requirements.txt` file using;
```
pythondata-cpu-vexriscv
```

# Issues and Fixes

This package is autogenerated from the sources in
<https://github.com/SpinalHDL/VexRISCV.git>
using the [pythondata-auto](https://github.com/litex-hub/pythondata-auto)
toolset. Pull requests and issues on this pythondata repo may not be monitored.
