https://github.com/charcoal-lang/Charcoal

A concise language for sketching ASCII art.
https://github.com/charcoal-lang/Charcoal

ascii-art esoteric-language golfing-language

Last synced: 3 months ago
JSON representation

A concise language for sketching ASCII art.

• Host: GitHub
• URL: https://github.com/charcoal-lang/Charcoal
• Owner: charcoal-lang
• License: mit
• Created: 2016-10-03T00:28:19.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2024-02-20T11:18:02.000Z (9 months ago)
• Last Synced: 2024-05-19T05:24:29.580Z (6 months ago)
• Topics: ascii-art, esoteric-language, golfing-language
• Language: Python
• Homepage:
• Size: 1.09 MB
• Stars: 205
• Watchers: 5
• Forks: 8
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-esolangs - Charcoal - Concise language for sketching ASCII art. (Languages)

README

        
# Charcoal

Want to be able to write basic Charcoal quickly? Then read on. If you came here looking for help, scroll to the bottom for the FAQ.

## Example REPL session

To use the REPL, simply invoke with `./charcoal.py`, `python charcoal.py` or `python3 charcoal.py`.

    Charcoal> Hello, World!  

    Hello, World!

    Charcoal> ^C

    Cleared canvas

## Literals

There are two basic types of literals: strings and numbers. A string is just a run of printable ASCII, and a number is just a run of the superscript digits `⁰¹²³⁴⁵⁶⁷⁸⁹`.

Examples:

`foo` is equivalent to `"foo"`.  

`foo¶bar` is the same as `"foo\nbar"`.  

`¹²³⁴` is `1234`.  

## Printing

In a Charcoal program, expressions are implicitly printed. Numbers print a line, and arrows can be used to specify a direction.

Examples:

`foo` prints `foo`  

`foo⁴` prints `foo----`  

`foo↖⁴` prints:  

```

\   

 \  

  \ 

foo\

```

## FAQ

- When I run Charcoal it throws some errors about UTF-8 characters and exits.

	- Maybe you don't have Python 3 installed. Try installing Python 3 from [here](https://www.python.org/downloads/).

- When I run Charcoal it throws some errors and exits.

	- If the message comes with a stack trace, it looks like you have found a bug. File a bug report [here](https://github.com/somebody1234/Charcoal/issues), and we'll come back to you as soon as we can.