Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/McCLIM/McCLIM
An implementation of the Common Lisp Interface Manager, version II
https://github.com/McCLIM/McCLIM
common-lisp debugger inspector listener mcclim
Last synced: 3 months ago
JSON representation
An implementation of the Common Lisp Interface Manager, version II
- Host: GitHub
- URL: https://github.com/McCLIM/McCLIM
- Owner: McCLIM
- License: other
- Archived: true
- Created: 2014-01-21T04:47:22.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2023-03-13T19:03:10.000Z (almost 2 years ago)
- Last Synced: 2024-08-01T03:41:56.339Z (6 months ago)
- Topics: common-lisp, debugger, inspector, listener, mcclim
- Language: Common Lisp
- Size: 22.5 MB
- Stars: 577
- Watchers: 50
- Forks: 118
- Open Issues: 201
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 
## New Repository
McCLIM repository has migrated to
[Codeberg](https://codeberg.org/McCLIM/McCLIM).
## [McCLIM](https://common-lisp.net/project/mcclim/) Version 0.9.8-dev post-"Imbolc"
McCLIM, an implementation of the "[Common Lisp Interface Manager CLIM
II Specification](http://bauhh.dyndns.org:8000/clim-spec/index.html)",
is a portable and high-level user interface management system toolkit
for Common Lisp. It has a powerful presentation model which allows us
to directly link the visual representation of an object to its
semantics. It has several high-level programming capabilities that
enable us to develop a user interface conveniently; including
formatted output, graphics, windowing and commands that are invoked by
typing text, keyboard shortcuts or clicking a mouse button.
McCLIM works with Allegro CL, Clozure CL, CLISP, CMUCL, Embeddable CL,
the Scieneer CL Common-lisp, SBCL and the LispWorks implementations.
Right now the only backend supported by McCLIM is CLX, which ties it
to the Xserver on the host system. Any platform capable of running
Xserver may run McCLIM applications.
### Installing McCLIM
McCLIM is available on
[`Quicklisp`](https://www.quicklisp.org/beta/). Make sure you have
installed a supported Common Lisp implementation and `Quicklisp` is
configured correctly. Then, McCLIM can be installed by entering the
following in your REPL:
```lisp
(ql:quickload "mcclim")
```
To see if McCLIM works on your host you may load the system with examples
and run the example browser application:
```lisp
(ql:quickload "clim-examples") ; Load the system with examples.
(clim-demo:demodemo) ; Run the example browser application.
```
### An Example
1. Quickload McCLIM by running `(ql:quickload "mcclim")`.
2. Put the following code in a file `example.lisp`.
```lisp
(in-package :common-lisp-user)
(defpackage "APP"
(:use :clim :clim-lisp)
(:export "APP-MAIN"))
(in-package :app)
;;; Define a application-frame (a.k.a. application window in traditional GUI's).
(define-application-frame superapp ()
()
;; :panes section describes different parts of the
;; application-frame. This application has only one pane.
(:panes
(int :interactor :height 400 :width 600))
;; :layouts section describes how the panes are layed out.
;; This application has one layout named "default" which has a single pane.
(:layouts
(default int)))
;;; Following function launches an instance of "superapp" application-frame.
(defun app-main ()
(run-frame-top-level (make-application-frame 'superapp)))
```
3. Load the file and run:
```lisp
(app:app-main)
```
### Documentation
You can access the McCLIM manual draft in
[HTML](https://common-lisp.net/project/mcclim/static/manual/mcclim.html)
and
[PDF](https://common-lisp.net/project/mcclim/static/documents/mcclim.pdf)
formats if you want, but it's still a work in progress. Several other
CLIM 2 resources are listed on [CLiki](http://www.cliki.net/CLIM) and
McCLIM [homepage](https://common-lisp.net/project/mcclim/).
### Subdirectory Overview
- `Apps` - sample applications. This includes:
- `Apps/Debugger` - Peter Mechleborg's debugger (similar to Slime's).
- `Apps/Functional-Geometry` - Frank Buss and Rainer Joswig's functional
geometry package for drawing "Escher" tiles.
- `Apps/Clouseau` - A powerful inspector for Lisp objects.
- `Apps/Listener` - Andy Hefner's Lisp Listener.
- `Apps/Scigraph` - BBN's graphing package.
- `Documentation` - Contains available documentation such as
Documentation for Libraries `Drei` and `ESA`, A Guided Tour of
CLIM, Specification in LATEX source and Manual in LATEX and texinfo
sources (For the time being, texinfo manual contains some
additional Documentation not found in LATEX version).
- `Examples` - Sources for the examples in `clim-demo` and some
additional examples. These are of varying quality and style; many
of them date from when McCLIM was quite incomplete.
- `Extensions` - Contains several extensions to CLIM 2 spec, such
as fonts, additional layouts, bezier, images etc. Most
of them are loaded automatically with McCLIM.
- `Libraries` - Contains `Drei` and `ESA` Libraries. See
Documentation for details.
### Important Links
- [Homepage](https://common-lisp.net/project/mcclim/)
- [Mailing List](https://mailman.common-lisp.net/listinfo/mcclim-devel)
- [#clim @ irc.libera.chat](https://libera.chat)
- [Wiki](https://codeberg.org/McCLIM/McCLIM/wiki)