Software Open Access

Polite Smalltalk - An Implementation

Kurš, Jan; Lungu, Mircea; Nierstrasz, Oscar; Steinmann, Thomas

Polite Smalltalk is a programming language that allows programmers to use sentence case identifiers -- a notation for embedding spaces in identifiers. We hope  that a syntax like that of Polite will encourage developers to write more readable code. Even the smallest increase in code readability is to be desired since software developers spend the largest part of their time reading code rather than writing it.

In order to replace identifiers with sentences, we need to make sure that our language grammar allows the code to be parsed unambiguously. This is why the implementation published here starts from a Smalltalk-like syntax defined with parsing expression grammars and modifies it to add two desired features:
1) sentence case identifiers, and
2) indentation based method definitions. 

Polite is implemented on top of Pharo Smalltalk and PetitParser is used to define its grammar. 

The uploaded files represent a Pharo image together with three Pharo virtual machines for the dominant operating systems. To open the image execute the corresponding virtual machine and load Polite.image in it. You will need to have the PharoV50.sources (the fifth file) in the same directory as the image.

Inside the image, the Polite implementation can be found in the PoliteSmalltalk package. The package contains more than 450 passing unit tests. The image also contains a small role playing game simulator that illustrates the syntax of Polite. 

For the latest news on Polite Smalltalk, check out and

Files (147.2 MB)
Name Size md5:388da646d5835dd134d478391a59bac3 34.3 MB Download md5:486bab416c08768a2fdfd668f7ef27f6 3.5 MB Download md5:49296a59fd94e2c8bb718225163f477a 29.5 MB Download
PharoV50.sources md5:9c77ab2274979b0f43bb4d7d40d8097e 32.2 MB Download
Polite.image md5:0fbe289044c50c0873ec4fef9868e5a2 47.7 MB Download


Cite as