Skip to content

Commit 1580a54

Browse files
plexusplexus
committed
lein new chestnut clojurians-log +http-kit +site-middleware +coc +garden +re-frame +bleeding-edge
0 parents  commit 1580a54

31 files changed

+813
-0
lines changed

‎.dir-locals.el

+3
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
((nil . ((cider-refresh-before-fn . "reloaded.repl/suspend")
2+
(cider-refresh-after-fn . "reloaded.repl/resume")
3+
(cider-cljs-lein-repl . "(do (user/go) (user/cljs-repl))"))))

‎.gitignore

+16
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
*.class
2+
*.jar
3+
/.lein-*
4+
/.nrepl-port
5+
/.repl
6+
/checkouts/
7+
/classes/
8+
/lib/
9+
/log/
10+
/out/
11+
/resources/public/js/compiled/**
12+
/target/
13+
figwheel_server.log
14+
pom.xml
15+
pom.xml.asc
16+
/dev-target

‎LICENSE

+214
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,214 @@
1+
THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS ECLIPSE PUBLIC
2+
LICENSE ("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION OF THE PROGRAM
3+
CONSTITUTES RECIPIENT'S ACCEPTANCE OF THIS AGREEMENT.
4+
5+
1. DEFINITIONS
6+
7+
"Contribution" means:
8+
9+
a) in the case of the initial Contributor, the initial code and
10+
documentation distributed under this Agreement, and
11+
12+
b) in the case of each subsequent Contributor:
13+
14+
i) changes to the Program, and
15+
16+
ii) additions to the Program;
17+
18+
where such changes and/or additions to the Program originate from and are
19+
distributed by that particular Contributor. A Contribution 'originates' from
20+
a Contributor if it was added to the Program by such Contributor itself or
21+
anyone acting on such Contributor's behalf. Contributions do not include
22+
additions to the Program which: (i) are separate modules of software
23+
distributed in conjunction with the Program under their own license
24+
agreement, and (ii) are not derivative works of the Program.
25+
26+
"Contributor" means any person or entity that distributes the Program.
27+
28+
"Licensed Patents" mean patent claims licensable by a Contributor which are
29+
necessarily infringed by the use or sale of its Contribution alone or when
30+
combined with the Program.
31+
32+
"Program" means the Contributions distributed in accordance with this
33+
Agreement.
34+
35+
"Recipient" means anyone who receives the Program under this Agreement,
36+
including all Contributors.
37+
38+
2. GRANT OF RIGHTS
39+
40+
a) Subject to the terms of this Agreement, each Contributor hereby grants
41+
Recipient a non-exclusive, worldwide, royalty-free copyright license to
42+
reproduce, prepare derivative works of, publicly display, publicly perform,
43+
distribute and sublicense the Contribution of such Contributor, if any, and
44+
such derivative works, in source code and object code form.
45+
46+
b) Subject to the terms of this Agreement, each Contributor hereby grants
47+
Recipient a non-exclusive, worldwide, royalty-free patent license under
48+
Licensed Patents to make, use, sell, offer to sell, import and otherwise
49+
transfer the Contribution of such Contributor, if any, in source code and
50+
object code form. This patent license shall apply to the combination of the
51+
Contribution and the Program if, at the time the Contribution is added by the
52+
Contributor, such addition of the Contribution causes such combination to be
53+
covered by the Licensed Patents. The patent license shall not apply to any
54+
other combinations which include the Contribution. No hardware per se is
55+
licensed hereunder.
56+
57+
c) Recipient understands that although each Contributor grants the licenses
58+
to its Contributions set forth herein, no assurances are provided by any
59+
Contributor that the Program does not infringe the patent or other
60+
intellectual property rights of any other entity. Each Contributor disclaims
61+
any liability to Recipient for claims brought by any other entity based on
62+
infringement of intellectual property rights or otherwise. As a condition to
63+
exercising the rights and licenses granted hereunder, each Recipient hereby
64+
assumes sole responsibility to secure any other intellectual property rights
65+
needed, if any. For example, if a third party patent license is required to
66+
allow Recipient to distribute the Program, it is Recipient's responsibility
67+
to acquire that license before distributing the Program.
68+
69+
d) Each Contributor represents that to its knowledge it has sufficient
70+
copyright rights in its Contribution, if any, to grant the copyright license
71+
set forth in this Agreement.
72+
73+
3. REQUIREMENTS
74+
75+
A Contributor may choose to distribute the Program in object code form under
76+
its own license agreement, provided that:
77+
78+
a) it complies with the terms and conditions of this Agreement; and
79+
80+
b) its license agreement:
81+
82+
i) effectively disclaims on behalf of all Contributors all warranties and
83+
conditions, express and implied, including warranties or conditions of title
84+
and non-infringement, and implied warranties or conditions of merchantability
85+
and fitness for a particular purpose;
86+
87+
ii) effectively excludes on behalf of all Contributors all liability for
88+
damages, including direct, indirect, special, incidental and consequential
89+
damages, such as lost profits;
90+
91+
iii) states that any provisions which differ from this Agreement are offered
92+
by that Contributor alone and not by any other party; and
93+
94+
iv) states that source code for the Program is available from such
95+
Contributor, and informs licensees how to obtain it in a reasonable manner on
96+
or through a medium customarily used for software exchange.
97+
98+
When the Program is made available in source code form:
99+
100+
a) it must be made available under this Agreement; and
101+
102+
b) a copy of this Agreement must be included with each copy of the Program.
103+
104+
Contributors may not remove or alter any copyright notices contained within
105+
the Program.
106+
107+
Each Contributor must identify itself as the originator of its Contribution,
108+
if any, in a manner that reasonably allows subsequent Recipients to identify
109+
the originator of the Contribution.
110+
111+
4. COMMERCIAL DISTRIBUTION
112+
113+
Commercial distributors of software may accept certain responsibilities with
114+
respect to end users, business partners and the like. While this license is
115+
intended to facilitate the commercial use of the Program, the Contributor who
116+
includes the Program in a commercial product offering should do so in a
117+
manner which does not create potential liability for other Contributors.
118+
Therefore, if a Contributor includes the Program in a commercial product
119+
offering, such Contributor ("Commercial Contributor") hereby agrees to defend
120+
and indemnify every other Contributor ("Indemnified Contributor") against any
121+
losses, damages and costs (collectively "Losses") arising from claims,
122+
lawsuits and other legal actions brought by a third party against the
123+
Indemnified Contributor to the extent caused by the acts or omissions of such
124+
Commercial Contributor in connection with its distribution of the Program in
125+
a commercial product offering. The obligations in this section do not apply
126+
to any claims or Losses relating to any actual or alleged intellectual
127+
property infringement. In order to qualify, an Indemnified Contributor must:
128+
a) promptly notify the Commercial Contributor in writing of such claim, and
129+
b) allow the Commercial Contributor tocontrol, and cooperate with the
130+
Commercial Contributor in, the defense and any related settlement
131+
negotiations. The Indemnified Contributor may participate in any such claim
132+
at its own expense.
133+
134+
For example, a Contributor might include the Program in a commercial product
135+
offering, Product X. That Contributor is then a Commercial Contributor. If
136+
that Commercial Contributor then makes performance claims, or offers
137+
warranties related to Product X, those performance claims and warranties are
138+
such Commercial Contributor's responsibility alone. Under this section, the
139+
Commercial Contributor would have to defend claims against the other
140+
Contributors related to those performance claims and warranties, and if a
141+
court requires any other Contributor to pay any damages as a result, the
142+
Commercial Contributor must pay those damages.
143+
144+
5. NO WARRANTY
145+
146+
EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS PROVIDED ON
147+
AN "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER
148+
EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR
149+
CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A
150+
PARTICULAR PURPOSE. Each Recipient is solely responsible for determining the
151+
appropriateness of using and distributing the Program and assumes all risks
152+
associated with its exercise of rights under this Agreement , including but
153+
not limited to the risks and costs of program errors, compliance with
154+
applicable laws, damage to or loss of data, programs or equipment, and
155+
unavailability or interruption of operations.
156+
157+
6. DISCLAIMER OF LIABILITY
158+
159+
EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT NOR ANY
160+
CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL,
161+
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION
162+
LOST PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
163+
CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
164+
ARISING IN ANY WAY OUT OF THE USE OR DISTRIBUTION OF THE PROGRAM OR THE
165+
EXERCISE OF ANY RIGHTS GRANTED HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY
166+
OF SUCH DAMAGES.
167+
168+
7. GENERAL
169+
170+
If any provision of this Agreement is invalid or unenforceable under
171+
applicable law, it shall not affect the validity or enforceability of the
172+
remainder of the terms of this Agreement, and without further action by the
173+
parties hereto, such provision shall be reformed to the minimum extent
174+
necessary to make such provision valid and enforceable.
175+
176+
If Recipient institutes patent litigation against any entity (including a
177+
cross-claim or counterclaim in a lawsuit) alleging that the Program itself
178+
(excluding combinations of the Program with other software or hardware)
179+
infringes such Recipient's patent(s), then such Recipient's rights granted
180+
under Section 2(b) shall terminate as of the date such litigation is filed.
181+
182+
All Recipient's rights under this Agreement shall terminate if it fails to
183+
comply with any of the material terms or conditions of this Agreement and
184+
does not cure such failure in a reasonable period of time after becoming
185+
aware of such noncompliance. If all Recipient's rights under this Agreement
186+
terminate, Recipient agrees to cease use and distribution of the Program as
187+
soon as reasonably practicable. However, Recipient's obligations under this
188+
Agreement and any licenses granted by Recipient relating to the Program shall
189+
continue and survive.
190+
191+
Everyone is permitted to copy and distribute copies of this Agreement, but in
192+
order to avoid inconsistency the Agreement is copyrighted and may only be
193+
modified in the following manner. The Agreement Steward reserves the right to
194+
publish new versions (including revisions) of this Agreement from time to
195+
time. No one other than the Agreement Steward has the right to modify this
196+
Agreement. The Eclipse Foundation is the initial Agreement Steward. The
197+
Eclipse Foundation may assign the responsibility to serve as the Agreement
198+
Steward to a suitable separate entity. Each new version of the Agreement will
199+
be given a distinguishing version number. The Program (including
200+
Contributions) may always be distributed subject to the version of the
201+
Agreement under which it was received. In addition, after a new version of
202+
the Agreement is published, Contributor may elect to distribute the Program
203+
(including its Contributions) under the new version. Except as expressly
204+
stated in Sections 2(a) and 2(b) above, Recipient receives no rights or
205+
licenses to the intellectual property of any Contributor under this
206+
Agreement, whether expressly, by implication, estoppel or otherwise. All
207+
rights in the Program not expressly granted under this Agreement are
208+
reserved.
209+
210+
This Agreement is governed by the laws of the State of New York and the
211+
intellectual property laws of the United States of America. No party to this
212+
Agreement will bring a legal action under this Agreement more than one year
213+
after the cause of action arose. Each party waives its rights to a jury trial
214+
in any resulting litigation.

‎Procfile

+1
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
web: java $JVM_OPTS -cp target/clojurians-log.jar clojure.main -m clojurians-log.server

‎README.md

+144
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,144 @@
1+
# clojurians-log
2+
3+
4+
## Development
5+
6+
Open a terminal and type `lein repl` to start a Clojure REPL
7+
(interactive prompt).
8+
9+
In the REPL, type
10+
11+
```clojure
12+
(go)
13+
(cljs-repl)
14+
```
15+
16+
The call to `(go)` starts the Figwheel server at port 3449, which takes care of
17+
live reloading ClojureScript code and CSS, and the app server at port 10555
18+
which forwards requests to the http-handler you define.
19+
20+
Running `(cljs-repl)` starts the Figwheel ClojureScript REPL. Evaluating
21+
expressions here will only work once you've loaded the page, so the browser can
22+
connect to Figwheel.
23+
24+
When you see the line `Successfully compiled "resources/public/app.js" in 21.36
25+
seconds.`, you're ready to go. Browse to `http://localhost:10555` and enjoy.
26+
27+
**Attention: It is not needed to run `lein figwheel` separately. Instead `(go)`
28+
launches Figwheel directly from the REPL**
29+
30+
## Trying it out
31+
32+
If all is well you now have a browser window saying 'Hello Chestnut',
33+
and a REPL prompt that looks like `cljs.user=>`.
34+
35+
Open `resources/public/css/style.css` and change some styling of the
36+
H1 element. Notice how it's updated instantly in the browser.
37+
38+
Open `src/cljs/clojurians-log/core.cljs`, and change `dom/h1` to
39+
`dom/h2`. As soon as you save the file, your browser is updated.
40+
41+
In the REPL, type
42+
43+
```
44+
(ns clojurians-log.core)
45+
(swap! app-state assoc :text "Interactivity FTW")
46+
```
47+
48+
Notice again how the browser updates.
49+
50+
### Lighttable
51+
52+
Lighttable provides a tighter integration for live coding with an inline
53+
browser-tab. Rather than evaluating cljs on the command line with the Figwheel
54+
REPL, you can evaluate code and preview pages inside Lighttable.
55+
56+
Steps: After running `(go)`, open a browser tab in Lighttable. Open a cljs file
57+
from within a project, go to the end of an s-expression and hit Cmd-ENT.
58+
Lighttable will ask you which client to connect. Click 'Connect a client' and
59+
select 'Browser'. Browse to [http://localhost:10555](http://localhost:10555)
60+
61+
View LT's console to see a Chrome js console.
62+
63+
Hereafter, you can save a file and see changes or evaluate cljs code (without
64+
saving a file).
65+
66+
### Emacs/CIDER
67+
68+
CIDER is able to start both a Clojure and a ClojureScript REPL simultaneously,
69+
so you can interact both with the browser, and with the server. The command to
70+
do this is `M-x cider-jack-in-clojurescript`.
71+
72+
We need to tell CIDER how to start a browser-connected Figwheel REPL though,
73+
otherwise it will use a JavaScript engine provided by the JVM, and you won't be
74+
able to interact with your running app.
75+
76+
Put this in your Emacs configuration (`~/.emacs.d/init.el` or `~/.emacs`)
77+
78+
``` emacs-lisp
79+
(setq cider-cljs-lein-repl
80+
"(do (user/go)
81+
(user/cljs-repl))")
82+
```
83+
84+
Now `M-x cider-jack-in-clojurescript` (shortcut: `C-c M-J`, that's a capital
85+
"J", so `Meta-Shift-j`), point your browser at `http://localhost:10555`, and
86+
you're good to go.
87+
88+
## Testing
89+
90+
To run the Clojure tests, use
91+
92+
``` shell
93+
lein test
94+
```
95+
96+
To run the Clojurescript you use [doo](https://github.com/bensu/doo). This can
97+
run your tests against a variety of JavaScript implementations, but in the
98+
browser and "headless". For example, to test with PhantomJS, use
99+
100+
``` shell
101+
lein doo phantom
102+
```
103+
104+
## Deploying to Heroku
105+
106+
This assumes you have a
107+
[Heroku account](https://signup.heroku.com/dc), have installed the
108+
[Heroku toolbelt](https://toolbelt.heroku.com/), and have done a
109+
`heroku login` before.
110+
111+
``` sh
112+
git init
113+
git add -A
114+
git commit
115+
heroku create
116+
git push heroku master:master
117+
heroku open
118+
```
119+
120+
## Running with Foreman
121+
122+
Heroku uses [Foreman](http://ddollar.github.io/foreman/) to run your
123+
app, which uses the `Procfile` in your repository to figure out which
124+
server command to run. Heroku also compiles and runs your code with a
125+
Leiningen "production" profile, instead of "dev". To locally simulate
126+
what Heroku does you can do:
127+
128+
``` sh
129+
lein with-profile -dev,+production uberjar && foreman start
130+
```
131+
132+
Now your app is running at
133+
[http://localhost:5000](http://localhost:5000) in production mode.
134+
135+
## License
136+
137+
Copyright © 2016 FIXME
138+
139+
Distributed under the Eclipse Public License either version 1.0 or (at
140+
your option) any later version.
141+
142+
## Chestnut
143+
144+
Created with [Chestnut](http://plexus.github.io/chestnut/) 0.15.3-SNAPSHOT (6ef3c4bc).

0 commit comments

Comments
 (0)