{"size": 1317, "ext": "scrbl", "max_stars_repo_path": "scribblings/misc.scrbl", "max_stars_repo_name": "jessealama/riposte", "max_stars_repo_stars_event_min_datetime": "2018-11-08T19:12:04.000Z", "max_stars_repo_stars_event_max_datetime": "2021-06-11T16:09:15.000Z", "max_issues_repo_path": "scribblings/misc.scrbl", "max_issues_repo_name": "jessealama/riposte", "max_issues_repo_issues_event_min_datetime": "2018-10-25T08:57:28.000Z", "max_issues_repo_issues_event_max_datetime": "2021-10-12T12:38:06.000Z", "max_forks_repo_path": "scribblings/misc.scrbl", "max_forks_repo_name": "jessealama/riposte", "max_forks_repo_forks_event_min_datetime": "2018-11-15T08:33:59.000Z", "max_forks_repo_forks_event_max_datetime": "2021-02-05T21:07:15.000Z"}
{"max_stars_count": 37, "max_issues_count": 12, "max_forks_count": 5, "avg_line_length": 54.875, "max_line_length": 255, "alphanum_fraction": 0.7722095672}
#lang scribble/manual

@title{Miscellanea}

Here's where you can find some information for which I couldn't find a better place.

@section{File extension}

I suggest using @tt{.rip} for your Riposte scripts. But, in truth, it doesn't matter. Riposte scripts are supposed to be plain text, and there's no check that a script has any particular file extension.

@section{JSON-only}

Riposte works with JSON values and assumes that the responses it receives (more precisely, the response bodies) are JSON.

There's one exception to this. Some HTTP responses (again, their bodies) are empty. There's even an HTTP response code for this case (@tt{204}). Riposte can handle such responses, even though the empty string is not valid JSON.

If, however, a non-empty response is returned, Riposte attempts to parse the body as JSON. If if can't, Riposte will die.

This means that Riposte, currently, can't work with HTML, arbitrary plain text, images, and so on. If you request a URI and get a response that contains, say, HTML, Riposte will bail out (unless, by chance, the response turns out to be well-formed JSON!).

@section{Draft 07 Schema only}

Currently, schema validation with Riposte is done according to JSON Schema draft 07. There is, at the moment, no support for any other draft version of JSON Schema. Sorry.
