This is a fork of Phazic's Ascension Log Visualizer, a utility for parsing KoLmafia ascension logs into standard, more readable formats. My intent is to bring this tool back to the present.
Go to a Git directory and run
git clone https://github.com/m-e-meyer/kol-alv4
This will create a directory named kol-alv4. Go into that directory and, assuming you have ant, just run
ant
This will create alv.jar.
You can run alv.jar like any other jar, with
java -jar alv.jar [ <options> ] [ <mafia-log-directory> [ <parsed-log-directory> ] ]
Running it without the -p option or its synonyms brings up a GUI, with all options and parameters ignored. If you use the -p option or a synonym, then ALV will parse logs according to the options and parameters and quit. ALV takes the following parameters:
-p or -parse or --parse: Generate the parsed logs for the specified ascensions and quit.The following format options are available. They are not mutually exclusive. If no format options are given, then only a plaintext parsed log (--text) will be generated:
-text or --text: Generate parsed logs in plaintext format. -xml or --xml: Generate parsed logs in XML format. -html or --html: Generate parsed logs in HTML format. -bbcode or --bbcode: Generate parsed logs in BBcode format. The following options allow you to specify ascensions to parse:
-a <asc> or --ascension <asc>: Begin parsing with ascension number asc. Note that this number is one below the ascesnion number given by http://koldb.com. -c <n> or -count <n> or --count <n>: Produce the specified number of parsed logs. Defaults to 1, unless neither -a, -d, or their synonyms are specified, in which case all Mafia logs are parsed. -d <yyyymmdd> or --date <yyyymmdd>: Begin parsing with the last ascension beginning on or before the specified date. The date is specified as an 8-digit sequence yyyymmdd where yyyy is the year, mm is the month, and dd is the day. For example, April 6, 2020, would be 20200406. -n <name> or --name <name>: Parse only logs belonging to player named name, handy if you have multis. Defaults to the player that has the most ascensions in the Mafia logs. ALV takes the following optional arguments:
<mafia-log-directory>: Specifies the directory from which to read the Mafia logs. Defaults to the directory from which Mafia logs were read most recently.<parsed-log-directory>: Specifies the directory to which to write the parsed logs. Defaults to the directory to which parsed logs were written most recently.Copyright (c) 2008-2020, developers of the Ascension Log Visualizer
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
The current author wishes to acknowledge those who have gone before him in creating this software, and those whose software we use in this software:
Thank you all!