Upgrade to ipfs.scm 0.0.17
Upgrade to ipfs.scm 0.0.15
Upgrade to ipfs.scm 0.0.14
Lua library for the Kubo RPC API, the reference IPFS node implementation.
Endpoint definitions (ipfs-enpoints.lua
) are generated with
export-to-lua.scm
from ipfs.scm
.
Most of the requirements for ipfs.scm
also apply here. You must be familiar
with the IPFS HTTP API if you want to use this library. It tries to catch some
bad usage but it's not very strict.
Each exported procedure represents one endpoint -- see the note on ipfs.scm
about missing endpoints. In general, /api/v0/some/endpoint
will be used as
ipfs:some_endpoint
-- more specifically, [-/]
are replaced with _
to make
the endpoint name a valid Lua identifier. For example, id
is called id
,
bootstrap/list
is called bootstrap_list
, and diag/cmds/set-time
is called
diag_cmds_set_time
.
The reader
, writer
, and timeout
may all be overwritten on a per-call
basis.
-- There are some "module parameters":
local IPFS = require('ipfs')({
-- Both readers are optional. If not given, none will be used and you must
-- manually "read" the HTTP stream.
reader_json=...,
reader_plain=...,
})
-- And "instance parameters":
local ipfs = IPFS({
-- The connection details and their defaults:
scheme='http',
host="localhost",
port=5001,
-- Optionally (see the http rock):
timeout=...,
})
-- OR:
--[[
local ipfs = require('ipfs')({
reader_json=...,
reader_plain=...,
})({
scheme='http',
host="localhost",
port=5001,
timeout=...,
})
--]]
-- No arguments, parameters, nor options given. Calls the `/api/v0/id`
-- endpoint with the default reader, writer, and timeout.
ipfs:id()
-- The recognized options are `reader`, `writer`, and `timeout`.
ipfs:id(nil, {}, {reader=..., writer=..., timeout=...})
-- The reader may be skipped on a per-call basis if given and truthy but not a
-- procedure.
ipfs:id({}, nil, {reader=true})
-- Unexpected arguments/parameters, i.e., arguments/parameters that are no
-- specified in the endpoint's definition, are ignored.
ipfs:id({1, 2, 3}, {another="thing"})
Also check out example.lua
.