gremlin 3.6.0 → 3.6.2

package/lib/structure/io/binary/internals/VertexSerializer.js

@@ -0,0 +1,135 @@
+/*
+ *  Licensed to the Apache Software Foundation (ASF) under one
+ *  or more contributor license agreements.  See the NOTICE file
+ *  distributed with this work for additional information
+ *  regarding copyright ownership.  The ASF licenses this file
+ *  to you under the Apache License, Version 2.0 (the
+ *  "License"); you may not use this file except in compliance
+ *  with the License.  You may obtain a copy of the License at
+ *
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing,
+ *  software distributed under the License is distributed on an
+ *  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ *  KIND, either express or implied.  See the License for the
+ *  specific language governing permissions and limitations
+ *  under the License.
+ */
+
+/**
+ * @author Igor Ostapenko
+ */
+'use strict';
+
+const g = require('../../../graph');
+
+module.exports = class VertexSerializer {
+  constructor(ioc) {
+    this.ioc = ioc;
+    this.ioc.serializers[ioc.DataType.VERTEX] = this;
+  }
+
+  canBeUsedFor(value) {
+    return value instanceof g.Vertex;
+  }
+
+  serialize(item, fullyQualifiedFormat = true) {
+    if (item === undefined || item === null) {
+      if (fullyQualifiedFormat) {
+        return Buffer.from([this.ioc.DataType.VERTEX, 0x01]);
+      }
+      const id = [0x03, 0x00, 0x00, 0x00, 0x00, 0x00]; // String ''
+      const label = [0x00, 0x00, 0x00, 0x00]; // ''
+      const properties = [0xfe, 0x01]; // null
+      return Buffer.from([...id, ...label, ...properties]);
+    }
+
+    const bufs = [];
+    if (fullyQualifiedFormat) {
+      bufs.push(Buffer.from([this.ioc.DataType.VERTEX, 0x00]));
+    }
+
+    // {id}
+    bufs.push(this.ioc.anySerializer.serialize(item.id));
+
+    // {label}
+    bufs.push(this.ioc.stringSerializer.serialize(item.label, false));
+
+    // {properties}
+    bufs.push(this.ioc.anySerializer.serialize(item.properties));
+
+    return Buffer.concat(bufs);
+  }
+
+  deserialize(buffer, fullyQualifiedFormat = true) {
+    let len = 0;
+    let cursor = buffer;
+
+    try {
+      if (buffer === undefined || buffer === null || !(buffer instanceof Buffer)) {
+        throw new Error('buffer is missing');
+      }
+      if (buffer.length < 1) {
+        throw new Error('buffer is empty');
+      }
+
+      if (fullyQualifiedFormat) {
+        const type_code = cursor.readUInt8();
+        len++;
+        if (type_code !== this.ioc.DataType.VERTEX) {
+          throw new Error('unexpected {type_code}');
+        }
+        cursor = cursor.slice(1);
+
+        if (cursor.length < 1) {
+          throw new Error('{value_flag} is missing');
+        }
+        const value_flag = cursor.readUInt8();
+        len++;
+        if (value_flag === 1) {
+          return { v: null, len };
+        }
+        if (value_flag !== 0) {
+          throw new Error('unexpected {value_flag}');
+        }
+        cursor = cursor.slice(1);
+      }
+
+      let id, id_len;
+      try {
+        ({ v: id, len: id_len } = this.ioc.anySerializer.deserialize(cursor));
+        len += id_len;
+      } catch (err) {
+        err.message = '{id}: ' + err.message;
+        throw err;
+      }
+      cursor = cursor.slice(id_len);
+
+      let label, label_len;
+      try {
+        ({ v: label, len: label_len } = this.ioc.stringSerializer.deserialize(cursor, false));
+        len += label_len;
+      } catch (err) {
+        err.message = '{label}: ' + err.message;
+        throw err;
+      }
+      cursor = cursor.slice(label_len);
+
+      let properties, properties_len;
+      try {
+        ({ v: properties, len: properties_len } = this.ioc.anySerializer.deserialize(cursor));
+        len += properties_len;
+      } catch (err) {
+        err.message = '{properties}: ' + err.message;
+        throw err;
+      }
+      cursor = cursor.slice(properties_len);
+
+      const v = new g.Vertex(id, label, properties);
+      return { v, len };
+    } catch (err) {
+      throw this.ioc.utils.des_error({ serializer: this, args: arguments, cursor, err });
+    }
+  }
+};

package/lib/structure/io/binary/internals/utils.js

@@ -0,0 +1,59 @@
+/*
+ *  Licensed to the Apache Software Foundation (ASF) under one
+ *  or more contributor license agreements.  See the NOTICE file
+ *  distributed with this work for additional information
+ *  regarding copyright ownership.  The ASF licenses this file
+ *  to you under the Apache License, Version 2.0 (the
+ *  "License"); you may not use this file except in compliance
+ *  with the License.  You may obtain a copy of the License at
+ *
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing,
+ *  software distributed under the License is distributed on an
+ *  "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ *  KIND, either express or implied.  See the License for the
+ *  specific language governing permissions and limitations
+ *  under the License.
+ */
+
+/**
+ * @author Igor Ostapenko
+ */
+'use strict';
+
+/*
+ * Deserialization error general constructor.
+ */
+const des_error = ({ serializer, args, cursor, err }) => {
+  if (cursor === undefined) {
+    cursor = args[0]; // buffer
+  }
+  let cursor_tail = '';
+  if (cursor instanceof Buffer) {
+    if (cursor.length > 32) {
+      cursor_tail = '...';
+    }
+    cursor = cursor.slice(0, 32).toString('hex');
+  }
+
+  const fullyQualifiedFormat = args[1];
+  const nullable = args[2];
+
+  let m = `${serializer.constructor.name}.deserialize(cursor=${cursor}${cursor_tail}`;
+  if (fullyQualifiedFormat !== undefined) {
+    m += `, fullyQualifiedFormat=${fullyQualifiedFormat}`;
+  }
+  if (nullable !== undefined) {
+    m += `, nullable=${nullable}`;
+  }
+  m += `): ${err.message.replace(/\.$/, '')}.`;
+
+  err.message = m;
+
+  return err;
+};
+
+module.exports = {
+  des_error,
+};

