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 AySz88 (talk | contribs) at 14:21, 13 April 2006 (Temporary quick-start directions: clarify w/ "also"). 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.
Sample UI of the tool, while running on Windows XP.

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

  1. Download and install Java (see links below)
  2. Download the JAR from here. Double-click it to run it.
    • If this does not work:
    1. Also download the batch file here to the same folder. (You may need to right-click and click "Save As...")
    2. Run the batch file.

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