README.md

README

Name

ChupaText

Description

ChupaText is an extensible text extractor. You can plug your custom text extractor in ChupaText. You can write your plugin by Ruby.

Overview

ChupaText applies registered decomposers to input data recursively. Finally, the input data is decomposed to text data.

Here is an ASCII art to describe process flow:

input data
     |
    \|/
|decomposer|
     |
    \|/
other data
     |
    \|/
|decomposer|
     |
    \|/
...
     |
    \|/
|decomposer|
     |
    \|/
text data

Decomposer is a module that decomposes input data to other data. The decomposed data may not be text data. If the decomposed data is not text data, ChupaText applies a decomposer again. Finally, the decomposed data will be text data.

Decomposer module is a plugin. You can add supported data types by installing decomposer modules. Or you can create your custom decomposer. Decomposer is a simple Ruby object. So it is easy to create. It is described later.

Install

Install chupa-text gem:

% gem install chupa-text

Now, you can use chupa-text command:

% chupa-text --version
chupa-text 1.0.0

How to use

You can use ChupaText as command line tool or Ruby library. See the following documentations for details:

• doc/text/command-line.md describes how to use ChupaText as command line tool.
• doc/text/library.md describes how to use ChupaText as a Ruby library.

How to create a decomposer

See doc/text/decomposer.md how to write a decomposer.

Available plugins

Search by chupa-text-decomposer- on https://rubygems.org/: http://rubygems.org/search?query=chupa-text-decomposer-

Author

• Kouhei Sutou <kou@clear-code.com>

License

LGPL 2.1 or later.

(Kouhei Sutou has a right to change the license including contributed patches.)