Update versions

Author: GuillaumeGomez

_data/crates.json

@@ -1,35 +1,35 @@
 [
   {
     "name": "cairo-rs",
-    "max_version": "0.7.0"
+    "max_version": "0.8.0"
   },
   {
     "name": "gdk",
-    "max_version": "0.11.0"
+    "max_version": "0.12.0"
   },
   {
     "name": "gdk-pixbuf",
-    "max_version": "0.7.0"
+    "max_version": "0.8.0"
   },
   {
     "name": "gio",
-    "max_version": "0.7.0"
+    "max_version": "0.8.0"
   },
   {
     "name": "glib",
-    "max_version": "0.8.0"
+    "max_version": "0.9.0"
   },
   {
     "name": "gtk",
-    "max_version": "0.7.0"
+    "max_version": "0.8.0"
   },
   {
     "name": "pango",
-    "max_version": "0.7.0"
+    "max_version": "0.8.0"
   },
   {
     "name": "sourceview",
-    "max_version": "0.7.0"
+    "max_version": "0.8.0"
   }
 ]
 

_posts/2019-12-14-new-release.md renamed to _posts/2019-12-15-new-release.md

@@ -1,12 +1,116 @@
 ---
 layout: post
 author: GuillaumeGomez
-title: Simplification and more everything
+title: Simplification and more of everything
 categories: [front, crates]
-date: 2019-12-14 16:00:00 +0000
+date: 2019-12-15 19:00:00 +0000
 ---
 
