https://github.com/astares/pharo-teachable

A teachable object for Pharo
https://github.com/astares/pharo-teachable

pharo

Last synced: 3 months ago
JSON representation

A teachable object for Pharo

• Host: GitHub
• URL: https://github.com/astares/pharo-teachable
• Owner: astares
• License: mit
• Created: 2020-01-28T08:37:04.000Z (almost 5 years ago)
• Default Branch: main
• Last Pushed: 2024-01-23T07:48:58.000Z (12 months ago)
• Last Synced: 2024-10-09T13:25:17.205Z (3 months ago)
• Topics: pharo
• Language: Smalltalk
• Size: 57.6 KB
• Stars: 6
• Watchers: 2
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Pharo-Teachable

A **teachable object** for [Pharo](http://www.pharo.org).

[![Unit Tests](https://github.com/astares/Pharo-Teachable/actions/workflows/unit-tests.yml/badge.svg)](https://github.com/astares/Pharo-Teachable/actions/workflows/unit-tests.yml)

[![Coverage Status](https://codecov.io/github/astares/Pharo-Teachable/coverage.svg?branch=main)](https://codecov.io/gh/astares/Pharo-Teachable/branch/main)

[![Baseline Groups](https://github.com/astares/Pharo-Teachable/actions/workflows/loading-groups.yml/badge.svg)](https://github.com/astares/Pharo-Teachable/actions/workflows/loading-groups.yml)

[![Pharo 8.0](https://img.shields.io/badge/Pharo-8.0-informational)](https://pharo.org)

[![Pharo 9.0](https://img.shields.io/badge/Pharo-9.0-informational)](https://pharo.org)

[![Pharo 10](https://img.shields.io/badge/Pharo-10-informational)](https://pharo.org)

[![Pharo 11](https://img.shields.io/badge/Pharo-11-informational)](https://pharo.org)

[![Pharo 12](https://img.shields.io/badge/Pharo-12-informational)](https://pharo.org)

## Intro

Using the small project you can easily create objects responding to specific

messages. This is useful for mocking in unit tests and other. The code goes back

to an early idea of [Ernest Micklei](https://github.com/emicklei) with an

implementation for Pharo by [Torsten Bergmann (astares)](http://www.github.com/astares).

## Quick Start

```Smalltalk

Metacello new 

  repository: 'github://astares/Pharo-Teachable:main/src';

  baseline: 'Teachable';

  load

```

## Documentation

It's an implementation of a Teachable class who's instances can be taught to

respond to messages. It's useful for creating mocks who should behave like other

objects (for instance inside of a test case) without actually implementing a

real mock class. Here is an example how it can be used:

```Smalltalk

|teachable|

teachable := Teachable new.

teachable

    whenSend: #help return: 'ok';

    whenSend: #doit evaluate: [1 inspect];

    acceptSend: #noDebugger;

    whenSend: #negate: evaluate: [:num | num negated].

```

After teaching the object we can use it as if it had a normal implementation in

a class:

```Smalltalk

teachable help. "this will return the string 'ok'"

teachable doit. "this will open the inspector on the SmallInteger 1"

teachable noDebugger. "this will accept the send of #noDebugger and return the teachable"

teachable negate: 120 "this will return -120"

```

see [https://astares.blogspot.com/2005/04/teaching-behavior.html](https://astares.blogspot.com/2005/04/teaching-behavior.html)

## Video

[![Watch the video](https://img.youtube.com/vi/aJCX4Rpp9AU/hqdefault.jpg)](https://www.youtube.com/watch?time_continue=1&v=aJCX4Rpp9AU)

## Compendium

Available in Pharo compendium