Skip to main content

A command line based wordle game

Project description

Wordle CLI Game

Play the classic Wordle game directly in your terminal! Guess the secret five letter word within six attempts!

See how it looks like!

Features

  • Interactive Gameplay: Receive immediate feedback on your guesses.
  • Colour Coded Hints: Letters are highlighted to indicate correct positions and presence in the secret word.
    • Requires a terminal that supports coloured output.
  • Command Support:
    • /list: Display the status of all letters.
    • /grid: View your current guesses and their evaluations.
    • /end: End the current wordle game.

Installation

Option 1: Install from PyPI (Recommended)

The easiest way to install and start playing is by using pip:

pip install pywordle-cli

Once installed, you can start the game by typing:

wordle

Option 2: Install from Source

If you'd like to install the package yourself, follow these steps:

  1. Clone the repository:

    git clone https://github.com/ousmanebarry/wordle-cli.git
    cd wordle-cli
    
  2. Install the package:

    pip install .
    
  3. Start the game:

    wordle
    

How to Play

  1. Gameplay Instructions:

    • Guessing: Enter a valid five letter word and press Enter.
    • Feedback:
      • Green: Correct letter in the correct position.
      • Yellow: Correct letter in the wrong position.
      • Red: Letter not in the secret word.
  2. Commands:

    • /list: Display the status of all letters.
    • /grid: View your current guesses and their evaluations.
    • /end: End the current wordle game.
  3. Winning the Game:

    • Guess the secret word within six attempts to win.
    • If you fail to guess correctly after six tries, the secret word will be revealed.

Dependencies

  • Python 3.7 or higher
  • colorama: For colored terminal text.
  • A terminal that supports ANSI color codes.

License

This project is licensed under the MIT License. See the LICENSE file for details.


Acknowledgements

Inspired by the original Wordle game.


Enjoy the game and happy guessing! 🎉

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

pywordle_cli-0.1.2.tar.gz (42.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pywordle_cli-0.1.2-py3-none-any.whl (41.8 kB view details)

Uploaded Python 3

File details

Details for the file pywordle_cli-0.1.2.tar.gz.

File metadata

  • Download URL: pywordle_cli-0.1.2.tar.gz
  • Upload date:
  • Size: 42.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.0.1 CPython/3.12.8

File hashes

Hashes for pywordle_cli-0.1.2.tar.gz
Algorithm Hash digest
SHA256 692767333c9ab4e60a38e5c1e48766a1f926b6b4d15f4ebb6124f472648fef2f
MD5 474572c58eb708fa6b90ab95e70e38f6
BLAKE2b-256 733726ea30f68836741bfb06ad1759be633c2f71462b2f929e0ba17f0b6cb460

See more details on using hashes here.

Provenance

The following attestation bundles were made for pywordle_cli-0.1.2.tar.gz:

Publisher: python-publish.yml on ousmanebarry/wordle-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pywordle_cli-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: pywordle_cli-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 41.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.0.1 CPython/3.12.8

File hashes

Hashes for pywordle_cli-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 6b1f38cca199f8ecce362ca4c75731b467ef53a86ffd8fa2e2b517c23bfd7f26
MD5 461167dbf553c029455e5129716522d4
BLAKE2b-256 64a8adc88705f74fefb2eda430127b1eb6445cbf0a6cae09671b9c9309ad5035

See more details on using hashes here.

Provenance

The following attestation bundles were made for pywordle_cli-0.1.2-py3-none-any.whl:

Publisher: python-publish.yml on ousmanebarry/wordle-cli

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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