package/lib/utils.js

@@ -24,6 +24,8 @@
 'use strict';
 
 const crypto = require('crypto');
+const os = require('os');
+const { readFileSync } = require('fs');
 
 exports.toLong = function toLong(value) {
   return new Long(value);
@@ -79,3 +81,30 @@ class ImmutableMap extends Map {
 }
 
 exports.ImmutableMap = ImmutableMap;
+
+function generateUserAgent() {
+  const applicationName = (process.env.npm_package_name || 'NotAvailable').replace('_', ' ');
+  let driverVersion;
+  try {
+    driverVersion = JSON.parse(readFileSync(__dirname + '/../package.json')).version.replace('_', ' ');
+  } catch (e) {
+    driverVersion = 'NotAvailable';
+  }
+  const runtimeVersion = process.version.replace(' ', '_');
+  const osName = os.platform().replace(' ', '_');
+  const osVersion = os.release().replace(' ', '_');
+  const cpuArch = process.arch.replace(' ', '_');
+  const userAgent = `${applicationName} Gremlin-Javascript.${driverVersion} ${runtimeVersion} ${osName}.${osVersion} ${cpuArch}`;
+
+  return userAgent;
+}
+
+exports.getUserAgentHeader = function getUserAgentHeader() {
+  return 'User-Agent';
+};
+
+const userAgent = generateUserAgent();
+
+exports.getUserAgent = function getUserAgent() {
+  return userAgent;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gremlin",
-  "version": "3.6.0",
+  "version": "3.6.2",
   "description": "JavaScript Gremlin Language Variant",
   "author": "Apache TinkerPop team",
   "keywords": [
@@ -14,21 +14,22 @@
   ],
   "license": "Apache-2.0",
   "dependencies": {
-    "ws": "^6.2.2"
+    "ws": "^8.11.0"
   },
   "devDependencies": {
-    "chai": "~4.1.2",
+    "chai": "~4.3.6",
     "chai-string": "~1.5.0",
     "colors": "1.4.0",
-    "cucumber": "~4.2.1",
-    "eslint": "^7.32.0",
+    "cross-env": "^7.0.3",
+    "cucumber": "~6.0.7",
+    "eslint": "^8.30.0",
     "eslint-config-prettier": "^8.5.0",
     "eslint-plugin-prettier": "^4.0.0",
-    "grunt": "^1.4.1",
-    "grunt-cli": "~1.3.2",
+    "grunt": "^1.5.3",
+    "grunt-cli": "~1.4.3",
     "grunt-jsdoc": "~2.4.1",
-    "mocha": "^9.2.2",
-    "prettier": "^2.5.1"
+    "mocha": "^10.2.0",
+    "prettier": "^2.7.1"
   },
   "repository": {
     "type": "git",
@@ -39,9 +40,18 @@
     "url": "https://issues.apache.org/jira/browse/TINKERPOP"
   },
   "scripts": {
-    "test": "./node_modules/mocha/bin/mocha test/unit test/integration -t 5000",
-    "features": "./node_modules/.bin/cucumber-js --require test/cucumber ../../../../../gremlin-test/features/",
-    "unit-test": "./node_modules/mocha/bin/mocha test/unit",
+    "test": "npm run unit-test && npm run integration-test",
+    "unit-test": "mocha test/unit/*",
+    "integration-test": "npm run integration-test-graphson30 && npm run integration-test-graphbinary",
+    "integration-test-graphson30": "cross-env CLIENT_MIMETYPE='application/vnd.gremlin-v3.0+json' ./node_modules/mocha/bin/mocha.js test/integration -t 5000",
+    "integration-test-graphbinary": "cross-env CLIENT_MIMETYPE='application/vnd.graphbinary-v1.0' ./node_modules/mocha/bin/mocha.js test/integration -t 5000",
+    "TODO": "# test other mime types like graphbinary stringd",
+    "features": "npm run features-graphson30 && npm run features-graphbinary",
+    "features-graphson30": "cross-env CLIENT_MIMETYPE='application/vnd.gremlin-v3.0+json' cucumber-js --require test/cucumber ../../../../../gremlin-test/src/main/resources/org/apache/tinkerpop/gremlin/test/features/",
+    "features-graphbinary": "cross-env CLIENT_MIMETYPE='application/vnd.graphbinary-v1.0' cucumber-js --require test/cucumber ../../../../../gremlin-test/src/main/resources/org/apache/tinkerpop/gremlin/test/features/",
+    "features-docker": "npm run features-graphson30-docker && npm run features-graphbinary-docker",
+    "features-graphson30-docker": "cross-env CLIENT_MIMETYPE='application/vnd.gremlin-v3.0+json' cucumber-js --require test/cucumber ../gremlin-test/",
+    "features-graphbinary-docker": "cross-env CLIENT_MIMETYPE='application/vnd.graphbinary-v1.0' cucumber-js --require test/cucumber ../gremlin-test/",
     "lint": "eslint --ext .js ."
   },
   "engines": {