Skip to content

Latest commit

 

History

History
95 lines (67 loc) · 2.91 KB

Readme.md

File metadata and controls

95 lines (67 loc) · 2.91 KB
Raw

Node-ADT

New in v1.1.4: Support for Date, DateTime and NChar field types

Node ADT is a small fast library for reading Advantage Database Server database files (.ADT). It is a quick node port from the awesome rubygem by Chase Gray.

Installation

npm install node_adt

Basic Usage

    var Adt = require('node_adt');
    var adt = new Adt();

    adt.open('table.adt', 'ISO-8859-1', function(err, table) {

      console.log(table.header.recordCount);
      console.log(table.columns);

      table.eachRecord(function(err, record) {
        console.log(record.Name);
        console.log(record.Email);
      });

      table.findRecord(0, function(err, record) {
        console.log(record.Name);
      });

      table.close(); // Optional
    });

Changes in v1.0: Please note: forEach has been renamed to eachRecord

Supported ADT field types

ADT Field JavaScript
Character String
CiCharater String
NChar String
Logical Boolean
Double Number
Integer Number
ShortInteger Number
Date Date
Timestamp Date

Not implemented

Memo, Numeric, Image, Binary, Time, Raw, Money, ModTime, RowVersion

Limitations and known bugs

  • The rubygem has many more features than this node package, such as CSV export and an ActiveRecord-like find method.
  • ADT is read-only
  • External index files are not used

Acknowledgements

Thank you, Chase Gray, for all the hard work of figuring out how the ADT format works.

Thank you, @yortus for contributing bug fixes and support for Date, Timestamp and NChar fields types. 🎉

License

(The MIT Licence)

Copyright (c) 2010-2010 Chase Gray mailto:[email protected] Copyright (c) 2015 Albert Zak mailto:[email protected]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.