1
0
Fork 0

Merging upstream version 1.12.3.

Signed-off-by: Daniel Baumann <daniel@debian.org>
This commit is contained in:
Daniel Baumann 2025-02-09 17:55:14 +01:00
parent 7565ea4dc1
commit 47976d33df
Signed by: daniel
GPG key ID: FBB4F0E80A80222F
38 changed files with 323 additions and 677 deletions

View file

@ -1,6 +1,6 @@
# Development Guide
This is a guide for developers who would like to contribute to this project. It is recommended to use Python 3.7 and above for development.
This is a guide for developers who would like to contribute to this project. It is recommended to use Python 3.10 and above for development.
If you're interested in contributing to litecli, thank you. We'd love your help!
You'll always get credit for your work.
@ -24,8 +24,7 @@ You'll always get credit for your work.
```bash
$ cd litecli
$ pip install virtualenv
$ virtualenv litecli_dev
$ python -m venv .venv
```
We've just created a virtual environment that we'll use to install all the dependencies
@ -33,7 +32,7 @@ You'll always get credit for your work.
need to activate the virtual environment:
```bash
$ source litecli_dev/bin/activate
$ source .venv/bin/activate
```
When you're done working, you can deactivate the virtual environment:
@ -45,8 +44,7 @@ You'll always get credit for your work.
5. Install the dependencies and development tools:
```bash
$ pip install -r requirements-dev.txt
$ pip install --editable .
$ pip install --editable .[dev]
```
6. Create a branch for your bugfix or feature based off the `main` branch:
@ -75,18 +73,10 @@ You'll always get credit for your work.
While you work on litecli, it's important to run the tests to make sure your code
hasn't broken any existing functionality. To run the tests, just type in:
```bash
$ ./setup.py test
```
litecli supports Python 3.7+. You can test against multiple versions of
Python by running tox:
```bash
$ tox
```
### CLI Tests
Some CLI tests expect the program `ex` to be a symbolic link to `vim`.
@ -102,18 +92,12 @@ $ readlink -f $(which ex)
## Coding Style
litecli uses [black](https://github.com/ambv/black) to format the source code. Make sure to install black.
Litecli uses [ruff](https://docs.astral.sh/ruff/) to format the source code.
It's easy to check the style of your code, just run:
To check the style and fix any violations, run:
```bash
$ ./setup.py lint
```
If you see any style issues, you can automatically fix them by running:
```bash
$ ./setup.py lint --fix
$ tox -e style
```
Be sure to commit and push any stylistic fixes.