threedaymonk / detenc

A lightweight, low-memory character encoding detector suitable for massive files.

This URL has Read+Write access

detenc / README
100644 35 lines (24 sloc) 1.185 kb
raw blame history 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

detenc
A lightweight, low-memory character encoding detector.
Paul Battley <pbattley@gmail.com>
http://www.reevoo.com/
 
detenc is a fast character encoding detector for Western European text.  It can
determine whether a file is encoded in US-ASCII, UTF-8, ISO-8859-15,
WINDOWS-1252, or something else. It can distinguish ISO-8859-15 and
WINDOWS-1252 where there is enough information: this means that Euro signs are
handled correctly.
 
The program was written to help normalise the encoding of very large data feeds
(of the order of several gigabytes) at Reevoo. It uses very little memory and
can determine the encoding of a two-gigabyte file in under a minute.
 
Build
 
The program is written in C and uses standard libraries. The test suite is
written in Ruby. Additionally, the build process requires Rake:
 
  rake         # builds binary
  rake test    # runs test suite against binary
  rake install # installs binary to /usr/local/bin
 
It is also possible to build the binary manually: use something like:
 
  cc -o bin/detenc src/*.c
 
Use
 
  detenc FILENAME (FILENAME ...)
 
This will output the filename and encoding, one per line. To print just the
encoding, use the -q switch.