Skip to content

zakikero/Woracle

Repository files navigation

Woracle

Woracle is a modern, minimal C++20 project that demonstrates clean, production-style engineering while tackling a classic constraint-solving challenge: building a command-line Wordle solver.

The codebase was restarted from scratch after removing an earlier Qt dependency, resulting in a lightweight, easy-to-review project that highlights core C++, algorithmic reasoning, and testable design.

Highlights

  • Problem-solving focus: implements Wordle-style deduction through iterative filtering of candidate words.
  • Modern C++ (C++20): clear separation of concerns and a compact architecture.
  • Cross-platform build with CMake: straightforward workflow aligned with real-world C++ projects.
  • Unit-tested: includes tests to validate solver logic and enable confident refactoring.

Repository layout

  • src/ — CLI entry point and solver implementation (WordleSolver).
  • tests/ — unit tests for deduction / filtering behavior.
  • CMakeLists.txt — build configuration.

Roadmap

  • Improve handling of duplicate-letter edge cases.
  • Add smarter guess strategy (scoring / ranking).
  • Enforce stricter feedback processing (g/y/b).
  • Expand unit test coverage.
  • Support loading word lists from a file.

License

See LICENSE.

About

a wordle solver

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors