diff --git a/contrib/json/json.facts b/contrib/json/json.facts new file mode 100644 index 0000000000..2214df4645 --- /dev/null +++ b/contrib/json/json.facts @@ -0,0 +1,39 @@ +! Copyright (C) 2006 Chris Double. +! +! Redistribution and use in source and binary forms, with or without +! modification, are permitted provided that the following conditions are met: +! +! 1. Redistributions of source code must retain the above copyright notice, +! this list of conditions and the following disclaimer. +! +! 2. Redistributions in binary form must reproduce the above copyright notice, +! this list of conditions and the following disclaimer in the documentation +! and/or other materials provided with the distribution. +! +! THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, +! INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND +! FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE +! DEVELOPERS AND CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +! SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, +! PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; +! OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, +! WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR +! OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF +! ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +! +USING: help json ; + +HELP: >json "( obj -- string )" +{ $values { "obj" "an object" } { "string" "the object converted to JSON format" } } +{ $description "Serializes the object into a JSON formatted string." } +{ $see-also json-print json> } ; + +HELP: json-print "( obj -- )" +{ $values { "obj" "an object" } } +{ $description "Serializes the object into a JSON formatted string and outputs it to the standard output stream." } +{ $see-also >json json> } ; + +HELP: json> "( string -- object )" +{ $values { "string" "a string in JSON format" } { "object" "yhe object deserialized from the JSON string" } } +{ $description "Deserializes the JSON formatted string into a Factor object. JSON objects are converted to Factor hashtables. All other JSON objects convert to their obvious Factor equivalents." } +{ $see-also json-print >json } ; diff --git a/contrib/json/load.factor b/contrib/json/load.factor index 9eeaf405ae..cff1fe48a9 100644 --- a/contrib/json/load.factor +++ b/contrib/json/load.factor @@ -25,5 +25,6 @@ REQUIRES: parser-combinators ; PROVIDE: json { "json-reader.factor" "json-writer.factor" + "json.facts" } { } ; \ No newline at end of file