Skip to content

Commit 25532e2

Browse files
add docs
1 parent 9649bcd commit 25532e2

3 files changed

Lines changed: 32 additions & 15 deletions

File tree

.github/CONTRIBUTING.md

Lines changed: 29 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -25,28 +25,44 @@ or the Feature you have in mind.
2525

2626
We are very happy to receive Pull Requests considering:
2727

28-
* Style Guide. Follow the rules of [PEP8](http://legacy.python.org/dev/peps/pep-0008/) and make sure `tox -e lint` passes on your changes.
28+
* Style Guide. Follow the rules of [PEP8](http://legacy.python.org/dev/peps/pep-0008/) and make sure `ruff format` and `ruff check --fix` passes on your changes.
2929
* Tests. Make sure your code is covered by an automated test case. Make sure all tests pass.
3030

3131
## Development
3232

33-
radish can be installed as [editable install](https://setuptools.pypa.io/en/latest/userguide/development_mode.html).
33+
Install the development dependencies with [uv](https://docs.astral.sh/uv/getting-started/installation/) this will create a virtual environment for you and install all dependencies there.
34+
Make sure to install with `--all-extras` so that all optional dependencies are installed as well.
3435

3536
```bash
36-
pip install -r requirements-dev.txt
37-
pip install -e .
37+
uv sync --all-extras
3838
```
3939

40-
### tox: linting, testing, docs & more
40+
### Linting & Formatting
4141

42-
radish uses [`tox`](https://tox.readthedocs.io/en/latest/) to automate development tasks,
43-
like linting, testing, building the docs and creating the changelog.
42+
Radish uses [ruff](https://docs.astral.sh/ruff/) for linting and formatting the code base.
4443

45-
The radish tox setup provides the following automated tasks:
44+
```bash
45+
uv run ruff check --fix
46+
uv run format .
47+
```
48+
49+
### Testing
50+
51+
To run the tests you can use pytest.
52+
53+
```bash
54+
uv run pytest
55+
```
4656

47-
* `lint`: formats and lints the code base using [`ruff`](https://docs.astral.sh/ruff/)
48-
* `py<ver>`: runs tests with the Python Version from `<ver>`.
57+
If you want to run the tests for a specific Python version you can use `uv` to do so:
4958

50-
Before commiting your changes, it's a good practice to run `tox`.
51-
So that it'll run all the preconfigured tasks.
52-
If they all pass - you are good to go for a Pull Request! :tada:
59+
Make sure you have installed the development dependencies with that specific Python version first.
60+
61+
```bash
62+
uv python install 3.10
63+
```
64+
Then you can run the tests like this (`--all-extras` since some tests require optional dependencies) (`--isolated` to avoid interference with the current environment):
65+
66+
```bash
67+
uv run --isolated --python=3.11 --all-extras pytest
68+
```

.github/workflows/main.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,8 @@ jobs:
1414
fail-fast: false
1515
max-parallel: 8
1616
matrix:
17-
python-version: ["3.7", "3.8", "3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
18-
# python-version: [3.7, 3.13] # Switch back to this once we validate everything works
17+
# python-version: ["3.7", "3.8", "3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
18+
python-version: [3.7, 3.8, 3.14]
1919
os: [ubuntu-22.04, windows-latest, macos-latest]
2020
exclude:
2121
- os: macos-latest

pyproject.toml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@ name = "radish_bdd"
33
version = "0.18.2"
44
authors = [{ name = "Timo Furrer", email = "tuxtimo+radish@gmail.com" }]
55
description = "Behaviour-Driven-Development tool for Python"
6+
license = { file = "LICENSE" }
67
readme = "README.md"
78
requires-python = ">=3.7,<4.0"
89
classifiers = [

0 commit comments

Comments
 (0)