Skip to content

Latest commit

 

History

History
293 lines (194 loc) · 15.6 KB

CHANGELOG.md

File metadata and controls

293 lines (194 loc) · 15.6 KB
Raw

Pedestal Changelog

NOTE: Whenever upgrading versions of pedestal-app, please be sure to clean your project's out directory by running lein clean.

0.2.2 - November 5, 2013

Bug fix release preceding some exciting (and breaking) 0.3.0 changes. Unless any major bugs are discovered, no further work will continue on the 0.2.x stream.

For a full list of changes, please see this comparison of 0.2.1...0.2.2.

0.2.1 - September 1, 2013

Small bug fix for app-template.

For a full list of changes, please see this comparison of 0.2.0...0.2.1.

0.2.0 - August 30, 2013

This is a big one folks. Developer tooling has moved from generated projects into the app- and service-tools libraries.

If you want to take advantage of all the super-awesome new features then further action is required. See the respective changelogs in App and Service for more info.

App

  • Developer tooling has moved in its entirety to app-tools.

    Notable improvements:

    • Tooling functions are automatically included when running lein repl.
    • App configuration can be reloaded with (reload-config)
    • Future upgrades to tooling will be incorporated more easily.

    Additionally, app configuration is specified by an EDN file (instead of an executable Clojure file.) New projects will make use of this feature, but pre-0.2.0 generated projects will not.

    You do not have to make this upgrade, but we suggest you do.

    The easiest way to upgrade is to re-generate your application with the 0.2.0 app-template and transfer your existing code into it. It is possible, however, to migrate your existing application.

    How to migrate a 0.1.x project to 0.2.0: 1. Upgrade your project's pedestal-app dependencies to version "0.2.0" 2. Remove the dev/ folder. 3. $ touch config/user.clj -- This is needed for :repl-options with :init user to work. 4. Update your project.clj's :main and :repl-options keys like so. 5. Add the piggieback dependency to your project.clj ([com.cemerick/piggieback "0.1.0"]). 6. Update your application's config.clj file. There are two ways to do this... 1. *If you have not modified your config.clj: Generate a new application with the same name as your existing application, and steal the config.edn file from it. 2. If you have changed your config.clj, or you're a glutten for punishment perform these steps (looking like this is our goal): 1. mv config/config.clj config/config.edn 2. Remove the ns declaration. 3. Unwrap the configs def into a raw map. 4. Remove quotes from quoted namespaces. Look in :main and :renderer keys. 5. At path [:build :watch-files], (compile/html-files-in "app/templates") should become a map of tags to regex pattern strings like {:html ["^app/templates"]}. Note these are string regex patterns, not regexps--regexps aren't supported by EDN. 6. At path [:build :triggers], existing strings should be converted to string regex patterns. For example, the original {:html ["project-name/rendering.js"]} would become {:html ["project-name//rendering\\.js$"]}.

  • Tooling's cljs-repl is now provided by Chas Emerick's Piggieback.

  • Tooling's cljs-repl is now more clear about usage. This fixes #93, #90.

  • App's ClojureScript dependency has been bumped to r1835. Namespaced keywords are now allowed (::msg/topic)!

  • Logging in the browser is now grouped. #95

  • The template now includes a :ui aspect for rendering the simulated behavior. #184, #187

  • Added the :read-as option for msg/param. Setting to :data causes collected values to be parsed by the Clojure reader. #166*

Service

  • Service tooling has moved out of generated projects into a service-tools library.

    Notable improvements:

    • Tooling functions are automatically included when running lein repl.
    • Future upgrades to tooling will be incorporated more easily.

    There is a bit of migration necessary to move existing projects to 0.2.0 tooling. You don't have to make this change, but we suggest you do.

    How to migrate a 0.1.x project to 0.2.0: 1. Update your project's dependencies to match the new ones: 1. Upgrade your project's pedestal-service dependencies to version "0.2.0". 2. Add [io.pedestal/pedestal.service-tools "0.2.0"] as a dependency. 3. Remove logback and slf4j logging dependencies. 2. Remove the dev/ folder 3. $ touch config/user.clj -- This is needed for :repl-options with :init user to work. 4. Update your project.clj's :main and :repl-options keys to match the new template project.clj. 5. Pare down your src/**/server.clj file to match the new template server.clj.

  • Service now uses Cheshire instead of clojure.data.json for constructing json-responses and parsing json bodies. #162

    This change does eliminate some JSON parsing options that were previously possible in 0.1.10. Specifically the following options are no longer supported:

    • :eof-error? - "If true (default) will throw exception if the stream is empty."
    • :eof-value - "Object to return if the stream is empty and eof-error? is false. Default is nil."

    If your application makes use of these options you will need to construct a body-params interceptor with a parser-map where you have swapped in your own #"^application/json" key with a custom-json-parser similar to the old version.

    That might look something like this:

    ;; In a utility namespace