-* Write intro here *
+Hello everyone, time for a new release!
+
+This time, this is mostly about stabilization and simplification. It means that `gtk-rs` is now
+simpler to use and more complete than ever. Let's take a tour of what's new(er)!
+
+### Macro to make gtk-rs usage far simpler
+
+A big productivity killer when using `gtk-rs` in the past was the requirement to pass cloned
+references to objects, or even worse, weak references into signal handler closures. This is still
+required but to make it more ergonomic, a new `clone!` macro is provided as part of `glib`.
+
+See the [documentation](https://docs.rs/glib/0.9.0/glib/macro.clone.html) for various examples on
+how to use it. The big advantage of the macro is that you don't have to manually declare new local
+variables with a different name that are then moved into the closure, but simply have to provide the
+name of the variable you want to make available in the closure and whether it should be passed as a
+strong or weak reference. Inside the closure it can then be used as-is and for example upgrading any
+weak references manually is not necessary. In case of failure of upgrading a weak reference, an
+optional default return value for the closure can be provided or the closure can be configured to
+panic.
+
+The macro works on any `glib::Object` as well as on any `Arc` and `Rc`.
+
+As a side-note, it is important to know the difference between strong and weak references and not
+simply clone (strong reference) everything. By using strong references everywhere, many GTK
+applications (not only in Rust) currently create reference cycles and therefore have memory leaks.
+If, for example, you want to pass a reference to your `Window` into a `Button`'s `clicked` signal,
+you would create a reference cycle between the window, button, signal handler and again the window.
+This would lead to the whole cycle to be kept alive forever and leaked. The solution to this is to
+make one of the references a weak reference, in this case the reference to the window that is
+passed into the `clicked` signal handler. See also the `Rc` documentation about
+[reference cycles](https://doc.rust-lang.org/std/rc/index.html).
+
+### Subclass
+
+The "subclass" cargo feature was removed from all crates and is instead enabled by default with
+this release. The GObject subclassing support matured a lot over the last months and is ready for
+wider usage. A basic example for subclassing `gtk::Application` and `gtk::ApplicationWindow` can
+be found [here](https://github.com/gtk-rs/examples/blob/master/src/bin/basic_subclass.rs), another
+example using custom `glib::Object` subclasses as part of a `gtk::ListBox` model can be found
+[here](https://github.com/gtk-rs/examples/blob/master/src/bin/listbox_model.rs) and various examples
+for creating GStreamer elements [here](https://gitlab.freedesktop.org/gstreamer/gst-plugins-rs).
+
+While there are still subclassing bindings missing for many types, various basic types in the `gio`,
+`gtk` and `gstreamer` crates are covered already. If something is missing for you, please let us
+know with an issue or, even better, a pull request.
+
+Thanks to subclassing being a first-class citizen of the bindings, there is also an adapter
+available for making any `std::io::Read` available as `gio::InputStream` and any `std::io::Write`
+as `gio::OutputStream`: `gio::ReadInputStream` and `gio::WriteOutputStream`. Adapters in the other
+direction are available as `gio::InputStream::into_read()` and `gio::OutputStream::into_write()`.
+
+### Futures
+
+The futures support was ported to `std` `Future`s and `futures` 0.3, and as `async/await` is
+stabilized now it was also enabled by default. The "futures" feature is not needed anymore.
+
+With the futures support in `gio` and other modules it is now possible to write applications making
+use of asynchronous I/O with `async/await`, which allows writing asynchronous code in a much simpler
+way that looks close to the equivalent synchronous code. Check
+[async/await stable](https://blog.rust-lang.org/2019/11/07/Async-await-stable.html) on the official
+Rust blog for more details.
+
+An example making use of this with `gio`'s asynchronous file reading support can be found
+[here](https://github.com/gtk-rs/examples/blob/master/src/bin/gio_futures_await.rs). While it is
+not as streamlined as with native Rust crates like [async-std](https://async.rs) or
+[tokio](https://tokio.rs) because of how the `gio` API works, it nonetheless much more convenient
+to work with than the previous (but still available) callback-based approach.
+
+Another example that shows integration of `gio` with generic Rust futures crates can be found
+[here](https://github.com/gtk-rs/examples/blob/pending/src/bin/gio_async_tls.rs) . Each
+`gio::PollableInputStream` and `gio::PollableOutputStream` can be converted into an `AsyncRead` /
+`AsyncWrite`, and by this allows integration with the wider Rust async ecosystem. In this case a
+`gio` TCP connection is wrapped in a TLS connection provided by the `async-tls` crate, which uses
+`rustls` as underlying TLS implementation.
+
+### GTK4
+
+We have initial GTK4 bindings now, which are the result of [@sfanxiang][@sfanxiang]'s
+GSoC project this year. While not part of this release because GTK4 itself is still not API stable,
+you can also try it from git. The GTK4 bindings can be found [here](https://github.com/gtk-rs/gtk4).
+Once there are release candidates of GTK4 we will also do alpha releases of the bindings.
+
+### Cairo improvements
+
+The `cairo` bindings now consistently return `Result`s for various functions instead of sometimes
+`Option`s, sometimes silently failing. Many `cairo` operations return an actual `Surface` in an
+error state if something goes wrong, and this surface will then (usually silently) fail any future
+operations on it. Instead of returning the surface, an `Err` is returned now as it should.
+
+### GTK Builder improvements
+
+In `gtk::Builder` UI description files it is possible to declare signal handlers for the widgets.
+While it's not possible to connect them automatically to functions in Rust in a safe way, it is now
+possible for applications to implement the connection logic themselves based on the information from
+the UI description. `gtk::Builder::connect_signals_full()` allows to provide closures for each
+signal handler name that is given in the UI description.
+
+### `glib::Value::get` improvements
+
+`glib::Value::get()` was changed to allow distinguishing between the value containing a `None` and
+trying to get a value of the wrong type out of it. This means that it now returns a `Result`, and
+also that for types that can't possibly be `None` (e.g. integer types), `Value::get_some()` is
+provided as a helper to not require unwrapping the returned `Option` from the normal `Value::get()`.
+
+That's it for biggest changes. A lot of other small ones are in as well. So enjoy!
 
 ### Changes
 
@@ -16,29 +120,23 @@ For the interested ones, here is the list of the merged pull requests:
 
  * [Update with eoan's gir-files](https://github.com/gtk-rs/sys/pull/138)
  * [Add gtk4 files](https://github.com/gtk-rs/sys/pull/145)
- * [Regen](https://github.com/gtk-rs/sys/pull/148)
  * [Remove graphene](https://github.com/gtk-rs/sys/pull/149)
- * [Regen](https://github.com/gtk-rs/sys/pull/150)
- * [Regen](https://github.com/gtk-rs/sys/pull/152)
  * [Update minimum rust version to 1.39](https://github.com/gtk-rs/sys/pull/155)
  * [Use tempfile in tests](https://github.com/gtk-rs/sys/pull/154)
 
 [glib](https://github.com/gtk-rs/glib):
 
  * [New version](https://github.com/gtk-rs/glib/pull/502)
- * [Regen](https://github.com/gtk-rs/glib/pull/504)
  * [Zeroed](https://github.com/gtk-rs/glib/pull/505)
  * [Fix handling of GValues containing a floating GObject](https://github.com/gtk-rs/glib/pull/506)
- * [Publish new 0 8](https://github.com/gtk-rs/glib/pull/507)
  * [Implement FromGlib and ToGlib traits on Pid type](https://github.com/gtk-rs/glib/pull/508)
  * [Mark ByteArray::set_size() as unsafe](https://github.com/gtk-rs/glib/pull/512)
- * [ Value::get: return a Result to account for type mismatch...](https://github.com/gtk-rs/glib/pull/513)
+ * [Value::get: return a Result to account for type mismatch...](https://github.com/gtk-rs/glib/pull/513)
  * [Remove tests which panic in signals](https://github.com/gtk-rs/glib/pull/519)
  * [value::GetError: add a constructor and make fields public](https://github.com/gtk-rs/glib/pull/517)
  * [Improve docs.rs documentation](https://github.com/gtk-rs/glib/pull/511)
  * [Remove subclass feature](https://github.com/gtk-rs/glib/pull/521)
  * [Fully qualify inner macros for exported macros...](https://github.com/gtk-rs/glib/pull/522)
- * [Publish new 0.8](https://github.com/gtk-rs/glib/pull/523)
  * [Fix invalid cargo key for docs.rs](https://github.com/gtk-rs/glib/pull/524)
  * [Implement Value::transform()](https://github.com/gtk-rs/glib/pull/525)
  * [remove not needed anymore libffi fix](https://github.com/gtk-rs/glib/pull/528)
@@ -55,8 +153,6 @@ For the interested ones, here is the list of the merged pull requests:
  * [KeyFile::get_string() can return a string in error case that still ha…](https://github.com/gtk-rs/glib/pull/544)
  * [Remove glib_floating_reference_guard!() macro](https://github.com/gtk-rs/glib/pull/548)
  * [Manually implement FFI code for GObject instead of using glib_shared_wrapper!](https://github.com/gtk-rs/glib/pull/547)
- * [Regen](https://github.com/gtk-rs/glib/pull/549)
- * [Regen](https://github.com/gtk-rs/glib/pull/550)
 
 [cairo](https://github.com/gtk-rs/cairo):
 
@@ -77,40 +173,31 @@ For the interested ones, here is the list of the merged pull requests:
 
 [sourceview](https://github.com/gtk-rs/sourceview):
 
- * [Regen](https://github.com/gtk-rs/sourceview/pull/103)
  * [Fix boxing in async func](https://github.com/gtk-rs/sourceview/pull/107)
  * [Improve docs.rs documentation](https://github.com/gtk-rs/sourceview/pull/105)
  * [better handling of dox feature](https://github.com/gtk-rs/sourceview/pull/108)
  * [Use IsA for property setters](https://github.com/gtk-rs/sourceview/pull/110)
  * [Generate builders](https://github.com/gtk-rs/sourceview/pull/111)
  * [Builder use implemented interfaces properties](https://github.com/gtk-rs/sourceview/pull/112)
  * [Fix invalid cargo key for docs.rs](https://github.com/gtk-rs/sourceview/pull/113)
- * [Regen](https://github.com/gtk-rs/sourceview/pull/114)
  * [Use tempfile in tests](https://github.com/gtk-rs/sourceview/pull/115)
  * [Derive Default, Clone for builders](https://github.com/gtk-rs/sourceview/pull/116)
  * [Regen](https://github.com/gtk-rs/sourceview/pull/117)
 
 [atk](https://github.com/gtk-rs/atk):
 
- * [New version](https://github.com/gtk-rs/atk/pull/33)
- * [Regen](https://github.com/gtk-rs/atk/pull/34)
  * [Improve docs.rs documentation](https://github.com/gtk-rs/atk/pull/35)
  * [Update for new `Value::get` signature](https://github.com/gtk-rs/atk/pull/36)
  * [better handling of docs.rs features](https://github.com/gtk-rs/atk/pull/37)
  * [Use IsA for property setters](https://github.com/gtk-rs/atk/pull/38)
  * [Fix invalid cargo key for docs.rs](https://github.com/gtk-rs/atk/pull/39)
  * [remove not needed anymore libffi fix](https://github.com/gtk-rs/atk/pull/40)
- * [Regen](https://github.com/gtk-rs/atk/pull/41)
- * [Regen](https://github.com/gtk-rs/atk/pull/43)
  * [Update minimum required rust version](https://github.com/gtk-rs/atk/pull/44)
- * [Regen](https://github.com/gtk-rs/atk/pull/45)
 
 [gio](https://github.com/gtk-rs/gio):
 
  * [Fix docs for manual functions \[ci skip\]](https://github.com/gtk-rs/gio/pull/224)
- * [Regen](https://github.com/gtk-rs/gio/pull/225)
  * [New version](https://github.com/gtk-rs/gio/pull/227)
- * [Regen](https://github.com/gtk-rs/gio/pull/228)
  * [Generate FileEnumerator](https://github.com/gtk-rs/gio/pull/229)
  * [Improve docs.rs documentation](https://github.com/gtk-rs/gio/pull/231)
  * [Update for new `Value::get` signature](https://github.com/gtk-rs/gio/pull/233)
@@ -137,38 +224,29 @@ For the interested ones, here is the list of the merged pull requests:
  * [Derive Default, Clone for builders](https://github.com/gtk-rs/gio/pull/259)
  * [Remove usage of glib_floating_reference_guard!()](https://github.com/gtk-rs/gio/pull/260)
  * [Fix some clippy warnings by removing unused lifetime parameters](https://github.com/gtk-rs/gio/pull/261)
- * [Regen](https://github.com/gtk-rs/gio/pull/262)
 
 [pango](https://github.com/gtk-rs/pango):
 
- * [regen](https://github.com/gtk-rs/pango/pull/155)
  * [Improve docs.rs documentation](https://github.com/gtk-rs/pango/pull/157)
  * [(#156): Manual implementations of PangoGravity functions](https://github.com/gtk-rs/pango/pull/158)
  * [Improve docs.rs handling](https://github.com/gtk-rs/pango/pull/159)
  * [Fix invalid cargo key for docs.rs](https://github.com/gtk-rs/pango/pull/162)
  * [Add pango-glyph interfaces ](https://github.com/gtk-rs/pango/pull/163)
  * [remove not needed anymore libffi fix](https://github.com/gtk-rs/pango/pull/164)
  * [Add PangoAttrSize](https://github.com/gtk-rs/pango/pull/166)
- * [Regen](https://github.com/gtk-rs/pango/pull/169)
- * [Regen](https://github.com/gtk-rs/pango/pull/171)
 
 [gdk-pixbuf](https://github.com/gtk-rs/gdk-pixbuf):
 
- * [Regen](https://github.com/gtk-rs/gdk-pixbuf/pull/127)
  * [Update for new `Value::get` signature](https://github.com/gtk-rs/gdk-pixbuf/pull/128)
  * [Improve docs.rs documentation](https://github.com/gtk-rs/gdk-pixbuf/pull/129)
  * [Improve docs.rs handling](https://github.com/gtk-rs/gdk-pixbuf/pull/130)
  * [Fix invalid cargo key for docs.rs](https://github.com/gtk-rs/gdk-pixbuf/pull/131)
  * [remove not needed anymore libffi fix](https://github.com/gtk-rs/gdk-pixbuf/pull/132)
- * [Regen](https://github.com/gtk-rs/gdk-pixbuf/pull/133)
- * [Regenerate with latest gir](https://github.com/gtk-rs/gdk-pixbuf/pull/134)
- * [Regen](https://github.com/gtk-rs/gdk-pixbuf/pull/135)
 
 [gdk](https://github.com/gtk-rs/gdk):
 
  * [Fix docs for manual functions \[ci skip\]](https://github.com/gtk-rs/gdk/pull/299)
  * [Fix build after #299](https://github.com/gtk-rs/gdk/pull/302)
- * [Regen](https://github.com/gtk-rs/gdk/pull/303)
  * [Improve docs.rs documentation](https://github.com/gtk-rs/gdk/pull/305)
  * [Update for new `Value::get` signature](https://github.com/gtk-rs/gdk/pull/307)
  * [Cairo interactions: auto load Pixbuf & Surface Exts](https://github.com/gtk-rs/gdk/pull/309)
@@ -180,17 +258,13 @@ For the interested ones, here is the list of the merged pull requests:
  * [Fix invalid cargo key for docs.rs](https://github.com/gtk-rs/gdk/pull/316)
  * [remove not needed anymore libffi fix](https://github.com/gtk-rs/gdk/pull/317)
  * [Generate Keymap bindings](https://github.com/gtk-rs/gdk/pull/311)
- * [Regen](https://github.com/gtk-rs/gdk/pull/318)
  * [Don't reexport prelude content](https://github.com/gtk-rs/gdk/pull/319)
- * [Regen](https://github.com/gtk-rs/gdk/pull/320)
 
 [gtk](https://github.com/gtk-rs/gtk):
 
  * [Fix docs for manual functions \[ci skip\]](https://github.com/gtk-rs/gtk/pull/832)
  * [PadController is disguised so trait don't needed](https://github.com/gtk-rs/gtk/pull/839)
  * [Make PadController::set_action_entries() public so it can actually be…](https://github.com/gtk-rs/gtk/pull/841)
- * [New version](https://github.com/gtk-rs/gtk/pull/845)
- * [Regen](https://github.com/gtk-rs/gtk/pull/849)
  * [Implement Builder::connect_signals_full](https://github.com/gtk-rs/gtk/pull/852)
  * [Generate GtkWindowExt::set_geometry_hints](https://github.com/gtk-rs/gtk/pull/857)
  * [subclass: Get started on subclassing GtkWidget](https://github.com/gtk-rs/gtk/pull/861)
@@ -220,29 +294,26 @@ For the interested ones, here is the list of the merged pull requests:
  * [Fix format issue](https://github.com/gtk-rs/gtk/pull/903)
  * [remove not needed anymore libffi fix](https://github.com/gtk-rs/gtk/pull/904)
  * [subclass: Always allow to override the vfuns of classes](https://github.com/gtk-rs/gtk/pull/908)
- * [Regen](https://github.com/gtk-rs/gtk/pull/910)
  * [Fix various imports to fix the build](https://github.com/gtk-rs/gtk/pull/911)
  * [Make AccelGroup::connect() and ::connect_by_path() more usable](https://github.com/gtk-rs/gtk/pull/915)
  * [Add renaming for WidgetExt::set_name and BuildableExt::set_name](https://github.com/gtk-rs/gtk/pull/917)
- * [Regenerate with latest gir](https://github.com/gtk-rs/gtk/pull/918)
  * [Derive Default for builders](https://github.com/gtk-rs/gtk/pull/919)
  * [subclass/container: widget in set_focu_child should be Nullable](https://github.com/gtk-rs/gtk/pull/922)
  * [subclass/widget: Implement default handling for parent events](https://github.com/gtk-rs/gtk/pull/921)
- * [Regen](https://github.com/gtk-rs/gtk/pull/923)
 
 [pangocairo](https://github.com/gtk-rs/pangocairo):
 
  * [Fix docs for manual functions \[ci skip\]](https://github.com/gtk-rs/pangocairo/pull/53)
  * [Improve docs.rs documentation](https://github.com/gtk-rs/pangocairo/pull/54)
  * [Fix invalid cargo key for docs.rs](https://github.com/gtk-rs/pangocairo/pull/55)
  * [remove not needed anymore libffi fix](https://github.com/gtk-rs/pangocairo/pull/57)
- * [Regen](https://github.com/gtk-rs/pangocairo/pull/58)
  * [Fix build and reexports](https://github.com/gtk-rs/pangocairo/pull/59)
- * [Regen](https://github.com/gtk-rs/pangocairo/pull/61)
  * [Make FontMap::set_default() a static function and allow passing None …](https://github.com/gtk-rs/pangocairo/pull/62)
 
 [gtk-test](https://github.com/gtk-rs/gtk-test):
 
+ * [Update to last versions](https://github.com/gtk-rs/gtk-test/pull/32)
+
 
 All this was possible thanks to the [gtk-rs/gir](https://github.com/gtk-rs/gir) project as well:
 
@@ -272,7 +343,7 @@ All this was possible thanks to the [gtk-rs/gir](https://github.com/gtk-rs/gir)
  * [Add generic parameters to builder methods](https://github.com/gtk-rs/gir/pull/853)
  * [Fix invalid import add](https://github.com/gtk-rs/gir/pull/858)
  * [Remove dependencies](https://github.com/gtk-rs/gir/pull/855)
- * [Extend gpointer to void*](https://github.com/gtk-rs/gir/pull/860)
+ * [Extend gpointer to void\*](https://github.com/gtk-rs/gir/pull/860)
  * [Fix missing parenthesis on return types](https://github.com/gtk-rs/gir/pull/861)
  * [Add missing from_glib conversion for Pid](https://github.com/gtk-rs/gir/pull/864)
  * [Correctly generate glib::Error import](https://github.com/gtk-rs/gir/pull/863)
@@ -304,7 +375,9 @@ Thanks to all of our contributors for their (awesome!) work on this release:
  * [@nipunn1313](https://github.com/nipunn1313)
  * [@RazrFalcon](https://github.com/RazrFalcon)
  * [@sdroege](https://github.com/sdroege)
- * [@sfanxiang](https://github.com/sfanxiang)
+ * [@sfanxiang][@sfanxiang]
  * [@silwol](https://github.com/silwol)
  * [@timbodeit](https://github.com/timbodeit)
  * [@velyan](https://github.com/velyan)
+
+[@sfanxiang]: https://github.com/sfanxiang