Skip to main content

command line assistant and library for playing darts

Project description

pydartz

A Python3 assistant (and library) for playing darts

Play with your friends and keep track of your darts scores!

Features

  • arbitrary start value (501, 301, whatever positive number you like, ...)
  • unlimited number of players
  • scores can be passed in sum (i.e. the total visit) or throw by throw
  • finish suggestions
  • player database to keep track of player performance (average, highscore, finishes, etc.)
  • no external dependencies for basic functionality

Upcoming

TODO

  • full test coverage

Installation

pydartz requires Python 3.9 or higher.

From PyPI package

pip install --user -U pydartz

To enable sound support, either install additional dependencies

pip install --user -U pydartz[audio]

or set the PYDARTZ_MEDIA_PLAYER environment variable (default: mpv).

Using pipx

pipx install pydartz

Backwards compatibility

  • v1.2 is the last version to support Python 2.
  • v2.1.1 is the last version to support Python 3.6.
  • v2.2.0 is the last version to support Python 3.7.
  • v2.3.3 is the last version to support Python 3.8.

Usage

Command line assistant

Execute pydartz in the command line to start a classic 501 game. The setup instructions should be self-explanatory.

When the game starts, the program expects a player's score as an input. There are various options:

  1. You sum up the three throws of your visit yourself. Say you score 60, 5 and 1, i.e. a total of 66. You type 66d and hit enter. The suffix d indicates that your done.
  2. You directly enter after each throw. Say you score a triple 19, so you type 57 and hit enter. The prompt shows that you have two darts left. Repeat or use method 1.
  3. You busted. Type b and hit enter.
  4. Invalid input is not processed, please enter a correct value the next time.
  5. The program takes some constraints into account to check if your input is valid (e.g. total visit sum <= 180). Try to trick it and submit an issue if you found a glitch.

When the game is finished (i.e. one player has won the specified number of legs), the program asks whether you want to play again. Answer

  1. y (YES) if you want a rematch using the same settings
  2. n (NO) if you want to play again but re-define the settings
  3. q (QUIT) if you want to quit the application

Library

pydartz provides an API to include the dart assisting functionality into custom projects. Subclass communication.CommunicatorBase, create a game.Game object and run() it! Note that this call blocks until the user decides to quit. You might decide to execute it in a separate thread.

Example: I have a Raspberry/Arduino/ROS project. The custom communicator uses a ROS publisher to forward information to an LCD, taking the limited character width into account. Input requests are implemented using ROS client calls to the server (the Arduino listening for keypresses).

I can see a GUI being built on top of the library.

IMPORTANT

The last visit has to be entered throw by throw. Otherwise, the evaluation of the total number of throws per visit is not correct!

For displaying player statistics, type pydartz --stats <player_name>. You can put any number of names. Without any name, information of all players is printed.

Also, see the output of pydartz --help.

Have fun!

Example

Watch MVG casually nailing a 9 darter:

> pydartz
Nr of players: 1
Name of player 1: MVG
Start value: 501
Nr of legs: 1
MVG has 501 and three darts left.
MVG's score: 180
MVG has 321 and three darts left.
MVG's score: 180
MVG has 141 and three darts left.
Finish options:
    T20 T19 D12
MVG's score: 60
MVG has 81 and two darts left.
Finish options:
    T19 D12
    T15 D18
MVG's score: 57
MVG has 24 and one dart left.
MVG's score: 24
    MVG:  1
================================================================================
> pydartz -s MVG
MVG:
Legs won: 1
Average: 167.00
Highscore: 180
Finishes:
    141: 1
Darters:
      9-darter: 1

Credits

Development

Install from source

Get the source code

git clone https://github.com/pylipp/pydartz
cd pydartz

Install to a virtualenv

python3 -m venv .venv
source .venv/bin/activate
make install

Test suite

make test

Coverage analysis

make coverage

Style checks

make style-check

Releasing

  1. git tag with new version number (scheme vX.Y.Z)
  2. make release

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pydartz-2.4.0.tar.gz (417.4 kB view details)

Uploaded Source

Built Distribution

pydartz-2.4.0-py3-none-any.whl (408.5 kB view details)

Uploaded Python 3

File details

Details for the file pydartz-2.4.0.tar.gz.

File metadata

  • Download URL: pydartz-2.4.0.tar.gz
  • Upload date:
  • Size: 417.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for pydartz-2.4.0.tar.gz
Algorithm Hash digest
SHA256 d4352f884bc5f5e670111c400fcbb830be241e0813f91e8ca408eeffef433ccf
MD5 85dee355a0cf48511df404079a58cd46
BLAKE2b-256 496f7fb8ce7f70068a5895b13bb0943b27c529d53910190035e4e0e41dece5fc

See more details on using hashes here.

Provenance

The following attestation bundles were made for pydartz-2.4.0.tar.gz:

Publisher: release.yml on pylipp/pydartz

Attestations:

File details

Details for the file pydartz-2.4.0-py3-none-any.whl.

File metadata

  • Download URL: pydartz-2.4.0-py3-none-any.whl
  • Upload date:
  • Size: 408.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for pydartz-2.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4151ca0214d9001812d7dee15768fd5e322b3f8a3466139f346042aa351520e9
MD5 cbabff499dacc47d2d729d709b7db226
BLAKE2b-256 f952a16e4120ef0a6c5927c59165b4c26d0cf70229ccd7786362ac94e8a3b9fe

See more details on using hashes here.

Provenance

The following attestation bundles were made for pydartz-2.4.0-py3-none-any.whl:

Publisher: release.yml on pylipp/pydartz

Attestations:

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page