Deprecate enable_logging! in favour of configuring logging yourself

CHANGELOG.md

@@ -12,6 +12,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `ErasedStorage`, a storage with an erased error type.
 - Allow the storage generic `S` be `?Sized` in `Dialogue` and `HandlerExt::enter_dialogue`.
 
+### Deprecated
+
+- `enable_logging!` macro
+
 ### Fixed
 
 - Log `UpdateKind::Error` in `teloxide::dispatching2::Dispatcher`.

examples/README.md

@@ -1,7 +1,7 @@
 # Usage
 
 ```
-$ cargo run --features="full" --example <example-name>
+$ RUST_LOF=info cargo run --features="full" --example <example-name>
 ```
 
 Don't forget to initialise the `TELOXIDE_TOKEN` environmental variable.

examples/admin.rs

@@ -144,7 +144,7 @@ async fn action(
 
 #[tokio::main]
 async fn main() {
-    teloxide::enable_logging!();
+    pretty_env_logger::init();
     log::info!("Starting admin_bot...");
 
     let bot = teloxide::Bot::from_env().auto_send();

examples/buttons.rs

@@ -114,7 +114,7 @@ async fn callback_handler(
 
 #[tokio::main]
 async fn main() -> Result<(), Box<dyn Error>> {
-    teloxide::enable_logging!();
+    pretty_env_logger::init();
     log::info!("Starting bot...");
 
     let bot = Bot::from_env().auto_send();

examples/db_remember.rs

@@ -43,6 +43,9 @@ pub enum Command {
 
 #[tokio::main]
 async fn main() {
+    pretty_env_logger::init();
+    log::info!("Starting db_remember_bot...");
+
     let bot = Bot::from_env().auto_send();
 
     let storage: MyStorage = if std::env::var("DB_REMEMBER_REDIS").is_ok() {

examples/dialogue.rs

@@ -41,7 +41,7 @@ impl Default for State {
 
 #[tokio::main]
 async fn main() {
-    teloxide::enable_logging!();
+    pretty_env_logger::init();
     log::info!("Starting dialogue_bot...");
 
     let bot = Bot::from_env().auto_send();

examples/dices.rs

@@ -4,7 +4,7 @@ use teloxide::prelude2::*;
 
 #[tokio::main]
 async fn main() {
-    teloxide::enable_logging!();
+    pretty_env_logger::init();
     log::info!("Starting dices_bot...");
 
     let bot = Bot::from_env().auto_send();

examples/dispatching2_features.rs

@@ -13,7 +13,7 @@ use teloxide::{
 
 #[tokio::main]
 async fn main() {
-    teloxide::enable_logging!();
+    pretty_env_logger::init();
     log::info!("Starting dispatching2_features_bot...");
 
     let bot = Bot::from_env().auto_send();

examples/heroku_ping_pong.rs

@@ -36,7 +36,7 @@ use reqwest::{StatusCode, Url};
 
 #[tokio::main]
 async fn main() {
-    teloxide::enable_logging!();
+    pretty_env_logger::init();
     log::info!("Starting heroku_ping_pong_bot...");
 
     let bot = Bot::from_env().auto_send();

examples/inline.rs

@@ -8,7 +8,7 @@ use teloxide::{
 
 #[tokio::main]
 async fn main() {
-    teloxide::enable_logging!();
+    pretty_env_logger::init();
     log::info!("Starting inline_bot...");
 
     let bot = Bot::from_env().auto_send();

examples/ngrok_ping_pong.rs

@@ -19,7 +19,7 @@ use reqwest::{StatusCode, Url};
 
 #[tokio::main]
 async fn main() {
-    teloxide::enable_logging!();
+    pretty_env_logger::init();
     log::info!("Starting heroku_ping_pong_bot...");
 
     let bot = Bot::from_env().auto_send();

examples/shared_state.rs

@@ -9,7 +9,7 @@ static MESSAGES_TOTAL: Lazy<AtomicU64> = Lazy::new(AtomicU64::default);
 
 #[tokio::main]
 async fn main() {
-    teloxide::enable_logging!();
+    pretty_env_logger::init();
     log::info!("Starting shared_state_bot...");
 
     let bot = Bot::from_env().auto_send();

examples/simple_commands.rs

@@ -37,7 +37,7 @@ async fn answer(
 
 #[tokio::main]
 async fn main() {
-    teloxide::enable_logging!();
+    pretty_env_logger::init();
     log::info!("Starting simple_commands_bot...");
 
     let bot = Bot::from_env().auto_send();

src/logging.rs

@@ -10,8 +10,10 @@
 ///
 /// [pretty-env-logger]: https://crates.io/crates/pretty_env_logger
 #[macro_export]
+#[deprecated = "Choose logging implementation yourself"]
 macro_rules! enable_logging {
     () => {
+        #[allow(deprecated)]
         teloxide::enable_logging_with_filter!(log::LevelFilter::Trace);
     };
 }
@@ -39,6 +41,7 @@ macro_rules! enable_logging {
 /// [pretty-env-logger]: https://crates.io/crates/pretty_env_logger
 /// [`LevelFilter::Debug`]: https://docs.rs/log/0.4.10/log/enum.LevelFilter.html
 #[macro_export]
+#[deprecated = "Choose logging implementation yourself"]
 macro_rules! enable_logging_with_filter {
     ($filter:expr) => {
         pretty_env_logger::formatted_builder()