Cadeupdater

	ATTENTION: This application is a third party tool.
	It has been developed independently by a Puzzle Pirate player(s). It is not created, supported, or endorsed by Three Rings or Grey Havens. Players use third party tools at their own risk. For a full list of third-party tools, see this category list. For official rules and regulations regarding the use and acceptable functionality of third-party tools, see this page.

Cadeupdater is a Windows console program to help YPPedia editors update the Blockade History pages a little quicker. It was created by Therobotdude. To download, skip to the downloads section.

License

See included file "license.txt" for licensing.

Features

• Oceans/islands listed in data file so more islands/oceans etc can be added later if need be. These allow quick-entering of islandnames etc.
• Automatic ocean history detection
• Add n blockades on any YYYY/MM/DD date later than one found in logs
• Island-name autocompletion
• Defender/Contender autocompletion using lists generated from Win/Loss records
• Automatic disambiguation handling (this means those disambiguations that work with template:blockade stats - e.g. [[Jinx (flag)|Jinx]]. {{DL}}, {{Emerald}} etc don't fare so well)
• Automatic cade numbering in numerals
• BK flag detection and strength/sinking options
• Automatic Win/Loss records updating

Limitations

• Cannot yet add notes.
• Does not yet check for flag activity (this would be tricky, since it only works with the data from one page right now). Any new flag is marked "check", otherwise record is left as it was previously. (Expect this to change soon!)
• Flags which have changed names have new entries in the Win/Loss section for each new name (this is the convention on pages as of March 2014). At some point an update will allow flags that change names to be listed under their newest name.
• Sadly the tool still uses dark-ages data processing (i.e. ASCII).
• Only works on Windows, for WinXP+. May become platform-independent in the future.
• Cannot undo incorrect entries.
• Can only enter one day at a time. To enter blockades on multiple dates, use the "run again" option.
• Can only append blockades to the page - not insert them anywhere! (in most use-cases this makes sense).

How to use

• Download (see downloads). Ensure MD5 checksum listed matches that of the compressed archive downloaded. Extract to somewhere suitable.
• Copy the wiki-markup (not HTML!) source of the blockade history page into a file.
• Run the program, type or paste in the file path\name. (If file in same directory as program then just use filename).
• Follow steps listed to build up profile of that blockade (this includes reading the relevant data off the notice board).
• Program outputs to file where it found source: to update replace the page content on the relevant blockade history page with the content of the file.
• Check that "Show changes" displays the changes expected, then hit Save.

Contact

For any questions, bugs, suggestions, angry rants, etc, leave a message on Therobotdude's talk page. Alternatively, contact Moomintroll on the Meridian Ocean in-game.

Downloads

Version	Notes	MD5-checksum (zip archive)	Download link
Version 1.0	First release	1BF2F17F215DF3DD69C8F831C083AAD8	Cadeupdater

A MD5-checksum validator can be found here. Please note that this applies to the zip archive, not the extracted binary.