AIOSTEAMPY

Previously this library was a soft fork of bukson/steampy with intend to provide asynchronous methods and proxies support. But now it standalone project.

> Created for steam trading purposes mostly. Inspired by DoctorMcKay/node-steamcommunity

> [!IMPORTANT] > The project is unstable and there might be some breaking changes in the future unless stable (first major) version > is released. > > Take a look at TODO > > See full documentation here 📖

Installation

pip install aiosteampy

pipenv install aiosteampy

poetry add aiosteampy

Project have some extras currencies converter, socks proxies. To install them all, please, use aiosteampy[all] install target:

poetry add aiosteampy[all]

> [!TIP] > aiohttp docs recommends installing > speedups (aiodns, cchardet, ...)

AIOSTEAMPY use aiohttp underneath to do asynchronous requests to steam servers, with modern async/await syntax.

Key features ✨

• Stateless: low-middle layer API wrapper of some steam services and methods like market, tradeoffers, confirmations, steamguard, etc.
• Declarative: there is models or TypedDicts for every data.
• Typed: High-end support with extensive typing, tested on VSCode and PyCharm.
• Simple: Fit most important related to steam trading process methods.
• Web proxy support.

What can I do with this

• Operate with steam trade offers.
• Sell, buy items on market. Place, cancel orders.
• Login trough steam to 3rd party sites.
• Fetch data from market.
• Manipulate many accounts with proxies for each session.
• Get and load cookies to stay logged in (session persistence).
• Convert market prices into different currencies.

What I can't do

• Chat.
• Get apps, packages.
• All, that need connection to CM.
• Interact with game servers (inspect CS2 (ex. CSGO) items, ...).
• Social interaction(groups, clans).
• Handle entities (listings, items, tradeoffers) lifecycle for easy if you need to store it.

Tests 🧪

> [!WARNING] > Test cases and test code as a whole are deprecated and will not work until they are updated (a lot of work). > I'll leave the code and this heading here as a reminder 🫣

[//]: # (Read test documentation 📖)

TODO 📃

> Hard to say roadmap. Can be a little changed or updated later, get ready.

Path to first stable release. Non-exhaustive list, scheduled tasks can be done earlier than the version mentioned, but not otherwise.

v0.6.0

• [x] Listings, items, offers pagination/iteration
• [x] Get single item from inventory as browser does
• [x] Change client username method

v0.7.0

• [x] Remove storage methods. Caching entities must be user responsibility
• [x] Rename fetch_... methods to get_... to remove annoying methods symantic mess
• [x] Web browser mechanism to fetch trade offers from Steam, avoiding Steam Web Api
• [x] Edit profile privacy settings

v0.8.0

• [ ] Context managers as helpers to login/logout, load/dump or get/put cookies
• [x] Fetch/paginate over market search pages

v0.9.0

• [ ] Steam user model with minimal attrs, retrieving/fetching
• [x] Refresh access_token mechanism

v1.0.0

• [ ] Tests with Steam API mocking. Target coverage ~70%. Key points (listings, inventory items, trade offers) testing suits is mandatory
• [ ] Maturity, battle-testing in more different cases by more participants/users

Contribution 💛

There is no rules or requirements to contribute. Feedbacks, suggests, other are welcome. I will be very grateful for helping me get the things right.

Credits

• bukson/steampy
• aiohttp-socks
• croniter
• DoctorMcKay/node-steamcommunity
• Identifying Steam items
• Revadike/InternalSteamWebAPI
• Gobot1234/steam.py
• Steam Market id's storage repo
• steamapi.xpaw.me
• Steam Exchange Rate Tracker
• ethanfurman/aenum