@malloydata/malloy 0.0.2 → 0.0.4

package/README.md

@@ -9,17 +9,16 @@ This package facilitates building the Malloy language - or the usage of data mod
 ## Show me an example!
 
 ```
-import { Runtime } from "@malloydata/malloy";
-import { DuckDBConnection } from "@malloydata/db-duckdb";
-
-const connection = new DuckDBConnection("duckdb-example");
-const runtime = new Runtime(files, connection);
-
-runtime.loadModel("source: flights is table('duckdb:data/flights.parquet')")
-
-const runner = runtime.loadQuery("query: flights->{group_by: flight_num}")
-runner.run() // <- executes query, returns JSON of results
-
+const malloy = require("@malloydata/malloy")
+const bigquery = require("@malloydata/db-bigquery")
+
+const connection = new bigquery.BigQueryConnection("bigquery");
+const runtime = new malloy.SingleConnectionRuntime(connection);
+const model = runtime.loadModel("source: airports is table('malloytest.airports')")
+const runner = model.loadQuery("query: airports->{aggregate: airport_count is count()}")
+runner.run().then((result) => {
+    console.log(result.data.value) // [ { airport_count: 19793 } ]
+})
 ```
 
 Note: These APIs are still in beta and subject to change.
@@ -37,3 +36,5 @@ In practice, much of this loop is handled by various database plugins:
 ## Do you have any examples?
 
 You can find a (very) simple example of writing a CLI for executing Malloy queries [here](https://github.com/looker-open-source/malloy/tree/main/demo/malloy-demo-bq-cli)
+
+A more realistic and complex use case - we use these libraries to power our VSCode Extension. Some examples can be found [here](https://github.com/looker-open-source/malloy/tree/main/vscode-extension/src/extension/commands)

package/dist/dialect/duckdb.d.ts

@@ -34,7 +34,7 @@ export declare class DuckDBDialect extends Dialect {
     sqlSelectAliasAsStruct(alias: string, physicalFieldNames: string[]): string;
     sqlMaybeQuoteIdentifier(identifier: string): string;
     sqlCreateTableAsSelect(_tableName: string, _sql: string): string;
-    getFunctionInfo(_functionName: string): FunctionInfo | undefined;
+    getFunctionInfo(functionName: string): FunctionInfo | undefined;
     sqlMeasureTime(from: TimeValue, to: TimeValue, units: string): Expr;
     sqlNow(): Expr;
     sqlTrunc(sqlTime: TimeValue, units: TimestampUnit): Expr;

package/dist/dialect/postgres.d.ts

@@ -41,7 +41,7 @@ export declare class PostgresDialect extends Dialect {
     sqlCast(cast: TypecastFragment): Expr;
     sqlRegexpMatch(expr: Expr, regexp: string): Expr;
     sqlLiteralTime(timeString: string, type: TimeFieldType, _timezone: string): string;
-    getFunctionInfo(_functionName: string): FunctionInfo | undefined;
+    getFunctionInfo(functionName: string): FunctionInfo | undefined;
     sqlMeasureTime(from: TimeValue, to: TimeValue, units: string): Expr;
     sqlSumDistinct(key: string, value: string): string;
     sqlSampleTable(tableSQL: string, sample: Sampling | undefined): string;

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-export type { QueryDataRow, ModelDef, Fragment, Query, StructDef, NamedStructDefs, MalloyQueryData, AtomicFieldType as AtomicFieldTypeInner, DateUnit, ExtractUnit, TimestampUnit, TimeFieldType, QueryData, FieldTypeDef, Expr, DialectFragment, TimeValue, FilterExpression, SQLBlock, FieldDef, PipeSegment, QueryFieldDef, TurtleDef, SearchValueMapResult, SearchIndexResult, } from "./model";
+export type { QueryDataRow, ModelDef, Fragment, Query, StructDef, StructRelationship, NamedStructDefs, MalloyQueryData, AtomicFieldType as AtomicFieldTypeInner, DateUnit, ExtractUnit, TimestampUnit, TimeFieldType, QueryData, FieldTypeDef, Expr, DialectFragment, TimeValue, FilterExpression, SQLBlock, FieldDef, FilteredAliasedName, PipeSegment, QueryFieldDef, TurtleDef, SearchValueMapResult, SearchIndexResult, } from "./model";
 export { Segment, isFilteredAliasedName, } from "./model";
 export { HighlightType, MalloyTranslator, } from "./lang";
 export type { LogMessage, TranslateResponse } from "./lang";
-export { Malloy, Runtime, AtomicFieldType, ConnectionRuntime, SingleConnectionRuntime, EmptyURLReader, InMemoryURLReader, FixedConnectionMap, MalloyError, JoinRelationship, SourceRelationship, DateTimeframe, TimestampTimeframe, Result, parseTableURL, QueryMaterializer, CSVWriter, JSONWriter, DataWriter, } from "./malloy";
-export type { Explore, Model, PreparedQuery, PreparedResult, Field, AtomicField, ExploreField, QueryField, DataArray, DataRecord, DataColumn, DataArrayOrRecord, ModelMaterializer, DocumentSymbol, DocumentHighlight, ResultJSON, PreparedResultMaterializer, SQLBlockMaterializer, ExploreMaterializer, WriteStream, } from "./malloy";
-export type { URLReader, InfoConnection, LookupConnection, Connection, QueryString, ModelString, QueryURL, ModelURL, PooledConnection, TestableConnection, PersistSQLResults, } from "./runtime_types";
+export { Malloy, Runtime, AtomicFieldType, ConnectionRuntime, SingleConnectionRuntime, EmptyURLReader, InMemoryURLReader, FixedConnectionMap, MalloyError, JoinRelationship, SourceRelationship, DateTimeframe, TimestampTimeframe, Result, parseTableURI, QueryMaterializer, CSVWriter, JSONWriter, DataWriter, } from "./malloy";
+export type { Explore, Model, PreparedQuery, PreparedResult, Field, AtomicField, ExploreField, QueryField, DataArray, DataRecord, DataColumn, DataArrayOrRecord, ModelMaterializer, DocumentSymbol, DocumentHighlight, ResultJSON, RunSQLOptions, PreparedResultMaterializer, SQLBlockMaterializer, ExploreMaterializer, WriteStream, } from "./malloy";
+export type { URLReader, InfoConnection, LookupConnection, Connection, QueryString, ModelString, QueryURL, ModelURL, PooledConnection, TestableConnection, PersistSQLResults, FetchSchemaAndRunSimultaneously, StreamingConnection, FetchSchemaAndRunStreamSimultaneously, } from "./runtime_types";
 export type { Loggable } from "./malloy";
 export { toAsyncGenerator } from "./connection_utils";

package/dist/lang/ast/ast-expr.d.ts

@@ -141,7 +141,6 @@ export declare class ExprParens extends ExpressionDef {
     readonly expr: ExpressionDef;
     elementType: string;
     constructor(expr: ExpressionDef);
-    apply(fs: FieldSpace, op: string, expr: ExpressionDef): ExprValue;
     requestExpression(fs: FieldSpace): ExprValue | undefined;
     getExpression(fs: FieldSpace): ExprValue;
 }

package/dist/lang/field-space.d.ts

@@ -48,10 +48,10 @@ export declare type SourceSpec = model.StructDef | FieldSpace;
 /**
  * Based on how things are constructed, the starting field space
  * can either be another field space or an existing structdef.
- * Using a SourceSpace allows a class to accept either one
+ * Using a SpaceSeed allows a class to accept either one
  * and use either version at some future time.
  */
-declare class SourceSpace {
+declare class SpaceSeed {
     readonly sourceSpec: SourceSpec;
     private spaceSpec;
     private asFS?;
@@ -65,7 +65,7 @@ declare class SourceSpace {
  */
 export declare class DynamicSpace extends StaticSpace {
     protected final: model.StructDef | undefined;
-    protected source: SourceSpace;
+    protected source: SpaceSeed;
     outputFS?: QuerySpace;
     completions: (() => void)[];
     private complete;
@@ -86,11 +86,13 @@ export declare class DynamicSpace extends StaticSpace {
     structDef(): model.StructDef;
 }
 /**
- * A namespace for Query operations. The have an input and an
- * output set of fields. The InputSpace is the QueryOperationSpace
- * which is where all expressions are evaluated, and the output
- * space is ResultSpace.
+ * Unlike a source, which is a refinement of a namespace, a query
+ * is creating a new unrelated namespace. The query starts with a
+ * source, which it might modify. This set of fields used to resolve
+ * expressions in the query is called the "input space". There is a
+ * specialized QuerySpace for each type of query operation.
  *
+ * The query output is managed by an instance of ResultSpace.
  */
 export declare class QuerySpace extends DynamicSpace {
     readonly result: ResultSpace;

package/dist/lang/lib/Malloy/MalloyLexer.d.ts

@@ -27,112 +27,113 @@ export declare class MalloyLexer extends Lexer {
     static readonly SAMPLE = 22;
     static readonly SOURCE = 23;
     static readonly SQL = 24;
-    static readonly TOP = 25;
-    static readonly WHERE = 26;
-    static readonly ALL = 27;
-    static readonly AND = 28;
-    static readonly AS = 29;
-    static readonly ASC = 30;
-    static readonly AVG = 31;
-    static readonly BOOLEAN = 32;
-    static readonly BY = 33;
-    static readonly CASE = 34;
-    static readonly CAST = 35;
-    static readonly CONDITION = 36;
-    static readonly COUNT = 37;
-    static readonly DATE = 38;
-    static readonly DAY = 39;
-    static readonly DESC = 40;
-    static readonly DISTINCT = 41;
-    static readonly ELSE = 42;
-    static readonly END = 43;
-    static readonly EXCLUDE = 44;
-    static readonly FALSE = 45;
-    static readonly FOR = 46;
-    static readonly FROM = 47;
-    static readonly FROM_SQL = 48;
-    static readonly HAS = 49;
-    static readonly HOUR = 50;
-    static readonly IMPORT = 51;
-    static readonly IS = 52;
-    static readonly JSON = 53;
-    static readonly LAST = 54;
-    static readonly MAX = 55;
-    static readonly MIN = 56;
-    static readonly MINUTE = 57;
-    static readonly MONTH = 58;
-    static readonly NOT = 59;
-    static readonly NOW = 60;
-    static readonly NULL = 61;
-    static readonly NUMBER = 62;
-    static readonly ON = 63;
-    static readonly OR = 64;
-    static readonly PICK = 65;
-    static readonly QMARK = 66;
-    static readonly QUARTER = 67;
-    static readonly SECOND = 68;
-    static readonly STRING = 69;
-    static readonly SUM = 70;
-    static readonly TABLE = 71;
-    static readonly THEN = 72;
-    static readonly THIS = 73;
-    static readonly TIMESTAMP = 74;
-    static readonly TO = 75;
-    static readonly TRUE = 76;
-    static readonly TURTLE = 77;
-    static readonly WEEK = 78;
-    static readonly WHEN = 79;
-    static readonly WITH = 80;
-    static readonly YEAR = 81;
-    static readonly UNGROUPED = 82;
-    static readonly STRING_ESCAPE = 83;
-    static readonly HACKY_REGEX = 84;
-    static readonly STRING_LITERAL = 85;
-    static readonly AMPER = 86;
-    static readonly ARROW = 87;
-    static readonly FAT_ARROW = 88;
-    static readonly OPAREN = 89;
-    static readonly CPAREN = 90;
-    static readonly OBRACK = 91;
-    static readonly CBRACK = 92;
-    static readonly OCURLY = 93;
-    static readonly CCURLY = 94;
-    static readonly DOUBLECOLON = 95;
-    static readonly COLON = 96;
-    static readonly COMMA = 97;
-    static readonly DOT = 98;
-    static readonly LT = 99;
-    static readonly GT = 100;
-    static readonly EQ = 101;
-    static readonly NE = 102;
-    static readonly LTE = 103;
-    static readonly GTE = 104;
-    static readonly PLUS = 105;
-    static readonly MINUS = 106;
-    static readonly STAR = 107;
-    static readonly STARSTAR = 108;
-    static readonly SLASH = 109;
-    static readonly BAR = 110;
-    static readonly SEMI = 111;
-    static readonly NOT_MATCH = 112;
-    static readonly MATCH = 113;
-    static readonly LITERAL_TIMESTAMP = 114;
-    static readonly LITERAL_DAY = 115;
-    static readonly LITERAL_QUARTER = 116;
-    static readonly LITERAL_MONTH = 117;
-    static readonly LITERAL_WEEK = 118;
-    static readonly LITERAL_YEAR = 119;
-    static readonly IDENTIFIER = 120;
-    static readonly PERCENT_LITERAL = 121;
-    static readonly INTEGER_LITERAL = 122;
-    static readonly NUMERIC_LITERAL = 123;
-    static readonly OBJECT_NAME_LITERAL = 124;
-    static readonly BLOCK_COMMENT = 125;
-    static readonly COMMENT_TO_EOL = 126;
-    static readonly WHITE_SPACE = 127;
-    static readonly SQL_STRING = 128;
-    static readonly UNWATED_CHARS_TRAILING_NUMBERS = 129;
-    static readonly UNEXPECTED_CHAR = 130;
+    static readonly FANCYSQL = 25;
+    static readonly TOP = 26;
+    static readonly WHERE = 27;
+    static readonly ALL = 28;
+    static readonly AND = 29;
+    static readonly AS = 30;
+    static readonly ASC = 31;
+    static readonly AVG = 32;
+    static readonly BOOLEAN = 33;
+    static readonly BY = 34;
+    static readonly CASE = 35;
+    static readonly CAST = 36;
+    static readonly CONDITION = 37;
+    static readonly COUNT = 38;
+    static readonly DATE = 39;
+    static readonly DAY = 40;
+    static readonly DESC = 41;
+    static readonly DISTINCT = 42;
+    static readonly ELSE = 43;
+    static readonly END = 44;
+    static readonly EXCLUDE = 45;
+    static readonly FALSE = 46;
+    static readonly FOR = 47;
+    static readonly FROM = 48;
+    static readonly FROM_SQL = 49;
+    static readonly HAS = 50;
+    static readonly HOUR = 51;
+    static readonly IMPORT = 52;
+    static readonly IS = 53;
+    static readonly JSON = 54;
+    static readonly LAST = 55;
+    static readonly MAX = 56;
+    static readonly MIN = 57;
+    static readonly MINUTE = 58;
+    static readonly MONTH = 59;
+    static readonly NOT = 60;
+    static readonly NOW = 61;
+    static readonly NULL = 62;
+    static readonly NUMBER = 63;
+    static readonly ON = 64;
+    static readonly OR = 65;
+    static readonly PICK = 66;
+    static readonly QMARK = 67;
+    static readonly QUARTER = 68;
+    static readonly SECOND = 69;
+    static readonly STRING = 70;
+    static readonly SUM = 71;
+    static readonly TABLE = 72;
+    static readonly THEN = 73;
+    static readonly THIS = 74;
+    static readonly TIMESTAMP = 75;
+    static readonly TO = 76;
+    static readonly TRUE = 77;
+    static readonly TURTLE = 78;
+    static readonly WEEK = 79;
+    static readonly WHEN = 80;
+    static readonly WITH = 81;
+    static readonly YEAR = 82;
+    static readonly UNGROUPED = 83;
+    static readonly STRING_ESCAPE = 84;
+    static readonly HACKY_REGEX = 85;
+    static readonly STRING_LITERAL = 86;
+    static readonly AMPER = 87;
+    static readonly ARROW = 88;
+    static readonly FAT_ARROW = 89;
+    static readonly OPAREN = 90;
+    static readonly CPAREN = 91;
+    static readonly OBRACK = 92;
+    static readonly CBRACK = 93;
+    static readonly OCURLY = 94;
+    static readonly CCURLY = 95;
+    static readonly DOUBLECOLON = 96;
+    static readonly COLON = 97;
+    static readonly COMMA = 98;
+    static readonly DOT = 99;
+    static readonly LT = 100;
+    static readonly GT = 101;
+    static readonly EQ = 102;
+    static readonly NE = 103;
+    static readonly LTE = 104;
+    static readonly GTE = 105;
+    static readonly PLUS = 106;
+    static readonly MINUS = 107;
+    static readonly STAR = 108;
+    static readonly STARSTAR = 109;
+    static readonly SLASH = 110;
+    static readonly BAR = 111;
+    static readonly SEMI = 112;
+    static readonly NOT_MATCH = 113;
+    static readonly MATCH = 114;
+    static readonly LITERAL_TIMESTAMP = 115;
+    static readonly LITERAL_DAY = 116;
+    static readonly LITERAL_QUARTER = 117;
+    static readonly LITERAL_MONTH = 118;
+    static readonly LITERAL_WEEK = 119;
+    static readonly LITERAL_YEAR = 120;
+    static readonly IDENTIFIER = 121;
+    static readonly PERCENT_LITERAL = 122;
+    static readonly INTEGER_LITERAL = 123;
+    static readonly NUMERIC_LITERAL = 124;
+    static readonly OBJECT_NAME_LITERAL = 125;
+    static readonly BLOCK_COMMENT = 126;
+    static readonly COMMENT_TO_EOL = 127;
+    static readonly WHITE_SPACE = 128;
+    static readonly SQL_STRING = 129;
+    static readonly UNWATED_CHARS_TRAILING_NUMBERS = 130;
+    static readonly UNEXPECTED_CHAR = 131;
     static readonly channelNames: string[];
     static readonly modeNames: string[];
     static readonly ruleNames: string[];
@@ -150,6 +151,7 @@ export declare class MalloyLexer extends Lexer {
     private static readonly _serializedATNSegment0;
     private static readonly _serializedATNSegment1;
     private static readonly _serializedATNSegment2;
+    private static readonly _serializedATNSegment3;
     static readonly _serializedATN: string;
     static __ATN: ATN;
     static get _ATN(): ATN;