apg-conv is a command line data conversion tool. It is powered by apg-conv-api, an API with both high- and low-level access to all of the format conversion tools.
The features and design have been specifically built as an aid to apg.html, a web-page-based APG parser generator and tester. It is not meant to compete with more complete tools like iconv and iconv-lite. Nonetheless, for the encodings that it supports, it provides an alternate choice.
The original purpose of apg-conv was a means of getting arbitrary, 32-bit integer character codes in and out of an HTML
<textarea>. The ABNF syntax that defines the phrases that APG parses is capable of defining character codes of arbitrary-sized integers. However, with a web-page-based application, input and output is essentially constrained to the ASCII text of
<input> HTML tags. (The HTML5 File and Directory API is not standardized and not considered here.) The encoding and decoding formats and methods neccesary to implement this eventually led to this application.
There are no feature or usage changes from v1.0.0. However, apg-conv now has a dependency on apg-conv-api. apg-conv has been split into two parts. First is apg-conv, which is now just an I/O shell for converting files. Second, all of the data conversion functionality is now in apg-conv-api in the form of an API which a) does not use the node.js “fs” module and b) gives a developer better access to all functions. The “fs” module is incompatible with some development frameworks.
npm install -g apg-conv apg-conv -h *(displays the help screen)*
The documentation is in the code in
To generate the documentation, from the package directory:
npm install -g docco ./docco-gen
docs/index.html in any web browser to get started.