refactor: make some options non-exhaustive

BREAKING-CHANGE: In order to allow adding new options in the future,
 the structs LoginOptions and LogoutOptions have been made
 non-exhaustive. Adding some documentation on how to work with them.

src/agent/config.rs

@@ -1,8 +1,7 @@
+use super::LoginOptions;
 use crate::agent::Client;
 use std::time::Duration;
 
-use super::LoginOptions;
-
 #[derive(Clone, Debug)]
 pub struct AgentConfiguration<C: Client> {
     pub config: C::Configuration,

src/agent/mod.rs

@@ -25,7 +25,34 @@ use wasm_bindgen::JsValue;
 use wasm_bindgen_futures::spawn_local;
 use yew::Callback;
 
+/// Options for the login process
+///
+/// ## Non-exhaustive struct
+///
+/// The struct is "non exhaustive", which means that it is possible to add fields without breaking the API.
+///
+/// In order to create an instance, follow the following patterns:
+///
+/// ```rust
+/// # use reqwest::Url;
+/// # use yew_oauth2::prelude::LoginOptions;
+/// # let url = Url::parse("https://example.com").unwrap();
+/// let opts = LoginOptions {
+///   redirect_url: Some(url),
+///   ..Default::default()
+/// };
+/// ```
+///
+/// Or use the "with"-style pattern:
+///
+/// ```rust
+/// # use reqwest::Url;
+/// # use yew_oauth2::prelude::LoginOptions;
+/// # let url = Url::parse("https://example.com").unwrap();
+/// let opts = LoginOptions::default().with_redirect_url(url);
+/// ```
 #[derive(Debug, Clone, Default, PartialEq, Eq)]
+#[non_exhaustive]
 pub struct LoginOptions {
     pub query: HashMap<String, String>,
 
@@ -53,12 +80,16 @@ impl LoginOptions {
         self
     }
 
-    pub fn with_redirect_url(mut self, redirect_url: Url) -> Self {
-        self.redirect_url = Some(redirect_url);
+    pub fn with_redirect_url(mut self, redirect_url: impl Into<Url>) -> Self {
+        self.redirect_url = Some(redirect_url.into());
         self
     }
 }
 
+/// Options for the logout process
+///
+///**NOTE**: This is a non-exhaustive struct. See [`LoginOptions`] for an example on how to work with this.
+#[non_exhaustive]
 #[derive(Debug, Clone, Default, PartialEq, Eq)]
 pub struct LogoutOptions {
     /// An optional target to navigate to after the user was logged out.
@@ -67,6 +98,13 @@ pub struct LogoutOptions {
     pub target: Option<Url>,
 }
 
+impl LogoutOptions {
+    pub fn with_target(mut self, target: impl Into<Url>) -> Self {
+        self.target = Some(target.into());
+        self
+    }
+}
+
 pub enum Msg<C>
 where
     C: Client,

src/components/context/mod.rs

@@ -4,11 +4,9 @@ mod agent;
 
 pub use agent::*;
 
-use crate::context::LatestAccessToken;
-use crate::prelude::LoginOptions;
 use crate::{
-    agent::{AgentConfiguration, Client, OAuth2Operations},
-    context::OAuth2Context,
+    agent::{AgentConfiguration, Client, LoginOptions, OAuth2Operations},
+    context::{LatestAccessToken, OAuth2Context},
 };
 use agent::Agent as AgentContext;
 use std::time::Duration;