cheevy.py

by Tom Van Manen, released under Hippocratic License 2.1.

A quick CLI tool for grabbing achievements from TNNT (The November Nethack Tournament).

Installation

Get cheevy.py with

$ git clone "https://github.com/ciraben/cheevy"

Make the script executable with

$ chmod +x /path/to/cheevy.py

Get Python 3.

Install Python 3 dependencies with PyPi:

$ pip3 install requests BeautifulSoup4

Run cheevy.py with any of

$ python3 /path/to/cheevy.py
$ /path/to/cheevy.py
$ ./cheevy.py   # if current directory

The first time you run it, cheevy.py will prompt you for a hardfought.org username to inspect. Ensure proper capitalization. You can edit this at any time with the -n NAME argument.

By default, only user achievements are reported. For clan achievements, run with -c or --clan argument.

See ./cheevy.py --help for more options.

Including Current Game Achievements

To include current game results in cheevy.py output, you must first manually paste the results of the in-game #achievements command into dump.txt, and update as needed. (Automating this would be botting, which is against tournament rules.)

This means logging into your current game, typing in the #achievements extended command, and choosing option e (or b). Then paste the text output from your screen into dump.txt. Repeat for each page - order doesn't matter. It's fine to paste surrounding text too, or the whole window, no worries about that. See sample-dump.txt if you're unsure. Works with curses or tty.

I know this seems like a cumbersome "no bots" work-around, but it's actually pretty handy! Once you have your dump.txt in place, you can run subsequent searches for achievements you half-remember needing.

$ ./cheevy.py --include --search tree
✓ Isaac Newton                             Get fruit by kicking a tree
x Not The Bees                             Get bees by kicking a tree
$ ./cheevy.py -is bullwhip
x Indiana Jones                            Disarm a monster with a bullwhip

You can get a full night's sleep before your ascension run, without having to recall whether you nabbed that Oracle achievement on the way down.

$ ./cheevy.py -is oracle
x Sage Advice                              Consult the Oracle

And you can easily check whether those extra wands are worth something before dumping them.

$ ./cheevy.py -uis wand
x Predictably, Nothing Happens             Break an identified wand of nothing
x Dust to Dust                             Wrest one last charge from a wand of wishing
x The Deathly Hallows                      Wield a wand of death while wearing an invisibility cloak and amulet of life saving
x Wanton Waste                             Break an identified, charged wand of wishing
x Mikado                                   Identify all wands

With just a few keystrokes, cheevy.py takes care of searching and cross-referencing achievements for you, and keeps your focus on the game!📯