pysteam-client 1.4.6__tar.gz

pysteam_client-1.4.6/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2015 Rossen Georgiev <rossen@rgp.io>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pysteam_client-1.4.6/PKG-INFO

@@ -0,0 +1,225 @@
+Metadata-Version: 2.1
+Name: pysteam-client
+Version: 1.4.6
+Summary: Module for interacting with various Steam features
+Home-page: https://github.com/ValvePython/steam
+License: MIT
+Keywords: valve,steam,steamid,api,webapi,steamcommunity
+Author: Rossen Georgiev
+Author-email: rossen@rgp.io
+Requires-Python: >=3.13.11,<4.0.0
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Provides-Extra: client
+Requires-Dist: cachetools (>=3.0.0)
+Requires-Dist: gevent (>=1.5.0) ; extra == "client"
+Requires-Dist: gevent-eventemitter (>=2.1) ; extra == "client"
+Requires-Dist: protobuf (>=5.26,<7) ; extra == "client"
+Requires-Dist: pycryptodomex (>=3.7.0)
+Requires-Dist: requests (>=2.9.1)
+Requires-Dist: six (>=1.10.0)
+Requires-Dist: urllib3 (<2)
+Requires-Dist: vdf (>=3.3)
+Project-URL: Repository, https://github.com/H47R15/steam
+Description-Content-Type: text/x-rst
+
+steam
+=====
+
+Python client for the Steam network — CM protocol, PICS / CDN, WebAuth,
+Web API, Steam Guard, SteamIDs, master-server queries.
+
+**This is a fork of** `ValvePython/steam <https://github.com/ValvePython/steam>`_
+maintained under `H47R15/steam <https://github.com/H47R15/steam>`_.  The
+upstream project is largely inactive; this fork exists to keep the library
+working against modern Python and current Steam wire protocols.
+
+What changed vs. upstream
+-------------------------
+
+* **Python 3.13+ only.**  Dropped the py2 / py<3.4 compat shims (``six``,
+  ``six.moves``, ``raw_input``, ``xrange``, ``long``, ``win_inet_pton``,
+  ``backports.lzma``, ``enum34``, …).
+* **Modern protobuf runtime + regenerated ``_pb2`` files.**  Bumped from
+  ``protobuf==3.20.3`` to ``>=5.26,<7`` and re-ran ``protoc`` (v33.2) against
+  fresh SteamDB proto sources.  The old per-message
+  ``_reflection.GeneratedProtocolMessageType`` codegen shrunk ~20× to the
+  modern ``_descriptor_pool.AddSerializedFile`` + ``_builder`` pattern
+  (``steammessages_base_pb2.py``: 2 200 → 96 lines).
+* **Full ``.pyi`` type stubs** for every ``_pb2`` file via ``mypy-protobuf``
+  — ``msg.field`` accesses now type-check under Pylance / pyright.
+* **Poetry-first workflow.**  ``pip`` + ``Makefile`` + ``setup.py``
+  replaced by a single ``pyproject.toml``; regeneration steps registered as
+  ``poetry run pb-*`` console scripts (details below).
+* **~50 new proto files** picked up from upstream since the fork was last
+  synced (family groups, game recording, remote client, SteamOS webui
+  messages, HTML messages, virtual controller, community messages, and
+  more).  ``steam/enums/proto.py`` grew from 90 → 247 enums.
+* Real latent bug fixes surfaced while porting — e.g. a ``list + map(...)``
+  ``TypeError`` in ``struct.py``, a tuple-vs-int mismatch in
+  ``MarketingMessage.flags``, ``hexlify(None)`` in avatar-URL fallback,
+  broken ``CookieJar`` iteration in ``WebAuth``.
+
+Requirements
+------------
+
+* Python **3.13.11** (pinned via ``pyproject.toml``).  Any newer 3.13.x is
+  fine.  Older Pythons are not supported.
+* `Poetry <https://python-poetry.org/>`_ for dependency management.
+* ``protoc`` on ``PATH`` — required only when regenerating the ``_pb2``
+  files (``poetry run pb-compile``).  Install via ``brew install protobuf``
+  on macOS or the equivalent from your distro.
+
+Install
+-------
+
+Clone the repo and install with poetry:
+
+.. code:: bash
+
+    git clone https://github.com/H47R15/steam.git
+    cd steam
+    poetry install --with dev --extras client
+
+The ``client`` extra pulls in ``gevent`` + ``protobuf`` + ``gevent-eventemitter``
+— required by ``SteamClient`` and CDN.  Without it, only the
+``requests``-based subset (WebAPI / WebAuth / SteamID / master-server
+query) is functional.
+
+Features
+--------
+
+* **SteamClient** — CM protocol client on top of gevent.  Login flows
+  (password / QR / refresh token), PICS product info, friends list, chat,
+  game coordinator hooks.
+* **CDNClient** — content depot downloads with manifest parsing.
+* **WebAuth / MobileWebAuth** — obtain authenticated ``requests.Session``
+  cookies for ``store.steampowered.com`` / ``steamcommunity.com``.
+* **WebAPI** — thin wrapper around Steam's ``api.steampowered.com`` that
+  introspects the interface catalogue at construction time.
+* **SteamAuthenticator** — enable / disable / verify Steam Guard 2FA.
+* **SteamID** — parse and convert between the 32-bit / 64-bit /
+  ``STEAM_X:Y:Z`` / community-URL representations.
+* **Master server query protocol** — query masters directly or through
+  ``SteamClient``.
+
+Dev workflow (poetry)
+---------------------
+
+All commands run from the repo root.
+
+.. code:: bash
+
+    poetry install --with dev --extras client   # install everything
+    poetry run pytest                           # run the test suite (~83 tests, ~1s)
+    poetry run pytest -k test_webauth           # filter to a subset
+    poetry run pytest --tb=short -q             # concise output
+
+    poetry run pylint steam                     # optional lint pass
+
+Regenerating protobufs
+----------------------
+
+The ``_pb2.py`` and ``_pb2.pyi`` files under ``steam/protobufs`` are
+generated from ``.proto`` sources under ``protobufs/``.  Console scripts:
+
+.. code:: bash
+
+    poetry run pb-fetch       # download + normalize .proto files from SteamDB
+    poetry run pb-compile     # protoc --python_out --mypy_out + post-process
+    poetry run pb-services    # regenerate steam/core/msg/unified.py service map
+    poetry run pb-gen-enums   # regenerate steam/enums/proto.py from *_pb2
+
+    poetry run pb-update      # all four in sequence — the usual entry point
+
+``pb-fetch`` reads URLs from ``protobuf_list.txt`` (comments and blank
+lines skipped) and downloads them into ``protobufs/``.  Locally-maintained
+``.proto`` files (``gc.proto``, ``test_messages.proto``) are set aside via
+``.notouch`` rename before the fetch and restored after.
+
+``pb-compile`` wipes ``steam/protobufs/*_pb2.{py,pyi}`` first, then runs a
+single ``protoc`` invocation over every ``.proto``.  Post-processing:
+
+* ``.py`` — sibling protobuf imports get the ``steam.protobufs.`` prefix
+  so runtime import works without ``steam/protobufs/`` on ``sys.path``.
+* ``.pyi`` — ``DESCRIPTOR: _descriptor.Descriptor`` overrides inside each
+  message class are stripped (they trip
+  ``reportIncompatibleVariableOverride`` under types-protobuf 7.34+; the
+  parent ``Message`` class's union type is inherited instead).
+
+VCR fixtures
+------------
+
+Web-facing tests (``test_webapi.py``, ``test_webauth.py``,
+``test_steamid.py``) replay recorded HTTP fixtures from ``vcr/*.yaml`` in
+``RecordMode.NONE`` — no live network, no credentials needed for CI.
+
+To regenerate the ``webapi.yaml`` cassette against a fresh Steam API
+response, copy ``.env.example`` to ``.env`` and fill in ``STEAM_API_KEY``
+(see the template for instructions on where to get one), then follow the
+regen recipe at the top of ``tests/test_webapi.py``.
+
+The ``webauth_*.yaml`` cassettes are regenerated by
+``tests/generete_webauth_vcr.py`` — needs real Steam credentials at run
+time; run interactively when the anonymized replay drifts from live.
+
+Live smoke test
+---------------
+
+Beyond the unit suite, the CM handshake / anonymous-login / PICS-fetch
+end-to-end flow can be smoke-tested against live Steam:
+
+.. code:: python
+
+    from steam.client import SteamClient
+
+    client = SteamClient()
+    assert client.anonymous_login()
+    resp = client.get_product_info(apps=[553850], timeout=15)  # Helldivers 2
+    print(resp['apps'][553850]['common']['name'])
+    client.logout()
+    client.disconnect()
+
+Layout
+------
+
+.. code::
+
+    steam/
+    ├── steam/              # library source
+    │   ├── client/         # SteamClient, CDN, builtins/*
+    │   ├── core/           # CM protocol, message framing
+    │   ├── enums/          # SteamIntEnum wrappers (common.py hand-written,
+    │   │                   #   proto.py auto-generated by pb-gen-enums)
+    │   ├── protobufs/      # generated *_pb2.py + *_pb2.pyi
+    │   └── utils/
+    ├── scripts/            # poetry console-script entry points (pb-*)
+    ├── protobufs/          # .proto sources (fetched by pb-fetch)
+    ├── typings/            # local pyright stubs (see typings/…/builder.pyi
+    │                       #   for the BuildServices typeshed override)
+    ├── tests/              # pytest suite
+    ├── vcr/                # recorded HTTP fixtures for offline test replay
+    ├── docs/               # Sphinx source (rendered at steam.readthedocs.io
+    │                       #   — kept in-tree but not currently deployed
+    │                       #   from this fork)
+    └── pyproject.toml      # poetry config + [tool.pyright]
+
+Upstream links (reference only — refer to this fork for maintained code):
+
+* Upstream: https://github.com/ValvePython/steam
+* Old docs: https://steam.readthedocs.io/en/latest/  (mostly still
+  applicable — the library shape has not diverged from upstream, only its
+  Python-runtime and protobuf-vintage baseline)
+* Command-line companion (unmaintained upstream):
+  https://github.com/ValvePython/steamctl
+
+License
+-------
+
+MIT (unchanged from upstream).  See ``LICENSE``.
+

pysteam_client-1.4.6/README.rst

@@ -0,0 +1,194 @@
+steam
+=====
+
+Python client for the Steam network — CM protocol, PICS / CDN, WebAuth,
+Web API, Steam Guard, SteamIDs, master-server queries.
+
+**This is a fork of** `ValvePython/steam <https://github.com/ValvePython/steam>`_
+maintained under `H47R15/steam <https://github.com/H47R15/steam>`_.  The
+upstream project is largely inactive; this fork exists to keep the library
+working against modern Python and current Steam wire protocols.
+
+What changed vs. upstream
+-------------------------
+
+* **Python 3.13+ only.**  Dropped the py2 / py<3.4 compat shims (``six``,
+  ``six.moves``, ``raw_input``, ``xrange``, ``long``, ``win_inet_pton``,
+  ``backports.lzma``, ``enum34``, …).
+* **Modern protobuf runtime + regenerated ``_pb2`` files.**  Bumped from
+  ``protobuf==3.20.3`` to ``>=5.26,<7`` and re-ran ``protoc`` (v33.2) against
+  fresh SteamDB proto sources.  The old per-message
+  ``_reflection.GeneratedProtocolMessageType`` codegen shrunk ~20× to the
+  modern ``_descriptor_pool.AddSerializedFile`` + ``_builder`` pattern
+  (``steammessages_base_pb2.py``: 2 200 → 96 lines).
+* **Full ``.pyi`` type stubs** for every ``_pb2`` file via ``mypy-protobuf``
+  — ``msg.field`` accesses now type-check under Pylance / pyright.
+* **Poetry-first workflow.**  ``pip`` + ``Makefile`` + ``setup.py``
+  replaced by a single ``pyproject.toml``; regeneration steps registered as
+  ``poetry run pb-*`` console scripts (details below).
+* **~50 new proto files** picked up from upstream since the fork was last
+  synced (family groups, game recording, remote client, SteamOS webui
+  messages, HTML messages, virtual controller, community messages, and
+  more).  ``steam/enums/proto.py`` grew from 90 → 247 enums.
+* Real latent bug fixes surfaced while porting — e.g. a ``list + map(...)``
+  ``TypeError`` in ``struct.py``, a tuple-vs-int mismatch in
+  ``MarketingMessage.flags``, ``hexlify(None)`` in avatar-URL fallback,
+  broken ``CookieJar`` iteration in ``WebAuth``.
+
+Requirements
+------------
+
+* Python **3.13.11** (pinned via ``pyproject.toml``).  Any newer 3.13.x is
+  fine.  Older Pythons are not supported.
+* `Poetry <https://python-poetry.org/>`_ for dependency management.
+* ``protoc`` on ``PATH`` — required only when regenerating the ``_pb2``
+  files (``poetry run pb-compile``).  Install via ``brew install protobuf``
+  on macOS or the equivalent from your distro.
+
+Install
+-------
+
+Clone the repo and install with poetry:
+
+.. code:: bash
+
+    git clone https://github.com/H47R15/steam.git
+    cd steam
+    poetry install --with dev --extras client
+
+The ``client`` extra pulls in ``gevent`` + ``protobuf`` + ``gevent-eventemitter``
+— required by ``SteamClient`` and CDN.  Without it, only the
+``requests``-based subset (WebAPI / WebAuth / SteamID / master-server
+query) is functional.
+
+Features
+--------
+
+* **SteamClient** — CM protocol client on top of gevent.  Login flows
+  (password / QR / refresh token), PICS product info, friends list, chat,
+  game coordinator hooks.
+* **CDNClient** — content depot downloads with manifest parsing.
+* **WebAuth / MobileWebAuth** — obtain authenticated ``requests.Session``
+  cookies for ``store.steampowered.com`` / ``steamcommunity.com``.
+* **WebAPI** — thin wrapper around Steam's ``api.steampowered.com`` that
+  introspects the interface catalogue at construction time.
+* **SteamAuthenticator** — enable / disable / verify Steam Guard 2FA.
+* **SteamID** — parse and convert between the 32-bit / 64-bit /
+  ``STEAM_X:Y:Z`` / community-URL representations.
+* **Master server query protocol** — query masters directly or through
+  ``SteamClient``.
+
+Dev workflow (poetry)
+---------------------
+
+All commands run from the repo root.
+
+.. code:: bash
+
+    poetry install --with dev --extras client   # install everything
+    poetry run pytest                           # run the test suite (~83 tests, ~1s)
+    poetry run pytest -k test_webauth           # filter to a subset
+    poetry run pytest --tb=short -q             # concise output
+
+    poetry run pylint steam                     # optional lint pass
+
+Regenerating protobufs
+----------------------
+
+The ``_pb2.py`` and ``_pb2.pyi`` files under ``steam/protobufs`` are
+generated from ``.proto`` sources under ``protobufs/``.  Console scripts:
+
+.. code:: bash
+
+    poetry run pb-fetch       # download + normalize .proto files from SteamDB
+    poetry run pb-compile     # protoc --python_out --mypy_out + post-process
+    poetry run pb-services    # regenerate steam/core/msg/unified.py service map
+    poetry run pb-gen-enums   # regenerate steam/enums/proto.py from *_pb2
+
+    poetry run pb-update      # all four in sequence — the usual entry point
+
+``pb-fetch`` reads URLs from ``protobuf_list.txt`` (comments and blank
+lines skipped) and downloads them into ``protobufs/``.  Locally-maintained
+``.proto`` files (``gc.proto``, ``test_messages.proto``) are set aside via
+``.notouch`` rename before the fetch and restored after.
+
+``pb-compile`` wipes ``steam/protobufs/*_pb2.{py,pyi}`` first, then runs a
+single ``protoc`` invocation over every ``.proto``.  Post-processing:
+
+* ``.py`` — sibling protobuf imports get the ``steam.protobufs.`` prefix
+  so runtime import works without ``steam/protobufs/`` on ``sys.path``.
+* ``.pyi`` — ``DESCRIPTOR: _descriptor.Descriptor`` overrides inside each
+  message class are stripped (they trip
+  ``reportIncompatibleVariableOverride`` under types-protobuf 7.34+; the
+  parent ``Message`` class's union type is inherited instead).
+
+VCR fixtures
+------------
+
+Web-facing tests (``test_webapi.py``, ``test_webauth.py``,
+``test_steamid.py``) replay recorded HTTP fixtures from ``vcr/*.yaml`` in
+``RecordMode.NONE`` — no live network, no credentials needed for CI.
+
+To regenerate the ``webapi.yaml`` cassette against a fresh Steam API
+response, copy ``.env.example`` to ``.env`` and fill in ``STEAM_API_KEY``
+(see the template for instructions on where to get one), then follow the
+regen recipe at the top of ``tests/test_webapi.py``.
+
+The ``webauth_*.yaml`` cassettes are regenerated by
+``tests/generete_webauth_vcr.py`` — needs real Steam credentials at run
+time; run interactively when the anonymized replay drifts from live.
+
+Live smoke test
+---------------
+
+Beyond the unit suite, the CM handshake / anonymous-login / PICS-fetch
+end-to-end flow can be smoke-tested against live Steam:
+
+.. code:: python
+
+    from steam.client import SteamClient
+
+    client = SteamClient()
+    assert client.anonymous_login()
+    resp = client.get_product_info(apps=[553850], timeout=15)  # Helldivers 2
+    print(resp['apps'][553850]['common']['name'])
+    client.logout()
+    client.disconnect()
+
+Layout
+------
+
+.. code::
+
+    steam/
+    ├── steam/              # library source
+    │   ├── client/         # SteamClient, CDN, builtins/*
+    │   ├── core/           # CM protocol, message framing
+    │   ├── enums/          # SteamIntEnum wrappers (common.py hand-written,
+    │   │                   #   proto.py auto-generated by pb-gen-enums)
+    │   ├── protobufs/      # generated *_pb2.py + *_pb2.pyi
+    │   └── utils/
+    ├── scripts/            # poetry console-script entry points (pb-*)
+    ├── protobufs/          # .proto sources (fetched by pb-fetch)
+    ├── typings/            # local pyright stubs (see typings/…/builder.pyi
+    │                       #   for the BuildServices typeshed override)
+    ├── tests/              # pytest suite
+    ├── vcr/                # recorded HTTP fixtures for offline test replay
+    ├── docs/               # Sphinx source (rendered at steam.readthedocs.io
+    │                       #   — kept in-tree but not currently deployed
+    │                       #   from this fork)
+    └── pyproject.toml      # poetry config + [tool.pyright]
+
+Upstream links (reference only — refer to this fork for maintained code):
+
+* Upstream: https://github.com/ValvePython/steam
+* Old docs: https://steam.readthedocs.io/en/latest/  (mostly still
+  applicable — the library shape has not diverged from upstream, only its
+  Python-runtime and protobuf-vintage baseline)
+* Command-line companion (unmaintained upstream):
+  https://github.com/ValvePython/steamctl
+
+License
+-------
+
+MIT (unchanged from upstream).  See ``LICENSE``.

pysteam_client-1.4.6/pyproject.toml

@@ -0,0 +1,190 @@
+[tool.poetry]
+# ``name`` is the distribution name on PyPI (``pip install pysteam-client``);
+# ``packages`` below keeps the import module ``steam`` unchanged so consumer
+# code still writes ``from steam.client import SteamClient``.  The upstream
+# ``steam`` distribution name on PyPI is owned by ValvePython since 2013,
+# so the fork lives under a scoped name here.
+name = "pysteam-client"
+version = "1.4.6"
+description = "Module for interacting with various Steam features"
+authors = ["Rossen Georgiev <rossen@rgp.io>"]
+license = "MIT"
+readme = "README.rst"
+homepage = "https://github.com/ValvePython/steam"
+repository = "https://github.com/H47R15/steam"
+keywords = ["valve", "steam", "steamid", "api", "webapi", "steamcommunity"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Natural Language :: English",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3.13",
+]
+packages = [
+  { include = "steam" },
+  # Dev-only helpers exposed as poetry console scripts (see
+  # ``[tool.poetry.scripts]`` below).  Shipped alongside the runtime
+  # package so ``poetry install`` registers the ``pb-*`` entrypoints on
+  # PATH — the modules themselves are only imported when a script is
+  # explicitly invoked, so pulling them in has zero runtime cost for
+  # library consumers.
+  { include = "scripts" },
+]
+
+# ─── console scripts ─────────────────────────────────────────────
+#
+# After ``poetry install`` these are on PATH inside the venv, so a
+# maintainer can run e.g. ``poetry run pb-compile`` from the package
+# root without spelling out the full ``python scripts/…`` path.
+[tool.poetry.scripts]
+pb-fetch     = "scripts.pb_fetch:main"
+pb-compile   = "scripts.pb_compile:main"
+pb-services  = "scripts.pb_services:main"
+pb-gen-enums = "scripts.pb_gen_enums:main"
+pb-update    = "scripts.pb_update:main"
+vcr-webapi   = "scripts.vcr_webapi:main"    # regen vcr/webapi.yaml (needs STEAM_API_KEY)
+vcr-webauth  = "scripts.vcr_webauth:main"   # regen vcr/webauth_*.yaml (interactive)
+
+[tool.poetry.dependencies]
+# Pinned to Python 3.13.11.
+python =                "^3.13.11"
+
+# ─── runtime deps (from the original setup.py) ────────────────────
+#
+# The legacy ``win-inet-pton`` (py2.7 Windows shim) and
+# ``enum34`` (py<3.4 stdlib backport) constraints from setup.py
+# were dropped — this fork targets py3.13 only, both are provided
+# by the modern stdlib.
+pycryptodomex =         ">=3.7.0"
+requests =              ">=2.9.1"
+urllib3 =               "<2"
+vdf =                   ">=3.3"
+cachetools =            ">=3.0.0"
+# ``six`` is a py2/py3 compat shim.  Kept because the fork's
+# source still imports it in a few places; harmless on py3.13.
+six =                   ">=1.10.0"
+
+# ─── client extra (optional deps) ─────────────────────────────────
+#
+# The ``client`` extra pulls in the gevent-based SteamClient — same
+# split as the original setup.py's ``install_extras['client']``.
+# Enable with:  poetry install --extras client
+#
+# ``protobuf`` bumped from the original ``~=3.0`` to ``>=5.26,<7``.
+# The fork's ``steam/protobufs/*_pb2.py`` were originally protoc-3.x
+# generated (per-message ``_reflection.GeneratedProtocolMessageType``
+# + ``_sym_db.RegisterMessage``); protoc-5.x/6.x emits far cleaner
+# code (``_descriptor_pool.AddSerializedFile`` + ``_builder`` — 20×
+# smaller files, zero descriptor-mutation, works cleanly under
+# Pylance).  Runtime protobuf 5.26+ has ``google.protobuf.runtime_version``
+# which the modern codegen calls at import time to validate the
+# generator/runtime pair — 5.26 is the earliest release that ships
+# it, and py3.13 wheels ship from 5.28 onward.  Upper bound ``<7``
+# reserves the next major bump for a deliberate migration, not an
+# accidental one.
+gevent =                { version = ">=1.5.0",  optional = true }
+protobuf =              { version = ">=5.26,<7", optional = true }
+gevent-eventemitter =   { version = ">=2.1",    optional = true }
+
+[tool.poetry.extras]
+client = ["gevent", "protobuf", "gevent-eventemitter"]
+
+# ─── dev deps (from the original dev_requirements.txt) ────────────
+#
+# ``mock`` is part of the stdlib as ``unittest.mock`` on py3.3+,
+# but the fork's test files still ``import mock`` (the
+# py2.7-compatible pattern) so we keep the PyPI ``mock`` package
+# as a dev dep — it's a stdlib passthrough on modern Python,
+# harmless overhead, and rewriting the 7 test files to
+# ``from unittest import mock`` would be pure churn.
+# ``coveralls-python`` git fork was py2.7-specific and was dropped.
+# Everything else was bumped past the py3.13 wheel cliff (vcrpy
+# 2.x has no py3.13 wheels; 5.x does).
+[tool.poetry.group.dev.dependencies]
+mock =                  ">=5.0"
+vcrpy =                 ">=5.0"
+PyYAML =                ">=6.0"
+coverage =              ">=7.0"
+pytest =                ">=8.0"
+pytest-cov =            ">=4.0"
+coveralls =             ">=3.3"
+deptry =                "^0.23.0"
+# Typeshed stubs for the ``google.protobuf`` runtime — gives Pylance
+# the base ``Message`` class's methods (``ParseFromString`` /
+# ``SerializeToString`` / …) that the domain ``.pyi`` stubs below
+# inherit from.  Dev-only because it ships only ``.pyi`` files with
+# no runtime impact.
+types-protobuf =        ">=4.24"
+# ``mypy-protobuf`` ships a ``protoc-gen-mypy`` plugin that emits
+# a ``.pyi`` companion next to every ``*_pb2.py`` when protoc is
+# invoked with ``--mypy_out``.  Dev-only — used by the ``pb_compile``
+# Makefile target when regenerating from upstream ``.proto`` files;
+# never imported at runtime.
+#
+# ``mypy-protobuf`` bumped to the modern line now that the runtime
+# ``protobuf`` pin is ``>=5.26`` — 5.x mypy-protobuf matches the
+# 5.x/6.x protoc + runtime that Pylance's typeshed stubs are
+# generated against, so the emitted ``.pyi`` files line up with what
+# static analysers already expect.
+mypy-protobuf =         ">=3.6"
+
+# ─── deptry ignores ───────────────────────────────────────────────
+#
+# The client extras are legitimately optional runtime deps that the
+# fork's non-client modules don't import — deptry's DEP002 (unused)
+# would flag them under a default install, so ignore explicitly.
+python-dotenv = "^1.2.2"
+[tool.deptry.per_rule_ignores]
+DEP002 = ["gevent", "protobuf", "gevent-eventemitter", "six", "types-protobuf", "mypy-protobuf"]
+
+[tool.deptry.package_module_name_map]
+# Underscore vs hyphen in the extras names.
+gevent_eventemitter = "gevent-eventemitter"
+
+# ─── pyright / Pylance ─────────────────────────────────
+#
+# ``stubPath = "typings"`` points pyright at our local stub overrides
+# under ``typings/`` (default pyright convention, but must be enabled
+# explicitly).  Currently patches one typeshed bug:
+#   google/protobuf/internal/builder.pyi — ``BuildServices`` param typing
+# See the stub file's docstring for the full rationale.
+[tool.pyright]
+stubPath = "typings"
+
+# ─── semantic-release  ──────────────────
+[tool.semantic_release]
+version_toml = [ "pyproject.toml:tool.poetry.version" ]
+version_source = "toml"
+branch = "master"
+upload_to_PyPI = false
+github_release = false
+commit_author = "github-actions[bot] <github-actions[bot]@users.noreply.github.com>"
+upload_to_release = false
+tag_format = "steam-v{version}"
+
+[tool.semantic_release.commit_parser_options]
+allowed_tags = [
+    "build",
+    "chore",
+    "ci",
+    "docs",
+    "feat",
+    "fix",
+    "perf",
+    "style",
+    "refactor",
+    "test",
+    "MAJOR",
+    "BREAKING",
+    "breaking",
+    "BREAKING CHANGE",
+    "breaking change",
+]
+minor_tags = ["feat"]
+patch_tags = ["fix", "perf"]
+major_tags = ["MAJOR", "BREAKING",  "BREAKING CHANGE", "breaking change"]
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"

pysteam_client-1.4.6/scripts/__init__.py

@@ -0,0 +1,7 @@
+"""Dev-only helpers exposed as poetry console scripts.
+
+See ``pyproject.toml``'s ``[tool.poetry.scripts]`` block for the console
+entries (``pb-fetch`` / ``pb-compile`` / ``pb-services`` / ``pb-gen-enums``
+/ ``pb-update``).  Each is a thin wrapper around one of this package's
+``main()`` functions.
+"""