covscript icon indicating copy to clipboard operation
covscript copied to clipboard

Make Programming Easier

Covariant Script Programming Language: The Interpreter


Welcome to the Covariant Script programming language!
Covariant Script is an open source, cross-platform programming language.
This project is an officially maintained Covariant Script interpreter.

Switch language

  • 简体中文
  • English

Features

  • Cross-platform, supporting most mainstream Operating Systems
    • Compatible with legacy compilers -- written in C++ 14
    • Linux and Unix: x86, ARM, MIPS, Loongson ISA
    • Microsoft Windows: x86
  • Powerful and bloat-free extension system
    • C/C++ Native Interface(CNI) System: translate invoking from both C/C++ and Covariant Script
    • Interpreter Bootstrap: A portable way to access the Covariant Script Runtime from C++
    • CNI Composer Macro: Combined the extension system and CNI system organically
  • Self-developed efficient compilation system
    • Dependency-free and efficient compiler front-end
    • Support compile-time optimization
    • Exportable compilation results
  • High-performance runtime environment
    • Hotspot optimization algorithm
    • Efficient memory management system
    • Reference count garbage collection system

Documents

Please visit Covariant Script Organization README

Installation

  • [Recommend] Download installation package from covscript.org.cn
  • Download the precompiled executable on the Latest Release
  • Directly compile source code with CMake toolchain

Run

Basic command

cs [options...] <FILE> [arguments...]
cs [options...]

Options

Interpreter
Option Mnemonic Function
--compile-only -c Only compile
--dump-ast -d Export abstract syntax tree
--dependency -r Export module dependency
Interpreter REPL
Option Mnemonic Function
--silent -s Close the command prompt
--args <...> -a <...> Set the covscript arguments

Note that everything you set after option --args or its mnemonic -a will be regarded as arguments.

Common
Option Mnemonic Function
--no-optimize -o Disable optimizer
--help -h Show help infomation
--version -v Show version infomation
--wait-before-exit -w Wait before process exit
--stack-resize <SIZE> -S <SIZE> Reset the size of runtime stack
--log-path <PATH> -l <PATH> Set the log path
--import-path <PATH> -i <PATH> Set the import path

Note that if you do not set the log path, it will be directly output to the standard output stream.

Debugger

cs_dbg [options...] <FILE>

Options

Option Mnemonic Function
--help -h Show help infomation
--version -v Show version infomation
--wait-before-exit -w Wait before process exit
--stack-resize <SIZE> -S <SIZE> Reset the size of runtime stack
--log-path <PATH> -l <PATH> Set the log path
--import-path <PATH> -i <PATH> Set the import path

Note that if you do not set the log path, it will be printed to stdout.

Examples

The examples folder contains several example programs written by Covariant Script.

Copyright

The author of the Covariant Script Programming Language is @mikecovlee, licensed under Apache 2.0
Copyright © 2017-2022 Michael Lee(李登淳)
This software is registered with the National Copyright Administration of the People's Republic of China(Registration Number: 2020SR0408026) and is protected by the Copyright Law of the People's Republic of China.

Thanks

Sichuan University , freeCodeCamp Chengdu Community
@imkiva, @ice1000 , @MouriNaruto, @Access-Rend, Weicheng Shi