CartoSym Transcoder

A Python package for lossless transcoding between CartoSym CSS (.cscss) and other encodings associated with the OGC Style & Symbology Conceptual Model standard.

Installation

From Source

git clone --recursive https://github.com/maxcollombin/CartoSymTranscoder.git
cd CartoSymTranscoder
./setup.sh

From PyPI (Coming Soon)

pip install cartosym-transcoder

Usage

Command Line

# Parse a file
cartosym-parse parse input/0-basic.cscss

# Convert between formats
cartosym-parse convert input/example.cscss -o output/example.json
# Convert and display the result in the console
cartosym-parse convert input/example.cscss --print
# Validate the styles
cartosym-parse convert input/example.cscss or cartosym-parse convert input/example.cs.json 
# Convert and validate the result
cartosym-parse convert input/example.cscss -o output/example.cs.json --validate
# Display help
cartosym-parse --help
# Display version
cartosym-parse --version

Development

# Setup
./setup.sh

# Install development dependencies
source CartoSym/bin/activate
pip install -e ".[dev]"

# Run tests
pytest tests/

# Clean up
./clean.sh

Project Structure

• cartosym_transcoder/ - Main Python package
• grammar/ - Git submodule with ANTLR grammar files
• input/ - Sample files
• tests/ - Unit tests