Wikipedia:WikiProject edit counters/Flcelloguy's Tool

From Wikipedia, the free encyclopedia

Notice Current status of toolserver and other edit counting tools:
Interiot's Tool: Currently replicating from en.wiki very slowly.
Please use Interiot's Tool if it is working; this is only a backup.
See also: Kate's Tool and Interiot's Javascript
Attention users: We need your help to improve this tool. We're particularly looking for someone with Java knowledge or ideas for a good GUI. Feel free to make a feature request.
Flcelloguy's Tool

Screenshot of Flcelloguy's Tool, while running on Windows XP.
Developed by WikiProject edit counters
Latest release 5.20 / 2008-05-30
OS Platform independent
Genre Wikipedia edit counter
License GPL/GFDL
Website sourceforge.net/.../wiki-flcelloguy

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)

Executing the tool requires the Java Development Kit (JDK) for Java 5.0 (aka 1.5.0).

Contents

[edit] Requirements

  • Minimal requirements: Java Development Kit (JDK) from Sun Microsystems. 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.
  • 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.
  • Please see the help page for more information.

[edit] Quick-start directions

  1. Download and install Java version 5 (see links below)
  2. Download the JAR from SourceForge or M1ss1ontomars2k4's mirror. Double-click it to run it.
    • If this does not work:
    1. Check the java version (5.0, aka 1.5.0).
    2. Save the following text as a batch file ("something.bat") in the same folder and run it:
java -jar "Flcelloguy's Tool.jar"

[edit] Links

[edit] Capabilities

It works on Mac OS X, too.
It works on Mac OS X, too.

[edit] Current Capabilities

  • Count the number of edits
  • Break down count by project namespace
  • Count percentage and number of "minor" flag usage
  • Edit summary statistics
  • "Kill bit" functionality for turning off tool remotely when server load requires it
  • Many many ways to graph contributions
  • User permissions option (sysop, bureaucrat, etc.)
  • Cross-platform

[edit] Under development

  • Add more detailed statistics with the parsing of timestamps, etc. available in Titoxd's code
  • Add more buttons to UI, make more user friendly
  • Output to txt file for debugging (already done) and also to make copying results to the project easier
  • Add graphical progress bar (like this?)

[edit] 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)
  • Saving contributions in StatBundle to a local file, perhaps a CSV or similar file?

[edit] Known bugs and limitations

  • 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 (fixed in CVS)
  • Attempt to make counting less crude by using a query (Outside scope - use Interiot's Tool)
    Maybe not, if it can use the API. (Titoxd)

[edit] 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.
  • v4.00: Major release, added semi-automatic parsing capabilities, enhanced user interface, more classes and fixed unhandled exceptions.

[edit] Help

Please see the help page for help.

[edit] Code

For the current version (v5.00), please use the JAR (see instructions above) if possible, or get the code below. Any further enhancements to the tool will be available at the Java Sandbox CVS at the Sourceforge project page before being copied here.