You can [get it on GitHub](https://github.com/aw/picolisp-json).
You can [get it on my Git server](https://git.a1w.ca/aw/picolisp-json).
This library can be used to parse and serialize (encode/decode) JSON strings in [PicoLisp](http://picolisp.com/).
@ -12,7 +12,7 @@ This library can be used to parse and serialize (encode/decode) JSON strings in
# Explanation: JSON Encoder/Decoder for PicoLisp
This document provides a short walkthrough of the source code for the [PicoLisp-JSON](https://github.com/aw/picolisp-json.git) encoder/decoder.
This document provides a short walkthrough of the source code for the [PicoLisp-JSON](https://git.a1w.ca/aw/picolisp-json.git) encoder/decoder.
It's split into a few sections for easier reading:
@ -24,7 +24,7 @@ It's split into a few sections for easier reading:
Make sure you read the [README](README.md) to get an idea of what this library does.
Also, I recommend you read my [Nanomsg Explanation](https://github.com/aw/picolisp-nanomsg/blob/master/EXPLAIN.md) for additional PicoLisp tips and ideas.
Also, I recommend you read my [Nanomsg Explanation](https://git.a1w.ca/aw/picolisp-nanomsg/blob/master/EXPLAIN.md) for additional PicoLisp tips and ideas.
@ -184,7 +184,7 @@ Let's talk about danger first. In this function, we uses [setq](http://software-
The [lisp](http://software-lab.de/doc/refL.html#lisp) function is quite special. When using `(native)` for C calls, certain functions require a callback as an argument, or "function pointer" (Google it).
The `(ne-set-server-auth)` function requires a callback as its second argument, so we create one using `(lisp)`. If you've read the [JSON explanations](https://github.com/aw/picolisp-json/blob/master/EXPLAIN.md#make-array), you'll quickly notice there's an anonymous function in this `(lisp)` call. It essentially sends 5 arguments (which are numbers) to the `(do-auth)` function, under the name `ne_auth_creds`.
The `(ne-set-server-auth)` function requires a callback as its second argument, so we create one using `(lisp)`. If you've read the [JSON explanations](https://git.a1w.ca/aw/picolisp-json/blob/master/EXPLAIN.md#make-array), you'll quickly notice there's an anonymous function in this `(lisp)` call. It essentially sends 5 arguments (which are numbers) to the `(do-auth)` function, under the name `ne_auth_creds`.
Here's the C code to give a better picture:
@ -210,7 +210,7 @@ The main requirement is to set the `username`, `password`, and return an integer
Attempt )
```
Whoa wait, what's that `@` thing doing there? Remember we talked about the [@ result](https://github.com/aw/picolisp-nanomsg/blob/master/EXPLAIN.md#nn_symbols)? Well, this is **NOT** that.
Whoa wait, what's that `@` thing doing there? Remember we talked about the [@ result](https://git.a1w.ca/aw/picolisp-nanomsg/blob/master/EXPLAIN.md#nn_symbols)? Well, this is **NOT** that.
This is actually a [transient symbol](http://software-lab.de/doc/native.html#libs) which refers to the main program (PicoLisp).
@ -200,4 +200,4 @@ This library introduces simple wrappers around those predicates, which then call
This one is quite simple, all it does is check if `Expected` is equal to `Result`.
The [other assertions](https://github.com/aw/picolisp-unit/blob/master/README.md#assertions-table) are quite similar and seem to cover most test cases. I've considered adding opposite tests such as `refute`, but I've rarely found a need for them as there are alternate approaches.
The [other assertions](https://git.a1w.ca/aw/picolisp-unit/blob/master/README.md#assertions-table) are quite similar and seem to cover most test cases. I've considered adding opposite tests such as `refute`, but I've rarely found a need for them as there are alternate approaches.
You can [get it on GitHub](https://github.com/aw/picolisp-json).
You can [get it on my Git server](https://git.a1w.ca/aw/picolisp-json).
This library can be used to parse and serialize (encode/decode) JSON strings in [PicoLisp](http://picolisp.com/).
@ -12,9 +12,9 @@ This library can be used to parse and serialize (encode/decode) JSON strings in
# Explanation: JSON Encoder/Decoder in pure PicoLisp
This document provides a short walkthrough of the source code for the [PicoLisp-JSON](https://github.com/aw/picolisp-json.git) encoder/decoder.
This document provides a short walkthrough of the source code for the [PicoLisp-JSON](https://git.a1w.ca/aw/picolisp-json.git) encoder/decoder.
**Note:** This document covers `v3` of the JSON library. To view the older (C/ffi bindings) version [click here](https://github.com/aw/picolisp-json/blob/v2.2.0/EXPLAIN.md).
**Note:** This document covers `v3` of the JSON library. To view the older (C/ffi bindings) version [click here](https://git.a1w.ca/aw/picolisp-json/blob/v2.2.0/EXPLAIN.md).
It's split into a few sections for easier reading:
@ -227,4 +227,4 @@ The previously tokenized JSON string would end up like this:
## encoding JSON
The code for encoding JSON strings hasn't changed, so feel free to [read about it here](https://github.com/aw/picolisp-json/blob/master/EXPLAIN.md#encoding-json).
The code for encoding JSON strings hasn't changed, so feel free to [read about it here](https://git.a1w.ca/aw/picolisp-json/blob/master/EXPLAIN.md#encoding-json).
title: PicoLisp AWS CLI tool using OpenSSL and Curl
---
You can [get it on GitHub](https://github.com/aw/picolisp-awscurl).
You can [get it on my Git server](https://git.a1w.ca/aw/picolisp-awscurl).
This command line tool can be used to sign [AWS Signature Version 4](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html) requests and make calls to various AWS APIs.
@ -16,7 +16,7 @@ This command line tool can be used to sign [AWS Signature Version 4](https://doc
# Requirements
* `picolisp`: 32-bit or 64-bit `v3.1.11+`, tested up to PicoLisp `v20.6.29`, [see test runs](https://github.com/aw/picolisp-awscurl/actions/)
* `picolisp`: 32-bit or 64-bit `v3.1.11+`, tested up to PicoLisp `v20.6.29`, [see test runs](https://git.a1w.ca/aw/picolisp-awscurl/actions/)
* `libcrypto.so`: for using `--native` functions with PicoLisp `v17.12+`
* `picolisp-unit`: `v3.0.0+` for testing the library
* `openssl`: `v1.0.0+` for signing and hashing strings
@ -30,7 +30,7 @@ The file `libawscurl.l` can be included as a library, rather than using the comm
## WARNING
There is currently **no validation** on command line arguments. Be careful the input you provide. [See issue #1](https://github.com/aw/picolisp-awscurl/issues/1)
There is currently **no validation** on command line arguments. Be careful the input you provide. [See issue #1](https://git.a1w.ca/aw/picolisp-awscurl/issues/1)
title: GitHub Action to run 32-bit or 64-bit PicoLisp code
---
You can [get it on GitHub](https://github.com/aw/picolisp-action) or the [GitHub Marketplace](https://github.com/marketplace/actions/picolisp-action).
You can [get it on my Git server](https://git.a1w.ca/aw/picolisp-action) or the [GitHub Marketplace](https://github.com/marketplace/actions/picolisp-action).
This action downloads, compiles, and globally installs PicoLisp.
It can be used to run PicoLisp code such as [units tests](https://github.com/aw/picolisp-unit).
It can be used to run PicoLisp code such as [units tests](https://git.a1w.ca/aw/picolisp-unit).
title: Redis-inspired key/value store written in PicoLisp
---
You can [get it on GitHub](https://github.com/aw/picolisp-kv).
You can [get it on my Git server](https://git.a1w.ca/aw/picolisp-kv).
This program mimics functionality of a [Redis™](https://redis.io) in-memory database, but is designed specifically for [PicoLisp](https://picolisp.com) applications with optional on-disk persistence and encryption.
@ -73,7 +73,7 @@ Received data will be returned as-is (list, integer, string, etc). Wrap the resu
-> "12345"
```
Feel free to observe the example code in [client.l](https://github.com/aw/picolisp-kv/blob/master/client.l).
Feel free to observe the example code in [client.l](https://git.a1w.ca/aw/picolisp-kv/blob/master/client.l).
> **Note**: Using `(kv-send-data)` will send the data to the server and automatically block the client while waiting for a response.
You can [get it on GitHub](https://github.com/aw/picolisp-posixmq).
You can [get it on my Git server](https://git.a1w.ca/aw/picolisp-posixmq).
_[POSIX Message Queues](https://man7.org/linux/man-pages/man7/mq_overview.7.html)_ provide a dependency-free mechanism for processes to exchange data in the form of messages.
@ -26,7 +26,7 @@ This library makes it simple to embed support for _POSIX Message Queues_ in [Pic
The first step is to run the unit tests: `make check`
If those fail, jump to the [TUTORIALS](https://github.com/aw/picolisp-posixmq/blob/master/docs/TUTORIALS.md) section to perform the initial setup and and system check.
If those fail, jump to the [TUTORIALS](https://git.a1w.ca/aw/picolisp-posixmq/blob/master/docs/TUTORIALS.md) section to perform the initial setup and and system check.
If all works well, then your system is ready to use this library.
@ -61,9 +61,9 @@ The code below illustrates how to use the queue for sending and receiving a mess
# Documentation
Additional usage and reference documentation can be found in [docs/](https://github.com/aw/picolisp-posixmq/blob/master/docs/)
Additional usage and reference documentation can be found in [docs/](https://git.a1w.ca/aw/picolisp-posixmq/blob/master/docs/)
* [TUTORIALS](https://github.com/aw/picolisp-posixmq/blob/master/docs/TUTORIALS.md): some guides **for beginners** to get started using this library
* [HOWTO](https://github.com/aw/picolisp-posixmq/blob/master/docs/HOWTO.md): a set of recipes for performing more advanced tasks with this library
* [EXPLAIN](https://github.com/aw/picolisp-posixmq/blob/master/docs/EXPLAIN.md): an explanation of some key concepts, including how this library works
* [REFERENCE](https://github.com/aw/picolisp-posixmq/blob/master/docs/REFERENCE.md): technical information on the internals of this library
* [TUTORIALS](https://git.a1w.ca/aw/picolisp-posixmq/blob/master/docs/TUTORIALS.md): some guides **for beginners** to get started using this library
* [HOWTO](https://git.a1w.ca/aw/picolisp-posixmq/blob/master/docs/HOWTO.md): a set of recipes for performing more advanced tasks with this library
* [EXPLAIN](https://git.a1w.ca/aw/picolisp-posixmq/blob/master/docs/EXPLAIN.md): an explanation of some key concepts, including how this library works
* [REFERENCE](https://git.a1w.ca/aw/picolisp-posixmq/blob/master/docs/REFERENCE.md): technical information on the internals of this library
You can [get it on GitHub](https://github.com/aw/picolisp-rust).
You can [get it on my Git server](https://git.a1w.ca/aw/picolisp-rust).
This repo provides a simple example of how to use [PicoLisp](https://software-lab.de/down.html) with [Rust](https://www.rust-lang.org/tools/install) using PicoLisp's FFI `(native)` functionality.
<h1class="post-title">JSON Encoder/Decoder for PicoLisp</h1>
<spanclass="post-date">08 Mar 2015</span>
<p>You can <ahref="https://github.com/aw/picolisp-json">get it on GitHub</a>.</p>
<p>You can <ahref="https://git.a1w.ca/aw/picolisp-json">get it on my Git server</a>.</p>
<p>This library can be used to parse and serialize (encode/decode) JSON strings in <ahref="http://picolisp.com/">PicoLisp</a>.</p>
@ -117,7 +117,7 @@
<h1id="explanation-json-encoderdecoder-for-picolisp">Explanation: JSON Encoder/Decoder for PicoLisp</h1>
<p>This document provides a short walkthrough of the source code for the <ahref="https://github.com/aw/picolisp-json.git">PicoLisp-JSON</a> encoder/decoder.</p>
<p>This document provides a short walkthrough of the source code for the <ahref="https://git.a1w.ca/aw/picolisp-json.git">PicoLisp-JSON</a> encoder/decoder.</p>
<p>It’s split into a few sections for easier reading:</p>
@ -134,7 +134,7 @@
<p>Make sure you read the <ahref="README.md">README</a> to get an idea of what this library does.</p>
<p>Also, I recommend you read my <ahref="https://github.com/aw/picolisp-nanomsg/blob/master/EXPLAIN.md">Nanomsg Explanation</a> for additional PicoLisp tips and ideas.</p>
<p>Also, I recommend you read my <ahref="https://git.a1w.ca/aw/picolisp-nanomsg/blob/master/EXPLAIN.md">Nanomsg Explanation</a> for additional PicoLisp tips and ideas.</p>
<h1class="post-title">HTTP(S) client for PicoLisp</h1>
<spanclass="post-date">16 Mar 2015</span>
<p>You can <ahref="https://github.com/aw/picolisp-https">get it on GitHub</a>.</p>
<p>You can <ahref="https://git.a1w.ca/aw/picolisp-https">get it on my Git server</a>.</p>
<p>This library can be used to make HTTP and HTTPS requests in <ahref="http://picolisp.com">PicoLisp</a>, with support for authentication.</p>
@ -117,13 +117,13 @@
<h1id="explanation-https-client-for-picolisp">Explanation: HTTP(S) client for PicoLisp</h1>
<p>This document provides a short walkthrough of the source code for the <ahref="https://github.com/aw/picolisp-https.git">PicoLisp-HTTPS</a> client.</p>
<p>This document provides a short walkthrough of the source code for the <ahref="https://git.a1w.ca/aw/picolisp-https.git">PicoLisp-HTTPS</a> client.</p>
<p>I won’t cover concepts which were covered in previous source code explanations. You can read them here:</p>
<p>This document is split into a few sections:</p>
@ -289,7 +289,7 @@
<p>The <ahref="http://software-lab.de/doc/refL.html#lisp">lisp</a> function is quite special. When using <codeclass="language-plaintext highlighter-rouge">(native)</code> for C calls, certain functions require a callback as an argument, or “function pointer” (Google it).</p>
<p>The <codeclass="language-plaintext highlighter-rouge">(ne-set-server-auth)</code> function requires a callback as its second argument, so we create one using <codeclass="language-plaintext highlighter-rouge">(lisp)</code>. If you’ve read the <ahref="https://github.com/aw/picolisp-json/blob/master/EXPLAIN.md#make-array">JSON explanations</a>, you’ll quickly notice there’s an anonymous function in this <codeclass="language-plaintext highlighter-rouge">(lisp)</code> call. It essentially sends 5 arguments (which are numbers) to the <codeclass="language-plaintext highlighter-rouge">(do-auth)</code> function, under the name <codeclass="language-plaintext highlighter-rouge">ne_auth_creds</code>.</p>
<p>The <codeclass="language-plaintext highlighter-rouge">(ne-set-server-auth)</code> function requires a callback as its second argument, so we create one using <codeclass="language-plaintext highlighter-rouge">(lisp)</code>. If you’ve read the <ahref="https://git.a1w.ca/aw/picolisp-json/blob/master/EXPLAIN.md#make-array">JSON explanations</a>, you’ll quickly notice there’s an anonymous function in this <codeclass="language-plaintext highlighter-rouge">(lisp)</code> call. It essentially sends 5 arguments (which are numbers) to the <codeclass="language-plaintext highlighter-rouge">(do-auth)</code> function, under the name <codeclass="language-plaintext highlighter-rouge">ne_auth_creds</code>.</p>
<p>Here’s the C code to give a better picture:</p>
<p>Whoa wait, what’s that <codeclass="language-plaintext highlighter-rouge">@</code> thing doing there? Remember we talked about the <ahref="https://github.com/aw/picolisp-nanomsg/blob/master/EXPLAIN.md#nn_symbols">@ result</a>? Well, this is <strong>NOT</strong> that.</p>
<p>Whoa wait, what’s that <codeclass="language-plaintext highlighter-rouge">@</code> thing doing there? Remember we talked about the <ahref="https://git.a1w.ca/aw/picolisp-nanomsg/blob/master/EXPLAIN.md#nn_symbols">@ result</a>? Well, this is <strong>NOT</strong> that.</p>
<p>This is actually a <ahref="http://software-lab.de/doc/native.html#libs">transient symbol</a> which refers to the main program (PicoLisp).</p>
<h1class="post-title">Unit Testing framework for PicoLisp</h1>
<spanclass="post-date">18 Mar 2015</span>
<p>You can <ahref="https://github.com/aw/picolisp-unit">get it on GitHub</a>.</p>
<p>You can <ahref="https://git.a1w.ca/aw/picolisp-unit">get it on my Git server</a>.</p>
<p>This library can be used for Unit Testing your <ahref="http://picolisp.com/">PicoLisp</a> code.</p>
@ -117,14 +117,14 @@
<h1id="explanation-unit-testing-framework-for-picolisp">Explanation: Unit Testing framework for PicoLisp</h1>
<p>This document provides a short walkthrough of the source code for the <ahref="https://github.com/aw/picolisp-unit">PicoLisp-Unit</a> testing framework.</p>
<p>This document provides a short walkthrough of the source code for the <ahref="https://git.a1w.ca/aw/picolisp-unit">PicoLisp-Unit</a> testing framework.</p>
<p>I won’t cover concepts which were discussed in previous source code explanations. You can read them here:</p>
<p>This document is split into a few sections:</p>
@ -309,7 +309,7 @@
<p>This one is quite simple, all it does is check if <codeclass="language-plaintext highlighter-rouge">Expected</code> is equal to <codeclass="language-plaintext highlighter-rouge">Result</code>.</p>
<p>The <ahref="https://github.com/aw/picolisp-unit/blob/master/README.md#assertions-table">other assertions</a> are quite similar and seem to cover most test cases. I’ve considered adding opposite tests such as <codeclass="language-plaintext highlighter-rouge">refute</code>, but I’ve rarely found a need for them as there are alternate approaches.</p>
<p>The <ahref="https://git.a1w.ca/aw/picolisp-unit/blob/master/README.md#assertions-table">other assertions</a> are quite similar and seem to cover most test cases. I’ve considered adding opposite tests such as <codeclass="language-plaintext highlighter-rouge">refute</code>, but I’ve rarely found a need for them as there are alternate approaches.</p>
<h1class="post-title">JSON Encoder/Decoder in pure PicoLisp</h1>
<spanclass="post-date">11 May 2018</span>
<p>You can <ahref="https://github.com/aw/picolisp-json">get it on GitHub</a>.</p>
<p>You can <ahref="https://git.a1w.ca/aw/picolisp-json">get it on my Git server</a>.</p>
<p>This library can be used to parse and serialize (encode/decode) JSON strings in <ahref="http://picolisp.com/">PicoLisp</a>.</p>
@ -117,9 +117,9 @@
<h1id="explanation-json-encoderdecoder-in-pure-picolisp">Explanation: JSON Encoder/Decoder in pure PicoLisp</h1>
<p>This document provides a short walkthrough of the source code for the <ahref="https://github.com/aw/picolisp-json.git">PicoLisp-JSON</a> encoder/decoder.</p>
<p>This document provides a short walkthrough of the source code for the <ahref="https://git.a1w.ca/aw/picolisp-json.git">PicoLisp-JSON</a> encoder/decoder.</p>
<p><strong>Note:</strong> This document covers <codeclass="language-plaintext highlighter-rouge">v3</code> of the JSON library. To view the older (C/ffi bindings) version <ahref="https://github.com/aw/picolisp-json/blob/v2.2.0/EXPLAIN.md">click here</a>.</p>
<p><strong>Note:</strong> This document covers <codeclass="language-plaintext highlighter-rouge">v3</code> of the JSON library. To view the older (C/ffi bindings) version <ahref="https://git.a1w.ca/aw/picolisp-json/blob/v2.2.0/EXPLAIN.md">click here</a>.</p>
<p>It’s split into a few sections for easier reading:</p>
@ -332,7 +332,7 @@ In other words, our tokenized <code class="language-plaintext highlighter-rouge"
<h2id="encoding-json">encoding JSON</h2>
<p>The code for encoding JSON strings hasn’t changed, so feel free to <ahref="https://github.com/aw/picolisp-json/blob/master/EXPLAIN.md#encoding-json">read about it here</a>.</p>
<p>The code for encoding JSON strings hasn’t changed, so feel free to <ahref="https://git.a1w.ca/aw/picolisp-json/blob/master/EXPLAIN.md#encoding-json">read about it here</a>.</p>
<h1class="post-title">PicoLisp AWS CLI tool using OpenSSL and Curl</h1>
<spanclass="post-date">15 Mar 2019</span>
<p>You can <ahref="https://github.com/aw/picolisp-awscurl">get it on GitHub</a>.</p>
<p>You can <ahref="https://git.a1w.ca/aw/picolisp-awscurl">get it on my Git server</a>.</p>
<p>This command line tool can be used to sign <ahref="https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html">AWS Signature Version 4</a> requests and make calls to various AWS APIs.</p>
<li><codeclass="language-plaintext highlighter-rouge">picolisp</code>: 32-bit or 64-bit <codeclass="language-plaintext highlighter-rouge">v3.1.11+</code>, tested up to PicoLisp <codeclass="language-plaintext highlighter-rouge">v20.6.29</code>, <ahref="https://github.com/aw/picolisp-awscurl/actions/">see test runs</a></li>
<li><codeclass="language-plaintext highlighter-rouge">picolisp</code>: 32-bit or 64-bit <codeclass="language-plaintext highlighter-rouge">v3.1.11+</code>, tested up to PicoLisp <codeclass="language-plaintext highlighter-rouge">v20.6.29</code>, <ahref="https://git.a1w.ca/aw/picolisp-awscurl/actions/">see test runs</a></li>
<li><codeclass="language-plaintext highlighter-rouge">libcrypto.so</code>: for using <codeclass="language-plaintext highlighter-rouge">--native</code> functions with PicoLisp <codeclass="language-plaintext highlighter-rouge">v17.12+</code></li>
<li><codeclass="language-plaintext highlighter-rouge">picolisp-unit</code>: <codeclass="language-plaintext highlighter-rouge">v3.0.0+</code> for testing the library</li>
<li><codeclass="language-plaintext highlighter-rouge">openssl</code>: <codeclass="language-plaintext highlighter-rouge">v1.0.0+</code> for signing and hashing strings</li>
@ -139,7 +139,7 @@
<h2id="warning">WARNING</h2>
<p>There is currently <strong>no validation</strong> on command line arguments. Be careful the input you provide. <ahref="https://github.com/aw/picolisp-awscurl/issues/1">See issue #1</a></p>
<p>There is currently <strong>no validation</strong> on command line arguments. Be careful the input you provide. <ahref="https://git.a1w.ca/aw/picolisp-awscurl/issues/1">See issue #1</a></p>
<h1class="post-title">GitHub Action to run 32-bit or 64-bit PicoLisp code</h1>
<spanclass="post-date">02 Jan 2020</span>
<p>You can <ahref="https://github.com/aw/picolisp-action">get it on GitHub</a> or the <ahref="https://github.com/marketplace/actions/picolisp-action">GitHub Marketplace</a>.</p>
<p>You can <ahref="https://git.a1w.ca/aw/picolisp-action">get it on my Git server</a> or the <ahref="https://github.com/marketplace/actions/picolisp-action">GitHub Marketplace</a>.</p>
<p>This action downloads, compiles, and globally installs PicoLisp.
It can be used to run PicoLisp code such as <ahref="https://github.com/aw/picolisp-unit">units tests</a>.</p>
It can be used to run PicoLisp code such as <ahref="https://git.a1w.ca/aw/picolisp-unit">units tests</a>.</p>
@ -139,7 +139,7 @@ It can be used to run PicoLisp code such as <a href="https://github.com/aw/picol
<h2id="example-workflow">Example workflow</h2>
<p>See the <ahref="https://github.com/aw/picolisp-json/blob/master/.github/workflows/main.yml">picolisp-json workflow</a> for a more detailed usage example.</p>
<p>See the <ahref="https://git.a1w.ca/aw/picolisp-json/blob/master/.github/workflows/main.yml">picolisp-json workflow</a> for a more detailed usage example.</p>
<h1class="post-title">Redis-inspired key/value store written in PicoLisp</h1>
<spanclass="post-date">16 Jun 2020</span>
<p>You can <ahref="https://github.com/aw/picolisp-kv">get it on GitHub</a>.</p>
<p>You can <ahref="https://git.a1w.ca/aw/picolisp-kv">get it on my Git server</a>.</p>
<p>This program mimics functionality of a <ahref="https://redis.io">Redis™</a> in-memory database, but is designed specifically for <ahref="https://picolisp.com">PicoLisp</a> applications with optional on-disk persistence and encryption.</p>
@ -189,7 +189,7 @@
-> "12345"
</code></pre></div></div>
<p>Feel free to observe the example code in <ahref="https://github.com/aw/picolisp-kv/blob/master/client.l">client.l</a>.</p>
<p>Feel free to observe the example code in <ahref="https://git.a1w.ca/aw/picolisp-kv/blob/master/client.l">client.l</a>.</p>
<blockquote>
<p><strong>Note</strong>: Using <codeclass="language-plaintext highlighter-rouge">(kv-send-data)</code> will send the data to the server and automatically block the client while waiting for a response.</p>
<h1class="post-title">POSIX Message Queues library for PicoLisp</h1>
<spanclass="post-date">16 Sep 2020</span>
<p>You can <ahref="https://github.com/aw/picolisp-posixmq">get it on GitHub</a>.</p>
<p>You can <ahref="https://git.a1w.ca/aw/picolisp-posixmq">get it on my Git server</a>.</p>
<p><em><ahref="https://man7.org/linux/man-pages/man7/mq_overview.7.html">POSIX Message Queues</a></em> provide a dependency-free mechanism for processes to exchange data in the form of messages.</p>
@ -135,7 +135,7 @@
<p>The first step is to run the unit tests: <codeclass="language-plaintext highlighter-rouge">make check</code></p>
<p>If those fail, jump to the <ahref="https://github.com/aw/picolisp-posixmq/blob/master/docs/TUTORIALS.md">TUTORIALS</a> section to perform the initial setup and and system check.</p>
<p>If those fail, jump to the <ahref="https://git.a1w.ca/aw/picolisp-posixmq/blob/master/docs/TUTORIALS.md">TUTORIALS</a> section to perform the initial setup and and system check.</p>
<p>If all works well, then your system is ready to use this library.</p>
@ -168,13 +168,13 @@
<h1id="documentation">Documentation</h1>
<p>Additional usage and reference documentation can be found in <ahref="https://github.com/aw/picolisp-posixmq/blob/master/docs/">docs/</a></p>
<p>Additional usage and reference documentation can be found in <ahref="https://git.a1w.ca/aw/picolisp-posixmq/blob/master/docs/">docs/</a></p>
<ul>
<li><ahref="https://github.com/aw/picolisp-posixmq/blob/master/docs/TUTORIALS.md">TUTORIALS</a>: some guides <strong>for beginners</strong> to get started using this library</li>
<li><ahref="https://github.com/aw/picolisp-posixmq/blob/master/docs/HOWTO.md">HOWTO</a>: a set of recipes for performing more advanced tasks with this library</li>
<li><ahref="https://github.com/aw/picolisp-posixmq/blob/master/docs/EXPLAIN.md">EXPLAIN</a>: an explanation of some key concepts, including how this library works</li>
<li><ahref="https://github.com/aw/picolisp-posixmq/blob/master/docs/REFERENCE.md">REFERENCE</a>: technical information on the internals of this library</li>
<li><ahref="https://git.a1w.ca/aw/picolisp-posixmq/blob/master/docs/TUTORIALS.md">TUTORIALS</a>: some guides <strong>for beginners</strong> to get started using this library</li>
<li><ahref="https://git.a1w.ca/aw/picolisp-posixmq/blob/master/docs/HOWTO.md">HOWTO</a>: a set of recipes for performing more advanced tasks with this library</li>
<li><ahref="https://git.a1w.ca/aw/picolisp-posixmq/blob/master/docs/EXPLAIN.md">EXPLAIN</a>: an explanation of some key concepts, including how this library works</li>
<li><ahref="https://git.a1w.ca/aw/picolisp-posixmq/blob/master/docs/REFERENCE.md">REFERENCE</a>: technical information on the internals of this library</li>
<p>You can <ahref="https://github.com/aw/picolisp-rust">get it on GitHub</a>.</p>
<p>You can <ahref="https://git.a1w.ca/aw/picolisp-rust">get it on my Git server</a>.</p>
<p>This repo provides a simple example of how to use <ahref="https://software-lab.de/down.html">PicoLisp</a> with <ahref="https://www.rust-lang.org/tools/install">Rust</a> using PicoLisp’s FFI <codeclass="language-plaintext highlighter-rouge">(native)</code> functionality.</p>
<contenttype="html"><p>You can <a href="https://github.com/aw/picolisp-rust">get it on GitHub</a>.</p>
<contenttype="html"><p>You can <a href="https://git.a1w.ca/aw/picolisp-rust">get it on my Git server</a>.</p>
<p>This repo provides a simple example of how to use <a href="https://software-lab.de/down.html">PicoLisp</a> with <a href="https://www.rust-lang.org/tools/install">Rust</a> using PicoLisp’s FFI <code class="language-plaintext highlighter-rouge">(native)</code> functionality.</p>
<contenttype="html"><p>You can <a href="https://github.com/aw/picolisp-posixmq">get it on GitHub</a>.</p>
<contenttype="html"><p>You can <a href="https://git.a1w.ca/aw/picolisp-posixmq">get it on my Git server</a>.</p>
<p><em><a href="https://man7.org/linux/man-pages/man7/mq_overview.7.html">POSIX Message Queues</a></em> provide a dependency-free mechanism for processes to exchange data in the form of messages.</p>
@ -161,7 +161,7 @@ Extracted struct:
<p>The first step is to run the unit tests: <code class="language-plaintext highlighter-rouge">make check</code></p>
<p>If those fail, jump to the <a href="https://github.com/aw/picolisp-posixmq/blob/master/docs/TUTORIALS.md">TUTORIALS</a> section to perform the initial setup and and system check.</p>
<p>If those fail, jump to the <a href="https://git.a1w.ca/aw/picolisp-posixmq/blob/master/docs/TUTORIALS.md">TUTORIALS</a> section to perform the initial setup and and system check.</p>
<p>If all works well, then your system is ready to use this library.</p>
<p>Additional usage and reference documentation can be found in <a href="https://github.com/aw/picolisp-posixmq/blob/master/docs/">docs/</a></p>
<p>Additional usage and reference documentation can be found in <a href="https://git.a1w.ca/aw/picolisp-posixmq/blob/master/docs/">docs/</a></p>
<ul>
<li><a href="https://github.com/aw/picolisp-posixmq/blob/master/docs/TUTORIALS.md">TUTORIALS</a>: some guides <strong>for beginners</strong> to get started using this library</li>
<li><a href="https://github.com/aw/picolisp-posixmq/blob/master/docs/HOWTO.md">HOWTO</a>: a set of recipes for performing more advanced tasks with this library</li>
<li><a href="https://github.com/aw/picolisp-posixmq/blob/master/docs/EXPLAIN.md">EXPLAIN</a>: an explanation of some key concepts, including how this library works</li>
<li><a href="https://github.com/aw/picolisp-posixmq/blob/master/docs/REFERENCE.md">REFERENCE</a>: technical information on the internals of this library</li>
<li><a href="https://git.a1w.ca/aw/picolisp-posixmq/blob/master/docs/TUTORIALS.md">TUTORIALS</a>: some guides <strong>for beginners</strong> to get started using this library</li>
<li><a href="https://git.a1w.ca/aw/picolisp-posixmq/blob/master/docs/HOWTO.md">HOWTO</a>: a set of recipes for performing more advanced tasks with this library</li>
<li><a href="https://git.a1w.ca/aw/picolisp-posixmq/blob/master/docs/EXPLAIN.md">EXPLAIN</a>: an explanation of some key concepts, including how this library works</li>
<li><a href="https://git.a1w.ca/aw/picolisp-posixmq/blob/master/docs/REFERENCE.md">REFERENCE</a>: technical information on the internals of this library</li>
<contenttype="html"><p>You can <a href="https://github.com/aw/picolisp-supervisor">get it on GitHub</a>.</p>
<contenttype="html"><p>You can <a href="https://git.a1w.ca/aw/picolisp-supervisor">get it on my Git server</a>.</p>
<p>This program mimics functionality of <a href="https://yhbt.net/unicorn/">Unicorn</a>, without being limited to HTTP applications.</p>
<contenttype="html"><p>You can <a href="https://github.com/aw/picolisp-kv">get it on GitHub</a>.</p>
<contenttype="html"><p>You can <a href="https://git.a1w.ca/aw/picolisp-kv">get it on my Git server</a>.</p>
<p>This program mimics functionality of a <a href="https://redis.io">Redis™</a> in-memory database, but is designed specifically for <a href="https://picolisp.com">PicoLisp</a> applications with optional on-disk persistence and encryption.</p>
@ -405,7 +405,7 @@ Options:
-&gt; "12345"
</code></pre></div></div>
<p>Feel free to observe the example code in <a href="https://github.com/aw/picolisp-kv/blob/master/client.l">client.l</a>.</p>
<p>Feel free to observe the example code in <a href="https://git.a1w.ca/aw/picolisp-kv/blob/master/client.l">client.l</a>.</p>
<blockquote>
<p><strong>Note</strong>: Using <code class="language-plaintext highlighter-rouge">(kv-send-data)</code> will send the data to the server and automatically block the client while waiting for a response.</p>
@ -666,10 +666,10 @@ COMMAND LIST Commands are case-insensitive and don't always require
<contenttype="html"><p>You can <a href="https://github.com/aw/picolisp-action">get it on GitHub</a> or the <a href="https://github.com/marketplace/actions/picolisp-action">GitHub Marketplace</a>.</p>
<contenttype="html"><p>You can <a href="https://git.a1w.ca/aw/picolisp-action">get it on my Git server</a> or the <a href="https://github.com/marketplace/actions/picolisp-action">GitHub Marketplace</a>.</p>
<p>This action downloads, compiles, and globally installs PicoLisp.
It can be used to run PicoLisp code such as <a href="https://github.com/aw/picolisp-unit">units tests</a>.</p>
It can be used to run PicoLisp code such as <a href="https://git.a1w.ca/aw/picolisp-unit">units tests</a>.</p>
<p>See the <a href="https://github.com/aw/picolisp-json/blob/master/.github/workflows/main.yml">picolisp-json workflow</a> for a more detailed usage example.</p>
<p>See the <a href="https://git.a1w.ca/aw/picolisp-json/blob/master/.github/workflows/main.yml">picolisp-json workflow</a> for a more detailed usage example.</p>
<h2 id="code">Code</h2>
@ -730,11 +730,11 @@ It can be used to run PicoLisp code such as <a href="https://github.com/
<contenttype="html"><p>You can <a href="https://github.com/aw/picolisp-awscurl">get it on GitHub</a>.</p>
<contenttype="html"><p>You can <a href="https://git.a1w.ca/aw/picolisp-awscurl">get it on my Git server</a>.</p>
<p>This command line tool can be used to sign <a href="https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html">AWS Signature Version 4</a> requests and make calls to various AWS APIs.</p>
<li><code class="language-plaintext highlighter-rouge">picolisp</code>: 32-bit or 64-bit <code class="language-plaintext highlighter-rouge">v3.1.11+</code>, tested up to PicoLisp <code class="language-plaintext highlighter-rouge">v20.6.29</code>, <a href="https://github.com/aw/picolisp-awscurl/actions/">see test runs</a></li>
<li><code class="language-plaintext highlighter-rouge">picolisp</code>: 32-bit or 64-bit <code class="language-plaintext highlighter-rouge">v3.1.11+</code>, tested up to PicoLisp <code class="language-plaintext highlighter-rouge">v20.6.29</code>, <a href="https://git.a1w.ca/aw/picolisp-awscurl/actions/">see test runs</a></li>
<li><code class="language-plaintext highlighter-rouge">libcrypto.so</code>: for using <code class="language-plaintext highlighter-rouge">--native</code> functions with PicoLisp <code class="language-plaintext highlighter-rouge">v17.12+</code></li>
<li><code class="language-plaintext highlighter-rouge">picolisp-unit</code>: <code class="language-plaintext highlighter-rouge">v3.0.0+</code> for testing the library</li>
<li><code class="language-plaintext highlighter-rouge">openssl</code>: <code class="language-plaintext highlighter-rouge">v1.0.0+</code> for signing and hashing strings</li>
@ -760,7 +760,7 @@ It can be used to run PicoLisp code such as <a href="https://github.com/
<p>There is currently <strong>no validation</strong> on command line arguments. Be careful the input you provide. <a href="https://github.com/aw/picolisp-awscurl/issues/1">See issue #1</a></p>
<p>There is currently <strong>no validation</strong> on command line arguments. Be careful the input you provide. <a href="https://git.a1w.ca/aw/picolisp-awscurl/issues/1">See issue #1</a></p>
<contenttype="html"><p>You can <a href="https://github.com/aw/picolisp-json">get it on GitHub</a>.</p>
<contenttype="html"><p>You can <a href="https://git.a1w.ca/aw/picolisp-json">get it on my Git server</a>.</p>
<p>This library can be used to parse and serialize (encode/decode) JSON strings in <a href="http://picolisp.com/">PicoLisp</a>.</p>
@ -839,9 +839,9 @@ Options:
<h1 id="explanation-json-encoderdecoder-in-pure-picolisp">Explanation: JSON Encoder/Decoder in pure PicoLisp</h1>
<p>This document provides a short walkthrough of the source code for the <a href="https://github.com/aw/picolisp-json.git">PicoLisp-JSON</a> encoder/decoder.</p>
<p>This document provides a short walkthrough of the source code for the <a href="https://git.a1w.ca/aw/picolisp-json.git">PicoLisp-JSON</a> encoder/decoder.</p>
<p><strong>Note:</strong> This document covers <code class="language-plaintext highlighter-rouge">v3</code> of the JSON library. To view the older (C/ffi bindings) version <a href="https://github.com/aw/picolisp-json/blob/v2.2.0/EXPLAIN.md">click here</a>.</p>
<p><strong>Note:</strong> This document covers <code class="language-plaintext highlighter-rouge">v3</code> of the JSON library. To view the older (C/ffi bindings) version <a href="https://git.a1w.ca/aw/picolisp-json/blob/v2.2.0/EXPLAIN.md">click here</a>.</p>
<p>It’s split into a few sections for easier reading:</p>
@ -1054,7 +1054,7 @@ In other words, our tokenized <code class="language-plaintext highlighte
<p>The code for encoding JSON strings hasn’t changed, so feel free to <a href="https://github.com/aw/picolisp-json/blob/master/EXPLAIN.md#encoding-json">read about it here</a>.</p>
<p>The code for encoding JSON strings hasn’t changed, so feel free to <a href="https://git.a1w.ca/aw/picolisp-json/blob/master/EXPLAIN.md#encoding-json">read about it here</a>.</p>
</content>
</entry>
@ -1063,7 +1063,7 @@ In other words, our tokenized <code class="language-plaintext highlighte
<contenttype="html"><p>You can <a href="https://github.com/aw/picolisp-semver">get it on GitHub</a>.</p>
<contenttype="html"><p>You can <a href="https://git.a1w.ca/aw/picolisp-semver">get it on my Git server</a>.</p>
<p>This library can validate and compare <strong>Major.Minor.Patch</strong> versions (ex: <code class="language-plaintext highlighter-rouge">"1.0.0"</code>).
It ignores pre-release, build, metadata, and special extensions (ex: <code class="language-plaintext highlighter-rouge">.alpha.1</code>).</p>
@ -1192,7 +1192,7 @@ if left &gt; right then return T # left is newer
<contenttype="html"><p>You can <a href="https://github.com/aw/picolisp-unit">get it on GitHub</a>.</p>
<contenttype="html"><p>You can <a href="https://git.a1w.ca/aw/picolisp-unit">get it on my Git server</a>.</p>
<p>This library can be used for Unit Testing your <a href="http://picolisp.com/">PicoLisp</a> code.</p>
@ -1200,14 +1200,14 @@ if left &gt; right then return T # left is newer
<h1 id="explanation-unit-testing-framework-for-picolisp">Explanation: Unit Testing framework for PicoLisp</h1>
<p>This document provides a short walkthrough of the source code for the <a href="https://github.com/aw/picolisp-unit">PicoLisp-Unit</a> testing framework.</p>
<p>This document provides a short walkthrough of the source code for the <a href="https://git.a1w.ca/aw/picolisp-unit">PicoLisp-Unit</a> testing framework.</p>
<p>I won’t cover concepts which were discussed in previous source code explanations. You can read them here:</p>
<p>This document is split into a few sections:</p>
@ -1392,7 +1392,7 @@ if left &gt; right then return T # left is newer
<p>This one is quite simple, all it does is check if <code class="language-plaintext highlighter-rouge">Expected</code> is equal to <code class="language-plaintext highlighter-rouge">Result</code>.</p>
<p>The <a href="https://github.com/aw/picolisp-unit/blob/master/README.md#assertions-table">other assertions</a> are quite similar and seem to cover most test cases. I’ve considered adding opposite tests such as <code class="language-plaintext highlighter-rouge">refute</code>, but I’ve rarely found a need for them as there are alternate approaches.</p>
<p>The <a href="https://git.a1w.ca/aw/picolisp-unit/blob/master/README.md#assertions-table">other assertions</a> are quite similar and seem to cover most test cases. I’ve considered adding opposite tests such as <code class="language-plaintext highlighter-rouge">refute</code>, but I’ve rarely found a need for them as there are alternate approaches.</p>
</content>
</entry>
@ -1401,7 +1401,7 @@ if left &gt; right then return T # left is newer
<contenttype="html"><p>You can <a href="https://github.com/aw/picolisp-bcrypt">get it on GitHub</a>.</p>
<contenttype="html"><p>You can <a href="https://git.a1w.ca/aw/picolisp-bcrypt">get it on my Git server</a>.</p>
<p>This library can be used to hash strings (ex: passwords) using bcrypt in <a href="http://picolisp.com/">PicoLisp</a>.</p>
@ -1515,7 +1515,7 @@ if left &gt; right then return T # left is newer
<contenttype="html"><p>You can <a href="https://github.com/aw/picolisp-https">get it on GitHub</a>.</p>
<contenttype="html"><p>You can <a href="https://git.a1w.ca/aw/picolisp-https">get it on my Git server</a>.</p>
<p>This library can be used to make HTTP and HTTPS requests in <a href="http://picolisp.com">PicoLisp</a>, with support for authentication.</p>
@ -1523,13 +1523,13 @@ if left &gt; right then return T # left is newer
<h1 id="explanation-https-client-for-picolisp">Explanation: HTTP(S) client for PicoLisp</h1>
<p>This document provides a short walkthrough of the source code for the <a href="https://github.com/aw/picolisp-https.git">PicoLisp-HTTPS</a> client.</p>
<p>This document provides a short walkthrough of the source code for the <a href="https://git.a1w.ca/aw/picolisp-https.git">PicoLisp-HTTPS</a> client.</p>
<p>I won’t cover concepts which were covered in previous source code explanations. You can read them here:</p>
<p>This document is split into a few sections:</p>
@ -1695,7 +1695,7 @@ if left &gt; right then return T # left is newer
<p>The <a href="http://software-lab.de/doc/refL.html#lisp">lisp</a> function is quite special. When using <code class="language-plaintext highlighter-rouge">(native)</code> for C calls, certain functions require a callback as an argument, or “function pointer” (Google it).</p>
<p>The <code class="language-plaintext highlighter-rouge">(ne-set-server-auth)</code> function requires a callback as its second argument, so we create one using <code class="language-plaintext highlighter-rouge">(lisp)</code>. If you’ve read the <a href="https://github.com/aw/picolisp-json/blob/master/EXPLAIN.md#make-array">JSON explanations</a>, you’ll quickly notice there’s an anonymous function in this <code class="language-plaintext highlighter-rouge">(lisp)</code> call. It essentially sends 5 arguments (which are numbers) to the <code class="language-plaintext highlighter-rouge">(do-auth)</code> function, under the name <code class="language-plaintext highlighter-rouge">ne_auth_creds</code>.</p>
<p>The <code class="language-plaintext highlighter-rouge">(ne-set-server-auth)</code> function requires a callback as its second argument, so we create one using <code class="language-plaintext highlighter-rouge">(lisp)</code>. If you’ve read the <a href="https://git.a1w.ca/aw/picolisp-json/blob/master/EXPLAIN.md#make-array">JSON explanations</a>, you’ll quickly notice there’s an anonymous function in this <code class="language-plaintext highlighter-rouge">(lisp)</code> call. It essentially sends 5 arguments (which are numbers) to the <code class="language-plaintext highlighter-rouge">(do-auth)</code> function, under the name <code class="language-plaintext highlighter-rouge">ne_auth_creds</code>.</p>
<p>Here’s the C code to give a better picture:</p>
<p>Whoa wait, what’s that <code class="language-plaintext highlighter-rouge">@</code> thing doing there? Remember we talked about the <a href="https://github.com/aw/picolisp-nanomsg/blob/master/EXPLAIN.md#nn_symbols">@ result</a>? Well, this is <strong>NOT</strong> that.</p>
<p>Whoa wait, what’s that <code class="language-plaintext highlighter-rouge">@</code> thing doing there? Remember we talked about the <a href="https://git.a1w.ca/aw/picolisp-nanomsg/blob/master/EXPLAIN.md#nn_symbols">@ result</a>? Well, this is <strong>NOT</strong> that.</p>
<p>This is actually a <a href="http://software-lab.de/doc/native.html#libs">transient symbol</a> which refers to the main program (PicoLisp).</p>
<contenttype="html"><p>You can <a href="https://github.com/aw/picolisp-json">get it on GitHub</a>.</p>
<contenttype="html"><p>You can <a href="https://git.a1w.ca/aw/picolisp-json">get it on my Git server</a>.</p>
<p>This library can be used to parse and serialize (encode/decode) JSON strings in <a href="http://picolisp.com/">PicoLisp</a>.</p>
<h1 id="explanation-json-encoderdecoder-for-picolisp">Explanation: JSON Encoder/Decoder for PicoLisp</h1>
<p>This document provides a short walkthrough of the source code for the <a href="https://github.com/aw/picolisp-json.git">PicoLisp-JSON</a> encoder/decoder.</p>
<p>This document provides a short walkthrough of the source code for the <a href="https://git.a1w.ca/aw/picolisp-json.git">PicoLisp-JSON</a> encoder/decoder.</p>
<p>It’s split into a few sections for easier reading:</p>
<p>Make sure you read the <a href="README.md">README</a> to get an idea of what this library does.</p>
<p>Also, I recommend you read my <a href="https://github.com/aw/picolisp-nanomsg/blob/master/EXPLAIN.md">Nanomsg Explanation</a> for additional PicoLisp tips and ideas.</p>
<p>Also, I recommend you read my <a href="https://git.a1w.ca/aw/picolisp-nanomsg/blob/master/EXPLAIN.md">Nanomsg Explanation</a> for additional PicoLisp tips and ideas.</p>
<p>You can <ahref="https://github.com/aw/picolisp-rust">get it on GitHub</a>.</p>
<p>You can <ahref="https://git.a1w.ca/aw/picolisp-rust">get it on my Git server</a>.</p>
<p>This repo provides a simple example of how to use <ahref="https://software-lab.de/down.html">PicoLisp</a> with <ahref="https://www.rust-lang.org/tools/install">Rust</a> using PicoLisp’s FFI <codeclass="language-plaintext highlighter-rouge">(native)</code> functionality.</p>
<p>You can <ahref="https://github.com/aw/picolisp-https">get it on GitHub</a>.</p>
<p>You can <ahref="https://git.a1w.ca/aw/picolisp-https">get it on my Git server</a>.</p>
<p>This library can be used to make HTTP and HTTPS requests in <ahref="http://picolisp.com">PicoLisp</a>, with support for authentication.</p>
@ -125,13 +125,13 @@
<h1id="explanation-https-client-for-picolisp">Explanation: HTTP(S) client for PicoLisp</h1>
<p>This document provides a short walkthrough of the source code for the <ahref="https://github.com/aw/picolisp-https.git">PicoLisp-HTTPS</a> client.</p>
<p>This document provides a short walkthrough of the source code for the <ahref="https://git.a1w.ca/aw/picolisp-https.git">PicoLisp-HTTPS</a> client.</p>
<p>I won’t cover concepts which were covered in previous source code explanations. You can read them here:</p>
<p>This document is split into a few sections:</p>
@ -297,7 +297,7 @@
<p>The <ahref="http://software-lab.de/doc/refL.html#lisp">lisp</a> function is quite special. When using <codeclass="language-plaintext highlighter-rouge">(native)</code> for C calls, certain functions require a callback as an argument, or “function pointer” (Google it).</p>
<p>The <codeclass="language-plaintext highlighter-rouge">(ne-set-server-auth)</code> function requires a callback as its second argument, so we create one using <codeclass="language-plaintext highlighter-rouge">(lisp)</code>. If you’ve read the <ahref="https://github.com/aw/picolisp-json/blob/master/EXPLAIN.md#make-array">JSON explanations</a>, you’ll quickly notice there’s an anonymous function in this <codeclass="language-plaintext highlighter-rouge">(lisp)</code> call. It essentially sends 5 arguments (which are numbers) to the <codeclass="language-plaintext highlighter-rouge">(do-auth)</code> function, under the name <codeclass="language-plaintext highlighter-rouge">ne_auth_creds</code>.</p>
<p>The <codeclass="language-plaintext highlighter-rouge">(ne-set-server-auth)</code> function requires a callback as its second argument, so we create one using <codeclass="language-plaintext highlighter-rouge">(lisp)</code>. If you’ve read the <ahref="https://git.a1w.ca/aw/picolisp-json/blob/master/EXPLAIN.md#make-array">JSON explanations</a>, you’ll quickly notice there’s an anonymous function in this <codeclass="language-plaintext highlighter-rouge">(lisp)</code> call. It essentially sends 5 arguments (which are numbers) to the <codeclass="language-plaintext highlighter-rouge">(do-auth)</code> function, under the name <codeclass="language-plaintext highlighter-rouge">ne_auth_creds</code>.</p>
<p>Here’s the C code to give a better picture:</p>
<p>Whoa wait, what’s that <codeclass="language-plaintext highlighter-rouge">@</code> thing doing there? Remember we talked about the <ahref="https://github.com/aw/picolisp-nanomsg/blob/master/EXPLAIN.md#nn_symbols">@ result</a>? Well, this is <strong>NOT</strong> that.</p>
<p>Whoa wait, what’s that <codeclass="language-plaintext highlighter-rouge">@</code> thing doing there? Remember we talked about the <ahref="https://git.a1w.ca/aw/picolisp-nanomsg/blob/master/EXPLAIN.md#nn_symbols">@ result</a>? Well, this is <strong>NOT</strong> that.</p>
<p>This is actually a <ahref="http://software-lab.de/doc/native.html#libs">transient symbol</a> which refers to the main program (PicoLisp).</p>
<p>You can <ahref="https://github.com/aw/picolisp-json">get it on GitHub</a>.</p>
<p>You can <ahref="https://git.a1w.ca/aw/picolisp-json">get it on my Git server</a>.</p>
<p>This library can be used to parse and serialize (encode/decode) JSON strings in <ahref="http://picolisp.com/">PicoLisp</a>.</p>
@ -125,7 +125,7 @@
<h1id="explanation-json-encoderdecoder-for-picolisp">Explanation: JSON Encoder/Decoder for PicoLisp</h1>
<p>This document provides a short walkthrough of the source code for the <ahref="https://github.com/aw/picolisp-json.git">PicoLisp-JSON</a> encoder/decoder.</p>
<p>This document provides a short walkthrough of the source code for the <ahref="https://git.a1w.ca/aw/picolisp-json.git">PicoLisp-JSON</a> encoder/decoder.</p>
<p>It’s split into a few sections for easier reading:</p>
@ -142,7 +142,7 @@
<p>Make sure you read the <ahref="README.md">README</a> to get an idea of what this library does.</p>
<p>Also, I recommend you read my <ahref="https://github.com/aw/picolisp-nanomsg/blob/master/EXPLAIN.md">Nanomsg Explanation</a> for additional PicoLisp tips and ideas.</p>
<p>Also, I recommend you read my <ahref="https://git.a1w.ca/aw/picolisp-nanomsg/blob/master/EXPLAIN.md">Nanomsg Explanation</a> for additional PicoLisp tips and ideas.</p>
<p>You can <ahref="https://github.com/aw/picolisp-posixmq">get it on GitHub</a>.</p>
<p>You can <ahref="https://git.a1w.ca/aw/picolisp-posixmq">get it on my Git server</a>.</p>
<p><em><ahref="https://man7.org/linux/man-pages/man7/mq_overview.7.html">POSIX Message Queues</a></em> provide a dependency-free mechanism for processes to exchange data in the form of messages.</p>
@ -143,7 +143,7 @@
<p>The first step is to run the unit tests: <codeclass="language-plaintext highlighter-rouge">make check</code></p>
<p>If those fail, jump to the <ahref="https://github.com/aw/picolisp-posixmq/blob/master/docs/TUTORIALS.md">TUTORIALS</a> section to perform the initial setup and and system check.</p>
<p>If those fail, jump to the <ahref="https://git.a1w.ca/aw/picolisp-posixmq/blob/master/docs/TUTORIALS.md">TUTORIALS</a> section to perform the initial setup and and system check.</p>
<p>If all works well, then your system is ready to use this library.</p>
@ -176,13 +176,13 @@
<h1id="documentation">Documentation</h1>
<p>Additional usage and reference documentation can be found in <ahref="https://github.com/aw/picolisp-posixmq/blob/master/docs/">docs/</a></p>
<p>Additional usage and reference documentation can be found in <ahref="https://git.a1w.ca/aw/picolisp-posixmq/blob/master/docs/">docs/</a></p>
<ul>
<li><ahref="https://github.com/aw/picolisp-posixmq/blob/master/docs/TUTORIALS.md">TUTORIALS</a>: some guides <strong>for beginners</strong> to get started using this library</li>
<li><ahref="https://github.com/aw/picolisp-posixmq/blob/master/docs/HOWTO.md">HOWTO</a>: a set of recipes for performing more advanced tasks with this library</li>
<li><ahref="https://github.com/aw/picolisp-posixmq/blob/master/docs/EXPLAIN.md">EXPLAIN</a>: an explanation of some key concepts, including how this library works</li>
<li><ahref="https://github.com/aw/picolisp-posixmq/blob/master/docs/REFERENCE.md">REFERENCE</a>: technical information on the internals of this library</li>
<li><ahref="https://git.a1w.ca/aw/picolisp-posixmq/blob/master/docs/TUTORIALS.md">TUTORIALS</a>: some guides <strong>for beginners</strong> to get started using this library</li>
<li><ahref="https://git.a1w.ca/aw/picolisp-posixmq/blob/master/docs/HOWTO.md">HOWTO</a>: a set of recipes for performing more advanced tasks with this library</li>
<li><ahref="https://git.a1w.ca/aw/picolisp-posixmq/blob/master/docs/EXPLAIN.md">EXPLAIN</a>: an explanation of some key concepts, including how this library works</li>
<li><ahref="https://git.a1w.ca/aw/picolisp-posixmq/blob/master/docs/REFERENCE.md">REFERENCE</a>: technical information on the internals of this library</li>
<p>You can <ahref="https://github.com/aw/picolisp-kv">get it on GitHub</a>.</p>
<p>You can <ahref="https://git.a1w.ca/aw/picolisp-kv">get it on my Git server</a>.</p>
<p>This program mimics functionality of a <ahref="https://redis.io">Redis™</a> in-memory database, but is designed specifically for <ahref="https://picolisp.com">PicoLisp</a> applications with optional on-disk persistence and encryption.</p>
@ -197,7 +197,7 @@
-> "12345"
</code></pre></div></div>
<p>Feel free to observe the example code in <ahref="https://github.com/aw/picolisp-kv/blob/master/client.l">client.l</a>.</p>
<p>Feel free to observe the example code in <ahref="https://git.a1w.ca/aw/picolisp-kv/blob/master/client.l">client.l</a>.</p>
<blockquote>
<p><strong>Note</strong>: Using <codeclass="language-plaintext highlighter-rouge">(kv-send-data)</code> will send the data to the server and automatically block the client while waiting for a response.</p>
<p>You can <ahref="https://github.com/aw/picolisp-action">get it on GitHub</a> or the <ahref="https://github.com/marketplace/actions/picolisp-action">GitHub Marketplace</a>.</p>
<p>You can <ahref="https://git.a1w.ca/aw/picolisp-action">get it on my Git server</a> or the <ahref="https://github.com/marketplace/actions/picolisp-action">GitHub Marketplace</a>.</p>
<p>This action downloads, compiles, and globally installs PicoLisp.
It can be used to run PicoLisp code such as <ahref="https://github.com/aw/picolisp-unit">units tests</a>.</p>
It can be used to run PicoLisp code such as <ahref="https://git.a1w.ca/aw/picolisp-unit">units tests</a>.</p>
@ -147,7 +147,7 @@ It can be used to run PicoLisp code such as <a href="https://github.com/aw/picol
<h2id="example-workflow">Example workflow</h2>
<p>See the <ahref="https://github.com/aw/picolisp-json/blob/master/.github/workflows/main.yml">picolisp-json workflow</a> for a more detailed usage example.</p>
<p>See the <ahref="https://git.a1w.ca/aw/picolisp-json/blob/master/.github/workflows/main.yml">picolisp-json workflow</a> for a more detailed usage example.</p>
<p>You can <ahref="https://github.com/aw/picolisp-awscurl">get it on GitHub</a>.</p>
<p>You can <ahref="https://git.a1w.ca/aw/picolisp-awscurl">get it on my Git server</a>.</p>
<p>This command line tool can be used to sign <ahref="https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html">AWS Signature Version 4</a> requests and make calls to various AWS APIs.</p>
