bowmark-web-stubs
PEP 561 type stubs for
bowmark-web — the whole
Bowmark capability surface, typed.
pip install bowmark-web bowmark-web-stubs
async with session() as bm:
found = await bm.providers.gymshark.search({"query": "hoodie"})
# ^ your editor knows every provider, every
# function, every argument and every field
Why it is a separate distribution
PEP 561 is explicit: "The name of the stub package MUST follow the scheme
foopkg-stubs." So this is mandated rather than chosen, and PyPI has no rename, alias
or redirect mechanism to undo it with.
bowmark-web still ships py.typed, so installing only the client keeps the client's
own types and loses only the catalog.
This distribution is marked partial, which matters: without that marker a checker
resolving bowmark_web-stubs stops looking at bowmark_web altogether, and every
private submodule becomes unresolvable to anyone who imports one.
What is in it, and where it comes from
bowmark_web-stubs/__init__.pyi is generated — from the same LibraryManifest that
produces the TypeScript declarations in
@bowmark/web. One manifest, one refusal
rule, two languages, so the two clients cannot come to disagree about what the library
offers. A gate in the source repo asserts the parity on every change.
Everything the library can do is in CAPABILITIES.md and PROVIDERS.md, regenerated daily.
What it deliberately does NOT type
Some functions are absent, on purpose. A function whose declared argument is a bare
destructuring pattern with no field types, or whose signature names a type its own
documentation never defines, gets a comment in place of a signature naming it and saying
why. Those functions are real and callable at runtime — the stub withholds only the
compile-time claim, because we have none to make. A (*args: Any) -> Any stand-in would
pass every check and tell you nothing.
Family members are not enumerated. bowmark.providers.gymshark.search(…) works and is
not in these stubs: there are half a million Shopify storefronts and no manifest carries
one. Type checkers will not complete them; the client sends them happily.
Everything leans toward accepting. An argument-position list is Sequence[T], a
number is float (so an int is fine), and anything the schema could not model is Any.
A stub that refuses a correct argument is a red squiggle you cannot turn off, and that is
a worse failure than one round trip.
Versioning
bowmark-web, bowmark-web-stubs and @bowmark/web on npm are released together and
always carry the same version. A skew would mean one ecosystem is on an older contract.
1 maintainer
Release files for bowmark-web-stubs 1.24.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| bowmark_web_stubs-1.24.1.tar.gz | 370.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| bowmark_web_stubs-1.24.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 744.2 kB
Release files / bowmark_web_stubs-1.24.1.tar.gz
| Download URL | bowmark_web_stubs-1.24.1.tar.gz |
|---|---|
| Size | 370.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a0696f73fcc50b366c576b4f981e561513c3faff9561d2547972583f7b8a8389
|
|
BLAKE2b-256 checksum How to use checksums |
0f71ea58b2e59a5160ff4e75a811fbd6b3598e19650029a7cd8871e3820851d0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.15 {"installer":{"name":"uv","version":"0.12.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / bowmark_web_stubs-1.24.1-py3-none-any.whl
| Download URL | bowmark_web_stubs-1.24.1-py3-none-any.whl |
|---|---|
| Size | 373.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
3a720f4980028354d3ea8520ea10fc94a7bed492f3a003ff71f05654353ce07d
|
|
BLAKE2b-256 checksum How to use checksums |
6625f7887468c5a85293ace7089112b29005427f28d2290503da5f46a39308e7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.15 {"installer":{"name":"uv","version":"0.12.15","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
