Download ffi - download do código-fonte ffi

ffi

Outro código-fonte

1.0.0

Baixar

Ruby-FFI https://github.com/ffi/ffi/wiki

Descrição

Ruby-FFI é uma jóia para carregar programaticamente bibliotecas nativas vinculadas dinamicamente, vincular funções dentro delas e chamar essas funções a partir do código Ruby. Além disso, uma extensão Ruby-FFI funciona sem alterações em CRuby (MRI), JRuby, Rubinius e TruffleRuby. Descubra por que você deve escrever sua próxima extensão usando Ruby-FFI.

Características

DSL intuitivo
Suporta todos os tipos nativos de C
Estruturas C (também aninhadas), enums e variáveis globais
Retornos de chamada de C para Ruby
Coleta automática de lixo da memória nativa
Utilizável no Ractor: Como usar o FFI-in-Ruby-Ractors

Sinopse

 require 'ffi'

module MyLib
  extend FFI :: Library
  ffi_lib 'c'
  attach_function :puts , [ :string ] , :int
end

MyLib . puts 'Hello, World using libc!'

Para exemplos menos minimalistas e mais exemplos, você pode consultar:

samples/ pasta
os exemplos no wiki
os projetos usando FFI listados no wiki: https://github.com/ffi/ffi/wiki/projects-using-ffi

Requisitos

Ao instalar a gema no CRuby (MRI), você precisará de:

Compilador AC (por exemplo, Xcode no macOS, gcc ou clang em todo o resto) Opcionalmente (acelera a instalação):
A biblioteca libffi e os cabeçalhos de desenvolvimento - geralmente nos pacotes libffi-dev ou libffi-devel

A gem ffi vem com uma versão libffi integrada, que é usada quando a biblioteca libffi do sistema não está disponível ou é muito antiga. O uso do sistema libffi pode ser imposto por:

 gem install ffi -- --enable-system-libffi        # to install the gem manually
bundle config build.ffi --enable-system-libffi   # for bundle install

ou impedido por --disable-system-libffi .

Em sistemas Linux rodando com PaX (Gentoo, Alpine, etc.), o FFI pode desencadear erros mprotect . Pode ser necessário desabilitar o mprotect para Ruby ( paxctl -m [/path/to/ruby] ) por enquanto até que uma solução seja encontrada.

Em sistemas FreeBSD, o pkgconf deve ser instalado para que a gem possa ser compilada usando clang. Instale através de pacotes pkg install pkgconf ou de ports via devel/pkgconf .

No JRuby e TruffleRuby, não há requisitos para instalar a gema FFI, e require 'ffi' funciona mesmo sem instalar a gema (ou seja, a gema está pré-instalada nessas implementações).

Instalação

De gemas de rubi:

 [sudo] gem install ffi

De um Gemfile usando git ou GitHub

 gem 'ffi', github: 'ffi/ffi', submodules: true

ou do repositório git no github:

 git clone git://github.com/ffi/ffi.git
cd ffi
git submodule update --init --recursive
bundle install
rake install

Opções de instalação:

--enable-system-libffi : Força o uso da libffi do sistema
--disable-system-libffi : Força o uso da libffi integrada
--enable-libffi-alloc : Força a alocação de fechamento pela libffi
--disable-libffi-alloc : Força a alocação de fechamento pelo método integrado

Licença

A biblioteca ffi é coberta pela licença BSD, veja também o arquivo LICENSE. As especificações são cobertas pela mesma licença que ruby/spec, a licença MIT.