sl4m / Gnu_smalltalk_koans
Programming Languages
GNU Smalltalk Koans
Hey there and welcome!
Supported GNU Smalltalk Versions
GNU Smalltalk versions 3.2.2
or higher should work on Mac OS X and Linux. I have written these koans on 3.2.2
, Mac OS X 10.6.
Note: I am certain that 3.0.x
does not work and it will complain about not understanding #asString
.
GNU Smalltalk on Mac OS X
The simplest way to install GNU Smalltalk is via homebrew:
brew install gnu-smalltalk
Or you can use the Docker image. See below.
Running koans locally
In the root directory of the project, type:
script/run
You will see a message similar to this:
TestAssert#testTruth has damaged your karma.
This means you will need to open the TestAssert.st
file under src/koans
and solve the test under testTruth
method (aka message).
All koan files contain a set of tests, each starting with 'test'. Solve each test one by one, running script/run
in between.
By default, script/run
does not reveal the answer. If you are truly stuck in a koan, type script/run_and_reveal
to run and reveal the answer. Use this sparingly!
Running koans via Docker
Make sure you have Docker installed.
In the root directory of the project, type:
script/docker/run
This runs against a small image built on debian:stretch-slim.
Editors with Smalltalk support
- vim
- emacs
Things You Should Know Before Starting
| variable1 variable2 |
is to declare variable1 and variable2 separate by a space. At least one space must be used to separate variables. Commas are not used.
:=
is an assignment operator
"this is a comment"
'this is a string'
#speak
is the notation used to describe the message 'speak'.
Words wrapped in <>
are called pragmas and define class comments, category, imported namespaces, and the shape of indexed instance variables. More information here.
In depth information here.
Ok, have at it!
List of Koans
- TestAssert
- TestBasic
- TestNil
- TestObject
- TestMessage
- TestNumber
- TestString
- TestCharacter
- TestSymbol
- TestArray
- TestOrderedCollection
- TestSortedCollection
- TestBag
- TestAssociation
- TestDictionary
- TestSet
- TestBlock
- TestCollectionsRevisited
- TestIteration
- TestBoolean
- TestException
- TestRegex
- TestClass
Future Koans
- TestMetaclass
Pull Requests and Feedback are Welcome!
Please create a GitHub issue or find me on Twitter (@skim), if you have any suggestions on how to improve existing koans, new koans, or any other comments.
Inspiration and Credits
GNU Smalltalk Koans were inspired by Ruby Koans and Clojure Koans.
Thanks to Matt Yoho at Edgecase for letting me port some of the koans over.
Contributors
Other thanks:
- 8th Light
- Chris Rathman for the awesome language notes.
- @jayden for being the first person to run through the koans.
License
GNU Smalltalk Koans shares the same license as Ruby Koans and is released under a Creative Commons, Attribution-NonCommercial-ShareAlike, Version 3.0 (https://creativecommons.org/licenses/by-nc-sa/3.0/) License.