chessql 3.0.2

Chess Query Language (cql) parser.

Contents

• Description

• Installation Instructions

• Use

• Notes

Description

This package provides a parser for Chess Query Language (CQL).

The documentation for CQL version 6.0.4 as found in first half of 2020, plus CQL version 6.1 and CQL version 6.2 as found in mid-2024, was used as a reference.

CQLi provides an alternative implementation of CQL-6.1 and a ‘-parse’ option which gives output more easily compared with ChessQL output.

This package does not implement an evaluator to find games in a PGN file which match a query.

Installation Instructions

This package is available on PyPI so can be installed by typing

python -m pip install –user chessql

at the command prompt.

See Python and pip documentation for alternatives and platform-specific points.

Use

Function core.parser.parse(<string>) returns a QueryContainer instance with the result of parsing a string usually read from a <*>.cql file.

Function core.parser.parse_command_line_query() returns a QueryContainer instance with the result of parsing a command line usually passed to the CQL executable.

Notes

Version 3.0 of Chessql is incompatible with earlier versions.

An evaluator for some CQL constructs is implemented in ChessTab.