(require '[io.pedestal.service.http.body-params :as bp])
(defn old-style-json-parser ...)

(def my-body-params (bp/body-params (-> (bp/default-parser-map)
                                        (assoc #"^application/json" (old-style-json-parser)))))

  • The default behavior of the body-params interceptor now keywordizes JSON keys. To retain the old behavior, create a body-params interceptor like so:

    (require '[io.pedestal.service.http.body-params :as bp])
(def string-keys-body-params (bp/body-params (bp/default-parser-map :json-options {:key-fn nil})))

  • A bug with CORS headers has been fixed.

  • The default MIME type has been returned to text/plain (it was a bug that it changed to octet-stream.)

Miscellaneous bug-fixes and improvements

For a full list of changes, please see this comparison of 0.1.10...0.2.0.

0.1.10 - July 5, 2013

App

  • The messages queue is now a priority queue. Specify msg/priority :high in a message for that message to be processed before all other unadorned messages. 2495b9a5
  • Various improvements that make it easier to run in a web worker (more on that to follow, 😉)

Service

  • io.pedestal.service.http.route/url-for now accepts a :fragment option for specifying URL fragments (i.e `http://example.com/#foobars). #85
  • io.pedestal.service.http.body-params's edn and json parsers can now be configured (both alone and as part of default-parser-map). #96, #97, #98

Miscellaneous bug-fixes and improvements

For a full list of changes, please see this comparison of 0.1.9...0.1.10.

0.1.9 - June 14, 2013

General

  • All Pedestal libraries now properly depend on Clojure 1.5.1.

App

  • The dataflow engine now properly reports changes when nodes have nil or falsey values. #78
  • Messages that throw exceptions during processing now log an error message.
  • Templates can now insert content at a specific index with io.pedestal.app.render.push.templates/insert-t. #81
  • Generated dev/dev.clj now uses (start) instead of (run), bringing it in line with pedestal-service. #84

Miscellaneous bug-fixes and improvements

For a full list of changes, please see this comparison of 0.1.8...0.1.9.

0.1.8 - May 29, 2013

General

  • App and service templates now allow creating projects with namespaces #68.

          $ lein new pedestal-app com.example/foo
      ... creates foo/ with src/com/example/foo/*.clj

Service

  • Corrected a test error in the generated service template project.

Miscellaneous bug-fixes and improvements

For a full list of changes, please see this comparison of 0.1.7...0.1.8.

0.1.7 - May 24, 2013

App

  • The new simplified dataflow engine is here! We're working to update our documentation and samples now. Stay informed by following @pedestal_team on twitter.
    • Existing applications will continue to function normally.
  • io.pedestal.app.templates/dtfn now allows for more than one data field #60.

Service

  • Empty EDN responses are now handled gracefully #69.
  • Resources for services can now be drawn from resources/ #51.
  • Typo fixes in HTML and JSON interceptors #72.
  • Corrected a few places the Content-Type header was not being set properly #58, #65.

Miscellaneous bug-fixes and improvements

For a full list of changes, please see this comparison of 0.1.6...0.1.7.

0.1.6 - May 03, 2013

Service

  • Context paths now work with JBoss

  • It is now possible to specify TCP port in routes (default: 8080). Specified ports will also be reflected in generated URL.

      (defroutes routes
    [[:app1 8080
      ["/" {:get app1-root}]]
     [:app2 8181
      ["/" {:get app2-root}]]]

Miscellaneous bug-fixes and improvements

For a full list of changes, please see a comparison of 0.1.5...0.1.6.

0.1.4/0.1.5 - April 05, 2013

We encountered a bug deploying version 0.1.4 so that release was re-done as version 0.1.5

App

  • lein clean now correctly deletes out directory.

Service

  • Added text-as-html and data-as-json interceptors.
  • Newly generated service apps assume content is text/html if not specified otherwise.

Miscellaneous bug-fixes and improvements

Special thanks to @ddeaguiar for grammar and spelling corrections, as well as his help in removing lein-marginalia as a dependency. We've updated the documentation with instructions on how to continue to generate marginalia documentation.

For a full list of changes, please see a comparison of 0.1.3...0.1.5.

0.1.3 - April 05, 2013

App

  • app-tools now serves every request with header Cache-Control: no-cache (#44) - @rkneufeld

Service

  • Add CORS support to SSE and service template - @timewald

Miscellaneous bug-fixes and improvements

For a full list of changes, please see a comparison of 0.1.2...0.1.3.

0.1.2 - March 29, 2013

General

App

Service