{-# LANGUAGE ForeignFunctionInterface, FlexibleInstances, CPP #-} #include "shim.h" #include module Foreign.Ruby.Bindings where import Foreign import Foreign.C -- | This is the type of Ruby values. It is defined as a pointer to some unsigned long, just like Ruby does. The actual value is either pointed to, or encoded in the pointer. type RValue = Ptr CULong -- | The Ruby ID type, mostly used for symbols. type RID = CULong data ShimDispatch = ShimDispatch String String [RValue] instance Storable ShimDispatch where sizeOf _ = (#size struct s_dispatch) alignment = sizeOf peek ptr = do a <- peekCString ((#ptr struct s_dispatch, classname) ptr) b <- peekCString ((#ptr struct s_dispatch, methodname) ptr) return (ShimDispatch a b []) poke ptr (ShimDispatch c m vals) = do cs <- newCString c cm <- newCString m (#poke struct s_dispatch, classname) ptr cs (#poke struct s_dispatch, methodname) ptr cm (#poke struct s_dispatch, nbargs) ptr (length vals) let arrayblock = (#ptr struct s_dispatch, args) ptr pokeArray arrayblock vals -- | The ruby built-in types data RBuiltin = RNONE | RNIL | ROBJECT | RCLASS | RICLASS | RMODULE | RFLOAT | RSTRING | RREGEXP | RARRAY | RFIXNUM | RHASH | RSTRUCT | RBIGNUM | RFILE | RTRUE | RFALSE | RDATA | RMATCH | RSYMBOL | RUNDEF | RNODE deriving (Show) -- | Ruby native types, as encoded in the Value type. data RType = RFixNum | RNil | RFalse | RTrue | RSymbol | RUndef | RBuiltin RBuiltin deriving (Show) type Registered0 = IO RValue type Registered1 = RValue -> IO RValue type Registered2 = RValue -> RValue -> IO RValue -- | Creates a function pointer suitable for usage with `rb_define_global_function` of type `Registered0` (with 0 arguments). foreign import ccall "wrapper" mkRegistered0 :: Registered0 -> IO (FunPtr Registered0) -- | Creates a function pointer suitable for usage with `rb_define_global_function` of type `Registered1` (with 1 `RValue` arguments). foreign import ccall "wrapper" mkRegistered1 :: Registered1 -> IO (FunPtr Registered1) -- | Creates a function pointer suitable for usage with `rb_define_global_function` of type `Registered2` (with 2 `RValue` arguments). foreign import ccall "wrapper" mkRegistered2 :: Registered2 -> IO (FunPtr Registered2) type RegisteredCB3 = RValue -> RValue -> RValue -> IO Int foreign import ccall "wrapper" mkRegisteredCB3 :: RegisteredCB3 -> IO (FunPtr RegisteredCB3) foreign import ccall "ruby_finalize" ruby_finalize :: IO () foreign import ccall "ruby_initialization" ruby_initialization :: IO () #ifdef RUBY21 foreign import ccall "rb_str_new_cstr" c_rb_str_new2 :: CString -> IO RValue foreign import ccall "rb_ary_new_capa" rb_ary_new2 :: CLong -> IO RValue foreign import ccall "rb_ary_new_from_values" rb_ary_new4 :: CLong -> Ptr RValue -> IO RValue #else foreign import ccall "rb_str_new2" c_rb_str_new2 :: CString -> IO RValue foreign import ccall "rb_ary_new2" rb_ary_new2 :: CLong -> IO RValue foreign import ccall "rb_ary_new4" rb_ary_new4 :: CLong -> Ptr RValue -> IO RValue #endif foreign import ccall safe "rb_load_protect" c_rb_load_protect :: RValue -> Int -> Ptr Int -> IO () foreign import ccall safe "rb_funcall" c_rb_funcall_0 :: RValue -> RID -> Int -> IO RValue foreign import ccall safe "rb_funcall" c_rb_funcall_1 :: RValue -> RID -> Int -> RValue -> IO RValue foreign import ccall safe "rb_funcall" c_rb_funcall_2 :: RValue -> RID -> Int -> RValue -> RValue -> IO RValue foreign import ccall safe "rb_funcall" c_rb_funcall_3 :: RValue -> RID -> Int -> RValue -> RValue -> RValue -> IO RValue foreign import ccall safe "rb_funcall" c_rb_funcall_4 :: RValue -> RID -> Int -> RValue -> RValue -> RValue -> RValue -> IO RValue foreign import ccall safe "rb_funcall" c_rb_funcall_5 :: RValue -> RID -> Int -> RValue -> RValue -> RValue -> RValue -> RValue -> IO RValue foreign import ccall unsafe "rb_gv_get" c_rb_gv_get :: CString -> IO RValue foreign import ccall unsafe "rb_intern" c_rb_intern :: CString -> IO RID foreign import ccall unsafe "rb_id2name" rb_id2name :: RID -> IO CString foreign import ccall unsafe "rb_string_value_ptr" c_rb_string_value_ptr :: Ptr RValue -> IO CString foreign import ccall unsafe "&rb_cObject" rb_cObject :: Ptr RValue foreign import ccall unsafe "rb_iv_set" c_rb_iv_set :: RValue -> CString -> RValue -> IO RValue foreign import ccall safe "rb_define_class" c_rb_define_class :: CString -> RValue -> IO RValue foreign import ccall safe "rb_define_method" c_rb_define_method :: RValue -> CString -> FunPtr a -> Int -> IO () foreign import ccall safe "rb_define_global_function" c_rb_define_global_function :: CString -> FunPtr a -> Int -> IO () foreign import ccall unsafe "rb_const_get" rb_const_get :: RValue -> RID -> IO RValue foreign import ccall safe "&safeCall" safeCallback :: FunPtr (RValue -> IO RValue) foreign import ccall safe "rb_protect" c_rb_protect :: FunPtr (RValue -> IO RValue) -> RValue -> Ptr Int -> IO RValue foreign import ccall unsafe "rb_string_value_cstr" c_rb_string_value_cstr :: Ptr RValue -> IO CString foreign import ccall unsafe "rb_ary_new" rb_ary_new :: IO RValue foreign import ccall unsafe "rb_ary_push" rb_ary_push :: RValue -> RValue -> IO RValue foreign import ccall unsafe "rb_ary_entry" rb_ary_entry :: RValue -> CLong -> IO RValue foreign import ccall safe "rb_hash_foreach" rb_hash_foreach :: RValue -> FunPtr a -> RValue -> IO () foreign import ccall unsafe "rb_big2str" rb_big2str :: RValue -> CInt -> IO RValue foreign import ccall unsafe "rb_cstr_to_inum" rb_cstr_to_inum :: CString -> CInt -> CInt -> IO RValue foreign import ccall unsafe "newFloat" newFloat :: Double -> IO RValue foreign import ccall unsafe "rb_hash_new" rb_hash_new :: IO RValue foreign import ccall unsafe "rb_hash_aset" rb_hash_aset :: RValue -> RValue -> RValue -> IO RValue foreign import ccall unsafe "rb_define_module" c_rb_define_module :: CString -> IO () foreign import ccall unsafe "arrayLength" arrayLength :: RValue -> IO CLong foreign import ccall unsafe "rubyType" rubyType :: RValue -> IO CInt foreign import ccall unsafe "num2dbl" num2dbl :: RValue -> IO Double foreign import ccall unsafe "int2num" int2num :: CLong -> IO RValue foreign import ccall unsafe "num2long" num2long :: RValue -> IO CLong foreign import ccall unsafe "id2sym" id2sym :: RID -> RValue foreign import ccall unsafe "sym2id" sym2id :: RValue -> RID rbFalse,rbTrue,rbNil,rbUndef :: RValue #ifdef RUBY2 rbFalse = intPtrToPtr 0x00 rbTrue = intPtrToPtr 0x14 rbNil = intPtrToPtr 0x08 rbUndef = intPtrToPtr 0x34 #else rbFalse = intPtrToPtr 0 rbTrue = intPtrToPtr 2 rbNil = intPtrToPtr 4 rbUndef = intPtrToPtr 6 #endif rtype :: RValue -> IO RType rtype v = rubyType v >>= \x -> case x of (#const RUBY_T_NONE) -> return RUndef (#const RUBY_T_OBJECT) -> return (RBuiltin ROBJECT) (#const RUBY_T_CLASS) -> return (RBuiltin RCLASS) (#const RUBY_T_MODULE) -> return (RBuiltin RMODULE) (#const RUBY_T_FLOAT) -> return (RBuiltin RFLOAT) (#const RUBY_T_STRING) -> return (RBuiltin RSTRING) (#const RUBY_T_REGEXP) -> return (RBuiltin RREGEXP) (#const RUBY_T_ARRAY) -> return (RBuiltin RARRAY) (#const RUBY_T_HASH) -> return (RBuiltin RHASH) (#const RUBY_T_STRUCT) -> return (RBuiltin RSTRUCT) (#const RUBY_T_BIGNUM) -> return (RBuiltin RBIGNUM) (#const RUBY_T_FILE) -> return (RBuiltin RFILE) (#const RUBY_T_DATA) -> return (RBuiltin RDATA) (#const RUBY_T_MATCH) -> return (RBuiltin RMATCH) (#const RUBY_T_NIL) -> return RNil (#const RUBY_T_TRUE) -> return RTrue (#const RUBY_T_FALSE) -> return RFalse (#const RUBY_T_SYMBOL) -> return RSymbol (#const RUBY_T_FIXNUM) -> return RFixNum (#const RUBY_T_UNDEF) -> return (RBuiltin RUNDEF) (#const RUBY_T_NODE) -> return (RBuiltin RNODE) (#const RUBY_T_ICLASS) -> return (RBuiltin RICLASS) _ -> return RUndef rb_string_value_cstr :: RValue -> IO String rb_string_value_cstr v = do pv <- new v o <- c_rb_string_value_cstr pv >>= peekCString free pv return o -- | Defines a global function that can be called from the Ruby world. This function must only accept `RValue`s as arguments. rb_define_global_function :: String -- ^ Name of the function -> FunPtr a -- ^ Pointer to the function (created with something like `mkRegistered0`) -> Int -- ^ Number of arguments the function accepts. -> IO () rb_define_global_function s f i = withCString s (\cs -> c_rb_define_global_function cs f i) rb_define_method :: RValue -> String -> FunPtr a -> Int -> IO () rb_define_method r s f i = withCString s (\cs -> c_rb_define_method r cs f i) rb_define_class :: String -> RValue -> IO RValue rb_define_class str rv = withCString str (\s -> c_rb_define_class s rv) rb_str_new2 :: String -> IO RValue rb_str_new2 str = withCString str c_rb_str_new2 rb_define_module :: String -> IO () rb_define_module str = withCString str c_rb_define_module -- | Sets an instance variable rb_iv_set :: RValue -- ^ The object -> String -- ^ The variable name (without the @) -> RValue -- ^ The value to set -> IO RValue -- ^ The value you just set rb_iv_set obj varname varvalue = withCString ('@' : varname) $ \cvarname -> c_rb_iv_set obj cvarname varvalue -- | Loads a ruby script (and executes it). rb_load_protect :: String -- ^ Path to the script -> Int -- ^ Just set this to 0, unless you know what you are doing -> IO Int -- ^ Return code, equal to 0 if everything went right. `showErrorStack` can be used in case of errors. rb_load_protect rv a = do bptr <- new 0 rvs <- rb_str_new2 rv c_rb_load_protect rvs a bptr status <- peek bptr free bptr return status rb_funcall :: RValue -> RID -> [RValue] -> IO RValue rb_funcall a b [] = c_rb_funcall_0 a b 0 rb_funcall a b [d] = c_rb_funcall_1 a b 1 d rb_funcall a b [d,e] = c_rb_funcall_2 a b 2 d e rb_funcall a b [d,e,f] = c_rb_funcall_3 a b 3 d e f rb_funcall a b [d,e,f,g] = c_rb_funcall_4 a b 4 d e f g rb_funcall a b [d,e,f,g,h] = c_rb_funcall_5 a b 5 d e f g h rb_funcall _ _ _ = error "Can't call functions with that many arguments" rbMethodCall :: String -> String -> [RValue] -> IO RValue rbMethodCall classname methodname args = do c <- getClass classname m <- rb_intern methodname rb_funcall c m args getClass :: String -> IO RValue getClass s = do i <- rb_intern s o <- peek rb_cObject rb_const_get o i rb_gv_get :: String -> IO RValue rb_gv_get s = withCString s c_rb_gv_get rb_intern :: String -> IO RID rb_intern s = withCString s c_rb_intern rb_string_value_ptr :: RValue -> IO String rb_string_value_ptr rv = do rvp <- new rv o <- c_rb_string_value_ptr rvp >>= peekCString free rvp return o