@@ -333,25 +333,18 @@ is a Rust library that provides bindings for the Godot game engine.
333
333
334
334
November has been a month of refactoring for godot-rust. The API was cleaned up
335
335
across different locations, reducing confusion and making the library more
336
- accessible. The module simplification ([ #811 ] [ gd-811 ] ) continued initial efforts
337
- on the
338
- module structure, such as shorter paths and avoidance of redundant re-exports.
339
- The improvements are best expressed as a picture -- these are differences
340
- between version v0.9.3 and now:
341
-
342
- In a similar vein, several core symbols were renamed for consistency
343
- ([ #815 ] [ gd-815 ] ). Examples include:
344
-
345
- - ` RefInstance ` -> ` TInstance `
346
- - ` TypedArray ` -> ` PoolArray `
347
- - ` ThreadAccess ` -> ` Ownership `
348
- - ` RefKind ` -> ` Memory `
349
-
350
- Another refactoring affects the ` Variant ` conversion methods ([ #819 ] [ gd-819 ] ).
351
- Instead of ` Variant::to_i64() ` which may silently fail and return a default
352
- value (Godot behavior), the recommended method is now ` Variant::to<T>() ` . This
353
- enables genericity and is more idiomatic in Rust, returning an ` Option ` to
354
- indicate success or failure.
336
+ accessible:
337
+
338
+ - The module simplification ([ #811 ] [ gd-811 ] ) continued initial efforts on the
339
+ module structure, such as shorter paths and avoidance of redundant re-exports.
340
+ Some differences between v0.9.3 and now can be seen in the above picture.
341
+ - Several core symbols were renamed for consistency ([ #815 ] [ gd-815 ] ):
342
+ ` RefInstance ` -> ` TInstance ` and ` TypedArray ` -> ` PoolArray ` , among others.
343
+ - Another refactoring affects the ` Variant ` conversion methods ([ #819 ] [ gd-819 ] ).
344
+ Instead of ` Variant::to_i64() ` which may silently fail and return a default
345
+ value (Godot behavior), the recommended method is now ` Variant::to<T>() ` . This
346
+ enables genericity and is more idiomatic in Rust, returning an ` Option ` to
347
+ indicate success or failure.
355
348
356
349
As a binding to a C++ library, one topic godot-rust has to deal with is the use
357
350
of ` unsafe ` , which sometimes boils down to a trade-off between safety and
@@ -360,14 +353,9 @@ philosophies on their execution, see [The CXX Debate][gd-cxx] for an example.
360
353
To discuss how APIs interacting with Godot can as ergonomic as possible while
361
354
preserving safety, [ issue #808 ] [ gd-808 ] was opened.
362
355
363
- Smaller changes include safety bugfixes ([ #795 ] [ gd-795 ] ) or a
364
- ` GodotString::format() ` method ([ #816 ] [ gd-816 ] ).
365
-
366
- [ gd-795 ] : https://github.com/godot-rust/godot-rust/pull/795
367
356
[ gd-808 ] : https://github.com/godot-rust/godot-rust/pull/808
368
357
[ gd-811 ] : https://github.com/godot-rust/godot-rust/pull/811
369
358
[ gd-815 ] : https://github.com/godot-rust/godot-rust/pull/815
370
- [ gd-816 ] : https://github.com/godot-rust/godot-rust/pull/816
371
359
[ gd-819 ] : https://github.com/godot-rust/godot-rust/pull/819
372
360
373
361
[ gd-cxx ] : https://steveklabnik.com/writing/the-cxx-debate
0 commit comments