Espresso Karol — A simple gui editor for javakarol

Espresso Karol is a simple gui editor for javakarol, which can be used by students who are only starting to learn Java and yet have problems to write whole class structures. It is written in java and uses gradle for building.

IMPORTANT NOTE (2018-06-17): This dates from the early days I programmed and therefore is probably of very bad code quality. Additionally, I know of no recent use of this and haven't updated it for some years. Hence, I declare this as deprecated and don't recommend it for use. If you want to use it, please contact me under johannes.rosenberger (at) jorsn.eu.

Features

• class tree of ROBOTER and WELT showing methods and constructors of these classes
• editor: syntax highlighting, line numbers, undo, redo
• error/output console
• automatic compilation and running of javakarol programs
• save and restore
• flexible configuration via modes and EProperties files (manual)
• gradle build and ecj: no dependencies except for a JRE

Dependencies

• Java Runtime Environment 1.6 or 1.7
• gradle is installed by gradlew
• the rest is managed automatically by gradle

Usage

1. Build it with gradle/gradlew.
2. Put it in your preferred installation directory.
3. Configure it: edit espresso.props, an EProperties file. A manual for EProperties files can be read here. You can find a list of java system-properties here.
4. Run the start script:
   • UNIX: bin/espresso
   • Windows: bin\espresso.bat

Modes

In the default mode, only the body of the main method of a javakarol program has to be written, but the preset parts of the class can be configured by creating other modes.

All modes are located in the directory modes or src/dist/modes. They are constituted of a directory whose name is the mode name, which contains three files:

• code: An executable java class template. // karolcode is substituted by the javakarol code from the editor.
• desc (optional): A description for this mode which is displayed above the editor pane.
• text (optional): A default text that is automatically inserted in the editor pane.

For examples please have a look at the built-in modes.

Copyright

Copyright (c) 2013 Johannes Rosenberger <jo.rosenberger(at)gmx-topmail.de>

This program and all of its files are released under a BSD Style License.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

For more details please read the LICENSE file.

---

###3rd-party libs

####JSyntaxPane v1.0.0

Copyright 2008 Ayman Al-Sairafi ayman.alsairafi@gmail.com

It is released under the Apache License, Version 2.0. The source code can be obtained here.

####juniversalchardet v1.0.3

is released under the Mozilla Public License Version 1.1 (MPLv1.1). The source code can be obtained here.

####Jakarta Commons Logging v1.1.1

Copyright 2001-2007 The Apache Software Foundation

It is released under the Apache License, Version 2.0. The source code can be obtained here.

####Eclipse Compiler for Java (ecj) v4.2.2+

is released under the Eclipse Public License v 1.0. The source code can be obtained here.

####sdreams v0.1

Copyright (c) 2013 Johannes Rosenberger

It is released under a [BSD Style License], as this program (see LICENSE). The source code can be obtained here.

####EProperties v1.1.5

Copyright 2009, Paul Bemowski

It is released under the Apache License, Version 2.0. The source code can be obtained here.

####javakarol v1.1

Copyright (c) 2008 Ulli Freiberger, (c) 2013 Ulli Freiberger

It is released under a custom license. You can find it in the javakarol documentation: In JavaKarolHandbuch.doc in lib/javakarol.zip (if downloaded) or here as PDF.