The reblocks-parenscript Reference Manual

This is the reblocks-parenscript Reference Manual, version 0.6.0, generated automatically by Declt version 4.0 beta 2 "William Riker" on Sun Sep 15 06:34:32 2024 GMT+0.

Table of Contents


1 Introduction


2 Systems

The main system appears first, followed by any subsystem dependency.


2.1 reblocks-parenscript

An utility to define JavaScript dependencies for Weblocks widgets using Parenscript.

Author

Alexander Artemenko <>

Home Page

https://40ants.com/reblocks-parenscript/

Source Control

(GIT https://github.com/40ants/reblocks-parenscript)

Bug Tracker

https://github.com/40ants/reblocks-parenscript/issues

License

Unlicense

Long Description

<a id="x-28REBLOCKS-PARENSCRIPT-DOCS-2FINDEX-3A-40README-2040ANTS-DOC-2FLOCATIVES-3ASECTION-29"></a>

# reblocks-parenscript - An utility to define JavaScript dependencies for Weblocks widgets using Parenscript.

<a id="reblocks-parenscript-asdf-system-details"></a>

## REBLOCKS-PARENSCRIPT ASDF System Details

* Version: 0.6.0

* Description: An utility to define JavaScript dependencies for Weblocks widgets using Parenscript.

* Licence: Unlicense

* Author: Alexander Artemenko <svetlyak.40wt@gmail.com>

* Homepage: [https://40ants.com/reblocks-parenscript/][7b2b]

* Bug tracker: [https://github.com/40ants/reblocks-parenscript/issues][f0d4]

* Source control: [GIT][c5e3]

* Depends on: [alexandria][8236], [bordeaux-threads][3dbf], [parenscript][7921], [reblocks][184b]

[![](https://github-actions.40ants.com/40ants/reblocks-parenscript/matrix.svg?only=ci.run-tests)][cd34]

![](http://quickdocs.org/badge/reblocks-parenscript.svg)

<a id="x-28REBLOCKS-PARENSCRIPT-DOCS-2FINDEX-3A-3A-40INSTALLATION-2040ANTS-DOC-2FLOCATIVES-3ASECTION-29"></a>

## Installation

You can install this library from Quicklisp, but you want to receive updates quickly, then install it from Ultralisp.org:

“‘
(ql-dist:install-dist "http://dist.ultralisp.org/"
:prompt nil)
(ql:quickload :reblocks-parenscript)
“‘
<a id="x-28REBLOCKS-PARENSCRIPT-DOCS-2FINDEX-3A-3A-40USAGE-2040ANTS-DOC-2FLOCATIVES-3ASECTION-29"></a>

## Usage

This library should be used to define JavaScript dependencies for Reblocks widgets.

<a id="x-28REBLOCKS-PARENSCRIPT-DOCS-2FINDEX-3A-3A-40API-2040ANTS-DOC-2FLOCATIVES-3ASECTION-29"></a>

## API

<a id="x-28REBLOCKS-PARENSCRIPT-DOCS-2FINDEX-3A-3A-40REBLOCKS-PARENSCRIPT-3FPACKAGE-2040ANTS-DOC-2FLOCATIVES-3ASECTION-29"></a>

### REBLOCKS-PARENSCRIPT

<a id="x-28-23A-28-2820-29-20BASE-CHAR-20-2E-20-22REBLOCKS-PARENSCRIPT-22-29-20PACKAGE-29"></a>

#### [package](d2f9) ‘reblocks-parenscript‘

<a id="x-28REBLOCKS-PARENSCRIPT-DOCS-2FINDEX-3A-3A-7C-40REBLOCKS-PARENSCRIPT-3FClasses-SECTION-7C-2040ANTS-DOC-2FLOCATIVES-3ASECTION-29"></a>

#### Classes

<a id="x-28REBLOCKS-PARENSCRIPT-DOCS-2FINDEX-3A-3A-40REBLOCKS-PARENSCRIPT-24PARENSCRIPT-DEPENDENCY-3FCLASS-2040ANTS-DOC-2FLOCATIVES-3ASECTION-29"></a>

##### PARENSCRIPT-DEPENDENCY

<a id="x-28REBLOCKS-PARENSCRIPT-3APARENSCRIPT-DEPENDENCY-20CLASS-29"></a>

###### [class](6f09) ‘reblocks-parenscript:parenscript-dependency‘ (local-dependency)

Keeps JavaScript code, created using [‘make-dependency‘][8c2d] macro or [‘make-dependency*‘][8b74] function.

**Readers**

<a id="x-28REBLOCKS-PARENSCRIPT-3AJS-CODE-20-2840ANTS-DOC-2FLOCATIVES-3AREADER-20REBLOCKS-PARENSCRIPT-3APARENSCRIPT-DEPENDENCY-29-29"></a>

###### [reader](f8cc) ‘reblocks-parenscript:js-code‘ (parenscript-dependency) (:js)

<a id="x-28REBLOCKS-PARENSCRIPT-DOCS-2FINDEX-3A-3A-7C-40REBLOCKS-PARENSCRIPT-3FFunctions-SECTION-7C-2040ANTS-DOC-2FLOCATIVES-3ASECTION-29"></a>

#### Functions

<a id="x-28REBLOCKS-PARENSCRIPT-3AMAKE-DEPENDENCY-2A-20FUNCTION-29"></a>

##### [function](cb0e) ‘reblocks-parenscript:make-dependency*‘ parenscript-code

This function works similarly like [‘make-dependency‘][8c2d] macro but accepts
Parenscript code as a list. They are related to each other like
parenscript:ps macro and parenscript:ps* function.

Use a function version when you want to build a JavaScript code from
parts and embed some value into it.

Usually it looks like this:

“‘lisp
CL-USER> (let ((widget-id "foo-bar"))
(reblocks-parenscript:make-dependency*
‘(defun show-alert ()
(alert (+ "Hello from widget with id = " ,widget-id)))))
#<REBLOCKS-PARENSCRIPT:PARENSCRIPT-DEPENDENCY >
“‘
This will generate following JavaScript code:

“‘
CL-USER> (format t "~A~%"
(reblocks-parenscript:js-code *))
function showAlert() {
__PS_MV_REG = [];
return alert(’Hello from widget with id = ’ + ’foo-bar’);
};
“‘
<a id="x-28REBLOCKS-PARENSCRIPT-DOCS-2FINDEX-3A-3A-7C-40REBLOCKS-PARENSCRIPT-3FMacros-SECTION-7C-2040ANTS-DOC-2FLOCATIVES-3ASECTION-29"></a>

#### Macros

<a id="x-28REBLOCKS-PARENSCRIPT-3AMAKE-DEPENDENCY-20-2840ANTS-DOC-2FLOCATIVES-3AMACRO-29-29"></a>

##### [macro](5145) ‘reblocks-parenscript:make-dependency‘ &body parenscript-code

This macro creates an object of class [‘parenscript-dependency‘][1a62] transformin the ‘BODY‘
into JavaScript Code. It interpreters whole body as a Parenscript code.

Here is a usage example.

“‘lisp
CL-USER> (reblocks-parenscript:make-dependency
(defun show-alert ()
(ps:chain console (log "Showing alert"))
(alert "Hello from Lisp!"))

(set-interval show-alert 3000))
#<REBLOCKS-PARENSCRIPT:PARENSCRIPT-DEPENDENCY >
“‘
This dependency will have this JavaScript code:

“‘lisp
CL-USER> (format t "~A~%"
(reblocks-parenscript:js-code *))
function showAlert() {
console.log(’Showing alert’);
__PS_MV_REG = [];
return alert(’Hello from Lisp!’);
};
setInterval(showAlert, 3000);
“‘
You can use this dependency in a method of [‘reblocks/dependencies:get-dependencies‘][0fcf] generic-function like this:

“‘lisp
(defmethod reblocks/dependencies:get-dependencies ((widget example))
(list*
(reblocks-parenscript:make-dependency
(defun show-alert ()
(ps:chain console (log "Showing alert"))
(alert "Hello from Lisp!"))

(set-interval show-alert 3000))
(call-next-method)))
“‘
<a id="x-28REBLOCKS-PARENSCRIPT-3AMAKE-JS-HANDLER-20-2840ANTS-DOC-2FLOCATIVES-3AMACRO-29-29"></a>

##### [macro](cb35) ‘reblocks-parenscript:make-js-handler‘ &key lisp-code js-code

Creates a Reblocks action and returns JavaScript code, which can be used as ‘onChange‘, ‘onClick‘, etc. handler.

* Argument ‘LISP-CODE‘ should be a list of conses:

First list item should be action’s lambda list.
Other list items are wrapped into implicit progn.

* Argument ‘JS-CODE‘ also should be a list of conses:

Parenscript code, returning an object.
This object will be passed to the Lisp part of the handler
as keyword arguments.

This macro creates a code which will return a string.
The result is suitable to be used inline as value for ‘HTML‘ attributes like ‘onChange‘, ‘onClick‘, etc.

Handler must be build from two parts ‘JS‘ and Lisp.

JavaScript part should be written in Parenscript and return
an objects. This object will be passed to the backend as
keyword arguments for the action, defined by Lisp part of the handler.

The code from ‘JS-CODE‘ argument will be wrapped into a function which is called
immediately with implicit arguments.

Here is a real world example. This code processes updates of a text
in the ‘HTML‘ input. This way you can make a suggest or on fly value validation:

“‘
(:input :value url
:name "url"
:type "text"
:onchange
(reblocks-parenscript:make-js-handler
:lisp-code ((&key url)
(update-url (branches widget)
url))
:js-code ((event)
;; This will pass new URL value
;; to the backend:
(parenscript:create
:url (@ event target value)))))
“‘

[7b2b]: https://40ants.com/reblocks-parenscript/
[8c2d]: https://40ants.com/reblocks-parenscript/#x-28REBLOCKS-PARENSCRIPT-3AMAKE-DEPENDENCY-20-2840ANTS-DOC-2FLOCATIVES-3AMACRO-29-29
[8b74]: https://40ants.com/reblocks-parenscript/#x-28REBLOCKS-PARENSCRIPT-3AMAKE-DEPENDENCY-2A-20FUNCTION-29
[1a62]: https://40ants.com/reblocks-parenscript/#x-28REBLOCKS-PARENSCRIPT-3APARENSCRIPT-DEPENDENCY-20CLASS-29
[0fcf]: https://40ants.com/reblocks/dependencies/#x-28REBLOCKS-2FDEPENDENCIES-3AGET-DEPENDENCIES-20GENERIC-FUNCTION-29
[c5e3]: https://github.com/40ants/reblocks-parenscript
[cd34]: https://github.com/40ants/reblocks-parenscript/actions
[d2f9]: https://github.com/40ants/reblocks-parenscript/blob/cad417124707657f1c98f2d33ea810240323f2fc/src/reblocks-parenscript.lisp#L1
[cb0e]: https://github.com/40ants/reblocks-parenscript/blob/cad417124707657f1c98f2d33ea810240323f2fc/src/reblocks-parenscript.lisp#L111
[cb35]: https://github.com/40ants/reblocks-parenscript/blob/cad417124707657f1c98f2d33ea810240323f2fc/src/reblocks-parenscript.lisp#L181
[6f09]: https://github.com/40ants/reblocks-parenscript/blob/cad417124707657f1c98f2d33ea810240323f2fc/src/reblocks-parenscript.lisp#L40
[f8cc]: https://github.com/40ants/reblocks-parenscript/blob/cad417124707657f1c98f2d33ea810240323f2fc/src/reblocks-parenscript.lisp#L41
[5145]: https://github.com/40ants/reblocks-parenscript/blob/cad417124707657f1c98f2d33ea810240323f2fc/src/reblocks-parenscript.lisp#L61
[f0d4]: https://github.com/40ants/reblocks-parenscript/issues
[8236]: https://quickdocs.org/alexandria
[3dbf]: https://quickdocs.org/bordeaux-threads
[7921]: https://quickdocs.org/parenscript
[184b]: https://quickdocs.org/reblocks

* * *
###### [generated by [40ANTS-DOC](https://40ants.com/doc/)]

Version

0.6.0

Defsystem Dependency

40ants-asdf-system (system).

Dependencies
Source

reblocks-parenscript.asd.


2.2 reblocks-parenscript/reblocks-parenscript

Author

Alexander Artemenko <>

Home Page

https://40ants.com/reblocks-parenscript/

Source Control

(GIT https://github.com/40ants/reblocks-parenscript)

Bug Tracker

https://github.com/40ants/reblocks-parenscript/issues

License

Unlicense

Dependencies
  • reblocks/dependencies (system).
  • reblocks/utils/misc (system).
  • alexandria (system).
  • parenscript (system).
  • bordeaux-threads (system).
Source

reblocks-parenscript.asd.


3 Files

Files are sorted by type and then listed depth-first from the systems components trees.


3.1 Lisp


3.1.1 reblocks-parenscript/reblocks-parenscript.asd

Source

reblocks-parenscript.asd.

Parent Component

reblocks-parenscript (system).

ASDF Systems

3.1.2 reblocks-parenscript/reblocks-parenscript/file-type.lisp

Source

reblocks-parenscript.asd.

Parent Component

reblocks-parenscript/reblocks-parenscript (system).

Packages

reblocks-parenscript.

Public Interface
Internals

4 Packages

Packages are listed by definition order.


4.1 reblocks-parenscript

Source

file-type.lisp.

Nickname

reblocks-parenscript/reblocks-parenscript

Use List

common-lisp.

Public Interface
Internals

5 Definitions

Definitions are sorted by export status, category, package, and then by lexicographic order.


5.1 Public Interface


5.1.1 Macros

Macro: make-dependency (&body parenscript-code)

This macro creates an object of class PARENSCRIPT-DEPENDENCY transformin the BODY
into JavaScript Code. It interpreters whole body as a Parenscript code.

Here is a usage example.

“‘lisp
CL-USER> (reblocks-parenscript:make-dependency
(defun show-alert ()
(ps:chain console (log "Showing alert"))
(alert "Hello from Lisp!"))

(set-interval show-alert 3000))
#<REBLOCKS-PARENSCRIPT:PARENSCRIPT-DEPENDENCY >
“‘

This dependency will have this JavaScript code:

“‘lisp
CL-USER> (format t "~A~%"
(reblocks-parenscript:js-code *))
function showAlert() {
console.log(’Showing alert’);
__PS_MV_REG = [];
return alert(’Hello from Lisp!’);
};
setInterval(showAlert, 3000);
“‘

You can use this dependency in a method of REBLOCKS/DEPENDENCIES:GET-DEPENDENCIES generic-function like this:

“‘lisp
(defmethod reblocks/dependencies:get-dependencies ((widget example))
(list*
(reblocks-parenscript:make-dependency
(defun show-alert ()
(ps:chain console (log "Showing alert"))
(alert "Hello from Lisp!"))

(set-interval show-alert 3000))
(call-next-method)))
“‘

Package

reblocks-parenscript.

Source

file-type.lisp.

Macro: make-js-handler (&key lisp-code js-code)

Creates a Reblocks action and returns JavaScript code, which can be used as ‘onChange‘, ‘onClick‘, etc. handler.

- Argument LISP-CODE should be a list of conses:

First list item should be action’s lambda list.
Other list items are wrapped into implicit progn.

- Argument JS-CODE also should be a list of conses:

Parenscript code, returning an object.
This object will be passed to the Lisp part of the handler
as keyword arguments.

This macro creates a code which will return a string.
The result is suitable to be used inline as value for HTML attributes like ‘onChange‘, ‘onClick‘, etc.

Handler must be build from two parts JS and Lisp.

JavaScript part should be written in Parenscript and return
an objects. This object will be passed to the backend as
keyword arguments for the action, defined by Lisp part of the handler.

The code from JS-CODE argument will be wrapped into a function which is called
immediately with implicit arguments.

Here is a real world example. This code processes updates of a text
in the HTML input. This way you can make a suggest or on fly value validation:

“‘
(:input :value url
:name "url"
:type "text"
:onchange
(reblocks-parenscript:make-js-handler
:lisp-code ((&key url)
(update-url (branches widget)
url))
:js-code ((event)
;; This will pass new URL value
;; to the backend:
(parenscript:create
:url (@ event target value)))))
“‘

Package

reblocks-parenscript.

Source

file-type.lisp.


5.1.2 Ordinary functions

Function: make-dependency* (parenscript-code)

This function works similarly like MAKE-DEPENDENCY macro but accepts Parenscript code as a list. They are related to each other like parenscript:ps macro and parenscript:ps* function.

Use a function version when you want to build a JavaScript code from parts and embed some value into it.

Usually it looks like this:

“‘lisp
CL-USER> (let ((widget-id "foo-bar")) (reblocks-parenscript:make-dependency*
‘(defun show-alert ()
(alert (+ "Hello from widget with id = " ,widget-id))))) #<REBLOCKS-PARENSCRIPT:PARENSCRIPT-DEPENDENCY >
“‘

This will generate following JavaScript code:

“‘
CL-USER> (format t "~A~%"
(reblocks-parenscript:js-code *))
function showAlert() {
__PS_MV_REG = [];
return alert(’Hello from widget with id = ’ + ’foo-bar’);
};
“‘

Package

reblocks-parenscript.

Source

file-type.lisp.


5.1.3 Generic functions

Generic Reader: js-code (object)
Package

reblocks-parenscript.

Methods
Reader Method: js-code ((parenscript-dependency parenscript-dependency))

automatically generated reader method

Source

file-type.lisp.

Target Slot

js.


5.1.4 Standalone methods

Method: get-url ((dependency parenscript-dependency))

Returns a hash-like url for this dependency because it does not have a real filename.

Package

reblocks/dependencies.

Source

file-type.lisp.

Method: serve ((dependency parenscript-dependency))

Serves static dependency from the disk.

Package

reblocks/dependencies.

Source

file-type.lisp.


5.1.5 Classes

Class: parenscript-dependency

Keeps JavaScript code, created using MAKE-DEPENDENCY macro or MAKE-DEPENDENCY* function.

Package

reblocks-parenscript.

Source

file-type.lisp.

Direct superclasses

local-dependency.

Direct methods
Direct slots
Slot: js
Type

string

Initargs

:js

Readers

js-code.

Writers

This slot is read-only.


5.2 Internals


5.2.1 Special variables

Special Variable: *js-compiler-lock*
Package

reblocks-parenscript.

Source

file-type.lisp.


5.2.2 Macros

Macro: ps (&body body)
Package

reblocks-parenscript.

Source

file-type.lisp.


5.2.3 Ordinary functions

Function: make-js-code-for-handler (js-code action-code)

Returns Parenscript code, ready to be translated into JavaScript.

The code from ‘js-code‘ will be wrapped into a function which is called immediately with implicit arguments.

This result is suitable to be used inline as value for HTML attributes like onChange, onClick, etc.

Args:
js-code (list of conses):
Parenscript code, returning an object.
This object will be passed to the Lisp part of the handler
as keyword arguments.
action-code (string):
A symbol used as a placeholder for the action’s id string.

Returns:
Sexps with Parenscript code.

Package

reblocks-parenscript.

Source

file-type.lisp.

Function: ps* (&rest parenscript-code)
Package

reblocks-parenscript.

Source

file-type.lisp.


Appendix A Indexes


A.1 Concepts


A.3 Variables