@@ -333,25 +333,18 @@ is a Rust library that provides bindings for the Godot game engine.
333333
334334November has been a month of refactoring for godot-rust. The API was cleaned up
335335across 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.
355348
356349As a binding to a C++ library, one topic godot-rust has to deal with is the use
357350of ` 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.
360353To discuss how APIs interacting with Godot can as ergonomic as possible while
361354preserving safety, [ issue #808 ] [ gd-808 ] was opened.
362355
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
367356[ gd-808 ] : https://github.com/godot-rust/godot-rust/pull/808
368357[ gd-811 ] : https://github.com/godot-rust/godot-rust/pull/811
369358[ gd-815 ] : https://github.com/godot-rust/godot-rust/pull/815
370- [ gd-816 ] : https://github.com/godot-rust/godot-rust/pull/816
371359[ gd-819 ] : https://github.com/godot-rust/godot-rust/pull/819
372360
373361[ gd-cxx ] : https://steveklabnik.com/writing/the-cxx-debate
0 commit comments