142 lines
3.1 KiB
Markdown
142 lines
3.1 KiB
Markdown
# Blitz
|
|
Big Kotlin library adding features that the Kotlin standard library just does not have (and might never get)
|
|
|
|
## How to get
|
|
```kotlin
|
|
repositories {
|
|
maven {
|
|
name = "alex's repo"
|
|
url = uri("http://207.180.202.42:8080/libs")
|
|
isAllowInsecureProtocol = true
|
|
}
|
|
}
|
|
|
|
dependencies {
|
|
implementation("me.alex_s168:blitz:0.8")
|
|
}
|
|
```
|
|
|
|
## Examples
|
|
### Fibonacci sequence
|
|
```kotlin
|
|
val fib = lazySequence(0 to 1) { i, f ->
|
|
f(i-1) + f(i-2)
|
|
}
|
|
|
|
println(fib[10])
|
|
```
|
|
### Terminal colors
|
|
```kotlin
|
|
Terminal.print("Hello, ", Terminal.STYLES.BOLD)
|
|
Terminal.println("World!", Terminal.COLORS.RED.brighter.fg, Terminal.COLORS.WHITE.bg)
|
|
```
|
|
### Unix `uniq`
|
|
```kotlin
|
|
val inp = sequenceOf("AAA", "BBB", "AAA", "AAA", "AAA", "BBB")
|
|
val out = inp.easyMappingSequence { i, s, m ->
|
|
if (s(i-1) == m(i)) null
|
|
else m(i)
|
|
}
|
|
println(out.contents)
|
|
```
|
|
### Reading files
|
|
```kotlin
|
|
val file = Path.of("test.txt") // Path
|
|
.getFile() // File
|
|
|
|
val text = file.read() // ByteBatchSequence
|
|
.stringify() // Sequence<String> // (NOT lines!!)
|
|
.flatten() // String
|
|
```
|
|
### Bit fields
|
|
```kotlin
|
|
class Flags: BitField() {
|
|
var direction by bit(0)
|
|
var moving by bit(1)
|
|
var frontLight by bit(2)
|
|
}
|
|
|
|
val byte = getByteFromSomewhere()
|
|
val flags = Flags().decode(byte)
|
|
flags.direction = !flags.direction
|
|
putByteSomewhere(flags.encode())
|
|
```
|
|
### Unix `cat` with monads (pure)
|
|
```kotlin
|
|
fun pureCat(args: Array<String>): Monad<Unit> =
|
|
args
|
|
.ifEmpty { arrayOf("-") }
|
|
.map {
|
|
if (it == "-") readIn()
|
|
else unit(it)
|
|
.asPath()
|
|
.read()
|
|
.stringify()
|
|
}
|
|
.rewrap()
|
|
.flatten()
|
|
.reduce { s -> print(s) }
|
|
```
|
|
### Numbers to bytes
|
|
```kotlin
|
|
val num: Short = 5
|
|
val bytes = num.toBytes(Endian.LITTLE)
|
|
```
|
|
### Caching delegate property
|
|
```kotlin
|
|
class Label {
|
|
var font = "Arial 11"
|
|
val fontWith by caching(::font) {
|
|
someFunctionToCalculate(it)
|
|
}
|
|
}
|
|
```
|
|
### Contents
|
|
```kotlin
|
|
val a = listOf(1, 2, 3, 4)
|
|
val b = arrayOf(1, 2, 3, 4)
|
|
println(a.contents == b.contents) // true
|
|
println(b.contents) // [1, 2, 3, 4]
|
|
```
|
|
### Code error messages
|
|
````kotlin
|
|
val source = Errors.Source("main.kt", MutMultiLineString.from("""
|
|
fn main() {
|
|
return 1 + 0
|
|
}
|
|
""".trimIndent(), ' '))
|
|
|
|
val errors = listOf(
|
|
Errors.Error(
|
|
"cannot return integer from function with return type void",
|
|
Errors.Error.Level.ERROR,
|
|
Errors.Location(source, 1, 11, 5)
|
|
),
|
|
Errors.Error(
|
|
"return is deprecated. use yeet instead",
|
|
Errors.Error.Level.WARN,
|
|
Errors.Location(source, 1, 4, 6)
|
|
),
|
|
Errors.Error(
|
|
"useless addition",
|
|
Errors.Error.Level.INFO,
|
|
Errors.Location(source, 1, 13, 3),
|
|
isHint = true
|
|
),
|
|
Errors.Error(
|
|
"Visit https://www.example.com/doc/yeet for more information",
|
|
Errors.Error.Level.INFO,
|
|
Errors.Location(source, 1, 0, 0),
|
|
isLongDesc = true
|
|
)
|
|
)
|
|
|
|
val config = Errors.PrintConfig()
|
|
|
|
Errors.print(config, errors)
|
|
````
|
|
Output:
|
|
|
|
### Either
|
|
No example yet
|