# Fugue SQL Antlr Parser
[![PyPI version](https://badge.fury.io/py/fugue-sql-antlr.svg)](https://pypi.python.org/pypi/fugue-sql-antlr/)
[![PyPI pyversions](https://img.shields.io/pypi/pyversions/fugue-sql-antlr.svg)](https://pypi.python.org/pypi/fugue-sql-antlr/)
[![PyPI license](https://img.shields.io/pypi/l/fugue-sql-antlr.svg)](https://pypi.python.org/pypi/fugue-sql-antlr/)
[![codecov](https://codecov.io/gh/fugue-project/fugue-sql-antlr/branch/master/graph/badge.svg?token=TRJFPVXS67)](https://codecov.io/gh/fugue-project/fugue-sql-antlr)
Chat with us on slack!
[![Slack Status](https://img.shields.io/badge/slack-join_chat-white.svg?logo=slack&style=social)](http://slack.fugue.ai)
# Fugue SQL Antlr Parser
This is the dedicated package for the Fugue SQL parser built on Antlr4. It consists of two packages: [fugue-sql-antlr](https://pypi.python.org/pypi/fugue-sql-antlr/) and [fugue-sql-antlr-cpp](https://pypi.python.org/pypi/fugue-sql-antlr-cpp/).
[fugue-sql-antlr](https://pypi.python.org/pypi/fugue-sql-antlr/) is the main package. It contains the python parser of Fugue SQL and the vistor for the parser tree.
[fugue-sql-antlr-cpp](https://pypi.python.org/pypi/fugue-sql-antlr-cpp/) is the C++ implementation of the parser. This solution is based on the incredible work of [speedy-antlr-tool](https://github.com/amykyta3/speedy-antlr-tool), a tool that generates thin python interface code on top of the C++ Antlr parser. This package is purely optional, it should not affect the correctness and features of the Fugue SQL parser. However, with this package installed, the parsing time is **~25x faster**.
Neither of these two packages should be directly used by users. They are the core internal dependency of the main [Fugue](https://github.com/fugue-project/fugue) project (>=0.7.0).
## Installation
To install fugue-sql-antlr:
```bash
pip install fugue-sql-antlr
```
To install fugue-sql-antlr and fugue-sql-antlr-cpp:
```bash
pip install fugue-sql-antlr[cpp]
```
We try to pre-build the wheels for major operating systems and active python versions. But in case your environment is special, then when you install fugue-sql-antlr-cpp, please make sure you have the C++ compiler in your operating system. The C++ compiler must support the ISO C++ 2017 standard.
Raw data
{
"_id": null,
"home_page": "http://github.com/fugue-project/fugue",
"name": "fugue-sql-antlr",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "distributed spark dask sql dsl domain specific language",
"author": "The Fugue Development Team",
"author_email": "hello@fugue.ai",
"download_url": "https://files.pythonhosted.org/packages/85/c0/382c5bace6b6961d4246739c3d3d0c2c3cc5771ef47e226e9a635b0a34a0/fugue-sql-antlr-0.2.2.tar.gz",
"platform": null,
"description": "# Fugue SQL Antlr Parser\n\n[![PyPI version](https://badge.fury.io/py/fugue-sql-antlr.svg)](https://pypi.python.org/pypi/fugue-sql-antlr/)\n[![PyPI pyversions](https://img.shields.io/pypi/pyversions/fugue-sql-antlr.svg)](https://pypi.python.org/pypi/fugue-sql-antlr/)\n[![PyPI license](https://img.shields.io/pypi/l/fugue-sql-antlr.svg)](https://pypi.python.org/pypi/fugue-sql-antlr/)\n[![codecov](https://codecov.io/gh/fugue-project/fugue-sql-antlr/branch/master/graph/badge.svg?token=TRJFPVXS67)](https://codecov.io/gh/fugue-project/fugue-sql-antlr)\n\nChat with us on slack!\n[![Slack Status](https://img.shields.io/badge/slack-join_chat-white.svg?logo=slack&style=social)](http://slack.fugue.ai)\n\n# Fugue SQL Antlr Parser\n\nThis is the dedicated package for the Fugue SQL parser built on Antlr4. It consists of two packages: [fugue-sql-antlr](https://pypi.python.org/pypi/fugue-sql-antlr/) and [fugue-sql-antlr-cpp](https://pypi.python.org/pypi/fugue-sql-antlr-cpp/).\n\n[fugue-sql-antlr](https://pypi.python.org/pypi/fugue-sql-antlr/) is the main package. It contains the python parser of Fugue SQL and the vistor for the parser tree.\n\n[fugue-sql-antlr-cpp](https://pypi.python.org/pypi/fugue-sql-antlr-cpp/) is the C++ implementation of the parser. This solution is based on the incredible work of [speedy-antlr-tool](https://github.com/amykyta3/speedy-antlr-tool), a tool that generates thin python interface code on top of the C++ Antlr parser. This package is purely optional, it should not affect the correctness and features of the Fugue SQL parser. However, with this package installed, the parsing time is **~25x faster**.\n\nNeither of these two packages should be directly used by users. They are the core internal dependency of the main [Fugue](https://github.com/fugue-project/fugue) project (>=0.7.0).\n\n## Installation\n\nTo install fugue-sql-antlr:\n\n```bash\npip install fugue-sql-antlr\n```\n\nTo install fugue-sql-antlr and fugue-sql-antlr-cpp:\n\n```bash\npip install fugue-sql-antlr[cpp]\n```\n\nWe try to pre-build the wheels for major operating systems and active python versions. But in case your environment is special, then when you install fugue-sql-antlr-cpp, please make sure you have the C++ compiler in your operating system. The C++ compiler must support the ISO C++ 2017 standard.\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Fugue SQL Antlr Parser",
"version": "0.2.2",
"project_urls": {
"Homepage": "http://github.com/fugue-project/fugue"
},
"split_keywords": [
"distributed",
"spark",
"dask",
"sql",
"dsl",
"domain",
"specific",
"language"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "85c0382c5bace6b6961d4246739c3d3d0c2c3cc5771ef47e226e9a635b0a34a0",
"md5": "4f6824d6424f24adab8072c8925351aa",
"sha256": "22af96a6aa295441425482c6619daac1702de222c942ede12b36bc2e2993aa40"
},
"downloads": -1,
"filename": "fugue-sql-antlr-0.2.2.tar.gz",
"has_sig": false,
"md5_digest": "4f6824d6424f24adab8072c8925351aa",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 154682,
"upload_time": "2024-08-15T07:25:57",
"upload_time_iso_8601": "2024-08-15T07:25:57.574108Z",
"url": "https://files.pythonhosted.org/packages/85/c0/382c5bace6b6961d4246739c3d3d0c2c3cc5771ef47e226e9a635b0a34a0/fugue-sql-antlr-0.2.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-15 07:25:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "fugue-project",
"github_project": "fugue",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "fugue-sql-antlr"
}