https://github.com/claromes/fivbvis
🏐 [WIP] Python client for the Volleyball Information System (FIVB VIS)
https://github.com/claromes/fivbvis
beach-volleyball dataset fivb olympics python-client sports-analytics volley volleyball
Last synced: 3 months ago
JSON representation
🏐 [WIP] Python client for the Volleyball Information System (FIVB VIS)
- Host: GitHub
- URL: https://github.com/claromes/fivbvis
- Owner: claromes
- License: gpl-3.0
- Created: 2022-12-18T09:31:41.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-02-09T15:49:56.000Z (over 1 year ago)
- Last Synced: 2025-03-07T16:27:24.596Z (3 months ago)
- Topics: beach-volleyball, dataset, fivb, olympics, python-client, sports-analytics, volley, volleyball
- Language: Python
- Homepage: https://pypi.org/project/fivbvis
- Size: 77.1 KB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# FIVB VIS Python Client
[](https://pypi.org/project/fivbvis/)  [](https://pypistats.org/packages/fivbvis)
The package `fivbvis` is a Python client library for easy integration with the [Volleyball Information System Web Service](https://www.fivb.org/VisSDK/VisWebService) of the Fédération Internationale de Volleyball (FIVB), handling public data and only documented requests, and providing XML and JSON responses.
The VIS Web Service enables third party applications to access all public data about volleyball, beach volleyball and other events. This client facilitates access for Python programmers, enabling access to data such as articles, matches, events, images, players, player rankings, and tournaments.
It is compatible with Python versions 3.8 and above, but it has been tested specifically on versions 3.8 and 3.11.
## Installation
```shell
pip install fivbvis
```
## Usage
Basic example:
```python
from fivbvis import Volleyball
v = Volleyball()
v.getVolleyMatch(9211, fields="City CountryName DateLocal TeamNameA TeamNameB")
```
XML response:
```xml
```
## Documentation
The documentation is based on FIVB VIS Web Service requests. It is simple and includes only requests documented by the FIVB developer team. Check the [docs folder](https://github.com/claromes/fivbvis/blob/main/docs/documentation.md) for detailed information and examples.
[This list contains all available requests via VIS web service](https://www.fivb.org/VisSDK/VisWebService/#RequestList.html); those with links are documented. Currently, this Python client is read-only.
## Author
[Claromes](https://claromes.com)