gremlin 3.8.1 → 4.0.0-beta.3

package/build/esm/language/index.d.ts

@@ -0,0 +1,12 @@
+export { GremlinTranslator } from './translator/GremlinTranslator.js';
+export { Translation } from './translator/Translation.js';
+export { TranslatorException } from './translator/TranslatorException.js';
+export { Translator } from './translator/Translator.js';
+export { default as TranslateVisitor } from './translator/TranslateVisitor.js';
+export { default as JavascriptTranslateVisitor } from './translator/JavascriptTranslateVisitor.js';
+export { default as PythonTranslateVisitor } from './translator/PythonTranslateVisitor.js';
+export { default as GoTranslateVisitor } from './translator/GoTranslateVisitor.js';
+export { default as DotNetTranslateVisitor } from './translator/DotNetTranslateVisitor.js';
+export { default as JavaTranslateVisitor } from './translator/JavaTranslateVisitor.js';
+export { default as GroovyTranslateVisitor } from './translator/GroovyTranslateVisitor.js';
+export { default as AnonymizedTranslateVisitor } from './translator/AnonymizedTranslateVisitor.js';

package/build/esm/language/index.js

@@ -0,0 +1,30 @@
+/*
+ * 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.
+ */
+export { GremlinTranslator } from './translator/GremlinTranslator.js';
+export { Translation } from './translator/Translation.js';
+export { TranslatorException } from './translator/TranslatorException.js';
+export { Translator } from './translator/Translator.js';
+export { default as TranslateVisitor } from './translator/TranslateVisitor.js';
+export { default as JavascriptTranslateVisitor } from './translator/JavascriptTranslateVisitor.js';
+export { default as PythonTranslateVisitor } from './translator/PythonTranslateVisitor.js';
+export { default as GoTranslateVisitor } from './translator/GoTranslateVisitor.js';
+export { default as DotNetTranslateVisitor } from './translator/DotNetTranslateVisitor.js';
+export { default as JavaTranslateVisitor } from './translator/JavaTranslateVisitor.js';
+export { default as GroovyTranslateVisitor } from './translator/GroovyTranslateVisitor.js';
+export { default as AnonymizedTranslateVisitor } from './translator/AnonymizedTranslateVisitor.js';

package/build/esm/language/translator/AnonymizedTranslateVisitor.d.ts

@@ -0,0 +1,39 @@
+import TranslateVisitor from './TranslateVisitor.js';
+/**
+ * Anonymizes a Gremlin traversal by replacing literal values with type-based
+ * placeholders (e.g. `string0`, `number1`).  Identical values within the same
+ * traversal reuse the same placeholder.  Mirrors the Java AnonymizedTranslatorVisitor.
+ */
+export default class AnonymizedTranslateVisitor extends TranslateVisitor {
+    /** outer key: Java simple class name (e.g. "String"); inner key: original text → placeholder */
+    private readonly cache;
+    constructor(graphTraversalSourceName?: string);
+    /**
+     * Replaces the text of `ctx` with a type-tagged placeholder.
+     * The first unique value of each type gets index 0, the second index 1, etc.
+     * Repeated occurrences of the same text reuse the same placeholder.
+     *
+     * @param ctx  ANTLR parse-tree context whose getText() is used as the cache key
+     * @param type Java simple class name (e.g. "String", "Integer", "Number")
+     */
+    protected anonymize(ctx: any, type: string): void;
+    visitGenericSetLiteral(ctx: any): void;
+    visitGenericCollectionLiteral(ctx: any): void;
+    visitGenericMapLiteral(ctx: any): void;
+    visitGenericMapNullableArgument(ctx: any): void;
+    visitStringLiteral(ctx: any): void;
+    visitStringNullableLiteral(ctx: any): void;
+    visitIntegerLiteral(ctx: any): void;
+    visitFloatLiteral(ctx: any): void;
+    visitBooleanLiteral(ctx: any): void;
+    visitDateLiteral(ctx: any): void;
+    visitNullLiteral(ctx: any): void;
+    visitNanLiteral(ctx: any): void;
+    visitInfLiteral(ctx: any): void;
+    visitUuidLiteral(ctx: any): void;
+    visitCharacterLiteral(ctx: any): void;
+    visitDurationLiteral(ctx: any): void;
+    visitBinaryLiteral(ctx: any): void;
+    visitNakedKey(ctx: any): void;
+    visitKeyword(ctx: any): void;
+}

