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.1.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.1-py3-none-any.whl (41.7 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: pywordle_cli-0.1.1.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.1.tar.gz
Algorithm Hash digest
SHA256 4a4b17ad89e86b45529703b428d31cc4f43d3c0248ccdbe8b21dd1b1f5b3eea6
MD5 48bf60d58c22541df11009027c634d2d
BLAKE2b-256 f5b0892bbf39aa66e2cbdf55070b813f77f5c27d0a7c500dad19445d5a068014

See more details on using hashes here.

Provenance

The following attestation bundles were made for pywordle_cli-0.1.1.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.1-py3-none-any.whl.

File metadata

  • Download URL: pywordle_cli-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 41.7 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b91161ef3d8140efc3c3ddc47e5cde6fd4c50c2771215840d12255aa39fa1155
MD5 c8586ff5769aba3fd24f2d369c03f9a2
BLAKE2b-256 87294bb2f378a0530e8b41f4226bb4828400ad9a1eaae8375f9d0c0b5c534a13

See more details on using hashes here.

Provenance

The following attestation bundles were made for pywordle_cli-0.1.1-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