WIP: Impl/from geo types

CHANGES.md

@@ -1,8 +1,11 @@
 # Changes
 
 ## next release
-### Changed
+### Added
 * impl `std::fmt::Display` for `Wkt`.
+* impls of From for the different types in `geo_types` are added.
+### Changed
+* Trait ToWkt gets deprecated.
 
 ## 0.10.0 - 2022-02-24
 ### Changed

src/lib.rs

@@ -22,24 +22,42 @@
 //!
 //! # Examples
 //!
+//! Parse a WKT string to a type:
+//!
 //! ```
-//! use std::str::FromStr;
 //! use wkt::Wkt;
-//! let point: Wkt<f64> = Wkt::from_str("POINT(10 20)").unwrap();
+//!
+//! let point: Wkt<f64> = "POINT(10 20)".parse().unwrap();
 //! ```
 //!
-//! ```ignore
-//! // Convert to a geo_types primitive from a Wkt struct
-//! use std::convert::TryInto;
+//! Convert to a geo_types primitive from a Wkt struct:
+//!
+//! ```
 //! use wkt::Wkt;
 //! use geo_types::Point;
-//! let point: Wkt<f64> = Wkt::from_str("POINT(10 20)").unwrap();
-//! let g_point: geo_types::Point<f64> = (10., 20.).into();
-// // We can attempt to directly convert the Wkt without having to access its items field
+//!
+//! let point: Wkt<f64> = "POINT(10 20)".parse().unwrap();
 //! let converted: Point<f64> = point.try_into().unwrap();
+//!
+//! let g_point: geo_types::Point<f64> = (10., 20.).into();
+//!
 //! assert_eq!(g_point, converted);
 //! ```
 //!
+//! Take a geo_types structure and get its WKT representation:
+//!
+//! ```
+//! use wkt::Wkt;
+//!
+//! let g_point: geo_types::Point<f64> = (10., 20.).into();
+//! let wkt_point: Wkt<f64> = g_point.into();
+//!
+//! assert_eq!(wkt_point.to_string(), "POINT(10 20)");
+//!
+//! // or use it in a format string
+//! assert_eq!(format!("{wkt_point}"), "POINT(10 20)");
+//! ```
+//!
 //! ## Direct Access to the `item` Field
 //! If you wish to work directly with one of the WKT [`types`] you can match on the `item` field
 //! ```
@@ -84,9 +102,6 @@ extern crate geo_types;
 
 extern crate thiserror;
 
-#[cfg(feature = "geo-types")]
-pub use crate::towkt::ToWkt;
-
 #[cfg(feature = "geo-types")]
 pub mod conversion;