package/build/esm/language/translator/AnonymizedTranslateVisitor.js

@@ -0,0 +1,160 @@
+/*
+ * 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.
+ */
+// Context parameters are typed as `any` because the generated grammar files
+// require accepting arbitrary context types at runtime.
+import TranslateVisitor from './TranslateVisitor.js';
+/**
+ * Anonymizes a Gremlin traversal by replacing literal values with type-based
+ * placeholders (e.g. `string0`, `number1`).  Identical values within the same
+ * traversal reuse the same placeholder.  Mirrors the Java AnonymizedTranslatorVisitor.
+ */
+export default class AnonymizedTranslateVisitor extends TranslateVisitor {
+    /** outer key: Java simple class name (e.g. "String"); inner key: original text → placeholder */
+    cache = new Map();
+    constructor(graphTraversalSourceName = 'g') {
+        super(graphTraversalSourceName);
+    }
+    /**
+     * Replaces the text of `ctx` with a type-tagged placeholder.
+     * The first unique value of each type gets index 0, the second index 1, etc.
+     * Repeated occurrences of the same text reuse the same placeholder.
+     *
+     * @param ctx  ANTLR parse-tree context whose getText() is used as the cache key
+     * @param type Java simple class name (e.g. "String", "Integer", "Number")
+     */
+    anonymize(ctx, type) {
+        const text = ctx.getText();
+        let inner = this.cache.get(type);
+        if (inner === undefined) {
+            inner = new Map();
+            this.cache.set(type, inner);
+        }
+        let placeholder = inner.get(text);
+        if (placeholder === undefined) {
+            placeholder = type.toLowerCase() + inner.size;
+            inner.set(text, placeholder);
+        }
+        this.sb.push(placeholder);
+    }
+    // ─── Collection / map literals ───────────────────────────────────────────
+    visitGenericSetLiteral(ctx) {
+        this.anonymize(ctx, 'Set');
+    }
+    visitGenericCollectionLiteral(ctx) {
+        this.anonymize(ctx, 'List');
+    }
+    visitGenericMapLiteral(ctx) {
+        this.anonymize(ctx, 'Map');
+    }
+    visitGenericMapNullableArgument(ctx) {
+        this.anonymize(ctx, 'Map');
+    }
+    // ─── String literals ─────────────────────────────────────────────────────
+    visitStringLiteral(ctx) {
+        this.anonymize(ctx, 'String');
+    }
+    visitStringNullableLiteral(ctx) {
+        this.anonymize(ctx, 'String');
+    }
+    // ─── Numeric literals ────────────────────────────────────────────────────
+    visitIntegerLiteral(ctx) {
+        const lastChar = ctx.getText().toLowerCase().slice(-1);
+        switch (lastChar) {
+            case 'b':
+                this.anonymize(ctx, 'Byte');
+                break;
+            case 's':
+                this.anonymize(ctx, 'Short');
+                break;
+            case 'i':
+                this.anonymize(ctx, 'Integer');
+                break;
+            case 'l':
+                this.anonymize(ctx, 'Long');
+                break;
+            case 'n':
+                this.anonymize(ctx, 'BigInteger');
+                break;
+            default:
+                this.anonymize(ctx, 'Number');
+                break;
+        }
+    }
+    visitFloatLiteral(ctx) {
+        // Do NOT delegate to infLiteral/nanLiteral — anonymize the FloatLiteralContext directly
+        const lastChar = ctx.getText().toLowerCase().slice(-1);
+        switch (lastChar) {
+            case 'f':
+                this.anonymize(ctx, 'Float');
+                break;
+            case 'd':
+                this.anonymize(ctx, 'Double');
+                break;
+            case 'm':
+                this.anonymize(ctx, 'BigDecimal');
+                break;
+            default:
+                this.anonymize(ctx, 'Number');
+                break;
+        }
+    }
+    // ─── Other literals ──────────────────────────────────────────────────────
+    visitBooleanLiteral(ctx) {
+        this.anonymize(ctx, 'Boolean');
+    }
+    visitDateLiteral(ctx) {
+        this.anonymize(ctx, 'OffsetDateTime');
+    }
+    visitNullLiteral(ctx) {
+        this.anonymize(ctx, 'Object');
+    }
+    visitNanLiteral(ctx) {
+        this.anonymize(ctx, 'Number');
+    }
+    visitInfLiteral(ctx) {
+        this.anonymize(ctx, 'Number');
+    }
+    visitUuidLiteral(ctx) {
+        this.anonymize(ctx, 'String');
+    }
+    visitCharacterLiteral(ctx) {
+        this.anonymize(ctx, 'Character');
+    }
+    visitDurationLiteral(ctx) {
+        this.anonymize(ctx, 'Duration');
+    }
+    visitBinaryLiteral(ctx) {
+        this.anonymize(ctx, 'ByteBuffer');
+    }
+    // ─── Keys — output unquoted (only values are anonymized) ─────────────────
+    visitNakedKey(ctx) {
+        this.sb.push(ctx.getText());
+    }
+    visitKeyword(ctx) {
+        const keyword = ctx.getText();
+        const parentName = ctx.parent?.constructor?.name ?? '';
+        if (parentName === 'MapKeyContext' || parentName === 'ConfigurationContext') {
+            this.sb.push(keyword);
+        }
+        else {
+            this.sb.push(keyword);
+            this.sb.push(' ');
+        }
+    }
+}

