Jump to content

Wikipedia:WikiProject edit counters/Flcelloguy's Tool

From Wikipedia, the free encyclopedia
This is an old revision of this page, as edited by Super-Magician (talk | contribs) at 00:56, 4 June 2006 (Code: Correct interarticle link). The present address (URL) is a permanent link to this revision, which may differ significantly from the current revision.
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
Developer(s)WikiProject edit counters
Stable release
4.25 / 2006-04-24
Operating systemPlatform independent
TypeWikipedia edit counter
LicenseGPL/GFDL
Websitesourceforge.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)[reply]

Compiling and executing the tool requires the Java Development Kit (JDK) for Java 5.0 (aka 1.5.0).

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.

Quick-start directions

(Note: these directions may become outdated in the near-future.)

  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"

Capabilities

It works on Mac OS X, too.

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
  • User permissions option (sysop, bureaucrat, etc.)
  • Cross-platform

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?)

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 "First edit" date (easy)
  • Saving contributions in StatBundle to a local file, perhaps a CSV or similar file?

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)

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.

Help

Please see the help page for help.

Code

For the current version (v4.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 before being copied here.