Skip to content
Newer
Older
100644 98 lines (67 sloc) 4 KB
be23185 @daveray Travis build status.
authored Feb 27, 2012
1 [![Build Status](https://secure.travis-ci.org/daveray/seesaw.png?branch=develop)](http://travis-ci.org/daveray/seesaw)
2
c4fbc21 @daveray notes
authored May 24, 2011
3 _Note that current development is on the *develop* branch, not master_
4
426da21 @daveray fix link. :(
authored May 29, 2011
5 There's now a [Google Group] (https://groups.google.com/group/seesaw-clj) for discussion and questions.
39c617f @daveray Note google group.
authored May 29, 2011
6
7df6864 @daveray Update readme a bit
authored Dec 8, 2011
7 [Here's a brief tutorial] (https://gist.github.com/1441520) that covers some Seesaw basics. It assumes no knowledge of Swing or Java.
8
9c86415 @daveray Added Clojure/West slide link to README. Mostly just giving travisci …
authored Mar 26, 2012
9 [Here's the slides] (http://darevay.com/talks/clojurewest2012/) from a Clojure/West 2012 talk on the Seesaw. Best viewed in Chrome or Safari.
10
6a9c005 @daveray Update readme
authored May 18, 2011
11 # Seesaw: Clojure + UI
cdb4045 @daveray readme and various cleanup
authored Mar 28, 2011
12
31cbcf0 @Domon Fix a small typo in README.md
Domon authored Sep 2, 2011
13 _*See [the Seesaw Wiki] (https://github.com/daveray/seesaw/wiki) and [the Seesaw API Docs] (http://daveray.github.com/seesaw/) for more detailed docs. Note that the docs in the code (use the `doc` function!) are always the most up-to-date and trustworthy.*_
da37ca4 @daveray Fix typo
authored Feb 4, 2012
14
3a35326 @daveray update readme
authored Feb 4, 2012
15 Seesaw is a library/DSL for constructing user interfaces in Clojure. It happens to be built on Swing, but please don't hold that against it.
cdb4045 @daveray readme and various cleanup
authored Mar 29, 2011
16
a6ab8dd @daveray Update README.md
authored Dec 2, 2011
17 ## Features
18
7df6864 @daveray Update readme a bit
authored Dec 9, 2011
19 Seesaw is compatible with both Clojure 1.2 and 1.3.
20
3a35326 @daveray update readme
authored Feb 5, 2012
21 * Swing knowledge is *not required* for many apps!
38b0ed2 @daveray links
authored Dec 2, 2011
22 * [Construct widgets](https://github.com/daveray/seesaw/wiki/Widgets) with simple functions, e.g. `(listbox :model (range 100))`
bf1ddd6 @daveray Update README.md
authored Dec 2, 2011
23 * Support for all of Swing's built-in widgets as well as SwingX.
38b0ed2 @daveray links
authored Dec 2, 2011
24 * Support for all of Swing's layout managers as well as MigLayout, and JGoodies Forms
bf1ddd6 @daveray Update README.md
authored Dec 2, 2011
25 * Convenient shortcuts for most properties. For example, `:background :blue` or `:background "#00f"`, or `:size [640 :by 480]`.
38b0ed2 @daveray links
authored Dec 2, 2011
26 * [CSS-style selectors](https://github.com/daveray/seesaw/wiki/Selectors) with same syntax as [Enlive](https://github.com/cgrand/enlive).
27 * Unified, extensible [event API](https://github.com/daveray/seesaw/wiki/Handling-events)
28 * Unified, extensible [selection API](https://github.com/daveray/seesaw/wiki/Handling-selection)
29 * [Widget binding](http://blog.darevay.com/2011/07/seesaw-widget-binding/), i.e. map changes from one widget into one or more others in a more functional style. Also integrates with Clojure's reference types.
30 * [Graphics](https://github.com/daveray/seesaw/wiki/Graphics)
31 * [i18n](https://github.com/daveray/seesaw/wiki/Resource-bundles-and-i18n)
32 * An extensive [test suite](https://github.com/daveray/seesaw/tree/master/test/seesaw/test)
a6ab8dd @daveray Update README.md
authored Dec 2, 2011
33
34 _There are numerous Seesaw examples in [test/seesaw/test/examples](https://github.com/daveray/seesaw/tree/master/test/seesaw/test/examples)._
e5e53e5 @daveray Moved most stuff over to the wiki. README was getting unwieldy.
authored May 17, 2011
35
97c54c9 @daveray Lein getting started...
authored May 9, 2011
36 ## TL;DR
37
38 Here's how you use Seesaw with [Leiningen] (https://github.com/technomancy/leiningen)
39
40 Install `lein` as described and then:
41
42 $ lein new hello-seesaw
43 $ cd hello-seesaw
44
45 Add Seesaw to `project.clj`
46
47 (defproject hello-seesaw "1.0.0-SNAPSHOT"
48 :description "FIXME: write"
7df6864 @daveray Update readme a bit
authored Dec 9, 2011
49 :dependencies [[org.clojure/clojure "1.3.0"]
fb20cba @daveray Doc updates
authored May 31, 2011
50 [seesaw "x.y.z"]])
bfe3669 @daveray Figuring out this whole versioning/release process.
authored May 14, 2011
51
fb20cba @daveray Doc updates
authored Jun 1, 2011
52 _Replace the Seesaw version with whatever the latest version tag is. See below!_
97c54c9 @daveray Lein getting started...
authored May 10, 2011
53
54 Now edit the generated `src/hello_seesaw/core.clj` file:
55
56 (ns hello-seesaw.core
57 (:use seesaw.core))
58
59 (defn -main [& args]
9d7e7d1 @daveray whitespace
authored Apr 20, 2012
60 (invoke-later
61 (-> (frame :title "Hello",
97c54c9 @daveray Lein getting started...
authored May 10, 2011
62 :content "Hello, Seesaw",
22e5e67 @daveray update readme
authored Jun 4, 2011
63 :on-close :exit)
64 pack!
65 show!)))
97c54c9 @daveray Lein getting started...
authored May 10, 2011
66
67 Now run it:
68
69 $ lein run -m hello-seesaw.core
70
807577e @daveray Seesaw doesn't seem so experimental anymore.
authored Dec 8, 2011
71 *NOTE:* Here's how you can run against the bleeding edge of Seesaw:
4b13830 @daveray add a note about bleeding edge
authored May 17, 2011
72
d0962ce @daveray Mention dev branch
authored May 19, 2011
73 * Clone Seesaw from github. Fork if you like. *Switch to the "develop" branch.*
f054a05 @erturne Added required step to run against the bleeding edge of Seesaw. It wo…
erturne authored Jul 7, 2012
74 * In your Seesaw checkout, run `lein deps` to get Seesaw's dependencies
4b13830 @daveray add a note about bleeding edge
authored May 18, 2011
75 * In your Seesaw checkout, run `lein install` to build it
76 * In your project's `project.clj` file, change the Seesaw version to `X.Y.Z-SNAPSHOT` to match whatever's in Seesaw's `project.clj`.
77 * Run `lein deps`
78 * Move along
97c54c9 @daveray Lein getting started...
authored May 10, 2011
79
82c63de @daveray Update contributors.
authored Dec 12, 2011
80 ## Contributors
81
82 * Meikel Brandmeyer (kotarak)
d2e4ad4 @daveray alphabetize.
authored Dec 12, 2011
83 * David Brunell (Quantalume)
82c63de @daveray Update contributors.
authored Dec 12, 2011
84 * Stuart Campbell (harto)
d2e4ad4 @daveray alphabetize.
authored Dec 12, 2011
85 * Michael Frericks
86 * Jonathan Fischer Friberg (odyssomay)
82c63de @daveray Update contributors.
authored Dec 12, 2011
87 * Anthony Grimes (Raynes)
d2e4ad4 @daveray alphabetize.
authored Dec 12, 2011
88 * Thomas Karolski (MHOOO)
82c63de @daveray Update contributors.
authored Dec 12, 2011
89 * Chun-wei Kuo (Domon)
5be7853 @daveray Update README.md
authored Dec 12, 2011
90 * Vladimir Matveev (dpx-infinity)
9517a81 @daveray Add Jeff Rose to contrib list
authored Dec 20, 2011
91 * Jeff Rose (rosejn)
82c63de @daveray Update contributors.
authored Dec 12, 2011
92
cdb4045 @daveray readme and various cleanup
authored Mar 29, 2011
93 ## License
94
95 Copyright (C) 2011 Dave Ray
96
97 Distributed under the Eclipse Public License, the same as Clojure.
Something went wrong with that request. Please try again.