package/build/esm/language/translator/DotNetTranslateVisitor.d.ts

@@ -0,0 +1,166 @@
+import TranslateVisitor from './TranslateVisitor.js';
+/**
+ * Converts a Gremlin traversal string into a C# source code representation.
+ * Mirrors the Java DotNetTranslateVisitor.
+ */
+export default class DotNetTranslateVisitor extends TranslateVisitor {
+    constructor(graphTraversalSourceName?: string);
+    protected processGremlinSymbol(step: string): string;
+    protected getCardinalityFunctionClass(): string;
+    /**
+     * .NET enum values are capitalized but do NOT go through processGremlinSymbol,
+     * since the SymbolHelper mappings (bigdecimal→BigDecimal etc.) don't apply to enums.
+     */
+    protected appendExplicitNaming(txt: string, prefix: string): void;
+    visitTraversalGType(ctx: any): void;
+    visitTraversalDirection(ctx: any): void;
+    visitTraversalDirectionShort(ctx: any): void;
+    visitTraversalDirectionLong(ctx: any): void;
+    visitNanLiteral(_ctx: any): void;
+    visitInfLiteral(ctx: any): void;
+    visitIntegerLiteral(ctx: any): void;
+    visitFloatLiteral(ctx: any): void;
+    visitDateLiteral(ctx: any): void;
+    visitGenericRangeLiteral(_ctx: any): void;
+    visitGenericSetLiteral(ctx: any): void;
+    visitGenericCollectionLiteral(ctx: any): void;
+    visitGenericMapLiteral(ctx: any): void;
+    visitMapEntry(ctx: any): void;
+    visitMapKey(ctx: any): void;
+    visitUuidLiteral(ctx: any): void;
+    visitCharacterLiteral(ctx: any): void;
+    visitDurationLiteral(ctx: any): void;
+    visitBinaryLiteral(ctx: any): void;
+    visitClassType(ctx: any): void;
+    visitTraversalStrategy(ctx: any): void;
+    visitConfiguration(ctx: any): void;
+    visitStringNullableArgumentVarargs(ctx: any): void;
+    private handleGenerics;
+    private handleLongArguments;
+    private tryAppendCastToLong_IntArg;
+    private tryAppendCastToString_StringArg;
+    private visitStringArgumentVarargsWithCast;
+    private tryAppendCastToString_StringNullableLit;
+    private tryAppendCastToString_StringNullableArg;
+    private tryAppendCastToObject_GenericArg;
+    private tryAppendCastToObject_GenericLit;
+    private isCalledAsFirstStepInAnonymousTraversal;
+    visitTraversalSourceSpawnMethod_inject(ctx: any): void;
+    visitTraversalSourceSpawnMethod_io(ctx: any): void;
+    visitTraversalSourceSpawnMethod_union(ctx: any): void;
+    visitTraversalSourceSpawnMethod_call_empty(ctx: any): void;
+    visitTraversalSourceSpawnMethod_match_string(ctx: any): void;
+    visitTraversalSourceSpawnMethod_match_string_map(ctx: any): void;
+    visitTraversalSourceSpawnMethod_addV_String(ctx: any): void;
+    visitTraversalSourceSpawnMethod_addE(ctx: any): void;
+    visitTraversalSourceSpawnMethod_call_string(ctx: any): void;
+    visitTraversalSourceSpawnMethod_call_string_map(ctx: any): void;
+    visitTraversalSourceSpawnMethod_call_string_traversal(ctx: any): void;
+    visitTraversalSourceSpawnMethod_call_string_map_traversal(ctx: any): void;
+    visitTraversalSourceSpawnMethod_mergeV_Map(ctx: any): void;
+    visitTraversalSourceSpawnMethod_mergeV_Traversal(ctx: any): void;
+    visitTraversalSourceSpawnMethod_mergeE_Map(ctx: any): void;
+    visitTraversalSourceSpawnMethod_mergeE_Traversal(ctx: any): void;
+    visitTraversalMethod_asString_Scope(ctx: any): void;
+    visitTraversalMethod_branch(ctx: any): void;
+    visitTraversalMethod_cap(ctx: any): void;
+    visitTraversalMethod_choose_Function(ctx: any): void;
+    visitTraversalMethod_choose_Predicate_Traversal(ctx: any): void;
+    visitTraversalMethod_choose_Predicate_Traversal_Traversal(ctx: any): void;
+    visitTraversalMethod_choose_Traversal(ctx: any): void;
+    visitTraversalMethod_choose_Traversal_Traversal(ctx: any): void;
+    visitTraversalMethod_choose_Traversal_Traversal_Traversal(ctx: any): void;
+    visitTraversalMethod_coalesce(ctx: any): void;
+    visitTraversalMethod_constant(ctx: any): void;
+    visitTraversalMethod_elementMap(ctx: any): void;
+    visitTraversalMethod_flatMap(ctx: any): void;
+    visitTraversalMethod_fold_Empty(ctx: any): void;
+    visitTraversalMethod_fold_Object_BiFunction(ctx: any): void;
+    visitTraversalMethod_group_Empty(ctx: any): void;
+    visitTraversalMethod_groupCount_Empty(ctx: any): void;
+    visitTraversalMethod_index(ctx: any): void;
+    visitTraversalMethod_length_Scope(ctx: any): void;
+    visitTraversalMethod_local(ctx: any): void;
+    visitTraversalMethod_lTrim_Scope(ctx: any): void;
+    visitTraversalMethod_map(ctx: any): void;
+    visitTraversalMethod_match_traversal(ctx: any): void;
+    visitTraversalMethod_match_string(ctx: any): void;
+    visitTraversalMethod_match_string_map(ctx: any): void;
+    visitTraversalMethod_max_Empty(ctx: any): void;
+    visitTraversalMethod_max_Scope(ctx: any): void;
+    visitTraversalMethod_mean_Empty(ctx: any): void;
+    visitTraversalMethod_mean_Scope(ctx: any): void;
+    visitTraversalMethod_min_Empty(ctx: any): void;
+    visitTraversalMethod_min_Scope(ctx: any): void;
+    visitTraversalMethod_optional(ctx: any): void;
+    visitTraversalMethod_profile_Empty(ctx: any): void;
+    visitTraversalMethod_project(ctx: any): void;
+    visitTraversalMethod_properties(ctx: any): void;
+    visitTraversalMethod_propertyMap(ctx: any): void;
+    visitTraversalMethod_replace_Scope_String_String(ctx: any): void;
+    visitTraversalMethod_rTrim_Scope(ctx: any): void;
+    visitTraversalMethod_sack_Empty(ctx: any): void;
+    visitTraversalMethod_select_Column(ctx: any): void;
+    visitTraversalMethod_select_Pop_String(ctx: any): void;
+    visitTraversalMethod_select_Pop_String_String_String(ctx: any): void;
+    visitTraversalMethod_select_Pop_Traversal(ctx: any): void;
+    visitTraversalMethod_select_String(ctx: any): void;
+    visitTraversalMethod_select_String_String_String(ctx: any): void;
+    visitTraversalMethod_select_Traversal(ctx: any): void;
+    visitTraversalMethod_split_Scope_String(ctx: any): void;
+    visitTraversalMethod_substring_Scope_int(ctx: any): void;
+    visitTraversalMethod_substring_Scope_int_int(ctx: any): void;
+    visitTraversalMethod_sum_Empty(ctx: any): void;
+    visitTraversalMethod_sum_Scope(ctx: any): void;
+    visitTraversalMethod_tail_Empty(ctx: any): void;
+    visitTraversalMethod_tail_Scope(ctx: any): void;
+    visitTraversalMethod_toLower_Scope(ctx: any): void;
+    visitTraversalMethod_toUpper_Scope(ctx: any): void;
+    visitTraversalMethod_tree_Empty(ctx: any): void;
+    visitTraversalMethod_trim_Scope(ctx: any): void;
+    visitTraversalMethod_unfold(ctx: any): void;
+    visitTraversalMethod_union(ctx: any): void;
+    visitTraversalMethod_value(ctx: any): void;
+    visitTraversalMethod_valueMap_String(ctx: any): void;
+    visitTraversalMethod_valueMap_boolean_String(ctx: any): void;
+    visitTraversalMethod_values(ctx: any): void;
+    visitTraversalMethod_limit_long(ctx: any): void;
+    visitTraversalMethod_limit_Scope_long(ctx: any): void;
+    visitTraversalMethod_range_long_long(ctx: any): void;
+    visitTraversalMethod_range_Scope_long_long(ctx: any): void;
+    visitTraversalMethod_skip_long(ctx: any): void;
+    visitTraversalMethod_skip_Scope_long(ctx: any): void;
+    visitTraversalMethod_tail_long(ctx: any): void;
+    visitTraversalMethod_tail_Scope_long(ctx: any): void;
+    visitTraversalMethod_addV_String(ctx: any): void;
+    visitTraversalMethod_addE_String(ctx: any): void;
+    visitTraversalMethod_call_string(ctx: any): void;
+    visitTraversalMethod_call_string_map(ctx: any): void;
+    visitTraversalMethod_call_string_traversal(ctx: any): void;
+    visitTraversalMethod_call_string_map_traversal(ctx: any): void;
+    visitTraversalMethod_has_String_Object(ctx: any): void;
+    visitTraversalMethod_has_String_P(ctx: any): void;
+    visitTraversalMethod_has_String_String_Object(ctx: any): void;
+    visitTraversalMethod_has_String_String_P(ctx: any): void;
+    visitTraversalMethod_has_T_Object(ctx: any): void;
+    visitTraversalMethod_has_T_P(ctx: any): void;
+    visitTraversalMethod_hasKey_P(ctx: any): void;
+    visitTraversalMethod_hasKey_String_String(ctx: any): void;
+    visitTraversalMethod_hasValue_Object_Object(ctx: any): void;
+    visitTraversalMethod_hasValue_P(ctx: any): void;
+    visitTraversalMethod_hasLabel_P(ctx: any): void;
+    visitTraversalMethod_hasLabel_String_String(ctx: any): void;
+    visitTraversalMethod_mergeV_Map(ctx: any): void;
+    visitTraversalMethod_mergeV_Traversal(ctx: any): void;
+    visitTraversalMethod_mergeE_Map(ctx: any): void;
+    visitTraversalMethod_mergeE_Traversal(ctx: any): void;
+    visitTraversalMethod_option_Merge_Map(ctx: any): void;
+    visitTraversalMethod_option_Merge_Traversal(ctx: any): void;
+    visitTraversalMethod_option_Object_Traversal(ctx: any): void;
+    visitTraversalMethod_property_Object(ctx: any): void;
+    visitTraversalMethod_property_Cardinality_Object(ctx: any): void;
+    visitTraversalMethod_property_Traversal(ctx: any): void;
+    visitTraversalMethod_property_Cardinality_Object_Object_Object(ctx: any): void;
+    visitTraversalMethod_conjoin_String(ctx: any): void;
+    private tryAppendCastToString_StringLit;
+}