A programming language with semantics borrowed from the Swahili language to help teach programming concepts to Swahili speaking students.
# Swahili
A new programming language with semantics borrowed from the Swahili language to help teach programming concepts to native Swahili-speaking students.
## Get Started
### Installation
Swahili is built on Node. To get started, you can install Swahili, or follow the instructions to run without installing.
```
npm install -g swahili-lang
```
To start the REPL, just run `swahili` in your terminal.
```
swahili
```
Try things out! Here's a good command to get you started:
```swahili
> andika("Jambo Dunia! Hello, World!")
```
### External files
You can pass in a file path to be executed when you run the `swahili` command in your terminal:
```
swahili ./examples/jambo.swh
```
To see more options for the `swahili` command run
```
swahili -h
```
### Run without installing
If you'd like to run without installing, simply use:
```
npx swahili-lang [filename]
```
To enable syntax highlighting for your Swahili programs in VS Code (more coming soon!), get this VS Code extension.
---
## Documentation
### Language Guide
1. Introduction
2. Grammar and types
3. Control flow and error handling
4. Loops and iterations
5. Functions
6. Expressions and operators
7. Numbers and dates
### Packages
- HTTP
- Random (Yoyote)
### References
- Grammar
- Built-in functions
- Constants
---
## Examples
- Jambo, Dunia! (Hello, World!)
- Vitanzi (Loops)
- Mraba (Squares)
- FizzBuzz
- Vyupa 99 (99 Bottles)
- Mfuatano wa Fibonacci (Fibonacci Sequence)
- Tarihi (To-do List)
- Mchezo wa Dadu (Dice Rolls)
- Watu API (People API)
See all examples »