Téléchargement ffi - Téléchargement du code source ffi

ffi

Autre code source

1.0.0

Télécharger

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

Description

Ruby-FFI est un joyau permettant de charger par programme des bibliothèques natives liées dynamiquement, de lier des fonctions en leur sein et d'appeler ces fonctions à partir du code Ruby. De plus, une extension Ruby-FFI fonctionne sans modifications sur CRuby (MRI), JRuby, Rubinius et TruffleRuby. Découvrez pourquoi vous devriez écrire votre prochaine extension en utilisant Ruby-FFI.

Caractéristiques

ADSL intuitif
Prend en charge tous les types natifs C
Structures C (également imbriquées), énumérations et variables globales
Rappels de C vers Ruby
Récupération automatique des déchets de la mémoire native
Utilisable dans Ractor : Comment utiliser FFI-in-Ruby-Ractors

Synopsis

 require 'ffi'

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

MyLib . puts 'Hello, World using libc!'

Pour des exemples moins minimalistes et plus nombreux, vous pouvez consulter :

le dossier samples/
les exemples sur le wiki
les projets utilisant FFI répertoriés sur le wiki : https://github.com/ffi/ffi/wiki/projects-using-ffi

Exigences

Lors de l'installation de la gem sur CRuby (MRI), vous aurez besoin de :

Compilateur AC (par exemple, Xcode sur macOS, gcc ou clang sur tout le reste) En option (accélère l'installation) :
La bibliothèque libffi et les en-têtes de développement - cela se trouve généralement dans les packages libffi-dev ou libffi-devel

La gemme ffi est livrée avec une version libffi intégrée, qui est utilisée lorsque la bibliothèque système libffi n'est pas disponible ou est trop ancienne. L'utilisation du système libffi peut être imposée par :

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

ou empêché par --disable-system-libffi .

Sur les systèmes Linux fonctionnant avec PaX (Gentoo, Alpine, etc.), FFI peut déclencher des erreurs mprotect . Vous devrez peut-être désactiver mprotect pour Ruby ( paxctl -m [/path/to/ruby] ) pour le moment jusqu'à ce qu'une solution soit trouvée.

Sur les systèmes FreeBSD, pkgconf doit être installé pour que la gem puisse être compilée à l'aide de clang. Installez soit via les packages pkg install pkgconf , soit à partir des ports via devel/pkgconf .

Sur JRuby et TruffleRuby, il n'y a aucune exigence pour installer la gemme FFI, et require 'ffi' fonctionne même sans installer la gemme (c'est-à-dire que la gemme est préinstallée sur ces implémentations).

Installation

De rubygems :

 [sudo] gem install ffi

À partir d'un Gemfile en utilisant git ou GitHub

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

ou depuis le dépôt git sur github :

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

Options d'installation :

--enable-system-libffi : Forcer l'utilisation du système libffi
--disable-system-libffi : forcer l'utilisation de la libffi intégrée
--enable-libffi-alloc : Forcer l'allocation de fermeture par libffi
--disable-libffi-alloc : Forcer l'allocation de fermeture par la méthode intégrée

Licence

La bibliothèque ffi est couverte par la licence BSD, voir également le fichier LICENSE. Les spécifications sont couvertes par la même licence que ruby/spec, la licence MIT.