albertzak / node_adt

Read Advantage Database Server ADT files in Node

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.

• Original Project page: http://github.com/chasemgray/Ruby-ADT

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.

node_adt's Issues

TypeError [ERR_INVALID_ARG_TYPE]: The "fd" argument must be of type number.

I try to make eachRecord

  adt.open('./dev-scripts/adtImport/adtFiles/TypeSP.ADT', 'windows-1251', function(err, table) {
    const tableColumns = table.columns;
    table.eachRecord(function(err, record) {
      if(err){
        console.log(`err: ${JSON.stringify(err, null, 2)}`);
      }
      tableColumns.forEach(col => {
        console.log(col.name);
        console.log(record);
      });
      console.log(`next row`);
    });

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

First row logged successfuly.
But before start reading next row i have error:

internal/validators.js:113
    throw err;
    ^

TypeError [ERR_INVALID_ARG_TYPE]: The "fd" argument must be of type number. Received type object
    at Object.read (fs.js:456:3)
    at readNextRecord (\node_modules\node_adt\node_adt.js:150:10)
    at \node_modules\node_adt\node_adt.js:177:11
    at FSReqCallback.wrapper [as oncomplete] (fs.js:481:5)
npm ERR! code ELIFECYCLE
npm ERR! errno 1
npm ERR! @0.1.0 adt: `node dev-scripts/adtImport/index.js`
npm ERR! Exit status 1
npm ERR!
npm ERR! This is probably not a problem with npm. There is likely additional logging output above.