ChangeLog¶

dev¶

0.39.1 (2020-01-20)¶

0.39.0 (2019-09-16)¶

0.38.1 (2019-08-02)¶

• A small fix to make it work with weblocks-websocket.

0.38.0 (2019-07-07)¶

• Unhandled error processing was fixed. There were numerous problems with error processing: * Previosly server stopped to work because clack tried to write into a closed stream. * Also, before this fix, error page didn’t showed propertly. * Any error in the route lead to a server stop because there wasn’t any handler at all.

  Now they are handled with on-error method as errors in block/page rendering.

  All of them are fixed now.

0.37.0 (2019-06-01)¶

• Removed check if :bordeaux-threads is in the *features*, because this does not work in runtime in precompiled binary.

0.36.0(2019-05-03)¶

• Added function weblocks/session:expire, which can be used to tell Weblocks to delete current session after request processing.
• Also, now session middleware is created explicitly along with memory store. This made possible to add another two functions to gather some statistics about number of sessions:
  • weblocks/session:get-number-of-sessions;
  • weblocks/session:get-number-of-anonymous-sessions;
• The function weblocks/widgets/base:get-html-tag was fixed to render tables correctly. If the widget’s parent is a :table element, then this function returns :tr (instead of a :div). If it is :tr, it returns :td, and :div otherwise.
• A new setting weblocks/html:*pretty-html* was created, to further control pretty printing of html both in code and in tests.

0.35.3 (2019-03-31)¶

• Added a weblocks/response:add-retpath-to function, useful to add a retpath GET parameter to the URL.

  For example, calling:

  (add-retpath-to "/login" :retpath
  "http://example.com:10050/foo/bar")
  

  Will return:

  "/login?retpath=http%3A%2F%2Fexample.com%3A10050%2Ffoo%2Fbar"
  

  Argument :retpath is optional. By default, function will take an URL of the current web page.

0.35.2 (2019-03-21)¶

• Subsystem weblocks/utils/i18n was added to asd file, because otherwise system weblocks-ui can’t be installed from the Ultralisp.

0.35.1 (2019-02-02)¶

• Previosly, when you called (weblocks/debug:off), subsequent call to (weblocks/debug:status) returned T, but should return NIL.

  This was fixed now.

0.35.0¶

Request handling pipeline was refactored.

The idea of this refactoring, is to separate roles of the functions which process requests. Now weblocks/server:handle-http-request prepares data received from the Clack and calls weblocks/request-handler:handle-request to do the real job.

In it’s turn, weblocks/request-handler:handle-request should return an object of type weblocks/response:response containing a content, HTTP status code and headers of the response. Any error signal, thrown from the handle-request is considered by handle-http-request as an “unhandled error” and returned with 500 HTTP status code.

Here is a list of changes:

• Macro weblocks/hooks:on-application-hook-handle-request was renamed to weblocks/hooks:on-application-hook-handle-http-request.
• Generic-function weblocks/request-handler:handle-client-request was renamed to weblocks/request-handler:handle-request and now this function should return either string or an object of type response. Previously, it also made a non-local exit by throwing a tag, if request was aborted (for example to return a redirect response). But now it should only unwind a stack in case if some unhandled errow was thrown. Any condition of type weblocks/response:immediate-response will be catched inside a :around weblocks/request-handler:handle-request method and returned as usual response object.
• Function weblocks/response:abort-processing was renamed to weblocks/response:immediate-return, symbols *code*, *headers* and *content-type are not exported anymore. Instead of these global variables, use newly exported functions get-content, get-code, get-headers, get-custom-headers and get-content-type to extract information from the response object. * Package weblocks/response does not export symbols *code* and *content-type* anymore, but exports a function make-response which can be used by a weblocks/request-handler:handle-reqiest to return response.

0.34.0¶

0.33.2 (2018-12-06)¶

0.33.1 (2018-11-24)¶

0.33.0 (2018-11-22)¶

0.32.1 (2018-08-13)¶

0.32.0 (2018-06-26)¶

• Now weblocks system explicitly requires ASDF >= 3.1, because it uses package-inferred-system class.

0.31.1 (2018-06-16)¶

• Fixed error about missing ‘bool type under SBCL.

0.31.0 (2018-05-29)¶

• We don’t enforce *print-pretty* inside of weblocks/html:with-html macro. This hack was required because the bug in the spinneret, which was fixed at 2018-01-04:

  https://github.com/ruricolist/spinneret/commit/06b280612aff07cf376f593746d080230f2c7462

0.30.1 (2018-05-20)¶

• Error was fixed when you are trying to start a server which is already running. Now you have a “restart” to stop the old version of the server before starting the new one.

  However, it does not work with Woo server, because C library libev crashes with error:

  Assertion failed: (("libev: a signal must not be attached to two different loops", !signals [w->signum - 1].loop || signals [w->signum - 1].loop == loop)), function ev_signal_start, file ev.c, line 4082
  

0.30.0 (2018-05-19)¶

• Fixed the order of commands for frontend. Now they are returned in the chronological order.

0.29.0 (2018-05-05)¶

0.28.0 (2018-04-23)¶

Error handling was fixed. Previously it aborted Woo’s worker thread and break the server.

Variable weblocks/variables::*catch-errors-p* was renamed to weblocks/variables::*invoke-debugger-on-error* and it’s value was inverted. If this variable is True, then debugger will be invoked. Otherwise - Weblocks will return 500 error page.

Argument :invoke-debugger-on-errors of weblocks/debug:on function was renamed to :invoke-debugger-on-error.

Method weblocks/error-handler:on-error now is called when you abort request processing from the debugger. It is called with current app as the first argument and the nil instead of condition.

0.27.2 (2018-04-09)¶

Fixed a typo in string-widget and funcall-widget package definitions.

0.27.1 (2018-04-09)¶

Now string-widget and funcall-widget depends on weblocks/widgets/base instead of ``weblocks/widget.

0.27.0 (2018-03-11)¶

Reloading of the defapp definition now does not tries to restart an application. Previously, restart caused the problem – when there is only one application, whole Weblocks server was shut down. So, I’ve removed this implicit action.

Code which logs action result on the client-side was improved.

0.26.0 (2018-02-20)¶

Symbols add-application-hook, add-request-hook, add-session-hook, prepare-hooks and call-hook aren’t exported from weblocks/hooks anymore. Use new macro defhook instead.

Here is how it works:

You use defhook as the toplevel form of your file if you want to define a new hook. This macro will create few other macroses in weblocks/hooks package and will export them. For example:

(defhook database-opened
   "This hook is called when your application opens a database.")

This code will add these macroses into the weblocks/hooks package: on-session-hook-database-opened, on-request-hook-database-opened, on-application-hook-database-opened, with-database-opened-hook and call-database-opened-hook.

You need to wrap code, which opens a database, with with-database-opened-hook:

(weblocks/hooks:with-database-opened-hook ()
   (do-some-staff-to-open-database))

And in any other piece of code, you can define callbacks, using one of other three macroses:

(weblocks/hooks:on-session-hook-database-opened
    log-database-opening ()

  (weblocks/hooks:call-next-hook)
  (log:info "Database was opened"))

Usage of defhook macro gives more transparency to all defined hooks, because all of them now visible as external symbols in weblocks/hooks package.

0.25.2 (2018-02-04)¶

System weblocks/hooks now depends on log4cl and metatilities, because previously sometimes it was impossible to load weblocks.

0.25.1 (2018-02-04)¶

Old tests for widgets, removed from core framework were removed.

Tests for widget’s MOP methods were ported to Rove.

Package weblocks/utils/close now loaded with main :weblocks system.

Few old widget tests were removed.

Added function weblocks/session:reset which resets current session.

0.25.0 (2018-01-31)¶

0.24.0 (2018-01-29)¶

All rendering code was refactored.

Macroses with-html and with-html-to-string replaced with weblocks.html:with-html and weblocks.html:with-html-string. Stream *weblocks-output-stream* was moved to weblocks.html::*stream* and is not external anymore. Please, don’t use it directly.

0.23.0 (2018-01-11)¶

• Symbol weblocks.routes:*routes* is not external anymore. Use weblocks.routes:add-route and weblocks.routes:get-route to add new routes and to search a route matched on a path.
• Fixed getting the rendered widgets in weblocks.widget:update method when making :update-widget or :insert-widget (before) commands.
• Temporary added method weblocks::child-of-p for new type of widget. This should fix some issues, with widgets updating.

0.22.2 (2018-01-07)¶

