Skip to content

Commit

Permalink
Merge pull request #127 from FrameworkComputer/python-dev-docs
Browse files Browse the repository at this point in the history
docs: Add details about developing python
  • Loading branch information
JohnAZoidberg authored Nov 25, 2024
2 parents 14eb5df + 9e4830f commit d9f18af
Showing 1 changed file with 35 additions and 0 deletions.
35 changes: 35 additions & 0 deletions python/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -165,3 +165,38 @@ Bus 003 Device 078: ID 32ac:0020 Framework Computer Inc LED Matrix Input Module
bcdDevice 0.17
```

## Developing

One time setup

```
# Install dependencies on Ubuntu
sudo apt install python3 python3-tk
# Install dependencies on Fedora
sudo dnf install python3 python3-tkinter
# Create local venv and enter it
python3 -m venv venv
source venv/bin/activate
# Install package into local env
python3 -m pip install -e .
```

Developing

```
# In every new shell, source the virtual environment
source venv/bin/activate
# Launch GUI or commandline
ledmatrixgui
ledmatrixctl
# Launch Python REPL and import the library
# As example, launch the GUI
> python3
>>> from inputmodule import cli
>>> cli.main_gui()
```

0 comments on commit d9f18af

Please sign in to comment.