Provide line number info to CLJS Chrome dev tools, etc.

[domkm]

In ClojureScript, Chrome Developer Tools shows that Timbre logs originate from a line within taoensso.timbre.appenders.core/console-?appender because that is where console.log|warn|error is called. It would be great if logs showed the correct line number. This could be achieved by using macros instead of functions.

[ptaoussanis]

Hi Dom!

Timbre logging calls are done via a macro, in part to capture available ns + line-number info. The appender call itself is intentionally a fn call for simplicity, flexibility, and expansion size. Expanding all appenders in place would balloon a ClojureScript source file quite quickly.

The ideal solution is to convey the line number from the macro call to the appender (fn) call. That way you can include the line number in the log output. That's what the ?line entry is at https://github.com/ptaoussanis/timbre#configuration.

As noted there though, support for this is unfortunately still waiting on http://dev.clojure.org/jira/browse/CLJ-865

If 865 gets resolved, we can update the default output-fn to include the line number.

Will keep this issue open. Haven't looked into this in a while so not sure if any other possibilities/hacks have since come up (esp. on the cljs side).

I've got my hands full atm, but would be happy to hear ideas if you felt like doing the digging yourself?

Cheers! :-)

[domkm]

Hi Peter :)

I missed that ?line comment in the README. Thanks for pointing it out.

However, even with CLJ-865 resolved, I don't think that this will really achieve what I'm looking for, though please correct me if I'm wrong. Even if logs include correct line numbers, source maps will still point to Timbre, right? Also, is macro expansion size a real issue since logging macros can be elided in production?

Though unrelated to the function vs. macro question, I prefer objects to be printed with console.log directly (instead of being pr-stred first) because I use cljs-devtools. I'd highly recommend it; I find it very helpful for ClojureScript development. Perhaps Timbre could provide something like this in the future.

[ptaoussanis]

Hey :-)

Even if logs include correct line numbers, source maps will still point to Timbre, right?

Source maps will still point to the appender, that's correct. Idea is if you have the line numbers in the log output, you don't need source maps. Actually, may be a way to support source maps too if we wanted that for convenience - haven't investigated. Would be happy if you wanted to dig.

Also, is macro expansion size a real issue since logging macros can be elided in production?

Well, you rarely elide everything in production- you'll normally elide specific levels. In any case, macro expansion size isn't the only reason to prefer functions here. Functions are just a lot more flexible + easier to work with. There'd need to be pretty compelling reasons to go the macro route with all you'd need to give up for it - if that makes sense?

I prefer objects to be printed with console.log directly (instead of being pr-stred first) because I use cljs-devtools

Sure, totally! You can just add your own little appender for this if you like and disable the default console appender. Would be happy to see a PR if you felt like including one?

Could add it to the bottom of https://github.com/ptaoussanis/timbre/blob/master/src/taoensso/timbre/appenders/core.cljx#L135 and add an alias at https://github.com/ptaoussanis/timbre/blob/master/src/taoensso/timbre.cljx#L51

I haven't used cljs-devtools myself, so would be awesome if you could handle that since you've experience with it.

Cheers! :-)

[ptaoussanis]

I prefer objects to be printed with console.log directly (instead of being pr-stred first) because I use cljs-devtools

Just took a quick look at cljs-devtools btw. Looks like you actually might not need/want a different appender at all?: Timbre already includes all raw logging args under the :vargs_ appender key. You're welcome to use that instead of the :output-fn if you prefer. (Or to mod your output fn to just return the raw logging args).

I'd suggest checking the config docstring at https://github.com/ptaoussanis/timbre#configuration to see what info your appenders are given to work with. Hope that helps? :-)

[domkm]

Hey Peter,

Sorry for my slow response. I don't know how you manage to always respond so quickly, politely, and thoroughly, but I truly admire you for it. :)

I'll take a look at the appender documentation that you included. Thanks for that. I'll also look into whether it's possible to fix line numbers without resorting to macros.

Thanks again for your help with this and for everything you do for the community. :)

[ptaoussanis]

No problem, you're very welcome! Thanks for saying so :-)

Feel free to ping if you have any follow-up Q's or if you turn up anything that Timbre could handle better. Like I say, it's quite possible- haven't looked into the line number situation for a while (and never looked on the cljs side).

Cheers! :-)

[domkm]

Using this I was able to create an appender that displayed the line number on which the appender was called instead of a line number from within the appender. That solved the biggest problem caused by appenders being functions. The problem now is that line numbers originate from within log1-fn because that is where appenders are called. Would you be open to a PR that inlines log1-fn into log1-macro? This would fix line numbers and source maps in ClojureScript without sacrificing the current data/function composition of configs and appenders.

[ptaoussanis]

Hey, sorry for the delay replying to this - have been crazy swamped.

Haven't had a chance to look at this in detail yet, but would be happy to see a PR with what you had in mind!

[ptaoussanis]

Hey Dom, any update on this?

[domkm]

Hey Peter, sorry, I've been swamped. I'll get around to this eventually but it probably won't be that soon so I'll close the issue for now. Thanks for your help!

[ptaoussanis]

Zero problem, please take your time. Do prefer to keep this open in the meanwhile though so that I don't forget about it :-)