search

face-hh / bussin

An esolang in TypeScript, for heaven's sake.
Apache License 2.0
572 stars 37 forks source link

readme

An esoteric programming language, in TypeScript for heaven's sake.

P.S. Install the VSCode extension for syntax highlighting!

Running

Bussin

You can find an example at /examples/main.bs

Bussin X 🚀

We, at Bussin, believe everyone should be entertained while coding. Meet our alternative: .bsx.

Inside Bussin X, you can use BS syntax, however, it's recommended to use the BSX syntax described below.

New!

Variables

Mutable variables are created with:

lit x be 0 rn

You can also create a constant variable:

mf x be 0 rn

Note: You can only use rn on variables.

Data Strucutres

Strings

Strings can be created with:

lit x be "Hello, World!" rn

You can also insert variables by using:

lit x be 0 rn
lit y be strcon("Hello, ", x) rn // "Hello, 0"

Or you can format your string to include variables:

waffle(format("Hello, ${}", "World")) // "Hello, World"

However, you must use your regional currency symbol.

// All print "Hello, World"
waffle(format("Hello, ${}", "World"))
waffle(format("Hello, ¥{}", "World"))
waffle(format("Hello, {}€", "World"))
waffle(format("Hello, {}£", "World"))

You can also use bussin's helper functions to simplify your experience:

lit x be trim(" hello ") rn // hello
lit y be splitstr("Hello,World", ",") rn // ["Hello", "World"]

Numbers

Numbers are simple:

lit x be 34 rn
lit y be 12 rn
lit z be x minus y rn // 22
lit a be parseNumber("5") rn // 5

Null

lit abc be fake rn

Booleans

Booleans are also simple:

lit x be nocap rn
lit y be cap rn

Objects

Objects are essential in programming languages. Bussin X supports them too:

lit x be cap rn
lit obj be { key: nocap, x } rn

obj.key be cap
waffle(obj.key) // false

Getting/setting dynamic keys is possible using the global "objects" variable:

objects.get(obj, "key") // e.g. true
objects.set(obj, "key", nocap)

You can also get info on the keys of an object with it:

objects.hasKey(obj, "key") // e.g. true
objects.keys(obj) // e.g. ["key1", "key2", "key3"]

Arrays

Arrays contain information without needing keys. Bussin X has them as well:

lit arr be [ 1, 2, 3, 4 ] rn

arr[0] = 5

waffle(arr) // [5, 2, 3, 4]

Arrays start at 0.

Comments

You can write comments like this:

// single line
/*
multi line
*/

Functions

Functions in programming are intricate entities that serve as modular units of code designed to perform specific tasks with a high degree of abstraction and reusability. These multifaceted constructs encapsulate a series of instructions, often comprising algorithmic operations and logical conditions, which execute a well-defined purpose within a larger program. Functionality is delineated through a meticulously crafted signature, encompassing parameters and return types, allowing for parameterization and value transmission between the calling code and the function body. The complexity further burgeons as functions may exhibit a plethora of characteristics, including but not limited to recursion, closures, and the ability to manipulate variables within their designated scopes. Their utility extends beyond mere procedural decomposition, often intertwining with the paradigms of object-oriented, functional, or imperative programming, depending on the programming language employed. The orchestration of functions, with their nuanced interplay, results in the orchestration of intricate software systems, promoting maintainability, readability, and the efficient allocation of computational resources. In essence, functions epitomize the sophisticated essence of programming, embodying the elegance and subtlety required to navigate the intricacies of algorithmic design and software engineering. You can create functions by using:

bruh perform(x, y) {
    x minus y
}

We, at Bussin X, think return statements are redundant. Instead, our superior functions return the last value emitted.

bruh perform(x, y) {
    x plus y // will do nothing
    x minus y
}

You can also run the function after a specified timespan:

hollup(bruh() {
    waffle("A second later...")
}, 1000)

And you can also make it run at an interval:

yappacino(bruh() {
    waffle("Spam!!!")
}, 1000)

If statements

If statements in Bussin X are very intuitive:

sus (1 fr 1){
    waffle("1 is 1")
} impostor sus (1 nah 2){
    waffle("1 is NOT 2")
} impostor sus (1 fr 3 carenot 1 fr 1){
    waffle("1 is 1 or 3")
} impostor sus (1 fr 3 btw 1 fr 1){
    waffle("1 is 1 and 3. how's that possible hello??")
} impostor {
    waffle("How did we get here?")
}

