Refactor LogTap module and introduce logging utilities

- Move classes to specific subpackages: interceptor, logger, websocket, utils.
- Add LogTapInterceptor and LoggingWebSocket classes for enhanced logging.
- Introduce newWebSocketWithLogging extension function for WebSocket logging.
- Implement utility functions for logging at various levels (verbose, debug, info, warning, error).
- Update LogTap.kt with synchronized methods and default constructor for Config.
- Modify build.gradle.kts to include LogTap-Noop dependency.

Author: Hussein Habibi Juybari

CHANGELOG.md

@@ -3,6 +3,19 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+### v0.7.0
+Refactor LogTap-Noop module and update UI resources
+
+This commit refactors the LogTap-Noop module by:
+- Moving classes to more specific subpackages (interceptor, logger, websocket, utils).
+- Adding `LogTapInterceptor` and `LoggingWebSocket` classes.
+- Introducing `newWebSocketWithLogging` extension function and `LoggingWebSocketListener`.
+- Adding UI resources (HTML, CSS, JS) for the LogTap web interface.
+- Updating `LogTap.kt` with synchronized methods and a default constructor for `Config`.
+- Adding utility functions `isDebuggable`, `logV`, `logD`, `logI`, `logW`, and `logE`.
+- Deleting old classes: `LogTapInterceptor`, `LogTapLogcatBridge`, `LogTapLogger`, `LogTapSink`, `LogTapSinkAdapter`, and `WsLogging`.
+- Updating the app's build.gradle.kts to use LogTap-Noop.
+
 ### v0.6.0
 Refactor LogTap for improved modularity and WebSocket logging
 

LogTap-Noop/src/main/java/com/github/husseinhj/logtap/LogTap.kt

@@ -3,15 +3,18 @@ package com.github.husseinhj.logtap
 import android.content.Context
 
 object LogTap {
-  fun start(context: Context, config: Config) {}
-  fun stop() {}
-  fun isRunning(): Boolean = false
+    data class Config(
+        val port: Int = 8790,
+        val capacity: Int = 5000,
+        val maxBodyBytes: Long = 64_000,
+        val redactHeaders: Set<String> = setOf("Authorization","Cookie","Set-Cookie"),
+        val enableOnRelease: Boolean = false
+    )
 
-  data class Config(
-    val port: Int = 8790,
-    val capacity: Int = 5000,
-    val maxBodyBytes: Long = 64_000,
-    val redactHeaders: Set<String> = setOf("Authorization","Cookie","Set-Cookie"),
-    val enableOnRelease: Boolean = false
-  )
+    @Synchronized
+    fun start(context: Context, config: Config = Config()) {}
+
+    @Suppress("unused")
+    @Synchronized
+    fun stop() {}
 }

LogTap-Noop/src/main/java/com/github/husseinhj/logtap/LogTapInterceptor.kt

@@ -0,0 +1,23 @@
+package com.github.husseinhj.logtap.interceptor
+
+import okhttp3.*
+
+/**
+ * An OkHttp interceptor that logs HTTP requests and responses to LogTap.
+ *
+ * ### Example usage:
+ * ```kotlin
+ * val client = OkHttpClient.Builder()
+ *     .addInterceptor(LogTapInterceptor())
+ *     .build()
+ * ```
+ *
+ * This interceptor captures request and response details, including headers and bodies (up to a configured limit),
+ * while redacting sensitive headers. It handles various edge cases like streaming bodies, WebSocket upgrades,
+ * and gzip-encoded responses.
+ */
+class LogTapInterceptor : Interceptor {
+    override fun intercept(chain: Interceptor.Chain): Response {
+        return chain.proceed(chain.request())
+    }
+}

LogTap-Noop/src/main/java/com/github/husseinhj/logtap/LogTapLogcatBridge.kt

@@ -0,0 +1,27 @@
+package com.github.husseinhj.logtap.logger
+
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.SupervisorJob
+import kotlinx.coroutines.CoroutineScope
+
+/**
+ * Collects this process's Logcat lines (any android.util.Log usage by your app & libs)
+ * and forwards them to the provided sink.
+ *
+ * No READ_LOGS permission required (own PID only).
+ */
+object LogTapLogcatBridge {
+
+    /** Your hook to send a log event into LogTap. */
+    interface Sink {
+        fun onLog(priority: Char, tag: String, message: String, threadId: Int?, time: String?)
+    }
+
+    /**
+     * Start tailing logcat for **this** PID.
+     * @param sink your receiver that forwards to your in-memory queue / WebSocket / server
+     */
+    fun start(sink: Sink, scope: CoroutineScope = CoroutineScope(SupervisorJob() + Dispatchers.IO)) {}
+
+    fun stop() {}
+}