Setup - bohning/usdb_syncer GitHub Wiki
I am a developer and I just need to know how to run the syncer
poetry run usdb_syncer
. Use tox
to test.
For everybody else:
Installing python
If you already have python installed and do not want to change anything, just ensure it is up-to-date. You can skip the rest of this step.
The simplest way of managing python is pyenv. If you are on Linux/Unix/MacOS, install it from there. If you are on windows, use pyenv-win, a windows port of the aforementioned pyenv.
Once pyenv is installed, use pyenv install 3.12
to install python 3.12. Run pyenv global 3.12
to ensure that python 3.12 is set as your standard.
Installing other tools
Poetry
Install poetry if you haven't already. Poetry is used to manage the dependancies of the syncer.
Git
Install git if you haven't already. Git is used to synchronise work on different computers and provides a history of all changes.
Setting up usdb_syncer
Downloading and running
- Clone the git repository to your machine:
git clone https://github.com/bohning/usdb_syncer.git
. - Enter the local git repository:
cd usdb_syncer
- Install dependencies with
poetry install
- Run usdb_syncer with
poetry run usdb_syncer
Testing
Use tox
in the project folder to test your changes.
Making changes to the UI.
Run the qt/pyside designer with poetry run pyside6-designer
. Open and edit the .ui files at ~/src/usdb_syncer_gui/forms
.
Save in the designer, then re-run usdb_syncer. Do not edit the .py files in the forms
directory. These are automatically generated and will be overwritten.
If you want to contribute, see the github docs