Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/woctezuma/match-steam-tags
Match Steam tags with appIDs. Available on PyPI.
https://github.com/woctezuma/match-steam-tags
steam steam-api steam-games steam-tags
Last synced: 23 days ago
JSON representation
Match Steam tags with appIDs. Available on PyPI.
- Host: GitHub
- URL: https://github.com/woctezuma/match-steam-tags
- Owner: woctezuma
- License: mit
- Created: 2019-04-06T11:01:02.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-03-14T22:27:38.000Z (10 months ago)
- Last Synced: 2024-03-14T23:33:58.685Z (10 months ago)
- Topics: steam, steam-api, steam-games, steam-tags
- Language: Python
- Homepage: https://pypi.org/project/steamtags/
- Size: 33.2 KB
- Stars: 2
- Watchers: 4
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Match Steam Tags
[![PyPI status][pypi-image]][pypi]
[![Build status][build-image]][build]
[![Code coverage][codecov-image]][codecov]
[![Code Quality][codacy-image]][codacy]
This repository contains Python code to match Steam tags with appIDs.
## Installation
The code is packaged for [PyPI](https://pypi.org/project/steamtags/), so that the installation consists in running:
```bash
pip install steamtags
```
## Usage
### Load genres and tags
Ideally, data is loaded from a local cache.
Data is downloaded (and cached) if the local cache is:
- either unavailable,
- or obsolete, i.e. downloaded on a previous day.
```python
import steamtags
genres_dict, tags_dict = steamtags.load()
```
### Download genres and tags
**Caveat**: in the use case described below, data is not locally cached!
SteamSpy provides several Top-100 game rankings:
- `top100in2weeks`, with respect to the number of players in the last two weeks
- `top100forever`, with respect to the number of players since March 2009
- `top100owned`, with respect to the estimated number of owners
These rankings can be used to retrieve and aggregate genres and tags, as such:
```python
import steamtags
genres_dict, tags_dict = steamtags.download(data_source='top100in2weeks')
```
## References
- An exhaustive list of tags can be found in [`steam-labs-recommender`](https://github.com/woctezuma/steam-labs-recommender).
- [`gamedatacrunch`][gamedatacrunch-api]@[PyPI][gamedatacrunch-pypi]: an API to download data through [GameDataCrunch API][gamedatacrunch].
- [`steamspypi`][steamspy-api]@[PyPI][steamspy-pypi]: an API to download data through [SteamSpy API][steamspy-api-docs].
[gamedatacrunch-api]:
[gamedatacrunch-pypi]:
[gamedatacrunch]:
[steamspy-api]:
[steamspy-pypi]:
[steamspy-api-docs]:
[pypi]: https://pypi.python.org/pypi/steamtags
[pypi-image]: https://badge.fury.io/py/steamtags.svg
[build]:
[build-image]:
[publish-image]:
[pyup]:
[dependency-image]:
[python3-image]:
[codecov]:
[codecov-image]:
[codacy]:
[codacy-image]: