C implementation of the Smile binary format (wiki.fasterxml.com/SmileFormatSpec).
The library ships with a command line tool (unsmile) to decode binary files on the command line, as well as extensions for scripting languages.
libsmile is under heavy development and is still considered experimental.
What is working:
-
Single block decoding smile -> json (up to 64k by default, size can be increased)
-
Shared String references (see below for caveat)
-
Basic PHP, Ruby and Python support
What is missing:
-
The following decoding use cases are not yet supported due to lack of test data (feel free to contribute json/smile samples, see data/ directory): long String, long Shared String reference for Keys decoding, BigInteger, long Unicode String, long Shared String reference, Binary, Raw Binary for Values decoding
-
Streaming support: API has been designed to do chunk decoding, but is not yet functional (only single chunk for now between reset)
-
Encoding support json -> smile
To build libsmile.la:
make
To run tests:
make check
To build extensions:
make <ext>
To run tests:
make check-<ext>
where ext is php, ruby or py.
libsmile $ ./unsmile usage: unsmile <file>
For example:
libsmile $ ./unsmile data/smile/test1.smile
{"test key":true,"nullField":null,"foo":1,"foo2":{"a":3},"aãb":-323,"2":[1,2,3],"\"foo\"":"foo\nbar"}
The API can be found under include/smile.h. A good starting point is tools/unsmile.c for a working example.
Copyright 2011 Pierre-Alexandre Meyer
Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.