{"header":{"message":"Add some support for the Lua API (#319)","description":"* Add some support for the Lua API\n\n* Add example\n\n* Update README\n\n* Update authors\n\n* Minor bump `playdate` crate\n\n* CI: add package test for example of `playdate-lua` crate\n\n---------\n\nCo-authored-by: Alexander Koz ","timestamp":"2024-05-07T03:10:00Z","authors":[{"email":"84700+paulyoung@users.noreply.github.com","name":"Paul Young"}]},"hash":"7SNEOSPKPHRCONHQ63K7D5OIG63KLIGHYRIH6TUBCYQAZ3VZ4IJAC","authors":[],"deps":{"hashes":[["7SNEOSPKPHRCONHQ63K7D5OIG63KLIGHYRIH6TUBCYQAZ3VZ4IJAC","Add some support for the Lua API (#319)"],["AA",null],["N37SUM4JCJBPJ47YSITTXZNT3HDOA4I7J23UNY57LHJPPVEZSBZQC","Initial import (history reset)"],["33G5WXD5ZDZBJ7XING26E2ZHRTG5VH6UPCE7MPGFTWT4IPWECL4QC","fix include miss-use in cargo manifests"],["ICZTDXWGYZ4FHFBTKAWPEZ56RPXOQWWFME6MOAEUGEJFFPCJUFXAC","Add main api crate (#96)"],["4FJROIHD3ZPNVJZ4JRRPZ2RWL7QM6TGSAQV3FBHDVU3LH4OF2NQAC","Add cached api end points (part 1) (#130)"],["3A6UFSQZP3J3Z3UFIXOR6LJ7XBLDW6H32WFI4Y6OGS4AUN2EBALQC","core: add sound end-point for easy-access from event-handler, improve video example"],["SDWZKQ7AU2CRPWATMQDADMSW4ZCYZOTV5YILO5T4YSQCZQ7KQVUAC","Api features refactoring to prevent lang-items duplication (#139)"],["QUGRW4H7QRZK3WBWSC4R6LMGODSMRT2VP3JVEPVFM5BVNLVXRKTAC","Improve examples (#143)"],["5ZASFUXBKDGBXR5MUZXM5GJT74YFZFKNPSI4K24RDIE37VUDOSSQC","add scoreboards api (closes #45)"],["45YBW6XDFKMCFS2UQLA7E6IL4EFVUYEVTXQD4POCNJ52S4LQYS7QC","improve docs"],["DONQSGG2ZTSF7MA37DLINX3WK4J3DLYXROPWEV72ZN7JTRTXPZ4QC","update all api crates"],["MNEEWMTZPSVZ367P5EGK7G7EAF2S4XPBVGMSM2PMKGVAXGINLWYQC","bump"],["QOAS6S47TDIQSZYDF3PUVQCKWKXTTSS3HMRPRE6YFMOWOMGFP4TQC","remove `sdk_2_1` feature"],["SFNCB6M4GGCTCYYDKSHPH23ZEPQ3OXI3B3TACFNDRZ2334SCNS4QC","Add cached api end points (part 2) (#131)"],["YHABB5J2ZD2PRI7AFPXCDPSSK5X3ULEHQOR5BF6YAT3E52GJWREAC","improve ctrls api,"],["2QO6FO3GNFDZ3YFQOMEBUL6DYTGDQWYAAMECVY2RFBFSBT7E7GZAC","bump pd version"],["LHCPV4HO6F4RCPNVPKWRTYMKVLO5J3OSJZ62FPIQQTNNT3MGXBQAC","better ctrl-flow, fix examples and templates"],["UZGMQBLF2TPEWJSSL75FUEQ473DMRXKH737OVGAZR2P5EG4W7FEQC","various api improvements:"],["IRPWJFHL6T2Z5AK2RW5EFRJPFKMCCHXV74HKGPZHPFC3QIYI23BAC","Api handlers, entry-point and various improvements (#118)"],["2SVXBYKBWMR2WGULGT2JX36BGZYVAD7P4ODBYEXQZ754D5QFGBHAC","add SDK v2.1 compatibility"],["S5OBUYOJBNY3XKSQIFAVL664TZDTC7II7NISQ2N4A6V7GDUSPGIQC","minor bump pd crate"],["3QY74JF5IQEM5N53R6TGO2L7O4RVCWJ7T6WYP7KJO6RRKOD74R3AC","Update deps, fix breaking changes of deps, bump versions, fix rust toolchain channel."],["UEVSH77MUES342YHST7RXMAGSXHZS2QMAZURGLGRCV6HK5V73CTQC","Improve sprite examples, fix metadata for docs.rs"]],"deps":["N37SUM4JCJBPJ47YSITTXZNT3HDOA4I7J23UNY57LHJPPVEZSBZQC","33G5WXD5ZDZBJ7XING26E2ZHRTG5VH6UPCE7MPGFTWT4IPWECL4QC","ICZTDXWGYZ4FHFBTKAWPEZ56RPXOQWWFME6MOAEUGEJFFPCJUFXAC","4FJROIHD3ZPNVJZ4JRRPZ2RWL7QM6TGSAQV3FBHDVU3LH4OF2NQAC","3A6UFSQZP3J3Z3UFIXOR6LJ7XBLDW6H32WFI4Y6OGS4AUN2EBALQC","SDWZKQ7AU2CRPWATMQDADMSW4ZCYZOTV5YILO5T4YSQCZQ7KQVUAC","QUGRW4H7QRZK3WBWSC4R6LMGODSMRT2VP3JVEPVFM5BVNLVXRKTAC","5ZASFUXBKDGBXR5MUZXM5GJT74YFZFKNPSI4K24RDIE37VUDOSSQC","45YBW6XDFKMCFS2UQLA7E6IL4EFVUYEVTXQD4POCNJ52S4LQYS7QC","DONQSGG2ZTSF7MA37DLINX3WK4J3DLYXROPWEV72ZN7JTRTXPZ4QC"],"known":["IRPWJFHL6T2Z5AK2RW5EFRJPFKMCCHXV74HKGPZHPFC3QIYI23BAC","SFNCB6M4GGCTCYYDKSHPH23ZEPQ3OXI3B3TACFNDRZ2334SCNS4QC","2QO6FO3GNFDZ3YFQOMEBUL6DYTGDQWYAAMECVY2RFBFSBT7E7GZAC","LHCPV4HO6F4RCPNVPKWRTYMKVLO5J3OSJZ62FPIQQTNNT3MGXBQAC","S5OBUYOJBNY3XKSQIFAVL664TZDTC7II7NISQ2N4A6V7GDUSPGIQC","2SVXBYKBWMR2WGULGT2JX36BGZYVAD7P4ODBYEXQZ754D5QFGBHAC","UEVSH77MUES342YHST7RXMAGSXHZS2QMAZURGLGRCV6HK5V73CTQC","YHABB5J2ZD2PRI7AFPXCDPSSK5X3ULEHQOR5BF6YAT3E52GJWREAC","UZGMQBLF2TPEWJSSL75FUEQ473DMRXKH737OVGAZR2P5EG4W7FEQC","3QY74JF5IQEM5N53R6TGO2L7O4RVCWJ7T6WYP7KJO6RRKOD74R3AC","QOAS6S47TDIQSZYDF3PUVQCKWKXTTSS3HMRPRE6YFMOWOMGFP4TQC","MNEEWMTZPSVZ367P5EGK7G7EAF2S4XPBVGMSM2PMKGVAXGINLWYQC"]},"hunks":[{"Edit":{"inode":{"change":4,"pos":5265},"path":"api/playdate/src/lib.rs","line":35,"atom":{"NewVertex":{"up_context":[{"change":4,"pos":5701}],"down_context":[{"change":5,"pos":6591}],"flag":"BLOCK","start":342,"end":376,"inode":{"change":4,"pos":5265}}},"contents":[{"Add":"}"},{"Add":""},{"Add":"pub mod lua {"},{"Add":"\tpub use lua::*;"}]}},{"Replacement":{"inode":{"change":4,"pos":5265},"path":"api/playdate/src/lib.rs","line":68,"ins":{"up_context":[{"change":6,"pos":346}],"down_context":[{"change":5,"pos":7101}],"flag":"BLOCK","start":377,"end":448,"inode":{"change":4,"pos":5265}},"del":{"edges":[{"previous":"","flag":"DELETED","from":{"change":6,"pos":346},"to":{"change":5,"start":7074,"end":7101},"introduced_by":6},{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":5,"pos":7074},"to":{"change":5,"start":7074,"end":7101},"introduced_by":5}],"inode":{"change":4,"pos":5265}},"ins_contents":[{"Add":"\t\t/// Playdate Lua API."},{"Add":"\t\tfn lua(&self) -> lua::Lua;"},{"Add":""}],"del_contents":[{"Del":"\t\t// fn lua() -> lua::Lua;\n"}]}},{"Edit":{"inode":{"change":4,"pos":5265},"path":"api/playdate/src/lib.rs","line":105,"atom":{"NewVertex":{"up_context":[{"change":9,"pos":23383}],"down_context":[{"change":5,"pos":7717}],"flag":"BLOCK","start":449,"end":576,"inode":{"change":4,"pos":5265}}},"contents":[{"Add":"\t\t}"},{"Add":""},{"Add":"\t\tfn lua(&self) -> lua::Lua {"},{"Add":"\t\t\tlua::Lua::new_with(lua::api::Cache::from(unsafe { self.as_ref() }.lua))"}]}},{"Edit":{"inode":{"change":4,"pos":5265},"path":"api/playdate/src/lib.rs","line":141,"atom":{"NewVertex":{"up_context":[{"change":9,"pos":23607}],"down_context":[{"change":5,"pos":8295}],"flag":"BLOCK","start":577,"end":718,"inode":{"change":4,"pos":5265}}},"contents":[{"Add":"\t\t}"},{"Add":""},{"Add":"\t\tfn lua(&self) -> lua::Lua {"},{"Add":"\t\t\tlua::Lua::new_with(lua::api::Cache::from(unsafe { self.as_ref() }.expect(\"api\").lua))"}]}},{"Edit":{"inode":{"change":4,"pos":5736},"path":"api/playdate/README.md","line":19,"atom":{"NewVertex":{"up_context":[{"change":4,"pos":6349}],"down_context":[{"change":10,"pos":865}],"flag":"BLOCK","start":725,"end":772,"inode":{"change":4,"pos":5736}}},"contents":[{"Add":"- [lua](https://crates.io/crates/playdate-lua)"}]}},{"Edit":{"inode":{"change":4,"pos":5736},"path":"api/playdate/README.md","line":32,"atom":{"EdgeMap":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":6742},"to":{"change":4,"start":6742,"end":6748},"introduced_by":4}],"inode":{"change":4,"pos":5736}}},"contents":[{"Del":"- lua\n"}]}},{"Replacement":{"inode":{"change":4,"pos":9200},"path":"api/playdate/Cargo.toml","line":3,"ins":{"up_context":[{"change":4,"pos":9229}],"down_context":[{"change":4,"pos":9247}],"flag":"BLOCK","start":774,"end":792,"inode":{"change":4,"pos":9200}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":9229},"to":{"change":11,"start":415,"end":434},"introduced_by":11}],"inode":{"change":4,"pos":9200}},"ins_contents":[{"Add":"version = \"0.2.0\""}],"del_contents":[{"Del":"version = \"0.1.17\"\n"}]}},{"Edit":{"inode":{"change":4,"pos":9200},"path":"api/playdate/Cargo.toml","line":20,"atom":{"NewVertex":{"up_context":[{"change":4,"pos":9779}],"down_context":[{"change":4,"pos":9779}],"flag":"BLOCK","start":793,"end":846,"inode":{"change":4,"pos":9200}}},"contents":[{"Add":"lua = { workspace = true, default-features = false }"}]}},{"FileAdd":{"meta":{"basename":"lua","metadata":576},"context":[{"change":2,"pos":447668}],"contents":[]}},{"FileAdd":{"meta":{"basename":"src","metadata":576},"context":[{"change":0,"pos":857}],"contents":[]}},{"FileAdd":{"meta":{"basename":"lib.rs","metadata":0},"context":[{"change":0,"pos":874}],"contents":[{"Add":"#![cfg_attr(not(test), no_std)]"},{"Add":"#![feature(error_in_core)]"},{"Add":""},{"Add":"// #[macro_use]"},{"Add":"extern crate sys;"},{"Add":"extern crate alloc;"},{"Add":""},{"Add":"use core::ffi::c_char;"},{"Add":"use alloc::borrow::ToOwned;"},{"Add":""},{"Add":"use sys::ffi::CStr;"},{"Add":"use sys::ffi::CString;"},{"Add":"use sys::ffi::lua_CFunction;"},{"Add":""},{"Add":""},{"Add":"pub mod error;"},{"Add":""},{"Add":"use error::*;"},{"Add":""},{"Add":"#[derive(Debug, Clone, Copy)]"},{"Add":"pub struct Lua(Api);"},{"Add":""},{"Add":"impl Lua {"},{"Add":"\t/// Creates default [`Lua`] without type parameter requirement."},{"Add":"\t///"},{"Add":"\t/// Uses ZST [`api::Default`]."},{"Add":"\t#[allow(non_snake_case)]"},{"Add":"\tpub fn Default() -> Self { Self(Default::default()) }"},{"Add":"}"},{"Add":""},{"Add":"impl Lua {"},{"Add":"\t/// Creates [`Lua`] without type parameter requirement."},{"Add":"\t///"},{"Add":"\t/// Uses [`api::Cache`]."},{"Add":"\t#[allow(non_snake_case)]"},{"Add":"\tpub fn Cached() -> Self { Self(Default::default()) }"},{"Add":"}"},{"Add":""},{"Add":"impl Default for Lua {"},{"Add":"\tfn default() -> Self { Self(Default::default()) }"},{"Add":"}"},{"Add":""},{"Add":"impl Lua {"},{"Add":"\tpub fn new() -> Self { Self(Default::default()) }"},{"Add":"}"},{"Add":""},{"Add":"impl Lua {"},{"Add":"\tpub fn new_with(api: Api) -> Self { Self(api) }"},{"Add":"}"},{"Add":""},{"Add":""},{"Add":"impl Lua {}"},{"Add":""},{"Add":""},{"Add":"impl Lua {"},{"Add":"\t/// Adds the Lua function *f* to the Lua runtime, with name *name*. (*name*"},{"Add":"\t/// can be a table path using dots, e.g. if name = “mycode.myDrawingFunction”"},{"Add":"\t/// adds the function “myDrawingFunction” to the global table “myCode”.)"},{"Add":"\t///"},{"Add":"\t/// Equivalent to [`sys::ffi::playdate_lua::addFunction`]"},{"Add":"\t#[doc(alias = \"sys::ffi::playdate_lua::addFunction\")]"},{"Add":"\tpub fn add_function>(&self, f: lua_CFunction, name: S) -> Result<(), ApiError> {"},{"Add":"\t\tlet name = CString::new(name.as_ref())?;"},{"Add":"\t\tlet mut out_err: *const c_char = core::ptr::null_mut();"},{"Add":""},{"Add":"\t\tlet func = self.0.add_function();"},{"Add":""},{"Add":"\t\t// Returns 1 on success or 0 with an error message in *outErr*."},{"Add":"\t\tlet result = unsafe { func(f, name.as_ptr(), &mut out_err) };"},{"Add":""},{"Add":"\t\tif result == 0 {"},{"Add":"\t\t\tlet err_msg = unsafe { CStr::from_ptr(out_err) };"},{"Add":"\t\t\tErr(Error::AddFunction(err_msg.to_owned()).into())"},{"Add":"\t\t} else {"},{"Add":"\t\t\tOk(())"},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":"\t/// Returns the argument at position *pos* as a string."},{"Add":"\t///"},{"Add":"\t/// Equivalent to [`sys::ffi::playdate_lua::getArgString`]"},{"Add":"\t#[doc(alias = \"sys::ffi::playdate_lua::getArgString\")]"},{"Add":"\tpub fn get_arg_string(&self, pos: i32) -> Option {"},{"Add":"\t\tlet f = self.0.get_arg_string();"},{"Add":"\t\tunsafe {"},{"Add":"\t\t\tlet ptr = f(pos);"},{"Add":"\t\t\tif ptr.is_null() {"},{"Add":"\t\t\t\tNone"},{"Add":"\t\t\t} else {"},{"Add":"\t\t\t\tSome(CStr::from_ptr(ptr).to_owned())"},{"Add":"\t\t\t}"},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":"}"},{"Add":""},{"Add":"pub mod api {"},{"Add":"\tuse core::ffi::c_char;"},{"Add":"\tuse core::ffi::c_int;"},{"Add":"\tuse core::ptr::NonNull;"},{"Add":"\tuse sys::ffi::lua_CFunction;"},{"Add":"\tuse sys::ffi::playdate_lua;"},{"Add":""},{"Add":""},{"Add":"\t/// Default lua api end-point, ZST."},{"Add":"\t///"},{"Add":"\t/// All calls approximately costs ~3 derefs."},{"Add":"\t#[derive(Debug, Clone, Copy, core::default::Default)]"},{"Add":"\tpub struct Default;"},{"Add":"\timpl Api for Default {}"},{"Add":""},{"Add":""},{"Add":"\t/// Cached lua api end-point."},{"Add":"\t///"},{"Add":"\t/// Stores one reference, so size on stack is eq `usize`."},{"Add":"\t///"},{"Add":"\t/// All calls approximately costs ~1 deref."},{"Add":"\t#[derive(Clone, Copy)]"},{"Add":"\t#[cfg_attr(feature = \"bindings-derive-debug\", derive(Debug))]"},{"Add":"\tpub struct Cache(&'static playdate_lua);"},{"Add":""},{"Add":"\timpl core::default::Default for Cache {"},{"Add":"\t\tfn default() -> Self { Self(sys::api!(lua)) }"},{"Add":"\t}"},{"Add":""},{"Add":"\timpl From<*const playdate_lua> for Cache {"},{"Add":"\t\t#[inline(always)]"},{"Add":"\t\tfn from(ptr: *const playdate_lua) -> Self { Self(unsafe { ptr.as_ref() }.expect(\"lua\")) }"},{"Add":"\t}"},{"Add":""},{"Add":"\timpl From<&'static playdate_lua> for Cache {"},{"Add":"\t\t#[inline(always)]"},{"Add":"\t\tfn from(r: &'static playdate_lua) -> Self { Self(r) }"},{"Add":"\t}"},{"Add":""},{"Add":"\timpl From> for Cache {"},{"Add":"\t\t#[inline(always)]"},{"Add":"\t\tfn from(ptr: NonNull) -> Self { Self(unsafe { ptr.as_ref() }) }"},{"Add":"\t}"},{"Add":""},{"Add":"\timpl From<&'_ NonNull> for Cache {"},{"Add":"\t\t#[inline(always)]"},{"Add":"\t\tfn from(ptr: &NonNull) -> Self { Self(unsafe { ptr.as_ref() }) }"},{"Add":"\t}"},{"Add":""},{"Add":""},{"Add":"\timpl Api for Cache {"},{"Add":"\t\t#[inline(always)]"},{"Add":"\t\tfn add_function("},{"Add":"\t\t\t&self)"},{"Add":"\t\t\t-> unsafe extern \"C\" fn(f: lua_CFunction, name: *const c_char, outErr: *mut *const c_char) -> c_int {"},{"Add":"\t\t\tself.0.addFunction.expect(\"addFunction\")"},{"Add":"\t\t}"},{"Add":""},{"Add":"\t\t#[inline(always)]"},{"Add":"\t\tfn get_arg_string(&self) -> unsafe extern \"C\" fn(pos: c_int) -> *const c_char {"},{"Add":"\t\t\tself.0.getArgString.expect(\"getArgString\")"},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":""},{"Add":""},{"Add":"\tpub trait Api {"},{"Add":"\t\t/// Returns [`sys::ffi::playdate_lua::addFunction`]"},{"Add":"\t\t#[doc(alias = \"sys::ffi::playdate_lua::addFunction\")]"},{"Add":"\t\tfn add_function("},{"Add":"\t\t\t&self)"},{"Add":"\t\t\t-> unsafe extern \"C\" fn(f: lua_CFunction, name: *const c_char, outErr: *mut *const c_char) -> c_int {"},{"Add":"\t\t\t*sys::api!(lua.addFunction)"},{"Add":"\t\t}"},{"Add":"\t\t/// Returns [`sys::ffi::playdate_lua::getArgString`]"},{"Add":"\t\t#[doc(alias = \"sys::ffi::playdate_lua::getArgString\")]"},{"Add":"\t\tfn get_arg_string(&self) -> unsafe extern \"C\" fn(pos: c_int) -> *const c_char {"},{"Add":"\t\t\t*sys::api!(lua.getArgString)"},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":"}"}]}},{"FileAdd":{"meta":{"basename":"error.rs","metadata":0},"context":[{"change":0,"pos":874}],"contents":[{"Add":"use alloc::borrow::ToOwned;"},{"Add":"use core::fmt;"},{"Add":"use sys::ffi::CStr;"},{"Add":"use sys::ffi::CString;"},{"Add":""},{"Add":""},{"Add":"pub type ApiError = sys::error::Error;"},{"Add":""},{"Add":""},{"Add":"#[derive(Debug)]"},{"Add":"pub enum Error {"},{"Add":"\tAddFunction(CString),"},{"Add":"}"},{"Add":""},{"Add":"impl fmt::Display for Error {"},{"Add":"\tfn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {"},{"Add":"\t\tmatch &self {"},{"Add":"\t\t\tError::AddFunction(cs) => {"},{"Add":"\t\t\t\tmatch cs.to_str() {"},{"Add":"\t\t\t\t\tOk(err) => err.fmt(f),"},{"Add":"\t\t\t\t\tErr(_) => f.write_fmt(format_args!(\"Add function error: {cs:?}\")),"},{"Add":"\t\t\t\t}"},{"Add":"\t\t\t},"},{"Add":"\t\t}"},{"Add":"\t}"},{"Add":"}"},{"Add":""},{"Add":""},{"Add":"impl From for ApiError {"},{"Add":"\tfn from(err: Error) -> Self { ApiError::Api(err) }"},{"Add":"}"},{"Add":""},{"Add":"impl From<&'_ CStr> for Error {"},{"Add":"\tfn from(cs: &CStr) -> Self { Self::AddFunction(cs.to_owned()) }"},{"Add":"}"},{"Add":""},{"Add":""},{"Add":"impl core::error::Error for Error {}"}]}},{"FileAdd":{"meta":{"basename":"examples","metadata":576},"context":[{"change":0,"pos":857}],"contents":[]}},{"FileAdd":{"meta":{"basename":"sources","metadata":576},"context":[{"change":0,"pos":6264}],"contents":[]}},{"FileAdd":{"meta":{"basename":"main.lua","metadata":0},"context":[{"change":0,"pos":6286}],"contents":[{"Add":"example.logToConsole(\"hello from main.lua\");"}]}},{"FileAdd":{"meta":{"basename":"add-function-get-arg-string.rs","metadata":0},"context":[{"change":0,"pos":6264}],"contents":[{"Add":"#![no_std]"},{"Add":"extern crate alloc;"},{"Add":""},{"Add":"#[macro_use]"},{"Add":"extern crate sys;"},{"Add":"extern crate playdate_lua as lua;"},{"Add":""},{"Add":"use core::ffi::c_int;"},{"Add":"use core::ptr::NonNull;"},{"Add":""},{"Add":"use lua::Lua;"},{"Add":"use sys::EventLoopCtrl;"},{"Add":"use sys::ffi::*;"},{"Add":"use system::System;"},{"Add":"use system::event::SystemEventExt as _;"},{"Add":"use system::update::UpdateCtrl;"},{"Add":""},{"Add":""},{"Add":"/// Entry point, event handler"},{"Add":"#[no_mangle]"},{"Add":"fn event_handler(_api: NonNull, event: PDSystemEvent, _: u32) -> EventLoopCtrl {"},{"Add":"\t// We need to set our update callback in the InitLua handler instead of Init."},{"Add":"\t// https://devforum.play.date/t/lua-c-minimal-example/4354/5"},{"Add":"\t//"},{"Add":"\t// Just for this example, ignore all other events."},{"Add":"\tif event != PDSystemEvent::InitLua {"},{"Add":"\t\treturn EventLoopCtrl::Continue;"},{"Add":"\t}"},{"Add":""},{"Add":"\t// Set update callback"},{"Add":"\tSystem::Default().set_update_callback_static(Some(on_update), ());"},{"Add":""},{"Add":"\t// Add a function that we depend on and call in main.lua"},{"Add":"\tLua::Default().add_function(Some(log_to_console_from_main_dot_lua), \"example.logToConsole\")"},{"Add":"\t .expect(\"add_function 'log_to_console_from_main_dot_lua' should succeed\");"},{"Add":""},{"Add":"\t// Continue event loop"},{"Add":"\tEventLoopCtrl::Continue"},{"Add":"}"},{"Add":""},{"Add":""},{"Add":"/// Update handler"},{"Add":"fn on_update(_: &mut ()) -> UpdateCtrl {"},{"Add":"\t// Continue updates"},{"Add":"\tUpdateCtrl::Continue"},{"Add":"}"},{"Add":""},{"Add":""},{"Add":"// The function we add to the Lua runtime and call from main.lua"},{"Add":"pub unsafe extern \"C\" fn log_to_console_from_main_dot_lua(_lua_state: *mut lua_State) -> c_int {"},{"Add":"\t// We know that our function takes a single argument which is a string."},{"Add":"\tlet arg_string = Lua::Default().get_arg_string(1)"},{"Add":"\t .expect(\"get_arg_string should succeed\");"},{"Add":""},{"Add":"\t// Avoid going from CString to str and back with playdate::sys::log::println"},{"Add":"\tlet f = (*(*sys::API).system).logToConsole"},{"Add":"\t .expect(\"get logToConsole to succeed\");"},{"Add":""},{"Add":"\tf(arg_string.as_ptr());"},{"Add":""},{"Add":"\t// A `lua_CFunction` should return the number of return values it has pushed"},{"Add":"\t// onto the stack."},{"Add":"\t0"},{"Add":"}"},{"Add":""},{"Add":""},{"Add":"// Needed for debug build"},{"Add":"ll_symbols!();"}]}},{"FileAdd":{"meta":{"basename":"README.md","metadata":0},"context":[{"change":0,"pos":6264}],"contents":[{"Add":"# Examples"},{"Add":""},{"Add":"These examples additionally use other crates with parts of Playdate API to minimize the amount of code."},{"Add":""},{"Add":""},{"Add":"# How to run"},{"Add":""},{"Add":"```bash"},{"Add":"cargo playdate run -p=playdate-lua --example=add-function-get-arg-string --features=sys/lang-items,sys/entry-point"},{"Add":"```"},{"Add":""},{"Add":"More information how to use [cargo-playdate][] in help: `cargo playdate --help`."},{"Add":""},{"Add":""},{"Add":""},{"Add":"[cargo-playdate]: https://crates.io/crates/cargo-playdate"}]}},{"FileAdd":{"meta":{"basename":"Example.pdx","metadata":576},"context":[{"change":0,"pos":6264}],"contents":[]}},{"FileAdd":{"meta":{"basename":"pdxinfo","metadata":0},"context":[{"change":0,"pos":8811}],"contents":[{"Add":"pdxversion=20400"},{"Add":"buildtime=767932885"}]}},{"FileAdd":{"meta":{"basename":"main.pdz","metadata":0},"context":[{"change":0,"pos":8811}],"contents":[]}},{"FileAdd":{"meta":{"basename":"README.md","metadata":0},"context":[{"change":0,"pos":857}],"contents":[{"Add":"# Lua API for PlayDate"},{"Add":""},{"Add":"High-level Lua API built on-top of [playdate-sys][]."},{"Add":""},{"Add":""},{"Add":"## Usage"},{"Add":""},{"Add":"See [examples][]."},{"Add":""},{"Add":"[examples]: ./examples"},{"Add":"[playdate-sys]: https://crates.io/crates/playdate-sys"},{"Add":""},{"Add":""},{"Add":""},{"Add":"- - -"},{"Add":""},{"Add":"This software is not sponsored or supported by Panic."}]}},{"FileAdd":{"meta":{"basename":"Cargo.toml","metadata":0},"context":[{"change":0,"pos":857}],"contents":[{"Add":"[package]"},{"Add":"name = \"playdate-lua\""},{"Add":"version = \"0.1.0\""},{"Add":"readme = \"README.md\""},{"Add":"description = \"High-level Lua API built on-top of Playdate API\""},{"Add":"keywords = [\"playdate\", \"sdk\", \"api\", \"gamedev\"]"},{"Add":"categories = [\"game-development\", \"api-bindings\", \"no-std\"]"},{"Add":"edition.workspace = true"},{"Add":"license.workspace = true"},{"Add":"authors = [\"Paul Young\", \"Alex Koz \"]"},{"Add":"homepage.workspace = true"},{"Add":"repository.workspace = true"},{"Add":""},{"Add":""},{"Add":"[features]"},{"Add":"default = [\"sys/default\"]"},{"Add":""},{"Add":"# playdate-sys features, should be shared because it's build configuration:"},{"Add":""},{"Add":"bindgen-runtime = [\"sys/bindgen-runtime\"]"},{"Add":"bindgen-static = [\"sys/bindgen-static\"]"},{"Add":"bindings-derive-debug = [\"sys/bindings-derive-debug\"]"},{"Add":""},{"Add":""},{"Add":"[dependencies]"},{"Add":"sys = { workspace = true, default-features = false }"},{"Add":""},{"Add":"[dev-dependencies]"},{"Add":"system = { workspace = true, default-features = false }"},{"Add":""},{"Add":""},{"Add":"[[example]]"},{"Add":"name = \"add-function-get-arg-string\""},{"Add":"crate-type = [\"dylib\", \"staticlib\"]"},{"Add":"path = \"examples/add-function-get-arg-string.rs\""},{"Add":"required-features = [\"sys/entry-point\", \"sys/lang-items\"]"},{"Add":""},{"Add":""},{"Add":"[package.metadata.playdate]"},{"Add":"bundle-id = \"rs.playdate.lua\""},{"Add":""},{"Add":"[package.metadata.playdate.dev-assets]"},{"Add":"# The Lua runtime expects us to provide a main.pdz file at the root."},{"Add":"#"},{"Add":"# Compiled with `pdc --skip-unknown --strip sources/main.lua Example.pdx`"},{"Add":"\"main.pdz\" = \"examples/Example.pdx/main.pdz\""},{"Add":""},{"Add":""},{"Add":"[package.metadata.docs.rs]"},{"Add":"all-features = false"},{"Add":"features = ["},{"Add":"\t\"sys/bindings-derive-default\","},{"Add":"\t\"sys/bindings-derive-eq\","},{"Add":"\t\"sys/bindings-derive-copy\","},{"Add":"\t\"bindings-derive-debug\","},{"Add":"\t\"sys/bindings-derive-hash\","},{"Add":"\t\"sys/bindings-derive-ord\","},{"Add":"\t\"sys/bindings-derive-partialeq\","},{"Add":"\t\"sys/bindings-derive-partialord\","},{"Add":"]"},{"Add":"rustdoc-args = [\"--cfg\", \"docsrs\", \"--show-type-layout\"]"},{"Add":"default-target = \"thumbv7em-none-eabihf\""},{"Add":"cargo-args = ["},{"Add":"\t\"-Zunstable-options\","},{"Add":"\t\"-Zrustdoc-scrape-examples\","},{"Add":"\t\"-Zbuild-std=core,alloc\","},{"Add":"]"}]}},{"Edit":{"inode":{"change":2,"pos":3671338},"path":"Cargo.toml","line":22,"atom":{"NewVertex":{"up_context":[{"change":5,"pos":94645}],"down_context":[{"change":7,"pos":10855}],"flag":"BLOCK","start":11234,"end":11330,"inode":{"change":2,"pos":3671338}}},"contents":[{"Add":"lua = { version = \"0.1\", path = \"api/lua\", package = \"playdate-lua\", default-features = false }"}]}},{"Replacement":{"inode":{"change":2,"pos":3671603},"path":"Cargo.lock","line":4053,"ins":{"up_context":[{"change":4,"pos":19179}],"down_context":[{"change":4,"pos":19197}],"flag":"BLOCK","start":11332,"end":11350,"inode":{"change":2,"pos":3671603}},"del":{"edges":[{"previous":"BLOCK","flag":"BLOCK | DELETED","from":{"change":4,"pos":19179},"to":{"change":11,"start":1233,"end":1252},"introduced_by":11}],"inode":{"change":2,"pos":3671603}},"ins_contents":[{"Add":"version = \"0.2.0\""}],"del_contents":[{"Del":"version = \"0.1.17\"\n"}]}},{"Edit":{"inode":{"change":2,"pos":3671603},"path":"Cargo.lock","line":4059,"atom":{"NewVertex":{"up_context":[{"change":4,"pos":19295}],"down_context":[{"change":4,"pos":19295}],"flag":"BLOCK","start":11351,"end":11368,"inode":{"change":2,"pos":3671603}}},"contents":[{"Add":" \"playdate-lua\","}]}},{"Edit":{"inode":{"change":2,"pos":3671603},"path":"Cargo.lock","line":4195,"atom":{"NewVertex":{"up_context":[{"change":2,"pos":3730848}],"down_context":[{"change":3,"pos":4274}],"flag":"BLOCK","start":11369,"end":11478,"inode":{"change":2,"pos":3671603}}},"contents":[{"Add":"name = \"playdate-lua\""},{"Add":"version = \"0.1.0\""},{"Add":"dependencies = ["},{"Add":" \"playdate-sys\","},{"Add":" \"playdate-system\","},{"Add":"]"},{"Add":""},{"Add":"[[package]]"}]}},{"Edit":{"inode":{"change":2,"pos":3767139},"path":".github/workflows/tests.yml","line":451,"atom":{"NewVertex":{"up_context":[{"change":8,"pos":21717}],"down_context":[{"change":8,"pos":21717}],"flag":"BLOCK","start":11484,"end":11586,"inode":{"change":2,"pos":3767139}}},"contents":[{"Add":" cargo playdate package --features=$FEATURES --examples --device --simulator -p=playdate-lua"}]}}],"owner":"fzzr","repo":"playdate","token":"gMfsB4Oe5LjEANTQFK9aMZkpADM/CDUKG6vJ8Sxz46k=","login":null}

…

Dependencies

Change contents