Wikipedia:WikiProject edit counters/Flcelloguy's Tool
Appearance
This is an extension of Flcelloguy's Tool which processes the HTML from a contribs file and parses it into a file readable by the tool. It is not finished, but the core is done, so I'm publishing it as v1.00.
Titoxd(?!? - did you read this?) 04:21, 8 December 2005 (UTC)
Compiling and executing the tool requires the JDK for Java 1.4. However, from version 4.0 and onwards, it will require Java 5.0.
Requirements
- Minimal requirements: Java Development Kit from Sun. This comes with a Java compiler (javac.exe) that can be executed from the command line and the program can be executed using java.exe. So, only one download is needed: one from Sun Microsystems, which developed Java.
- With IDE: You must have a Java IDE and JDK (freeware available; see below). Thus, you must make two downloads - one from Sun Microsystems, which developed Java, and another from a Java run-time development program. We recommend JCreator, BlueJ, or Eclipse.
Temporary quick-start directions
- Download and install Java (see links below)
- Download the JAR from here. Double-click it to run it.
- If this does not work:
- Also download the batch file here to the same folder. (You may need to right-click and click "Save As...")
- Run the batch file.
Links
Capabilities
Current Capabilities
Count the number of edits
Break down count by project namespace
Count percentage and number of "minor" flag usage
Correct parsing of edit summaries (through PurgeContribs.java)
Under development
Displaying of edit summary statistics (Titoxd)
Adding support for direct analysis of Special:Contributions (beta version can process in 5,000-edit intervals) (done, will be available in 4.0)
Add "kill bit" functionality for turning off tool remotely when server load requires it (done, will be available in 4.0)
- Add more detailed statistics with the parsing of timestamps, etc. available in Titoxd's code
- Add more buttons to UI, make more user friendly
Make choosing files simpler by using JFileChooser() (done)
Future developments (see also Feature requests)
- Merge the two pages (this page and User:Titoxd/Flcelloguy's Tool, perhaps under a WP:TOOLS subfile; rename to reflect that it's not "my" tool, but both my and Titoxd's tool (Flcelloguy)
- Add a progress bar (like this?)
- Add "First edit" date (easy)
- Better and more detailed instructions on how to download and use (perhaps a JAR?)
- JAR file done, will be distributed after 4.0, just needs hosting
- Output to
txt
file for debugging (already done) and also to make copying results to the project easier Attempt to make counting less crude by using a query (Outside scope - use Interiot's Tool)
- Saving contributions in StatBundle to a local file, perhaps a CSV or similar file?
- Processing of user logs (Titoxd)
Known bugs
- User UI is not completely user-friendly, needs improvements and suggestions
- Need to create/update documentation to reflect move to WikiProject (Flcelloguy)
- Exceptions not handled sometimes, need to process correctly
- The application appears to hang while it is downloading contribs, but it is not - add an indeterminate progress bar to tell the user to keep waiting
Revisions
- v1.00: Original version, parses contribs to HTML file
- v1.01: Revision, split into a separate class, removed print command to system buffer (slowing down tool, only used for debugging)
- v2.00: begun processing the raw HTML file, parsed date/time stamp and page name into a special "Contrib" class. Minor edits, edit summaries and most recent edits still to be implemented.
- v2.10: Minor edits implemented, some code for edit summaries created (not operational yet).
- v2.15: Contrib class parses namespaces.
- v3.00: Merged my code with Flcelloguy's code.
- v3.10: Removed 5,000-edit limit (the program now allows input from multiple sources) and added a basic Graphical user interface.
- v3.20: Enhanced the GUI, output now sent to a window, not to console.
- v3.30: Enabling parsing of edit summaries and automatic section-edit summaries.
- v3.31: Bug fix in edit summary parsing: now processes one-word edit summaries correctly
- v3.32: Minor bug fix.
- v3.40: Major code commit (fixed edit summary parsing bug), added new function to PurgeContribs.java to analyze edit summaries specifically.
Code
For the current version (4.0), please use the JAR (see instructions above) if possible, or get the code here.