p-programming-language / plang

The P programming language

Plang

The P programming language

Why?

becuz im bored

Examples

Check out examples/ for some examples.

Tools

• pint
  • The P interpreter CLI
• repl
  • A read-eval-print loop to run P interactively inside of your terminal
• ast-viewer
  • This is an interactive terminal where you can inspect the AST or bound AST of a provided source code node-by-node

Developer only tools

• test
  • Runs unit tests

Installation

Installation using NPM:

npm i -g @p-lang/plang

Custom install / self building

git clone https://github.com/p-programming-language/plang && cd plang

now just run:

npm i && npm run build

Then you can access our tools using:

npm run <tool>

or:

yarn run <tool>

Current Features

• Type analysis & hoisting before parsing
• Tokenizing:
  • Number literals (int, float)
  • String literals, supports both single and double quotes
  • Boolean literals
  • Identifiers
  • Keywords
  • Symbols (+, -, etc.)
  • Comments (## single line, ##: multi line :##)
• Parsing + Binding + Type checking + Interpreting:
  • Literals
    • Basics (numbers, strings, booleans)
    • String interpolations
    • Ranges
    • Array literals/types
    • Object literals/types
  • Array/object indexing
  • Binary expressions (including compound assignment, is, is in, etc.)
  • Unary expressions (including ++, --, #, typeof, etc.)
  • Variable declarations (mutability optional)
  • Variable assignment (:= and = operators)
  • Property assignment
  • Function declarations and calls

Planned Features

• Type guards (value is T, T extends U, asserts T, T extends U ? V : Q)
• Intrinsic types
• Spread types
• Parenthesized types
• Type casting (value as T)
• Throw statement
• Switch statement
• Classes (in progress)