You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+20-4Lines changed: 20 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,8 +3,8 @@
3
3
WS-Discovery in Python
4
4
======================
5
5
This is WS-Discovery implementation for Python 3. It allows to both discover
6
-
services and publish discoverable services. For Python 2 support, use the latest 1.x version
7
-
of this package.
6
+
services and publish discoverable services. For Python 2 support, use the
7
+
latest 1.x version of this package.
8
8
9
9
Extensive [package documentation is available at ReadTheDocs](https://python-ws-discovery.readthedocs.io).
10
10
@@ -13,9 +13,12 @@ Install from PyPI: `pip install WSDiscovery`.
13
13
Basic usage
14
14
------------
15
15
16
-
A simple `wsdiscover` command-line client is provided for discovering WS-Discovery compliant devices and systems. Run `wsdiscover --help` for usage instructions.
16
+
A simple `wsdiscover` command-line client is provided for discovering
17
+
WS-Discovery compliant devices and systems. Run `wsdiscover --help` for
18
+
usage instructions.
17
19
18
-
Here's an example of how to use the package in your Python code. The following code first publishes a service and then discovers it:
20
+
Here's an example of how to use the package in your Python code. The following
21
+
code first publishes a service and then discovers it:
19
22
20
23
```python
21
24
from wsdiscovery.discovery import ThreadedWSDiscovery as WSDiscovery
@@ -41,6 +44,19 @@ Here's an example of how to use the package in your Python code. The following c
41
44
wsd.stop()
42
45
```
43
46
47
+
Development notes
48
+
-----------------
49
+
To fix a bug or develop this package, it is recommended to use a virtual
50
+
environment and set up a development environment. For example:
51
+
```
52
+
$ python3 -m venv venv
53
+
$ . venv/bin/activate
54
+
(venv) $ pip3 install -e
55
+
```
56
+
Then you can call `wsdiscover` and `wspublish` from within this virtual
57
+
environment. Any code changes to the package will be available and testable
58
+
immediately.
59
+
44
60
Development state
45
61
-----------------
46
62
This is not 100% complete and correct WS-Discovery implementation. It doesn't
0 commit comments