\ No newline at end of file
diff --git a/index.cljs.html b/index.cljs.html
index 50ed56f..ce61ce7 100644
--- a/index.cljs.html
+++ b/index.cljs.html
@@ -1,4 +1,4 @@
-Telemere 1.0.0-alpha3
\ No newline at end of file
diff --git a/index.html b/index.html
index 34015de..3972a89 100644
--- a/index.html
+++ b/index.html
@@ -1,3 +1,3 @@
-Telemere 1.0.0-alpha3
\ No newline at end of file
diff --git a/taoensso.telemere.cljs.html b/taoensso.telemere.cljs.html
index 4514bd8..88dafc9 100644
--- a/taoensso.telemere.cljs.html
+++ b/taoensso.telemere.cljs.html
@@ -1,6 +1,6 @@
-taoensso.telemere documentation
Structured telemetry for Clojure/Script applications.
See the GitHub page (esp. Wiki) for info on motivation and design:
<https://www.taoensso.com/telemere>
Dynamic context: arbitrary user-level state attached as `:ctx` to all signals.
@@ -305,9 +305,10 @@ See also:
If anything is unclear, please ping me (@ptaoussanis) so that I can
improve these docs!
The handler API consists of the following:
- `get-handlers` - Returns info on currently registered handlers
- `add-handler!` - Used to register handlers
- `remove-handler!` - Used to unregister handlers
+ `get-handlers` - Returns info on currently registered handlers
+ `add-handler!` - Used to register handlers
+ `remove-handler!` - Used to unregister handlers
+ `shut-down-handlers!` - Used to shut down handlers
See the relevant docstrings for details.
@@ -499,7 +500,11 @@ will apply only for that signal kind.
(signal! {:as opts, :keys [elidable? location inst uid middleware sample-rate kind ns id level when rate-limit ctx parent trace? do let data msg error run & extra-kvs]})
Low-level generic signal call.
+the new value. Cross-platform. See also `update-var-root!`.
Shuts down all registered signal handlers and returns
+?{<handler-id> {:keys [okay error]}}.
+
+Future calls to handlers will no-op.
+Clj only: `shut-down-handlers!` is called automatically on JVM shutdown.
(signal! {:as opts, :keys [elidable? location inst uid middleware sample-rate kind ns id level when rate-limit ctx parent trace? do let data msg error run & extra-kvs]})
Structured telemetry for Clojure/Script applications.
See the GitHub page (esp. Wiki) for info on motivation and design:
<https://www.taoensso.com/telemere>
Dynamic context: arbitrary user-level state attached as `:ctx` to all signals.
@@ -331,9 +331,10 @@ See also:
If anything is unclear, please ping me (@ptaoussanis) so that I can
improve these docs!
The handler API consists of the following:
- `get-handlers` - Returns info on currently registered handlers
- `add-handler!` - Used to register handlers
- `remove-handler!` - Used to unregister handlers
+ `get-handlers` - Returns info on currently registered handlers
+ `add-handler!` - Used to register handlers
+ `remove-handler!` - Used to unregister handlers
+ `shut-down-handlers!` - Used to shut down handlers
See the relevant docstrings for details.
@@ -533,7 +534,11 @@ will apply only for that signal kind.
(signal! {:as opts, :keys [elidable? location inst uid middleware sample-rate kind ns id level when rate-limit ctx parent trace? do let data msg error run & extra-kvs]})
Low-level generic signal call.
+the new value. Cross-platform. See also `update-var-root!`.
Shuts down all registered signal handlers and returns
+?{<handler-id> {:keys [okay error]}}.
+
+Future calls to handlers will no-op.
+Clj only: `shut-down-handlers!` is called automatically on JVM shutdown.
(signal! {:as opts, :keys [elidable? location inst uid middleware sample-rate kind ns id level when rate-limit ctx parent trace? do let data msg error run & extra-kvs]})
Low-level generic signal call.
API: [opts] => depends on options [3]
Default kind: none (optional)
diff --git a/taoensso.telemere.timbre.cljs.html b/taoensso.telemere.timbre.cljs.html
new file mode 100644
index 0000000..5b2496f
--- /dev/null
+++ b/taoensso.telemere.timbre.cljs.html
@@ -0,0 +1,4 @@
+
+taoensso.telemere.timbre documentation
Main Timbre macros, reimplemented on top of Telemere.
+Intended to help ease migration from Timbre to Telemere.
\ No newline at end of file
diff --git a/taoensso.telemere.timbre.html b/taoensso.telemere.timbre.html
new file mode 100644
index 0000000..baf1cc0
--- /dev/null
+++ b/taoensso.telemere.timbre.html
@@ -0,0 +1,28 @@
+
+taoensso.telemere.timbre documentation
\ No newline at end of file
diff --git a/taoensso.telemere.utils.cljs.html b/taoensso.telemere.utils.cljs.html
index 619eb14..8b22089 100644
--- a/taoensso.telemere.utils.cljs.html
+++ b/taoensso.telemere.utils.cljs.html
@@ -1,6 +1,6 @@
-taoensso.telemere.utils documentation
Experimental, subject to change.
Returns given signal with possible `:error` replaced by
[{:keys [type msg data]} ...] cause chain.
@@ -10,14 +10,14 @@ Returns true iff given signal has an `:error` value, or a `:kind` or `:level`
that indicates that it's an error.
Experimental, subject to change.
Returns a (fn format [error]) that:
- Takes a platform error (`Throwable` or `js/Error`).
- - Returns a formatted human-readable string
Experimental, subject to change without notice.
Returns a (fn format [instant]) that:
- Takes a platform instant (`java.time.Instant` or `js/Date`).
- Returns a formatted human-readable string.
Options:
- `:zone` (Clj only) - `java.time.ZoneOffset` (defaults to UTC).
+ `:zone` (Clj only) `java.time.ZoneOffset` (defaults to UTC).
`:formatter`
`java.time.format.DateTimeFormatter` (Clj) or
`goog.i18n.DateTimeFormat` (Cljs),
@@ -54,5 +54,5 @@ Returns minimal signal map, removing:
Useful when serializing signals to edn/JSON/etc.
Prints given arg to an edn string readable with `read-edn`.
-
pr-json
cljs
added in Encore vX.Y.Z (YYYY-MM-DD)
(pr-json x)
Returns given Cljs argument as JSON string.
+
pr-json
cljs
added in Encore v3.98.0 (2024-04-08)
(pr-json x)
Returns given Cljs argument as JSON string.
\ No newline at end of file
diff --git a/taoensso.telemere.utils.html b/taoensso.telemere.utils.html
index 12faf75..7a8fa61 100644
--- a/taoensso.telemere.utils.html
+++ b/taoensso.telemere.utils.html
@@ -1,6 +1,6 @@
-taoensso.telemere.utils documentation
Experimental, subject to change.
Returns given signal with possible `:error` replaced by
[{:keys [type msg data]} ...] cause chain.
@@ -19,14 +19,14 @@ Writers MUST ALWAYS be manually closed after use!
Useful for handlers that write to files, etc.
Experimental, subject to change.
Returns a (fn format [error]) that:
- Takes a platform error (`Throwable` or `js/Error`).
- - Returns a formatted human-readable string
(format-inst-fn)(format-inst-fn {:keys [formatter zone], :or {formatter java.time.format.DateTimeFormatter/ISO_INSTANT, zone java.time.ZoneOffset/UTC}})
Experimental, subject to change without notice.
Returns a (fn format [instant]) that:
- Takes a platform instant (`java.time.Instant` or `js/Date`).
- Returns a formatted human-readable string.
Options:
- `:zone` (Clj only) - `java.time.ZoneOffset` (defaults to UTC).
+ `:zone` (Clj only) `java.time.ZoneOffset` (defaults to UTC).
`:formatter`
`java.time.format.DateTimeFormatter` (Clj) or
`goog.i18n.DateTimeFormat` (Cljs),