IPUZ

From Just Solve the File Format Problem
Revision as of 02:10, 22 March 2014 by Dan Tobias (Talk | contribs)

Jump to: navigation, search
File Format
Name IPUZ
Ontology
Extension(s) .ipuz

IPUZ is intended as an openly-documented format for data files of puzzle games such as crosswords and sudoku. In contrast to "proprietary" formats such as PUZ, there is an official spec available freely and released under a Creative Commons license (BY-ND 3.0), instead of the format having to be discovered by reverse engineering subject to possible hassles by intellectual-property owners.

Contents

Format

IPUZ data is expressed in JSON form, preferably in the JSONP variant in which the JSON data is surrounded by code to make it valid JavaScript, in this case an ipuz() function call.

Identification

IPUZ version 1 files contain the text line "version": "http://ipuz.org/v1", (perhaps with whitespace padding).

Puzzle types

Although IPUZ is not an XML-based format, its creators borrowed the "namespaces designated by URIs" concept for identifying subtypes of the format for different sorts of puzzles. Several puzzle types, with associated URIs in ipuz.org, are defined in the spec, and others may define puzzle types of their own and assign them identifying URIs within their own websites. The spec requires that anybody defining a puzzle type and assigning it a URL actually own the site within which that URL resides, but doesn't mandate that it actually resolve to anything useful; however, it is suggested that it lead to a description of the puzzle format in question. The URIs referenced in the original spec all seem to redirect to the spec document itself, rather than any more specific part of it related to a particular puzzle type.

The types defined in the spec are:

Official spec

Sample data

Software

Other links

Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox