Skip to main content

The Sheng programming language: A Chinese programming language

Project description

The Sheng Programming Language

sheng build python pypi license

结绳:在文字产生之前,古人们靠结绳记事、认事,此举起到了帮助人们记忆的作用。

Sheng is a Chinese programming language named after 结绳 (Jie Sheng), which means tying knots in ropes. In ancient China, before the creation of characters and words, the people remembered and recognized things by tying knots in ropes, which helped them memorize.

The philosophies of the Sheng grammar are interpretable, colloquial, and less punctuation marks. The compiler is implemented in Python with the PLY (Python Lex-Yacc) package which processes lexing and parsing in the phases of the compilation.


Usage

sheng [option] [file]

Installing and Running

Note: Sheng requires Python 3.9 or later

PyPI [Recommended]

Install the Sheng compiler from The Python Package Index (PyPI):

Note: This method requires Internet access.

pip install sheng

Then, execute command sheng [option] [file] to run.

Other install methods

Build and install

Build the code and install the Sheng compiler from the local builds:

Note: This method does not require Internet access.

python3 -m pip install --upgrade pip
python3 -m pip install --upgrade build
python3 -m build
pip install ./dist/<.whl file> --force-reinstall

Then, execute command sheng [option] [file] to run.

Run the compiler module via Python

Run the compiler directly without building and installing in advance:

Note: This method requires Python 3.9 or later in your environment.

python3 -m src [option] [file]

Getting Started

This is the Sheng code in example/helloworld.zh:

甲 赋值 "你好,世界!"
打印(甲)

The first line is an assignment statement where is a variable name which is 赋值 (assign)ed a string value 你好,世界! (Hello, World!) surrounded by " (double quotes). The second line is a function call statement which calls the built-in function 打印 (print) to output the value of the variable .

This is the Python equivalent of the above Sheng code:

x = "你好,世界!"
print(x)

Compile the .zh file via sheng executable:

sheng example/helloworld.zh

You should see the following output in stdout:

你好,世界!

Contributing

I am excited to work alongside you to build and enhance the Sheng Programming Language!

BEFORE you start work on a feature/fix, please read and follow the Contributor's Guide to help avoid any wasted or duplicate effort.


Code of Conduct

This project has adopted the Contributor Covenant Code of Conduct. For more information contact luo@jiahai.co with any additional questions or comments.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sheng-0.1.17.tar.gz (46.7 kB view details)

Uploaded Source

Built Distribution

sheng-0.1.17-py3-none-any.whl (54.6 kB view details)

Uploaded Python 3

File details

Details for the file sheng-0.1.17.tar.gz.

File metadata

  • Download URL: sheng-0.1.17.tar.gz
  • Upload date:
  • Size: 46.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.6.0 importlib_metadata/4.8.2 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.8

File hashes

Hashes for sheng-0.1.17.tar.gz
Algorithm Hash digest
SHA256 b476b928782f80dd518207b9630b52efdd9e5c5262fcf42f87cbdd2de41396da
MD5 a3c0532e7f3fc79644bae88c8d8866bc
BLAKE2b-256 b885e93437cba1baf26bcf5f8e9f5db5e5f42912dca173140f841a030411e03e

See more details on using hashes here.

File details

Details for the file sheng-0.1.17-py3-none-any.whl.

File metadata

  • Download URL: sheng-0.1.17-py3-none-any.whl
  • Upload date:
  • Size: 54.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.6.0 importlib_metadata/4.8.2 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.9.8

File hashes

Hashes for sheng-0.1.17-py3-none-any.whl
Algorithm Hash digest
SHA256 19dc4632ea407cc458230bd81816fd4a652b52854d952f656bef8923c8873e3f
MD5 ab438a6214c6df7f865dc91307f05951
BLAKE2b-256 6a811ba16e7c0f33c5ccd66e6deb39b0c8be782c675cdc65a2cdede9f90b3efb

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page