{"id":19520074,"url":"https://github.com/malloydata/malloy-vscode-extension","last_synced_at":"2025-04-26T07:31:30.323Z","repository":{"id":62648941,"uuid":"561037819","full_name":"malloydata/malloy-vscode-extension","owner":"malloydata","description":"The Malloy Visual Studio Code extension facilitates building Malloy data models, querying and transforming data, and creating simple visualizations and dashboards","archived":false,"fork":false,"pushed_at":"2025-04-24T16:47:00.000Z","size":16816,"stargazers_count":19,"open_issues_count":27,"forks_count":14,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-24T17:46:53.445Z","etag":null,"topics":["data","data-modeling","malloy","semantic-modeling","sql"],"latest_commit_sha":null,"homepage":"http://www.malloydata.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/malloydata.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"code_of_conduct.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-11-02T20:05:13.000Z","updated_at":"2025-04-24T16:47:02.000Z","dependencies_parsed_at":"2023-12-14T23:08:59.821Z","dependency_job_id":"61fecb9f-0f37-4fe0-b7d0-3ca993317260","html_url":"https://github.com/malloydata/malloy-vscode-extension","commit_stats":null,"previous_names":[],"tags_count":63,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/malloydata%2Fmalloy-vscode-extension","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/malloydata%2Fmalloy-vscode-extension/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/malloydata%2Fmalloy-vscode-extension/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/malloydata%2Fmalloy-vscode-extension/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/malloydata","download_url":"https://codeload.github.com/malloydata/malloy-vscode-extension/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250953560,"owners_count":21513388,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["data","data-modeling","malloy","semantic-modeling","sql"],"created_at":"2024-11-11T00:23:44.036Z","updated_at":"2025-04-26T07:31:27.159Z","avatar_url":"https://github.com/malloydata.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Malloy\nMalloy is an open source language for describing data relationships and transformations. It is both a semantic modeling language and a querying language that runs queries against a relational database. Malloy currently supports BigQuery, Postgres, and DuckDB. \n\nWe've built a Visual Studio Code extension to facilitate building Malloy data models, querying and transforming data, and creating simple visualizations and dashboards.\n\n### [Click here](https://github.dev/malloydata/try-malloy/airports.malloy) to try Malloy in your browser!\n\n---\n\n## Install the Visual Studio Code Extension locally\n\nTo write your own Malloy models, use the VS Code Extension, currently available for Mac, Linux, and Windows machines.\n\n1. **Download Visual Studio Code**: Download [Visual Studio Code](https://code.visualstudio.com/)\n\n2. **Add the Malloy (pre-release) extension from the Visual Studio Code Marketplace**: Open VS Code and click the Extensions button on the far left (it looks like 4 blocks with one flying away). This will open the Extension Marketplace. Search for \"Malloy\" and, once found, click \"Install\"\n\n3. **Download and unzip the [Sample Models](https://github.com/malloydata/malloy-samples/archive/refs/heads/main.zip)** (models + data).\n\n4. **Open the samples folder in VS Code**. In VS Code, go to File \u003e **Open Folder**... select malloy-samples/duckdb \u003e Open. DuckDB is built into the extension so you're ready to run these.\n\n5. **Start with `1_airports.malloy` in the FAA dataset**. This is a sub-sample of the NTSB Flights dataset. In the editor pane, above `source: airports`, click the word \"Preview\" to run a `SELECT *`, and click the word \"Run\" above any query object to run it (see gif below for example).\n\n\n![show_run](https://user-images.githubusercontent.com/1093458/182458787-ca228186-c954-4a07-b298-f92dbf91e48d.gif)\n\nTo get to know the Malloy language, follow the [Quickstart guide](https://malloydata.github.io/documentation/user_guides/basic.html) and/or continue through the numbered models in the FAA directory.\n\nNote: The Malloy VSCode Extension tracks a small amount of anonymous usage data. You can opt out in the extension settings.\n [Learn more](https://policies.google.com/technologies/cookies).\n\n## Join the Community\n\n- Join our [**Malloy Slack Community!**](https://malloydata.github.io/slack) Use this community to ask questions, meet other Malloy users, and share ideas with one another.\n- Use [**GitHub issues**](https://github.com/malloydata/malloy-vscode-extension/issues) in this Repo to provide feedback, suggest improvements, report bugs, and start new discussions.\n\n## Resources\n\nDocumentation:\n\n- [Malloy Language](https://malloydata.github.io/documentation/user_guides/basic.html) - A quick introduction to the language\n- [eCommerce Example Analysis](https://malloydata.github.io/documentation/examples/ecommerce.html) - a walkthrough of the basics on an ecommerce dataset (BigQuery public dataset)\n- [Modeling Walkthrough](https://malloydata.github.io/documentation/examples/iowa/iowa.html) - introduction to modeling via the Iowa liquor sales public data set (BigQuery public dataset)\n\n[YouTube](https://www.youtube.com/channel/UCfN2td1dzf-fKmVtaDjacsg) - Watch demos / walkthroughs of Malloy\n\n## Contributing\n\nIf you would like to [work on the Malloy VS Code extension](CONTRIBUTING.md), take a look at the instructions for [developing](DEVELOPING.md).\n\nTo report security issues please see our [security policy](https://github.com/malloydata/malloy/security/policy).\n\nMalloy is not an officially supported Google product.\n\n## Syntax Example\nHere is a simple example of a Malloy query:\n\n```malloy\nquery: table('malloy-data.faa.flights') -\u003e {\n  where: origin ? 'SFO'\n  group_by: carrier\n  aggregate:\n    flight_count is count()\n    average_flight_time is flight_time.avg()\n}\n```\n\nIn SQL this would be expressed:\n```sql\nSELECT\n   carrier,\n   COUNT(*) as flight_count,\n   AVG(flight_time) as average_flight_time\nFROM `malloy-data.faa.flights`\nWHERE origin = 'SFO'\nGROUP BY carrier\nORDER BY flight_count desc         -- malloy automatically orders by the first aggregate\n```\n\nLearn more about the syntax and language features of Malloy in the [Quickstart](https://malloydata.github.io/documentation/user_guides/basic.html).\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmalloydata%2Fmalloy-vscode-extension","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmalloydata%2Fmalloy-vscode-extension","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmalloydata%2Fmalloy-vscode-extension/lists"}