Add a command-line tool. Bump version to 1.1.

bin/chardetect.py

@@ -0,0 +1,39 @@
+#!/usr/bin/env python
+"""
+Script which takes one or more file paths and reports on their detected
+encodings
+
+Example::
+
+    % chardetect.py somefile someotherfile
+    somefile: windows-1252 with confidence 0.5
+    someotherfile: ascii with confidence 1.0
+
+"""
+from sys import argv
+
+from chardet.universaldetector import UniversalDetector
+
+
+def description_of(path):
+    """Return a string describing the probable encoding of a file."""
+    u = UniversalDetector()
+    for line in open(path, 'rb'):
+        u.feed(line)
+    u.close()
+    result = u.result
+    if result['encoding']:
+        return '%s: %s with confidence %s' % (path,
+                                              result['encoding'],
+                                              result['confidence'])
+    else:
+        return '%s: no result' % path
+
+
+def main():
+    for path in argv[1:]:
+        print description_of(path)
+
+
+if __name__ == '__main__':
+    main()

chardet/__init__.py

@@ -15,7 +15,7 @@
 # 02110-1301  USA
 ######################### END LICENSE BLOCK #########################
 
-__version__ = "1.0.1"
+__version__ = "1.1"
 
 def detect(aBuf):
     import universaldetector

setup.py

@@ -10,7 +10,7 @@
 
 setup(
     name = 'chardet',
-    version = '1.0.3',
+    version = '1.1',
     description = 'Universal encoding detector',
     long_description = """\
 Universal character encoding detector
@@ -30,6 +30,17 @@
  - TIS-620 (Thai)
 
 Requires Python 2.1 or later
+
+Command-line Tool
+-----------------
+
+chardet comes with a command-line script which reports on the encodings of one
+or more files::
+
+    % chardetect.py somefile someotherfile
+    somefile: windows-1252 with confidence 0.5
+    someotherfile: ascii with confidence 1.0
+
 """,
     author='Mark Pilgrim',
     author_email = 'mark@diveintomark.org',
@@ -48,5 +59,6 @@
         "Topic :: Software Development :: Libraries :: Python Modules",
         "Topic :: Text Processing :: Linguistic",
         ],
+    scripts=['bin/chardetect.py'],
     packages = ['chardet']
     )