Skip to content

🏐 [WIP] Python client for the Volleyball Information System (FIVB VIS)

License

Notifications You must be signed in to change notification settings

claromes/fivbvis

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

55 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

FIVB VIS Python Client

PyPI Development Status :: 4 - Beta PyPI

The package fivbvis is a Python client library for easy integration with the Volleyball Information System Web Service 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

pip install fivbvis

Usage

Basic example:

from fivbvis import Volleyball

v = Volleyball()
v.getVolleyMatch(9211, fields="City CountryName DateLocal TeamNameA TeamNameB")

XML response:

<VolleyballMatch
   City="Nagoya"
   CountryName="Japan"
   DateLocal="2018-10-07"
   TeamNameA="Germany"
   TeamNameB="Brazil"
   No="9211"
   Version="2393792"/>

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 for detailed information and examples.

This list contains all available requests via VIS web service; those with links are documented. Currently, this Python client is read-only.

Author

Claromes