anko icon indicating copy to clipboard operation
anko copied to clipboard

Published 20 hours ago • verified publisher icon mattn

Require syntax document

Open deafwolf opened this issue 7 years ago • 8 comments

As the title, the readme is too simple.

deafwolf avatar Jun 21 '17 06:06 deafwolf

Have you noticed the examples in anko/_example/scripts/ ? Maybe that helps a bit?

MarcusE1W avatar Sep 14 '17 00:09 MarcusE1W

Still, language specification would be very useful.

AlekSi avatar Oct 12 '17 14:10 AlekSi

Was curious, what would this look like? Is there an example from another language like Go, JavaScript, Python, etc.?

MichaelS11 avatar Dec 08 '17 17:12 MichaelS11

Go language specification is a good example.

AlekSi avatar Dec 29 '17 10:12 AlekSi

Yeah, having language specification would be very nice. I personally would like to see 95%+ code coverage testing first.

MichaelS11 avatar Dec 30 '17 05:12 MichaelS11

@MichaelS11 It is hard to write tests without knowing that the expected behavior is. I agree, a language spec is important. I'm writing a description for the documentation of my own project, but in order to do it I'm having to dive into the anko codebase because the examples aren't sufficient. Right now I'm trying to figure out if it's possible to expand / append to a slice, and what precisely is the difference between a slice and an array anyway.

floren avatar Mar 28 '18 19:03 floren

There is a lots still to do, including examples and language specifications. Anyone who would like to help, good PRs are excepted.

Until more examples are made for slices, I would suggest checking out the tests:

https://github.com/mattn/anko/blob/master/vm/vmArraysAndMaps_test.go

MichaelS11 avatar Mar 28 '18 19:03 MichaelS11

A BNF syntax would be great, although it's been so long since I've written one that I'm not confident I could pull it off.

floren avatar Mar 28 '18 19:03 floren