mark crate and entire functionality as deprecated and obsolete

Author: decathorpe

Cargo.toml

@@ -35,3 +35,5 @@ env_logger = "0.10"
 rpassword = "7"
 tokio = { version = "1.14.0", features = ["macros", "rt-multi-thread"] }
 
+[badges]
+maintenance = { status = "deprecated" }

README.md

@@ -1,27 +1,18 @@
-# base library for interacting with Fedora services
+# base library for interacting with Fedora services (DEPRECATED)
 
 [![crates.io](https://img.shields.io/crates/v/fedora.svg)](https://crates.io/crates/fedora/)
 [![crates.io](https://img.shields.io/crates/d/fedora.svg)](https://crates.io/crates/fedora/)
 [![crates.io](https://img.shields.io/crates/l/fedora.svg)](https://crates.io/crates/fedora/)
 [![docs.rs](https://docs.rs/fedora/badge.svg)](https://docs.rs/fedora/)
 
-This crate provides a base for interacting with Fedora web services.
-
-It is intended to provide functionality similar to the [`fedora`][fedora.py]
-Python package, but for Rust.
-
-Refer to the docs on [docs.rs] for a complete description of the functionality
-of this crate.
-
-[docs.rs]: https://docs.rs/fedora
-[fedora.py]: https://github.com/fedora-infra/python-fedora
-
-## DONE
-
-- OpenID authentication
-
-## TODO
-
-- authenticating with OpenID Connect
-- authenticating for FAS2, wiki
-
+**WARNING**: The OpenID-based authentication method for Fedora web services that
+was provided by this crate no longer works. Most web services that are part of
+the Fedora Project have moved to OpenID Connect (OIDC) or Kerberos-based
+authentication. Bodhi was one of the last services that provided a deprecated
+OpenID authentication endpoint, but that endpoint was accidentally broken in
+bodhi-server v8.0.0 and can likely not be fixed. That makes the `fedora` crate
+obsolete.
+
+If another project that is related with the Fedora Project wants to use the "fedora"
+name to publish on crates.io, transfer of ownership of the name can be discussed.
+Please open a ticket on GitHub in this case.

src/lib.rs

@@ -8,6 +8,13 @@
 #![warn(missing_debug_implementations)]
 #![warn(clippy::unwrap_used)]
 
+#![deprecated(
+    note = "The \"fedora\" crate is obsolete.
+    The OpenID-based authentication method for Fedora web services provided by this crate no longer works.
+    There is currently no known replacement.",
+    since = "2.1.2",
+)]
+
 use std::time::Duration;
 
 /// default value of the User-Agent HTTP header: `fedora-rs v$CARGO_PKG_VERSION`