• Class weblocks.widget:widget was exported, to make possible to define widgets based on it and some mixins.

0.22.1 (2018-01-07)¶

• Code broken in previos release was fixed.

0.22.0 (2018-01-06)¶

Most functions from weblocks.request were refactored and renamed:

• request-parameters -> get-parameters;
• request-parameter -> get-parameter;
• request-header -> get-header;
• remove-request-header -> remove-header;
• request-server-name -> get-host;
• request-server-port -> get-port;
• request-uri -> get-uri (and now it returns full URI with scheme, host and port;
• request-path-info -> get-path (and now it has keyword argument with-params to copy behaviour of old request-uri and return strings like /some/path?with=parameters;
• request-method -> get-method.

All these function now accept keyword argument :request. Previously it was &optional.

Another change is a new function weblocks.response:make-uri. It can be used to build new uri, based on the uri of the current request. This can be useful when embedding links into emails, for example.

0.21.0 (2018-01-01)¶

• Macro weblocks.session:get-value was replaced with a regular function.
• Function weblocks.session:set-value was removed and replaced with a setter (setf get-value).

0.20.1 (2017-12-20)¶

• Removed debug these debug messages from client-side JS:
  • LOADED;
  • Starting AJAX;
  • Stopping AJAX progress;
  • Some AJAX error;
  • Action success.

0.20.0 (2017-12-15)¶

• Package weblocks.debug now does not export *on variable, but provides three functions on, off and status.

• New method weblocks.server:serve-static-file was introduced. It can be used to create static routes which will respond with file’s content. For example, you could add this to your app’s initialize-instance method:

  (weblocks.server:serve-static-file
     "/favicon.png"
     (asdf:system-relative-pathname :app "favicon.png"))
  

0.19.2 (2017-11-29)¶

• Now weblocks rebinds *random-state* to itself for each request to allow it to use setf and change *random-state* until the end of request processing.

0.19.1 (2017-11-23)¶

• Dirty widgets rendering was fixed.

0.19.0 (2017-11-13)¶

• Variable *expired-action-handler*, method expired-action-handler and function default-expired-action-handler were replaced with method weblocks.actions:on-missing-action.
• Now we are trying to call action only if action’s name was given.
• Old method weblocks:handle-client-request ((app weblocks-webapp)) was removed. Look at it’s newer version in weblocks.request-handler.

0.18.0 (2017-11-12)¶

• Commented out call to update-widget-tree inside of (setf widget-children), because it breaks on (get-widgets-by-type 'selector :root obj) sometimes. Seems this is because I’ve removed selector’s code previously.

  Warning

  Probably parent/children handling code will be removed soon.

• Backtrace printing code was replaced with direct usage of trivial-backtrace:print-backtrace.

• Call to prepare-hooks was moved from weblocks.request-handler:handle-client-request to the the weblocks.server:handler-request, to fix session hooks processing when :process-request hook is called.

0.17.2 (2017-11-11)¶

• Error handling code was fixed. It was broken in 0.17.1 and prevented system loading.

0.17.1 (2017-11-11)¶

• Fixed error handling when debug mode is “off”. Now weblocks returns result of (weblocks.error-handler:on-error app) call.

0.17.0 (2017-11-11)¶

• Added a weblocks.actions package.
• Also, a commands were introduced. Commands describe remote calls which have to be applied on a client as a result of action’s execution. Previously, weblocks used similar technic to replace dirty widgets and to execute some javascript code before or after replacement. The new mechanism of “commands” is more generic and uses the JSON-RPC to pass function name and parameters from backend to client-side.
• Added weblocks.session:in-session-p function which returns t if session data can be retrived or stored without error.
• Now function initiateActionWithArgsAndCallback send arguments as JSON payload. This allows to send any datastructures as action’s params.
• Function weblocks.response:send-script was changed to use new mechanizm with commands. When you send script from the action, it will add a command :execute-code to the stack. All commands are executed in same order as they were added. If you want some code to be executed before widget update, just execute send-code before weblocks.widget:update.

0.16.0 (2017-11-04)¶

• New package was introduced - weblocks.widget it contains a new widget class with simplified rendering based on spinneret templating library.

• Now class route is exported from weblocks.routes and should be used instead of routes:route.

• New package weblocks.error-handler was introduced. It contains a on-error generic method which is called when some unhandled error raise by application.

• Fixed issue of adding multuple routes mapped to the same path. Now if url mapper already have a route all subsequent attempts to add a route with same path are ignored.

• Fixed error:

  Undefined function WEBLOCKS:WEBAPP-SESSION-KEY called with arguments
  (#<APP::APP #x3020052F01DD>)
  

• Fixed Content-Type of the default 500 page. Previously it was plain/text and browser didn’t undestand that and downloaded the file.

  Now Content-Type is text/plain.

0.15.0 (2017-11-03)¶

• Now weblocks does not checks if all tokens from URL were consumed by app during root widget rendering. Previously it returned 404 if some token weren’t consumed. Implement this logic in your app if needed.

• Macro assert-hooks-called was changed to return hooks in the order they were called. Also, now it waits hooks description as a DSL, like:

  (assert-hooks-called
    (:fact-created contact "vasya@pupkin.com")
    (:fact-removed contact "vasya@pupkin.com"))
  

• New system weblocks-testutils was introduced. It compiles weblocks.t.utils package which macroses useful for unittesting.

  Also, a new macro catch-hooks was added to check if some hooks were called during a unittest.

• Now weblocks does not open a new tab or window on 500 error during an action execution.

0.14.4 (2017-10-07)¶

• No more declaim optimize in different places. These declarations changed compiler’s settings at unexpected moments.
• Fixed error happened when “File not found”, and now with-hook macro returns the value of the last form’s evaluation.

0.14.3 (2017-09-23)¶

• Default method of render-page was fixed to really wrap page with <html>... block.
• Fixed a way how weblocks.debug:latest-session is processed.
• Function weblocks.request:remove-request-header now returns a new instance of request object and does not modify the original request. This fixes issue in weblocks-websocket.

0.14.2 (2017-09-22)¶

• Added package weblocks.debug and keeping latest session was rewritten using :process-request hook.

0.14.1 (2017-09-22)¶

• Added function weblocks.request:remove-request-header.
• Added a hook (:reset-session session), which is called around a code for clearing given session. Right now it is called only from weblocks.sessions:reset-latest-session.

0.14.0 (2017-09-20)¶

• html, menu, suggest and repl utilities were excluded.

• Code which was in request-handler.lisp, was excluded from build and partly moved to request-handler2.lisp.

• Added :stop-weblocks hook.

• Misc helper for repl were removed: sessions, in-session and pt. May be the will be restored in separate package.

• Page boilerplate rendering method render-page now does not use complex templating with contextes.

• Symbols refactoring: * *style-warn-on-circular-dirtying* variable ->

  weblocks.variables;

  • *style-warn-on-late-propagation* variable -> weblocks.variables;
  • gen-id function -> weblocks.session;
  • send-script function -> weblocks.response;
  • with-html-form macro -> weblocks-ui;
  • *approved-return-codes* variable -> weblocks.variables;
  • handle-ajax-request method -> weblocks.request-handler;
  • update-location-hash-dependents function -> weblocks.request-handler.
  • render-link function was moved to weblocks-ui.form in separate system.

0.13.11 (2017-09-12)¶

• Added weblocks.hooks:call-hook helper.
• Now call-next-hook is called automatically if it wasn’t called explicitly.

0.13.10 (2017-09-06)¶

0.13.10 (2017-09-06)¶

• Added :handle-request dynamic hook called around request handling code.

  Called when weblocks.request:*request* and weblocks.session:*session* are already bound.

0.13.9 (2017-09-02)¶

• Added integrity field for remove javascript dependencies. Also, get-cross-origin and :cross-origin were removed to get-crossorigin and :crossorigin, to conform the html attibute’s spelling.

0.13.8 (2017-09-02)¶

• Fixed error on (weblocks:redirect...) call.
• Fixed dependency handling in ajax requests.
• Now if unhandled exception occure, Woo’s handler remains working. Previously, handler’s thread shut down on any unhandled exception.
• Ajax progress now does not inserted into the document, but if element with id ajax-progress is present, it will be shown and hidden by jQuery’s .show and .hide methods. Also, they take optional speed parameters from data-* attributes data-show-speed and data-hide-speed.
• Reformatted documentation. Started to keep a changelog.

0.13.7 (2017-04-15)¶

• Previous history wasn’t tracked.