bsdcontrol.rb/lib/bsd/control.rb
2024-03-08 02:17:15 -03:00

40 lines
915 B
Ruby

module BSD::Control
require_relative "control/feature"
Error = Class.new(RuntimeError)
##
# @return [String]
# Returns the version of libhbsdcontrol.
def self.library_version
FFI.library_version
end
##
# @return [Array<BSD::Control::Feature>]
# Returns an array of available features.
def self.available_features
Feature.available
end
##
# @example
# BSD::Control
# .feature(:mprotect)
# .enable!("/usr/local/bin/emacs-29.2")
#
# @param [String] name
# The name of a feature.
#
# @raise [BSD::Control::Error]
# When a feature is not found.
#
# @return [BSD::Control::Feature]
# Returns an instance of {BSD::Control::Feature BSD::Control::Feature}.
def self.feature(name)
feature = available_features.find { _1.name == name.to_s }
feature ? feature : raise(Error, "feature '#{name}' wasn't found")
end
module FFI
end
end