guile-sjson's first public release (v0.2)!

guile-sjson's first public release (v0.2)!

[Christopher Allan Webber]

[-- Attachment #1: Type: text/plain, Size: 1970 bytes --]

Hello all!  I'm happy to announce the first public release of
guile-sjson!

What's guile-sjson?  Well, it's basically the previous work David
Thompson did on (ice-9 json), but since that seemed to sit without being
merged for a while and I needed it for several projects, I went ahead
and turned it into a module, with Dave's blessing.

Here's the repo:

  https://gitlab.com/dustyweb/guile-sjson

And as for the release:

  https://dustycloud.org/misc/sjson-0.2.tar.gz
  https://dustycloud.org/misc/sjson-0.2.tar.gz.asc

You can see some more about it on its README:

  https://gitlab.com/dustyweb/guile-sjson/blob/master/README.org

In sum though, it has a nice s-expression based syntax:

  scheme@(guile-user)> (define a-horse
                        '(@ ("name" "buttercup")
                            ("age" 6)
                            ("animal" "horse")
                            ("noise" "neigh!")
                            ("food" ("carrot" "oats"))))
                            scheme@(guile-user)> (json-pprint a-horse)
  {
    "name": "buttercup",
    "age": 6,
    "animal": "horse",
    "noise": "neigh!",
    "food": [
      "carrot",
      "oats"
    ]
  }

However, since I'm using this for some fancy linked data stuff using
json-ld, linear access on the hashmaps wasn't great.  No problem!  I
bundled Andy Wingo's fash.scm in the package:

  scheme@(guile-user)> (read-json-from-string "{\"some-key\": \"some-value\"}"
                                              #:use-fash #t)
  $2 = #<fash ((some-key . some-value))>

This also means that since there isn't any other package of fash.scm
right now that I know of, guile-sjson is also a reasonable if roundabout
way to get fashes :)

Anyway, there are also some useful utilities for slicing and dicing
json objects in (sjson utils), so check those out also!

And right after this email, I'm going to submit this to Guix, so
hopefully it'll be in Guix soon as well!

Happy hacking!
 - Chris

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 832 bytes --]

Re: guile-sjson's first public release (v0.2)!

[Marko Rauhamaa]

Christopher Allan Webber <cwebber@dustycloud.org>:

> In sum though, it has a nice s-expression based syntax:
>
>   scheme@(guile-user)> (define a-horse
>                         '(@ ("name" "buttercup")
>                             ("age" 6)
>                             ("animal" "horse")
>                             ("noise" "neigh!")
>                             ("food" ("carrot" "oats"))))

