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.
294 295 296 297 298 299 300 301 302 303 |
# File 'ext/rugged/rugged_config.c', line 294
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.
294 295 296 297 298 299 300 301 302 303 |
# File 'ext/rugged/rugged_config.c', line 294
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 |
# File 'ext/rugged/rugged_config.c', line 87
static VALUE rb_git_config_get(VALUE self, VALUE rb_key)
{
git_config *config;
const char *value;
int error;
Data_Get_Struct(self, git_config, config);
Check_Type(rb_key, T_STRING);
error = git_config_get_string(&value, config, StringValueCStr(rb_key));
if (error == GIT_ENOTFOUND)
return Qnil;
rugged_exception_check(error);
return rb_str_new_utf8(value);
}
|
#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
119 120 121 122 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 |
# File 'ext/rugged/rugged_config.c', line 119
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.
163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 |
# File 'ext/rugged/rugged_config.c', line 163
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
246 247 248 249 250 251 252 253 254 255 256 257 258 259 |
# File 'ext/rugged/rugged_config.c', line 246
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
217 218 219 220 221 222 223 224 225 226 227 228 229 230 |
# File 'ext/rugged/rugged_config.c', line 217
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
246 247 248 249 250 251 252 253 254 255 256 257 258 259 |
# File 'ext/rugged/rugged_config.c', line 246
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 |
# File 'ext/rugged/rugged_config.c', line 87
static VALUE rb_git_config_get(VALUE self, VALUE rb_key)
{
git_config *config;
const char *value;
int error;
Data_Get_Struct(self, git_config, config);
Check_Type(rb_key, T_STRING);
error = git_config_get_string(&value, config, StringValueCStr(rb_key));
if (error == GIT_ENOTFOUND)
return Qnil;
rugged_exception_check(error);
return rb_str_new_utf8(value);
}
|
#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
119 120 121 122 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 |
# File 'ext/rugged/rugged_config.c', line 119
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"}
271 272 273 274 275 276 277 278 279 280 281 282 283 |
# File 'ext/rugged/rugged_config.c', line 271
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;
}
|