Metadata-Version: 2.4
Name: rhythmgame-tools
Version: 2.0.0
Summary: Rhythm Game Toolset for VSRG - Modernized fork of reamberPy
Project-URL: Homepage, https://github.com/yaowan233/reamberPy
Project-URL: Documentation, https://eve-ning.github.io/reamberPy/index.html
Project-URL: Repository, https://github.com/yaowan233/reamberPy
Project-URL: Original Repository, https://github.com/Eve-ning/reamberPy
Project-URL: Issues, https://github.com/yaowan233/reamberPy/issues
Author-email: yaowan233 <572473053@qq.com>
Maintainer-email: yaowan233 <572473053@qq.com>
License: MIT
License-File: LICENSE
Keywords: bms,music-game,o2jam,osu,osumania,rhythm-game,stepmania,vsrg
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9.7
Requires-Dist: matplotlib>=3.8.0
Requires-Dist: numpy>=2.0.0
Requires-Dist: osrparse>=6.0.2
Requires-Dist: pandas>=2.1.1
Requires-Dist: pillow>=11.0.0
Requires-Dist: pyyaml>=6.0.1
Requires-Dist: tqdm>=4.67.0
Requires-Dist: unidecode>=1.3.7
Provides-Extra: dev
Requires-Dist: black>=24.3.0; extra == 'dev'
Requires-Dist: pytest>=7.4.2; extra == 'dev'
Requires-Dist: seaborn>=0.13.0; extra == 'dev'
Description-Content-Type: text/markdown

# Rhythm Game Tools (vsrg_tools)

**A modernized fork of [reamberPy](https://github.com/Eve-ning/reamberPy)**

[:blue_book: Original Wiki](https://eve-ning.github.io/reamberPy/index.html) & [Getting Started](https://eve-ning.github.io/reamberPy/info/GettingStarted.html)

`pip install rhythmgame-tools`

------

VSRG Toolbox for data extraction, manipulation & analysis.

## What's New in 2.0

- ✅ **Updated dependencies**: numpy 2.x, pandas 3.x, Python 3.14 support
- ✅ **Modern packaging**: Migrated from Poetry to native pyproject.toml with uv support
- ✅ **Bug fixes**: Fixed compatibility issues with latest Python and libraries

## Features

- Game Support: osu!mania, StepMania, BMS and partially O2Jam files.
- Algorithms: Map IO, Conversion, Map Image Generation, Pattern Extraction
- Data Architecture: Pandas DataFrame Integration

> This is built on pandas `DataFrame`, thus, if you need more control, you can 
retrieve the underlying `DataFrame` via the `.df` property on many vsrg_tools classes.

## Migration from reamber

Simply replace `reamber` with `vsrg_tools` in your imports:

```python
# Old
from reamber.osu import OsuMap

# New
from vsrg_tools.osu import OsuMap
```

## For Developers, By Developers

A growing amount of osu!mania players are interested in programming.
The best way to learn is to relate it to something that you're familiar with.

That's why this library allows you to tamper with your favorite
games, and learn on the way.

## Credits

Original library by [Evening (Eve-ning)](https://github.com/Eve-ning).
This is a community-maintained fork to keep the project alive and up-to-date.

