Skip to main content

A simple CLI quizz game

Project description

🤔 ankamantatra

Techzara WCC2 final week

A simple CLI quizz game.

The name ankamantatra is a malagasy word that means riddle.

The user can play within a specific category or mix them all. A game session consists of 4 questions, each of different type. A the end of a session, the user is prompted whether he wants to play again or not.

preview.gif

⚒️ Installation

To install from pypi, type in the terminal:

pip install ankamantatra

Or you can clone this repository and install it manually using poetry, a tool for dependency management and packaging in Python, by following the following steps :

git clone https://github.com/twisty-team/ankamantatra.git
pip install poetry
# in the project root directory
poetry build && poetry install

In some cases you may get a KeyringLocked error that you can bypass by typing :

export PYTHON_KEYRING_BACKEND=keyring.backends.null.Keyring

🏃 How to run

If you installed the package with pip, you can run the game by typing in the terminal :

ankamantatra

If you installed it manually using poetry, you can run the game by typing :

poetry run python -m ankamantatra

▶ Usage

Usage: ankamantatra [OPTIONS] COMMAND [ARGS]...

  A simple quizz game CLI

Options:
  --version  Show the version and exit.
  --help     Show this message and exit.

Commands:
  list  List all available questions to play with.
  play  Use to play quiz game

Usage: python -m ankamantatra play [OPTIONS]

  Use to play quiz game

Options:
  -c, --categorie TEXT  Specify Quiz categorie
  --help                Show this message and exit.
Usage: python -m ankamantatra list [OPTIONS]

  List all available questions to play with.

Options:
  -c, --category TEXT   Filter by TEXT
  -sa, --show-answer
  -sc, --show-category
  --category-only       Show only the categories and hide questions
  --help                Show this message and exit.

🚀 Features

  • Play quizz
  • List questions or categories

Authors

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

ankamantatra-1.0.0.tar.gz (9.8 kB view hashes)

Uploaded Source

Built Distribution

ankamantatra-1.0.0-py3-none-any.whl (11.1 kB view hashes)

Uploaded Python 3

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