Add dev docs
parent
851b6d93e7
commit
3f842a33c3
48
Home.md
48
Home.md
@ -31,3 +31,51 @@ Ideally written in Python, using GTK and x-platform
|
||||
|
||||
## Design / conceptual
|
||||
|
||||
## Develop
|
||||
|
||||
### Install for Hacking
|
||||
|
||||
Install [poetry](https://python-poetry.org/docs/#installation) and then install the package locally.
|
||||
|
||||
```
|
||||
$ poetry install
|
||||
```
|
||||
|
||||
### Run in Hackity Hack Hack Mode
|
||||
|
||||
```bash
|
||||
$ poetry run dropship
|
||||
```
|
||||
|
||||
### Updating dependencies
|
||||
|
||||
- Change the bounds/versions/etc. in the [pyproject.toml](./pyproject.toml)
|
||||
- Run `poetry update`
|
||||
- Commit and push your changes
|
||||
|
||||
The [poetry.lock](./poetry.lock) file helps us all get the same dependencies.
|
||||
|
||||
### Adding a Github Mirror
|
||||
|
||||
We use a Github mirror so we can have a [gratis automated release build](./.travis.yml).
|
||||
|
||||
Add the following to the bottom of your `.git/config`.
|
||||
|
||||
```
|
||||
[remote "all"]
|
||||
url = ssh://gitea@vvvvvvaria.org:12345/rra/dropship.git
|
||||
url = git@github.com:decentral1se/dropship.git
|
||||
```
|
||||
|
||||
The `git push -u all main` will setup `git push` to automatically push to both remotes.
|
||||
|
||||
### Make a new Release
|
||||
|
||||
> Publishing binaries is disabled until we make further progress on [#3](https://git.vvvvvvaria.org/rra/dropship/issues/3)
|
||||
|
||||
```bash
|
||||
$ git tag $mytag # follow semver.org please
|
||||
$ git push
|
||||
```
|
||||
|
||||
The [Travis CI configuration](./.travis.yml) will run [a build](https://travis-ci.org/github/decentral1se/dropship) and [publish binaries here](https://github.com/decentral1se/dropship/releases).
|
||||
|
Loading…
Reference in New Issue
Block a user