Metadata-Version: 2.1
Name: oxlang
Version: 0.0.1a0
Summary: Python implementation of ox.
Home-page: https://github.com/ongyx/ox
Author: Ong Yong Xin
Author-email: ongyongxin2020+github@gmail.com
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Dist: sly>=0.4
Requires-Dist: pytest>=6.2.2 ; extra == "test"
Provides-Extra: test

# ox: the ox programming language 🐂

ox is a intepreted, dynamic programming language inspired by [Cub] (no relation to the [2011] one.)
Its syntax borrows heavily from Cub itself and [golang].

Since ox keeps most of Cub's semantics, existing Cub code should run in ox without any changes (backward-compatible).

ox is not meant to be a production language: rather as an experiment in implementing a programming language entirely in Python.

## Why the name ox?

Because the zodiac animal this year is Ox, and to go along with the animal-themed names.

What it **can** do:

* Full Cub syntax support (except for `do` and `repeat while` loops).
* Import modules (you can import math functions using `import math`)

What it **cannot** do:

* Recursive functions (because of Python stack limitations).
  Maybe it would be a better idea to compile Ox code down into [Scorpion] bytecode and run it in an intepreter instead.
* Struct methods (for now).

## Todo

- [x] finish full parser (rewrote using sly)
- [x] code working intepreter 
- [x] add module system (puts all functions in global context though)
- [ ] add ability to interface Python modules

## Examples

```swift
// ox is kind of like untyped Swift (which is also what Cub was aiming for).
// Currently, these primitive types are supported:

// Strings (to have double quotes in a string, use single quotes, and vice versa.)
// Of course, UTF-8 is supported.
my_var = "Hello World!"

// Numbers are all floating-point as in Cub.
// Like Python, variables do not have a fixed type, and can be reassigned.
// (The '.0' can be omitted.)
my_var = 42

// Booleans can either be true or false.
// Comparisons will return a boolean.
a_bool = true
is_the_answer_to_life_and_everything = my_var >= 42

// Arrays are analogous to lists.
// To append, use '+='.
an_array = [4, 2, 0]
an_array += 1

// Functions define an operation so you don't have to keep copying and pasting the same section of code.
func pi() {
  return 3.141592
}

// Structs are similar to C structs.
// Members are defined inside its context.
struct Point {
  x, y
}

// A struct method (shown below) accepts a instance of the struct, plus any other parameter.
// The first arg should be named self, but you can name it something else.
func Point:distance(self) {
  return (self.x ^ 2) + (self.y ^ 2)
}

// Like Lua, static methods (on a uninitalised struct) use '.',
// while instance methods (on a initalised struct) use ':'.
// Static methods do not receive the 'self' parameter.
func Point.new_square(length) {
  return Point(length, length)
}

point = Point(0, 0)
square_point = Point.new_square(10)

// Structs can inherit members and methods from other structs.
// New members can be defined on top of the inherited struct's definition.
struct RelativePoint(Point) {
  cx, cy,
}

func RelativePoint:rel_distance(self) {
  return (abs(self.cx - self.x) ^ 2) + (abs(self.cy - self.y) ^ 2)
}
```

[2011]: https://en.wikipedia.org/wiki/Ox_(programming_language)
[Cub]: https://github.com/louisdh/cub
[golang]: https://golang.org

