FTPstats Files

====================
FTPstats v0.7.3 beta
====================

/*
    FTPstats is a FileZilla FTP Server log analyzer and stats compiler.
    Copyright (C) 2011 Zachary J. Rice

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see http://www.gnu.org/licenses/.
 */


This program will read FileZilla FTP Server logs and compile various stats such as number of uploads/downloads, logins, connections opened, etc.  It also provides a grid display that allows easy (or easier) reading of server activity for the selected user and time period.

The source code is available under the GPLv3 at:
https://sourceforge.net/projects/ftpstats/



CHANGELOG 
----------------


v0.7.3
------

: parser now runs on a separate thread than the UI (please report bugs or odd results that may come from this)

: cancellation possible while multiple files are being processed

: added Options menu to choose proper date/time format used in server logs

  - This is meant for servers on which the system time is set to a different culture than the system-wide culture.
    If your systime has not been set to a different culture, .NET should detect the correct one and prefill this option;
    otherwise you should set this manually.

: fixed DataGrid and Summary relying on incorrect lists in some cases after changing the User selection

: changed font and layout of Summary reports to improve readability

: disabled window resizing

: performance enhancements with StringBuilders ... ?



V0.7.2
------

: parser now accounts for some servers not including AM or PM in their timestamp

: usernames are now case-insensitive (like FZ) and should not show duplicates in the Users list
  if a user logs in with different capitalization schemes

: tweaked for somewhat faster performance when dealing with large amounts of log data

: multiple files can be selected in the Load File(s) window



v0.7.1
------

: fixed a few cases where stats were tallied inaccurately

: fixed duplicate successful upload/download entries when the FTP User was simply resuming these actions

  - Note: It is still possible for duplicates to affect Summary tallies.  FileZilla logs uploads/downloads that
	  the user cancels exactly the same as truly finished up/downloads.  FTPstats culls duplicates from the
	  up/download lists in the Summary box but the dupes are still included in the tally numbers.
	  I may try to find a workaround for this in the future but it's not a priority.

: added Created Directories, Deleted and Restarted files stats

: more detailed Simple Mode interpretations

: rewrote a couple functions to fix bugs and redesign data flow - any stats errors now should be
  caused by true bugs and not flawed design

----------------



REQUIREMENTS
------------
FTPstats has been tested on Windows 7 (32 && 64 bit) and Windows XP (32 bit) and requires the Microsoft .NET framework.

http://http://www.microsoft.com/net/Download.aspx



INSTALLATION??
------------
No.  Just run the exe.  Note: the program will log errors in its residing folder.



CURRENT KNOWN ISSUES
--------------------

Let me know if you find any!

--------------------



FUTURE PLANNED FEATURES
-----------------------

: run UI in a separate thread than the parse/stats logic

: implement SQLite db to store parsed data

: "Connection" Grid Mode that groups all log entries for each connection together to make it easier to
  follow the timeline of a particular connection

: more interpretation improvements in Simple grid view (error code details)

: in Verbose view, put useful information in the "Abnormality" column (and change its name)

: cull irrelevant dates from the Date listbox when specific Users are in focus

 ~ lower priority ~
: integrated Help menu
: print/save reports
: data grid sorting by column
: find filesize of user-accessed files (maybe; this info is not logged by FileZilla)
: other stuff

-----------------------




COMMENTS
--------

This program is a student effort.  It is a project in learning C# and .NET programming from someone with only a year of C++ programming experience.  As such, expect a few errors and bugs.  It has only been tested on small-scale server logs which are certainly not as verbose as any of the industrial sized FTPs out there.

Please send me any comments, suggestions, critiques, or contributions you might have.
https://sourceforge.net/projects/ftpstats/
zrice011@gmail.com

Thanks for downloading!  Hopefully you find this program to be useful.

--------