PuREST JSON is a library for connecting Puredata (Pd) to HTTP services and encoding and decoding JSON data.
 
 
 
 
 
Go to file
Thomas Mayer b964c59f93 Change links from github to codeberg. 2023-11-20 18:11:39 +01:00
.circleci Changes to CI pipeline: 2022-11-18 17:52:50 +01:00
circleci-scripts Add timing to build script. 2022-11-19 00:38:48 +01:00
dependencies Changes to CI pipeline: 2022-11-18 17:52:50 +01:00
examples Update example "the-sound-of-money". 2022-11-20 01:01:40 +01:00
manual Update example "the-sound-of-money". 2022-11-20 01:01:40 +01:00
pd-lib-builder@29349950a1 Update pd-lib-builder for Mac OS ARM. 2022-11-07 15:31:25 +01:00
src Strings are real strings. 2022-11-19 15:29:45 +01:00
unittests curl multi handle is removed on pthread cleanup. 2022-11-09 18:32:11 +01:00
.gitattributes Compile M1 and Intel 64bit for OS X. 2022-06-09 19:16:35 +02:00
.gitignore Copy only stated examples. 2016-01-10 02:54:03 +01:00
.gitmodules Added pd-lib-builder as submodule and build on Linux. 2015-12-01 01:30:58 +01:00
Changelog.txt Bugfix for including libcurl in Mac OS X packages. 2022-11-29 23:24:38 +01:00
LICENSE.txt Update copyright to latest versions. 2022-05-06 02:24:12 +02:00
Makefile Bugfix for including libcurl in Mac OS X packages. 2022-11-29 23:24:38 +01:00
README.md Change links from github to codeberg. 2023-11-20 18:11:39 +01:00
coverity Fixed possible "free after use" bug. 2022-11-19 00:28:32 +01:00
create-manual.py Rendering of manual: Replace subprocess with imported method. 2022-11-07 23:14:01 +01:00
json-help.pd Update to help files: 2022-11-21 00:54:00 +01:00
old-json-c-version.patch Patch for old json-c version reflects current version. 2015-03-25 02:25:15 +01:00
purest_json-meta.pd Bugfix for including libcurl in Mac OS X packages. 2022-11-29 23:24:38 +01:00
rest-help.pd Update to help files: 2022-11-21 00:54:00 +01:00
test.json Loading JSON data from file (issue #12); 2013-01-16 00:39:55 +01:00
urlparams-help.pd Cleaning up help patches. 2022-11-18 18:00:10 +01:00

README.md

  _____        _____  ______  _____ _______        _  _____  ____  _   _
 |  __ \      |  __ \|  ____|/ ____|__   __|      | |/ ____|/ __ \| \ | |
 | |__) |_   _| |__) | |__  | (___    | |         | | (___ | |  | |  \| |
 |  ___/| | | |  _  /|  __|  \___ \   | |     _   | |\___ \| |  | | . ` |
 | |    | |_| | | \ \| |____ ____) |  | |    | |__| |____) | |__| | |\  |
 |_|     \__,_|_|  \_\______|_____/   |_|     \____/|_____/ \____/|_| \_|

PuREST JSON is a library for connecting Puredata (Pd) to HTTP services and encoding and decoding JSON data.

The library can issue GET, POST, PUT and DELETE statements, so consumation of RESTful services is possible, e.g. CouchDB.

About Puredata (From the official website)

Pd (aka Pure Data) is a real-time graphical programming environment for audio, video, and graphical processing. It is the third major branch of the family of patcher programming languages known as Max (Max/FTS, ISPW Max, Max/MSP, jMax, etc.) originally developed by Miller Puckette and company at IRCAM. The core of Pd is written and maintained by Miller Puckette and includes the work of many developers, making the whole package very much a community effort.

Externals in the library

[rest]

Object for issuing HTTP request.

[oauth]

Object for issuing HTTP requests with OAUTH.

[json-encode]

Object for encoding data to JSON.

[json-decode]

Object for decoding JSON data.

[urlparams]

Object for url encoding and concatenating url parameters.

For the usage of the externals see the help patches for the objects.

Installation from package repositories

Downloads are available via deken which is included in Pd since version 0.47. Packages for Debian and Ubuntu are available as pd-purest-json.

Downloads of development versions

For each commit, a build in Circle CI is triggered. These builds generate deken-like packages, that are available from https://cloud.residuum.org/index.php/s/380C60JAabnO7jk

The format for the files is <Circle-CI-job-number>_<Date-in-YYYY-MM-DD>_<dekenfilename>.

Those downloads may not work, but represent the current state of development.

How to build PuREST JSON

The library uses the template for Pd-extended. Drop the library in a new folder purest_json in the "external" path of the Pd-extended source code and run make in the folder. libcurl and json-c is needed.

Details can be found at https://codeberg.org/Residuum/PuRestJson/wiki/Compilation

If you encouter bugs or feel like a feature is missing, have a look the bug tracker at https://codeberg.org/Residuum/PuRestJson/issues