![\"Traqula](\"../../assets/white-on-red/logo-white-on-red-lettered-social.png\"){kind=logo}
\n\n \n
\n A query language transpiler framework for JavaScript\n
\n\n# SPARQL 1.2 AST, SPARQL 1.2 Algebra transformer\n\n[](https://www.npmjs.com/package/@traqula/algebra-sparql-1-2)\n\nModular transformer to transform a SPARQL 1.2 AST generated by Traqula to SPARQL 1.2 algebra.\nThere is also support for 'non-algebra' entities such as ASK, FROM, etc.\nto make sure the output contains all relevant information from the query.\n\n## Installation\n\n```bash\nnpm install @traqula/algebra-sparql-1-2\n```\n\nor\n\n```bash\nyarn add @traqula/algebra-sparql-1-2\n```\n\n## Import\n\nEither through ESM import:\n\n```javascript\nimport { toAst, toAlgebra } from '@traqula/algebra-sparql-1-2';\n```\n\n_or_ CJS require:\n\n```javascript\nconst { toAst, toAlgebra } = require('@traqula/algebra-sparql-1-2');\n```\n\n## Usage\n\nInput for the translation function should be a Traqula AST, by calling [Traqula parser](../parser-sparql-1-2).\nAlgebra operations are modeled as objects of the structure `{ name: string; input: Operation[] }`.\nThe transformation is detailed by [section 18.3 of the SPARQL 1.2 specification](https://www.w3.org/TR/sparql12-query/#translation).\n\nThe example bellow demonstrates this package usage where we parse a query string and transform it to algebra, from the algebra we will go back to a query string.\nNote that unlike the AST level, we do not provide [round tripping](../generator-sparql-1-1/README.md#round-tripping-generation) on algebra level.\n\n```typescript\nimport { Parser } from '@traqula/parser-sparql-1-2';\nimport { Generator } from '@traqula/generator-sparql-1-2';\nimport { toAlgebra, fromAlgebra } from '@traqula/algebra-sparql-1-2';\n// Initialize required variables.\nconst parser = new Parser();\nconst generator = new Generator();\nconst query = `SELECT * { ?s ?p ?o }`;\n\nconst ast = parser.parse(query);\nconst algebra = toAlgebra(ast);\n\nconst generatedAst = toAst(algebra);\nconst generatedQuery = generator.generate(generatedAst);\n```\n\nThe algebra transformer for SPARQL 1.2 is a modification of [the SPARQL 1.1 algebra transformer](../algebra-sparql-1-1); therefore, much of the documentation of that transformer holds here too.\n","readmeFilename":"README.md"}