Loops

Loops in Bussin X are very easy:

yall(lit i be 0 rn i smol 10 rn i plusplus){}

Because we, at Bussin X, believe programmers should be responsible for their code, we did not add any break or continue keyword functionality to loops.

Types

Types in Bussin X are very important!

lit num: number be 0 rn

You can assign types on non-matching values too.

lit num: object be 0 rn

You can also assign types on values themselves.

lit x be nocap: boolean rn

You can assign types on types too.

lit x: number: number: object: string be 3 rn

In fact, you can use types anywhere!

yall: number(lit: object i: number be 0: object rn i smol 10 rn i plusplus){
    waffle(strcon("Currently at ", i): object)
}: object: object: string

Note: Types don't do anything, in fact, they're removed before the lexer kicks in.

Try Catch

Bussin X also supports try catch statements:

fuck_around {
    waffle(null plus hogrider)
} find_out {
    waffle(error)
}
Cannot resolve 'hogrider' as it does not exist.

Note: find_out doesn't return anything, "error" is a global variable.

Extra

Math

You can utilize the math helper by using:

waffle(nerd.random(0, 100)) // integer from 0-100
waffle(nerd.sqrt(144)) // 12
waffle(nerd.pi) // 3.141592653589793
waffle(nerd.e) // 2.718281828459045

We also added helper functions for your anxiety:

waffle(nerd.ceil(3.4)) // 4
waffle(nerd.round(3.9)) // 4
waffle(nerd.abs(-2)) // 2

You can also simplify your math equations:

x beplus 5
y betimes 6
i plusplus

Time

You can access the current time by using:

waffle(time())

Importing

You can import data from another bussin file like this:

lit stuff be import("./stuff.bsx") rn

The last value emitted in a file will be the exported data:

bruh waffleStuff() {
    waffle("Bussin X")
}
bruh waffleStuff2() {
    waffle("Also Bussin X")
}

{
    waffleStuff,
    waffleStuff2
}

If imported, the result will be an object which you can do obj.waffleStuff and obj.waffleStuff2

Fetch

You can fetch websites like this:

fetch("https://example.com/")(bruh(data) {
    waffle(data)
})

You can also set the method, body, and content type like this:

fetch("https://example.com/", { method: "POST", body: "{\"bussin\":\"x\"}", content_type: "application/json" })(bruh(data) {
    waffle(data)
})

Websockets

You can connect to a websocket like this:

lit ws be websocket("wss://thissiteis.fake/?EIO=4&transport=websocket") rn

You can assign listeners for socket events like this:

ws.onmessage = bruh(msg) { }
ws.onerror = bruh(err) { }
ws.onopen = bruh() { }
ws.onclose = bruh() { }

You can transmit data through the socket like this:

ws.send("Bussin X")

Regex

You can use regex like this:

lit string be "Hello World" rn

lit matches be regex.match(string, "/World/g") rn

waffle(matches) // [ 'World' ]

And this:

lit string be "Hello World" rn

waffle(regex.replace(string, "/World/g", "Everybody")) // Hello Everybody

BSON

Bussin Object Notation 🗣️💯🔥 can be used with the bson object:

bson.parse("{\"a\": 1, \"b\": 2, \"c\": 3}") // {a: 1, b: 2, c: 3}
bson.parse("[1, 2, 3]") // [1, 2, 3]
bson.stringify({a: 1, b: 2, c: 3}) // '{"a": 1, "b": 2, "c": 3}'
bson.stringify([1, 2, 3]) // "[1, 2, 3]"

Ternary

Bussin supports ternary operators like this:

lit x be 10 rn
lit y be 5 rn
lit z be x thicc y then "thicc" ornot "smol" rn // "thicc"

Exit

You can exit your program like this:

exit()

Command Line

You can run terminal commands by using our Blazingly Fast 🚀 ClapBack() feature:

mf res be clapback("ls") rn

waffle(res)

Note: Clapback will throw an error if failed. Better pair it with fuck_around & find_out.

fuck_around {
    lit insult be clapback("rm -rf /") rn

    waffle(insult)
} find_out {
    waffle(error, ":(")
}

User Input

yap("watcho name > ")(bruh(x) {
    waffle(x)
})

Credits

Created with pure fucking hate by Face ♥