Notice: Repository Deprecation

This repository is deprecated and no longer actively maintained. It contains outdated code examples or practices that do not align with current MongoDB best practices. While the repository remains accessible for reference purposes, we strongly discourage its use in production environments. Users should be aware that this repository will not receive any further updates, bug fixes, or security patches. This code may expose you to security vulnerabilities, compatibility issues with current MongoDB versions, and potential performance problems. Any implementation based on this repository is at the user's own risk. For up-to-date resources, please refer to the MongoDB Developer Center.

mongordle

Using MongoDB's Atlas with a collection of all of Wordle's possible answers, usefully indexed, the word_guesser.rb script provides possible solutions given word guesses and Wordle's response hints.

Setup

To use this tool, first import words.json into MongoDB Atlas:

mongoimport --uri "mongodb+srv://$ATLAS_USER:$ATLAS_PWD@$ATLAS_HOST/wordle" --collection words --file words.json --jsonArray --drop

If mongoimport isn't available on your system it can be downloaded as part of the MongoDB Database Tools package for your operating system.

Then, as you play Wordle, run word_guesser.rb providing each guessed word and the returned hints pattern. Like this:

$ ruby word_guesser.rb "ZESTY x~xxx"               
{"letters":{"$nin":["Z","S","T","Y"],"$all":["E"]},"letter2":{"$nin":["E"]}}
ABIDE
ABLED
ABODE
ABOVE
.
.
.
WOVEN
WREAK
WRECK
394

The output consists first of the constraints used on the .find() call to Atlas, for insight into how the guesses and associated match patterns are used to filter to the remaining possible solutions. Following the constraint criteria is a list of all possible solutions remaining, followed by the count of them.

The word_guesser.rb command-line syntax consists of up to 6 "<word guess> <pattern match to solution>" parameters. The match pattern must be 5 characters consisting of and positionally in sync with the associated word guess:

• x: the letter is not in the solution in this position, and perhaps not anywhere in the solution (Wordle's grey box)
• ~: the letter is in the solution, but not in this position (Wordle's yellow box)
• ^: the letter is correct, in this position (Wordle's green box)

Continuing with the above example, picking one of the words returned:

$ ruby word_guesser.rb "ZESTY x~xxx" "BREAD x~^~x" 
{"letters":{"$nin":["Z","S","T","Y","B","D"],"$all":["E","R","A"]},"letter2":{"$nin":["E","R"]},"letter3":{"$eq":"E"},"letter4":{"$nin":["A"]}}
OPERA
1

Voila, a win in three tries!