[rpsls-web.git] / api.py

# TODO: utiliser hug https://www.hug.rest/website/quickstart
# pour implémenter une API permettant d'obtenir :

# - les parties d'un joueur donné / avec ou sans les coups ?
#   (contre un joueur précis, qu'il a gagnées/perdues, à la date D...)
# - des joueurs par identifiant(s), ou par motifs sur le nom.

# L'idée étant, par exemple, de pouvoir créer un site sur lequel
# s'afficherait un "leaderboard" (comme sur fishrandom.io), et où
# on pourrait rejouer des parties, etc.

# => Requêtes plus complexes à construire ensuite ; exemples :
# - nombre maximal de parties gagnées d'affilée ?
# - pourcentage de victoires ?

# On peut aussi imaginer écrire dans la base depuis l'API :
# par exemple pour permettre de jouer des tournois.
# --> création d'une table "Tournaments",
#     ajout d'un champ "tid" dans la table Games (NULL par défaut),
#     ajout d'un paramètre optionnel après #!/play : ID de partie
#     (permet de récupérer l'adversaire ID + nom via XHR ...etc)
#     (si adversaire absent à la connexion, le signaler et attendre)

RPSLS_PATH = './' #edit if launched from elsewhere
DB_PATH = RPSLS_PATH + 'db/rpsls.sqlite'
# ...

# Extension : on peut aussi permettre de choisir le nombre de rounds.
Commit	Line	Data
	1	# TODO: utiliser hug https://www.hug.rest/website/quickstart
	2	# pour implémenter une API permettant d'obtenir :
	3
	4	# - les parties d'un joueur donné / avec ou sans les coups ?
	5	# (contre un joueur précis, qu'il a gagnées/perdues, à la date D...)
	6	# - des joueurs par identifiant(s), ou par motifs sur le nom.
	7
	8	# L'idée étant, par exemple, de pouvoir créer un site sur lequel
	9	# s'afficherait un "leaderboard" (comme sur fishrandom.io), et où
	10	# on pourrait rejouer des parties, etc.
	11
	12	# => Requêtes plus complexes à construire ensuite ; exemples :
	13	# - nombre maximal de parties gagnées d'affilée ?
	14	# - pourcentage de victoires ?
	15
	16	# On peut aussi imaginer écrire dans la base depuis l'API :
	17	# par exemple pour permettre de jouer des tournois.
	18	# --> création d'une table "Tournaments",
	19	# ajout d'un champ "tid" dans la table Games (NULL par défaut),
	20	# ajout d'un paramètre optionnel après #!/play : ID de partie
	21	# (permet de récupérer l'adversaire ID + nom via XHR ...etc)
	22	# (si adversaire absent à la connexion, le signaler et attendre)
	23
	24	RPSLS_PATH = './' #edit if launched from elsewhere
	25	DB_PATH = RPSLS_PATH + 'db/rpsls.sqlite'
	26	# ...
	27
	28	# Extension : on peut aussi permettre de choisir le nombre de rounds.