DEPRECATED

THIS REPOSITORY IS DEPRECATED. PLEASE FIND THE CODE IN PHARO MAIN REPO (FOR PHARO > 6.1).

---

Description

Epicea is a tool for Pharo that records code changes enriched with IDE events.

Epicea extends and could replace the traditional .changes logging mechanism, where the recorded code changes are incomplete and are not properly reified and thus it can be difficult to recover lost code after an image crash.

Epicea has a small subproject, named Ombu, which provides simple persistence. By default, Ombu uses STON to write the events when they are announced in the system. STON is part of Pharo 5.0.

Install it

Pharo 6 and 7

Epicea is part of these Pharo versions, so no need to install it.

Pharo 5

Metacello new
    configuration: #Epicea;
    smalltalkhubUser: 'MartinDias' project: 'Epicea';
    load.

Use it

• Enable recording at System Settings > Epicea.
• To browse the recorded logs, click on World menu > Tools > Code Changes
• To browse any .ombu file with a log, you can simply drag&drop it from your file browser (e.g. Finder in Mac) into the image.

Development

• Development, in Pharo 7:

• Development, in Pharo 6:

More info

Publications

• 2015: Ph.D. thesis, chapter 3
• 2013: short paper

Brief history

This project started as a fork (or a continuation) of Ezequiel's NewChangeSystem. It got inspiration as well in Göran's DeltaStreams.