RetroArch/libretro-db
Rob Loach 11f8938f7e Update RDB building to ignore missing keys
This change makes it so that when building the RDB files, the entries that are missing `serial` keys will simply be ignored and the RDB file will still build. When it's missing the key, it also logs which line it's processing so that we can easily fix the broken entry in libretro-database.
2017-06-07 10:43:56 -04:00
..
lua Try to avoid directly calling strcmp 2017-04-21 13:56:15 +02:00
bintree.c Header update #1 2017-01-22 13:40:32 +01:00
bintree.h Header update #1 2017-01-22 13:40:32 +01:00
c_converter_test.sh (libretro-db) c_converter: implement a binary search tree, improves 2016-01-24 03:16:25 +01:00
c_converter.c Update RDB building to ignore missing keys 2017-06-07 10:43:56 -04:00
dat_converter Change this back 2016-01-26 08:41:07 +01:00
libretrodb_tool.c Rewrite more string_is_equal call invocations as memcmp 2017-04-22 08:51:16 +02:00
libretrodb.c Start using string_is_equal_fast/string_is_not_equal_fast macros 2017-05-16 03:20:59 +02:00
libretrodb.h Header update #1 2017-01-22 13:40:32 +01:00
Makefile Fix libretro-db Makefile 2016-09-17 01:42:52 +02:00
query.c Silence more warnings on iOS 2017-02-26 21:46:19 +01:00
query.h Header update #1 2017-01-22 13:40:32 +01:00
README.md Add documentation for libretro-db compilation 2016-04-14 03:56:58 -04:00
rmsgpack_dom.c Try to prevent truckload of warnings on iOS 2017-02-26 10:33:03 +01:00
rmsgpack_dom.h Header update #1 2017-01-22 13:40:32 +01:00
rmsgpack_test.c Header update #1 2017-01-22 13:40:32 +01:00
rmsgpack.c Header update #1 2017-01-22 13:40:32 +01:00
rmsgpack.h Header update #1 2017-01-22 13:40:32 +01:00

libretrodb

A small read only database Mainly to be used by retroarch

Usage

Files specified later in the chain will override earlier ones if the same key exists multiple times.

To list out the content of a db libretrodb_tool <db file> list To create an index libretrodb_tool <db file> create-index <index name> <field name> To find an entry with an index libretrodb_tool <db file> find <index name> <value>

lua converters

In order to write you own converter you must have a lua file that implements the following functions:

-- this function gets called before the db is created and should validate the
-- arguments and set up the ground for db insertion
function init(...)
	local args = {...}
	local script_name = args[1]
end

-- this is in iterator function. It is called before each insert.
-- the function should return a table for insertion or nil when there are no
-- more records to insert.
function get_value()
	return {
		key = "value", -- will be saved as string
		num = 3, -- will be saved as int
		bin = binary("some string"), -- will be saved as binary
		unum = uint(3), -- will be saved as uint
		some_bool = true, -- will be saved as bool
	}
end

dat file converter

To convert a dat file use:

dat_converter <db file> <dat file>

If you want to merge multiple dat files you need to run:

dat_converter <db file> <match key> <dat file> ...

for example:

dat_converter snes.rdb rom.crc snes1.dat snes2.dat

Query examples

Some examples of queries you can use with libretrodbtool:

  1. Glob pattern matching Usecase : Search for all games starting with 'Street Fighter' in the 'name' field (glob pattern matching)

libretrodb_tool <db file> find "{'name':glob('Street Fighter*')}"

  1. Combined number matching query Usecase: Search for all games released on October 1995.

libretrodb_tool <db file> find "{'releasemonth':10,'releaseyear':1995}"

Compiling the Database

Use libretro-super to compile the entire database:

git clone git@github.com:libretro/libretro-super.git
cd libretro-super
./libretro-fetch.sh retroarch
./libretro-build-database.sh