Skip to content

Commit 674368b

Browse files
committed
update readme
1 parent 11b50f0 commit 674368b

2 files changed

Lines changed: 29 additions & 8 deletions

File tree

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,7 @@ site/*
1717
# Code coverage
1818
.coverage
1919
*.mp4
20+
htmlcov
2021

2122
# pyenv
2223
.python-version

README.md

Lines changed: 28 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
1-
![Python Janus Client](https://github.com/josephlim94/python_janus_client/blob/a09000e0c49d44918082dfa13dd27e6f309338fc/python_janus_client_logo.svg "Python Janus Client")
1+
![Python Janus Client](https://raw.githubusercontent.com/josephlim94/python_janus_client/refs/heads/master/python_janus_client_logo.svg "Python Janus Client")
22

33

44
[Janus](https://github.com/meetecho/janus-gateway) WebRTC gateway Python async client.
55

66
![PyPI - License](https://img.shields.io/pypi/l/janus-client)
77
![PyPI - Status](https://img.shields.io/pypi/status/janus-client)
88
![PyPI - Downloads](https://img.shields.io/pypi/dm/janus-client)
9-
![Code Coverage](https://img.shields.io/badge/coverage-84%25-brightgreen)
9+
![Code Coverage](https://img.shields.io/badge/coverage-82%25-brightgreen)
1010

1111
---
1212

@@ -199,14 +199,34 @@ hatch run mkdocs build
199199
hatch run +py=3.8 mkdocs build # to build in a specific python environment only, not all
200200
```
201201

202-
#### Documentation Structure
202+
## Dev
203203

204-
- `docs/index.md` - Main documentation page
205-
- `docs/session.md` - Session API documentation
206-
- `docs/plugins.md` - Plugin API documentation
207-
- `docs/transport.md` - Transport API documentation
208-
- `mkdocs.yml` - MkDocs configuration file
204+
### Run unit tests
209205

206+
Use following command to run unit tests and see all logs:
207+
208+
```bash
209+
hatch test # Run all tests on all environments
210+
hatch test -- -s --log-cli-level=INFO --full-trace -- tests # Run all tests with all logs on a default environment
211+
hatch test .\tests\test_plugin.py::TestTransportHttp::test_plugin_echotest_create -- -s --log-cli-level=INFO --full-trace # Run a specific test with all logs on a default environment
212+
hatch test -i py=3.8 .\tests\test_plugin.py::TestTransportHttp::test_plugin_echotest_create -- -s --log-cli-level=INFO --full-trace # Run a specific test with all logs on a specific environment
213+
```
214+
215+
Generate code coverage:
216+
217+
```bash
218+
# Not running it through all python environments because the webrtc connection might fail to setup.
219+
# That is a server configuration issue which naturally comes with integration tests like these.
220+
hatch test -i py=3.8 -c
221+
hatch env run -e py3.8 coverage html
222+
```
223+
224+
### Build and publish
225+
226+
```bash
227+
hatch -e py3.8 build --clean
228+
hatch publish
229+
```
210230
## Experiments
211231

212232
FFmpeg support for VideoRoom plugin has now been moved to `experiments` folder, together with GStreamer support.

0 commit comments

Comments
 (0)