GD_ (122/289 implemented)

Wanna jump into it? See the api docs

Visit it in the asset library

GD_ is an effort to bring Lodash into Godot. This will attempt to replicate Lodash's behavior as close as possible (even if the implementation becomes round about).

# Map Example
var users = [
  { 'user': 'barney' },
  { 'user': 'fred' }
]; 		 


GD_.map(users, 'user');  
# =>  ['barney', 'fred']

# Get Example
var node = Node2D.new()
node.global_position = Vector2(999,123)

var everything_everywhere_all_at_once = {
  "array": ["hello", node, "world"]
}

GD_.get_prop(everything_everywhere_all_at_once, "array:1:global_position:y")
# => 123

2 Ways to install

Install it through the asset library
Copy addons\gd_\src folder into your project and it must contain the following files
- GD_.gd
- GD_array.gd
- GD_collection.gd
- GD_object.gd
- GD_function.gd
- GD_math.gd
- GD_number.gd
- GD_util.gd
- GD_date.gd
- GD_string.gd
- GD_lang.gd
- GD_base.gd

Special callouts

Regarding callables and callbacks

Because of the way GDScript treats callables,

all callbacks should always be constructed with 2 arguments.

This means that if in lodash you have a callback like in _.drop_right_while which is invoked with 3 arguments (value,index,array). We drop the 3rd arguments.

var callback_2_args = func (value, index): 
  return value

GD_.drop_right_while(..., callback_2_args)

This also means that if in lodash a callback is invoked with only 1 argument like in _.differenceBy, we must supply a dummy arg.

var callback_1_arg =  func (value, _unused): 
  return value

GD_.difference_by(..., callback_1_arg)

Regarding equality

Some functions specifically use SameValueZero specification for equality. For GD_ we just use Godot's == operator which for the most part behaves like the SameValueZero.

@TODO tabulate differences

Requests

This project is very much in its early stages, so it's very likely for the function you need to not exist yet. If that happens, please leave an issue for a specific function to be prioritized.

Documentation for existing functions