Class: Rugged::Config
- Inherits:
-
Object
- Object
- Rugged::Config
- Defined in:
- ext/rugged/rugged_config.c
Class Method Summary collapse
-
.global ⇒ Object
Open the default global config file as a new
Rugged::Config
object. -
.new(path) ⇒ Object
Open the file specified in
path
as aRugged::Config
file. -
.open_global ⇒ Object
Open the default global config file as a new
Rugged::Config
object.
Instance Method Summary collapse
-
#[](rb_key) ⇒ Object
Get the value for the given config
key
. -
#[]=(rb_key, rb_val) ⇒ Object
Store the given
value
in the Config file, under the section and name specified bykey
. -
#delete(key) ⇒ Boolean
Delete the given
key
from the config file. -
#each ⇒ Object
Call the given block once for each key/value pair in the config file.
-
#each_key ⇒ Object
Call the given block once for each key in the config file.
-
#each_pair ⇒ Object
Call the given block once for each key/value pair in the config file.
-
#get(rb_key) ⇒ Object
Get the value for the given config
key
. -
#store(rb_key, rb_val) ⇒ Object
Store the given
value
in the Config file, under the section and name specified bykey
. -
#to_hash ⇒ Hash
Returns the config file represented as a Ruby hash, where each configuration entry appears as a key with its corresponding value.
Class Method Details
.global ⇒ Object .open_global ⇒ Object
Open the default global config file as a new Rugged::Config
object. An exception will be raised if the global config file doesn’t exist.
298 299 300 301 302 303 304 305 306 307 |
# File 'ext/rugged/rugged_config.c', line 298
static VALUE rb_git_config_open_default(VALUE klass)
{
git_config *cfg;
int error;
error = git_config_open_default(&cfg);
rugged_exception_check(error);
return rugged_config_new(klass, Qnil, cfg);
}
|
.new(path) ⇒ Object
Open the file specified in path
as a Rugged::Config
file. If path
cannot be found, or the file is an invalid Git config, an exception will be raised.
50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 |
# File 'ext/rugged/rugged_config.c', line 50
static VALUE rb_git_config_new(VALUE klass, VALUE rb_path)
{
git_config *config = NULL;
int error, i;
if (TYPE(rb_path) == T_ARRAY) {
error = git_config_new(&config);
rugged_exception_check(error);
for (i = 0; i < RARRAY_LEN(rb_path); ++i) {
VALUE f = rb_ary_entry(rb_path, i);
Check_Type(f, T_STRING);
error = git_config_add_file_ondisk(config, StringValueCStr(f), i + 1, 1);
rugged_exception_check(error);
}
} else if (TYPE(rb_path) == T_STRING) {
error = git_config_open_ondisk(&config, StringValueCStr(rb_path));
rugged_exception_check(error);
} else {
rb_raise(rb_eTypeError, "Expecting a filename or an array of filenames");
}
return rugged_config_new(klass, Qnil, config);
}
|
.global ⇒ Object .open_global ⇒ Object
Open the default global config file as a new Rugged::Config
object. An exception will be raised if the global config file doesn’t exist.
298 299 300 301 302 303 304 305 306 307 |
# File 'ext/rugged/rugged_config.c', line 298
static VALUE rb_git_config_open_default(VALUE klass)
{
git_config *cfg;
int error;
error = git_config_open_default(&cfg);
rugged_exception_check(error);
return rugged_config_new(klass, Qnil, cfg);
}
|
Instance Method Details
#get(key) ⇒ Object #[](key) ⇒ Object
Get the value for the given config key
. Values are always returned as String
, or nil
if the given key doesn’t exist in the Config file.
cfg['apply.whitespace'] #=> 'fix'
cfg['diff.renames'] #=> 'true'
87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 |
# File 'ext/rugged/rugged_config.c', line 87
static VALUE rb_git_config_get(VALUE self, VALUE rb_key)
{
git_config *config;
git_buf buf = { NULL };
int error;
VALUE rb_result;
Data_Get_Struct(self, git_config, config);
Check_Type(rb_key, T_STRING);
error = git_config_get_string_buf(&buf, config, StringValueCStr(rb_key));
if (error == GIT_ENOTFOUND)
return Qnil;
rugged_exception_check(error);
rb_result = rb_str_new_utf8(buf.ptr);
git_buf_free(&buf);
return rb_result;
}
|
#store(key, value) ⇒ Object #[]=(key) ⇒ Object
Store the given value
in the Config file, under the section and name specified by key
. Value can be any of the following Ruby types: String
, true
, false
and Fixnum
.
The config file will be automatically stored to disk.
cfg['apply.whitespace'] = 'fix'
cfg['diff.renames'] = true
cfg['gc.reflogexpre'] = 90
123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 |
# File 'ext/rugged/rugged_config.c', line 123
static VALUE rb_git_config_store(VALUE self, VALUE rb_key, VALUE rb_val)
{
git_config *config;
const char *key;
int error;
Data_Get_Struct(self, git_config, config);
Check_Type(rb_key, T_STRING);
key = StringValueCStr(rb_key);
switch (TYPE(rb_val)) {
case T_STRING:
error = git_config_set_string(config, key, StringValueCStr(rb_val));
break;
case T_TRUE:
case T_FALSE:
error = git_config_set_bool(config, key, (rb_val == Qtrue));
break;
case T_FIXNUM:
error = git_config_set_int32(config, key, FIX2INT(rb_val));
break;
default:
rb_raise(rb_eTypeError,
"Invalid value; config files can only store string, bool or int keys");
}
rugged_exception_check(error);
return Qnil;
}
|
#delete(key) ⇒ Boolean
Delete the given key
from the config file. Return true
if the deletion was successful, or false
if the key was not found in the Config file.
The config file is immediately updated on disk.
167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 |
# File 'ext/rugged/rugged_config.c', line 167
static VALUE rb_git_config_delete(VALUE self, VALUE rb_key)
{
git_config *config;
int error;
Data_Get_Struct(self, git_config, config);
Check_Type(rb_key, T_STRING);
error = git_config_delete_entry(config, StringValueCStr(rb_key));
if (error == GIT_ENOTFOUND)
return Qfalse;
rugged_exception_check(error);
return Qtrue;
}
|
#each_pair {|key, value| ... } ⇒ Object #each_pair ⇒ Object #each {|key, value| ... } ⇒ Object #each ⇒ Object
Call the given block once for each key/value pair in the config file. If no block is given, an enumerator is returned.
cfg.each do |key, value|
puts "#{key} => #{value}"
end
250 251 252 253 254 255 256 257 258 259 260 261 262 263 |
# File 'ext/rugged/rugged_config.c', line 250
static VALUE rb_git_config_each_pair(VALUE self)
{
git_config *config;
int error;
Data_Get_Struct(self, git_config, config);
if (!rb_block_given_p())
return rb_funcall(self, rb_intern("to_enum"), 1, CSTR2SYM("each_pair"));
error = git_config_foreach(config, &cb_config__each_pair, (void *)rb_block_proc());
rugged_exception_check(error);
return Qnil;
}
|
#each_key {|key| ... } ⇒ Object #each_key ⇒ Object
Call the given block once for each key in the config file. If no block is given, an enumerator is returned.
cfg.each_key do |key|
puts key
end
221 222 223 224 225 226 227 228 229 230 231 232 233 234 |
# File 'ext/rugged/rugged_config.c', line 221
static VALUE rb_git_config_each_key(VALUE self)
{
git_config *config;
int error;
Data_Get_Struct(self, git_config, config);
if (!rb_block_given_p())
return rb_funcall(self, rb_intern("to_enum"), 1, CSTR2SYM("each_key"));
error = git_config_foreach(config, &cb_config__each_key, (void *)rb_block_proc());
rugged_exception_check(error);
return Qnil;
}
|
#each_pair {|key, value| ... } ⇒ Object #each_pair ⇒ Object #each {|key, value| ... } ⇒ Object #each ⇒ Object
Call the given block once for each key/value pair in the config file. If no block is given, an enumerator is returned.
cfg.each do |key, value|
puts "#{key} => #{value}"
end
250 251 252 253 254 255 256 257 258 259 260 261 262 263 |
# File 'ext/rugged/rugged_config.c', line 250
static VALUE rb_git_config_each_pair(VALUE self)
{
git_config *config;
int error;
Data_Get_Struct(self, git_config, config);
if (!rb_block_given_p())
return rb_funcall(self, rb_intern("to_enum"), 1, CSTR2SYM("each_pair"));
error = git_config_foreach(config, &cb_config__each_pair, (void *)rb_block_proc());
rugged_exception_check(error);
return Qnil;
}
|
#get(key) ⇒ Object #[](key) ⇒ Object
Get the value for the given config key
. Values are always returned as String
, or nil
if the given key doesn’t exist in the Config file.
cfg['apply.whitespace'] #=> 'fix'
cfg['diff.renames'] #=> 'true'
87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 |
# File 'ext/rugged/rugged_config.c', line 87
static VALUE rb_git_config_get(VALUE self, VALUE rb_key)
{
git_config *config;
git_buf buf = { NULL };
int error;
VALUE rb_result;
Data_Get_Struct(self, git_config, config);
Check_Type(rb_key, T_STRING);
error = git_config_get_string_buf(&buf, config, StringValueCStr(rb_key));
if (error == GIT_ENOTFOUND)
return Qnil;
rugged_exception_check(error);
rb_result = rb_str_new_utf8(buf.ptr);
git_buf_free(&buf);
return rb_result;
}
|
#store(key, value) ⇒ Object #[]=(key) ⇒ Object
Store the given value
in the Config file, under the section and name specified by key
. Value can be any of the following Ruby types: String
, true
, false
and Fixnum
.
The config file will be automatically stored to disk.
cfg['apply.whitespace'] = 'fix'
cfg['diff.renames'] = true
cfg['gc.reflogexpre'] = 90
123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 |
# File 'ext/rugged/rugged_config.c', line 123
static VALUE rb_git_config_store(VALUE self, VALUE rb_key, VALUE rb_val)
{
git_config *config;
const char *key;
int error;
Data_Get_Struct(self, git_config, config);
Check_Type(rb_key, T_STRING);
key = StringValueCStr(rb_key);
switch (TYPE(rb_val)) {
case T_STRING:
error = git_config_set_string(config, key, StringValueCStr(rb_val));
break;
case T_TRUE:
case T_FALSE:
error = git_config_set_bool(config, key, (rb_val == Qtrue));
break;
case T_FIXNUM:
error = git_config_set_int32(config, key, FIX2INT(rb_val));
break;
default:
rb_raise(rb_eTypeError,
"Invalid value; config files can only store string, bool or int keys");
}
rugged_exception_check(error);
return Qnil;
}
|
#to_hash ⇒ Hash
Returns the config file represented as a Ruby hash, where each configuration entry appears as a key with its corresponding value.
cfg.to_hash #=> {"core.autolf" => "true", "core.bare" => "true"}
275 276 277 278 279 280 281 282 283 284 285 286 287 |
# File 'ext/rugged/rugged_config.c', line 275
static VALUE rb_git_config_to_hash(VALUE self)
{
git_config *config;
int error;
VALUE hash;
Data_Get_Struct(self, git_config, config);
hash = rb_hash_new();
error = git_config_foreach(config, &cb_config__to_hash, (void *)hash);
rugged_exception_check(error);
return hash;
}
|