blob: ee5ad23728e1497815736db236b136e460ed643f (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
|
Miscellaneous
=============
.. currentmodule:: websockets
Why do I get the error: ``module 'websockets' has no attribute '...'``?
.......................................................................
Often, this is because you created a script called ``websockets.py`` in your
current working directory. Then ``import websockets`` imports this module
instead of the websockets library.
.. _real-import-paths:
Why is the default implementation located in ``websockets.legacy``?
...................................................................
This is an artifact of websockets' history. For its first eight years, only the
:mod:`asyncio` implementation existed. Then, the Sans-I/O implementation was
added. Moving the code in a ``legacy`` submodule eased this refactoring and
optimized maintainability.
All public APIs were kept at their original locations. ``websockets.legacy``
isn't a public API. It's only visible in the source code and in stack traces.
There is no intent to deprecate this implementation — at least until a superior
alternative exists.
Why is websockets slower than another library in my benchmark?
..............................................................
Not all libraries are as feature-complete as websockets. For a fair benchmark,
you should disable features that the other library doesn't provide. Typically,
you may need to disable:
* Compression: set ``compression=None``
* Keepalive: set ``ping_interval=None``
* UTF-8 decoding: send ``bytes`` rather than ``str``
If websockets is still slower than another Python library, please file a bug.
Are there ``onopen``, ``onmessage``, ``onerror``, and ``onclose`` callbacks?
............................................................................
No, there aren't.
websockets provides high-level, coroutine-based APIs. Compared to callbacks,
coroutines make it easier to manage control flow in concurrent code.
If you prefer callback-based APIs, you should use another library.
|