Hm, how about:

   (define a-horse
           '((name . "buttercup")
             (age . 6)
             (animal . "horse")
             (noise . "neigh!")
             (food . #("carrot" "oats"))))


Marko

Re: guile-sjson's first public release (v0.2)!

[Christopher Allan Webber]

Marko Rauhamaa writes:

> Christopher Allan Webber <cwebber@dustycloud.org>:
>
>> In sum though, it has a nice s-expression based syntax:
>>
>>   scheme@(guile-user)> (define a-horse
>>                         '(@ ("name" "buttercup")
>>                             ("age" 6)
>>                             ("animal" "horse")
>>                             ("noise" "neigh!")
>>                             ("food" ("carrot" "oats"))))
>
> Hm, how about:
>
>    (define a-horse
>            '((name . "buttercup")
>              (age . 6)
>              (animal . "horse")
>              (noise . "neigh!")
>              (food . #("carrot" "oats"))))
>
>
> Marko

Hm... that's not bad, using vectors for arrays.  It also fixes the
reason I switched it away from simple cons cell style alists...
I was finding pretty-print of such things unreadable:

  scheme@(guile-user)> ,pretty-print '(@ (name . "buttercup")
                                         (age . 6)
                                         (animal . "horse")
                                         (food . ("carrot" "oats"))
                                         (mood-noises . (@ ("frustrated" . "haurrrfff")
                                                           ("happy" . "neiiiigh")
                                                           ("angry" . "*SNORT*"))))
  $7 = 
  (@ (name . "buttercup")
     (age . 6)
     (animal . "horse")
     (food "carrot" "oats")
     (mood-noises
       @
       ("frustrated" . "haurrrfff")
       ("happy" . "neiiiigh")
       ("angry" . "*SNORT*")))

However doing this with vectors as the arrays solves it:

  scheme@(guile-user)> ,pretty-print '((name . "buttercup")
                                       (age . 6)
                                       (animal . "horse")
                                       (food . #("carrot" "oats"))
                                       (mood-noises . (("frustrated" . "haurrrfff")
                                                       ("happy" . "neiiiigh")
                                                       ("angry" . "*SNORT*"))))
  $5 = 
  ((name . "buttercup")
   (age . 6)
   (animal . "horse")
   (food . #("carrot" "oats"))
   (mood-noises
     ("frustrated" . "haurrrfff")
     ("happy" . "neiiiigh")
     ("angry" . "*SNORT*")))

I'd be open to the change... if we're going to do the change, we should
do it now, when I'm pretty much the only user.  I wonder what David
Thompson thinks?

Re: guile-sjson's first public release (v0.2)!

[Marko Rauhamaa]

Christopher Allan Webber <cwebber@dustycloud.org>:
>   ((name . "buttercup")
>    (age . 6)
>    (animal . "horse")
>    (food . #("carrot" "oats"))
>    (mood-noises
>      ("frustrated" . "haurrrfff")
>      ("happy" . "neiiiigh")
>      ("angry" . "*SNORT*")))
>
> I'd be open to the change... if we're going to do the change, we
> should do it now, when I'm pretty much the only user. I wonder what
> David Thompson thinks?

Another thing: guile-sjson boldly uses Guile's

   null -> #nil

It is of course handy for the purpose but highly Guile-specific. I
wonder if

   null -> #:null

might create less grief down the road.


Marko

Re: guile-sjson's first public release (v0.2)!

[Christopher Allan Webber]

Marko Rauhamaa writes:

> Christopher Allan Webber <cwebber@dustycloud.org>:
>>   ((name . "buttercup")
>>    (age . 6)
>>    (animal . "horse")
>>    (food . #("carrot" "oats"))
>>    (mood-noises
>>      ("frustrated" . "haurrrfff")
>>      ("happy" . "neiiiigh")
>>      ("angry" . "*SNORT*")))
>>
>> I'd be open to the change... if we're going to do the change, we
>> should do it now, when I'm pretty much the only user. I wonder what
>> David Thompson thinks?
>
> Another thing: guile-sjson boldly uses Guile's
>
>    null -> #nil
>
> It is of course handy for the purpose but highly Guile-specific. I
> wonder if
>
>    null -> #:null
>
> might create less grief down the road.
>
>
> Marko

That may be a good idea worth adding.

I filed a bug:
  https://gitlab.com/dustyweb/guile-sjson/issues/3

Re: guile-sjson's first public release (v0.2)!

[Thompson, David]

On Wed, Apr 26, 2017 at 12:03 AM, Christopher Allan Webber
<cwebber@dustycloud.org> wrote:

> I'd be open to the change... if we're going to do the change, we should
> do it now, when I'm pretty much the only user.  I wonder what David
> Thompson thinks?

FWIW this is what Racket does, so there is precedent there, but Mark
Weaver and I explicitly avoided doing this with (ice-9 json) because
vectors are 1) imperative and 2) less convenient to process and
generate.  For example, you can no longer use unquote-splicing, which
is unfortunate.  Furthermore, if you have a list of objects that you
want to serialize, you now need to do the extra step of calling
list->vector.  Lists are the more natural data structure in Scheme for
sequences, so Mark and I thought it was best to stick with them rather
than use vectors even though vectors are more array-like.

Hope this helps,

- Dave

Re: guile-sjson's first public release (v0.2)!

[Christopher Allan Webber]

Thompson, David writes:

> On Wed, Apr 26, 2017 at 12:03 AM, Christopher Allan Webber
> <cwebber@dustycloud.org> wrote:
>
>> I'd be open to the change... if we're going to do the change, we should
>> do it now, when I'm pretty much the only user.  I wonder what David
>> Thompson thinks?
>
> FWIW this is what Racket does, so there is precedent there, but Mark
> Weaver and I explicitly avoided doing this with (ice-9 json) because
> vectors are 1) imperative and 2) less convenient to process and
> generate.  For example, you can no longer use unquote-splicing, which
> is unfortunate.  Furthermore, if you have a list of objects that you
> want to serialize, you now need to do the extra step of calling
> list->vector.  Lists are the more natural data structure in Scheme for
> sequences, so Mark and I thought it was best to stick with them rather
> than use vectors even though vectors are more array-like.
>
> Hope this helps,
>
> - Dave

I think that's the right call.  It also means having to not rewrite a
lot of my code. ;)

So things will stay as they are there!

Re: guile-sjson's first public release (v0.2)!

[Mark Oteiza]

Christopher Allan Webber <cwebber@dustycloud.org> writes:

> Hello all!  I'm happy to announce the first public release of
> guile-sjson!

Congratulations!

> What's guile-sjson?  Well, it's basically the previous work David
> Thompson did on (ice-9 json), but since that seemed to sit without being
> merged for a while and I needed it for several projects, I went ahead
> and turned it into a module, with Dave's blessing.

Sorry if I missed discussion on this, but is there intention to
address the issues that kept (ice-9 json) from being merged?

https://lists.gnu.org/archive/html/guile-devel/2015-09/msg00035.html

Re: guile-sjson's first public release (v0.2)!

[Christopher Allan Webber]

Mark Oteiza writes:

> Christopher Allan Webber <cwebber@dustycloud.org> writes:
>
>> Hello all!  I'm happy to announce the first public release of
>> guile-sjson!
>
> Congratulations!
>
>> What's guile-sjson?  Well, it's basically the previous work David
>> Thompson did on (ice-9 json), but since that seemed to sit without being
>> merged for a while and I needed it for several projects, I went ahead
>> and turned it into a module, with Dave's blessing.
>
> Sorry if I missed discussion on this, but is there intention to
> address the issues that kept (ice-9 json) from being merged?
>
> https://lists.gnu.org/archive/html/guile-devel/2015-09/msg00035.html

I did add tests, though not a standard test suite.

I didn't update the exception handling to be any better, I guess I
should do that. :)  I feel like I'm somewhat inadequate when it comes to
doing exceptions nicely in Guile...