SOM is a minimal Smalltalk dialect that was used to teach at the Hasso Plattner Institute and before that at the University of Århus (Denmark) where it was used for teaching and as the foundation for Resilient Smalltalk.

In addition to PySOM, other implementations exist for Java (SOM, TruffleSOM), C (CSOM), C++ (SOM++), Python (PySOM), and Squeak/Pharo Smalltalk (AweSOM).

A simple Hello World looks like:

Hello = (
  run = (
    'Hello World!' println.
  )
)

This repository contains a Python-base implementation of SOM, including SOM's standard library, and a number of benchmarks. The main project page has links to other SOM VM implementations.

PySOM implementation use either an abstract-syntax-tree or a bytecode-based interpreter. One can choose between them with the SOM_INTERP environment variable.

• AST-based interpreter: SOM_INTERP=AST
• bytecode-based interpreter: SOM_INTERP=BC

To check out the code, run:

git clone --recurse-submodules https://github.com/SOM-st/PySOM.git

Note the --recurse-submodules option. It makes sure that the core library, i.e., the Smalltalk code is downloaded.

PySOM's tests can be executed with:

SOM_INTERP=AST ./som.sh -cp Smalltalk TestSuite/TestHarness.som

A simple Hello World program can be started with:

SOM_INTERP=AST ./som.sh -cp Smalltalk Examples/Hello.som

To compile PySOM, a recent PyPy is recommended and the RPython source code is required. The source distribution of PyPy 7.3 can be used like this:

wget https://downloads.python.org/pypy/pypy2.7-v7.3.1-src.tar.bz2
tar xvf pypy2.7-v7.3.1-src.tar.bz2
export PYPY_DIR=`pwd`/pypy2.7-v7.3.1-src/

Information on previous authors are included in the AUTHORS file. This code is distributed under the MIT License. Please see the LICENSE file for details.

In 2013, the implementations of PySOM, RPySOM, and RTruffleSOM where split over multiple repositories. Since end of 2020, they are reunited here and PySOM can be used with Python 2.7, Python 3.8, as well as compiled with RPython. Thus, https://github.com/SOM-st/PySOM is again the only and the canonical repository.

Thanks to GitHub Actions, all pull requests of this repository are automatically tested. The current build status is: