quizzical


Namequizzical JSON
Version 0.2.1 PyPI version JSON
download
home_pageNone
SummaryA trivia quiz game for the terminal
upload_time2024-11-27 10:41:06
maintainerNone
docs_urlNone
authorNone
requires_python>=3.12
licenseLicense :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Quizzical

## Introduction

Quizzical is a terminal-based quiz game, using [The Open Trivia
Database](https://opentdb.com/) as the back end.

![Quizzical](https://raw.githubusercontent.com/davep/quizzical/main/images/quizzical.png)

## Installing

### pipx

The package can be installed using [`pipx`](https://pypa.github.io/pipx/):

```sh
$ pipx install quizzical
```

### Homebrew

The package is available via Homebrew. Use the following commands to install:

```sh
$ brew tap davep/homebrew
$ brew install quizzical
```

## Running

Once installed run the `quizzical` command.

## Playing the game

Hopefully the interface is pretty straightforward: run up the application,
use the `New` button to create a new quiz with your choice of parameters,
use the `Run` button to play a game. When you run a new game you'll be shown
the parameters:

![Starting a new quiz](https://raw.githubusercontent.com/davep/quizzical/main/images/start-quiz.png)

and once you start you'll be shown a series of questions; press keys
<kbd>1</kbd>, <kbd>2</kbd>, <kbd>3</kbd> or <kbd>4</kbd> to answer each one.

![An example question](https://raw.githubusercontent.com/davep/quizzical/main/images/question.png)

Once the quiz is over you can view your results and see which answers were
right and which were wrong:

![Viewing some results](https://raw.githubusercontent.com/davep/quizzical/main/images/results.png)

## Getting help

If you need help, or have any ideas, please feel free to [raise an
issue](https://github.com/davep/quizzical/issues) or [start a
discussion](https://github.com/davep/quizzical/discussions).

## TODO

Things I'm considering adding or addressing:

- [ ] Add session token support (less frequent question repeats).
- [ ] More quiz information in the main quiz list.
- [ ] Record scores for each game played, provide a history view.
- [ ] Allow answering a question with the mouse.

[//]: # (README.md ends here)

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "quizzical",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.12",
    "maintainer_email": null,
    "keywords": null,
    "author": null,
    "author_email": "Dave Pearson <davep@davep.org>",
    "download_url": "https://files.pythonhosted.org/packages/74/d0/02e1211ef145f1a1c3ba8e54d772b136a7555bd8d86ad7c61864610b7160/quizzical-0.2.1.tar.gz",
    "platform": null,
    "description": "# Quizzical\n\n## Introduction\n\nQuizzical is a terminal-based quiz game, using [The Open Trivia\nDatabase](https://opentdb.com/) as the back end.\n\n![Quizzical](https://raw.githubusercontent.com/davep/quizzical/main/images/quizzical.png)\n\n## Installing\n\n### pipx\n\nThe package can be installed using [`pipx`](https://pypa.github.io/pipx/):\n\n```sh\n$ pipx install quizzical\n```\n\n### Homebrew\n\nThe package is available via Homebrew. Use the following commands to install:\n\n```sh\n$ brew tap davep/homebrew\n$ brew install quizzical\n```\n\n## Running\n\nOnce installed run the `quizzical` command.\n\n## Playing the game\n\nHopefully the interface is pretty straightforward: run up the application,\nuse the `New` button to create a new quiz with your choice of parameters,\nuse the `Run` button to play a game. When you run a new game you'll be shown\nthe parameters:\n\n![Starting a new quiz](https://raw.githubusercontent.com/davep/quizzical/main/images/start-quiz.png)\n\nand once you start you'll be shown a series of questions; press keys\n<kbd>1</kbd>, <kbd>2</kbd>, <kbd>3</kbd> or <kbd>4</kbd> to answer each one.\n\n![An example question](https://raw.githubusercontent.com/davep/quizzical/main/images/question.png)\n\nOnce the quiz is over you can view your results and see which answers were\nright and which were wrong:\n\n![Viewing some results](https://raw.githubusercontent.com/davep/quizzical/main/images/results.png)\n\n## Getting help\n\nIf you need help, or have any ideas, please feel free to [raise an\nissue](https://github.com/davep/quizzical/issues) or [start a\ndiscussion](https://github.com/davep/quizzical/discussions).\n\n## TODO\n\nThings I'm considering adding or addressing:\n\n- [ ] Add session token support (less frequent question repeats).\n- [ ] More quiz information in the main quiz list.\n- [ ] Record scores for each game played, provide a history view.\n- [ ] Allow answering a question with the mouse.\n\n[//]: # (README.md ends here)\n",
    "bugtrack_url": null,
    "license": "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)",
    "summary": "A trivia quiz game for the terminal",
    "version": "0.2.1",
    "project_urls": {
        "Discussions": "https://github.com/davep/quizzical/discussions",
        "Documentation": "https://github.com/davep/quizzical/blob/main/README.md",
        "Homepage": "https://github.com/davep/quizzical",
        "Issues": "https://github.com/davep/quizzical/issues",
        "Repository": "https://github.com/davep/quizzical",
        "Source": "https://github.com/davep/quizzical"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "8a8d6f039814a3d461d81acab84425a11066e84c8057750065492611da2206cd",
                "md5": "ba347153b1fb86b94ea661a6188e5ce1",
                "sha256": "d07edd385098ce4cd23f417b6166dad2c2e7e2e387205428f06175bd854a2f61"
            },
            "downloads": -1,
            "filename": "quizzical-0.2.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "ba347153b1fb86b94ea661a6188e5ce1",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.12",
            "size": 37541,
            "upload_time": "2024-11-27T10:41:04",
            "upload_time_iso_8601": "2024-11-27T10:41:04.506438Z",
            "url": "https://files.pythonhosted.org/packages/8a/8d/6f039814a3d461d81acab84425a11066e84c8057750065492611da2206cd/quizzical-0.2.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "74d002e1211ef145f1a1c3ba8e54d772b136a7555bd8d86ad7c61864610b7160",
                "md5": "0def69021c31911c88134ef79fda471c",
                "sha256": "1cd9d75ef4f35eea0215d3fc0702bba2551acba8f010df28c714d8b075065dca"
            },
            "downloads": -1,
            "filename": "quizzical-0.2.1.tar.gz",
            "has_sig": false,
            "md5_digest": "0def69021c31911c88134ef79fda471c",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.12",
            "size": 493825,
            "upload_time": "2024-11-27T10:41:06",
            "upload_time_iso_8601": "2024-11-27T10:41:06.883072Z",
            "url": "https://files.pythonhosted.org/packages/74/d0/02e1211ef145f1a1c3ba8e54d772b136a7555bd8d86ad7c61864610b7160/quizzical-0.2.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-11-27 10:41:06",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "davep",
    "github_project": "quizzical",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "quizzical"
}
        
Elapsed time: 0.52144s