cljdoc

2022-03-26T13:38:50.217099Z

I am still collecting unspecified problems 🙃

✅ 1
2022-03-26T13:40:17.059269Z

unfortunately a search for cannot be cast to class clojure.pprint.PrettyFlush here or on GH does not help

lread 2022-03-26T13:52:56.111809Z

@huxley, happy to take a peek sometime today. But first... I see many clojure .class files in your jar. This is something you typically want to avoid for a library.

lread 2022-03-26T14:07:15.968369Z

You probably want to use b/jar instead of b/uber https://github.com/ribelo/doxa/blob/9a9571f3e7c49bac186512028e99ed4f15eefcce/build/build.clj#L65-L67?

2022-03-26T15:14:34.779829Z

when using jar, I have a problem with dependencies

2022-03-26T15:15:18.092829Z

I copied the config from malli

lread 2022-03-26T20:41:49.419639Z

An uberjar is typically for apps, not libs.

2022-03-26T21:13:18.758229Z

my problem was the dependencies served from github

2022-03-26T21:13:50.741139Z

after uploading to clojars and making jar and not uberjar, it seems to work now

2022-03-26T21:16:40.041469Z

👍 1
2022-03-26T21:17:08.589279Z

thanks for your help again

lread 2022-03-26T21:28:12.323819Z

Woot!

lread 2022-03-26T21:28:25.532019Z

Congrats, and you are most welcome.

lread 2022-03-26T21:33:20.332309Z

Oh @huxley, one more thing: your cljdoc badge image seems a bit off: You have: https://cljdoc.org/badge/ribelo/doxa.svg But I think you maybe want: https://cljdoc.org/badge/com.github.ribelo/doxa

2022-03-26T21:35:06.004419Z

definitely 😉

djblue 2022-03-26T19:20:55.710979Z

Hello 👋 just wanted to start off by saying cljdoc is a pretty awesome tool for the Clojure community! Thanks for all the hard work in both building and maintaining it 🙏 An issues I run into on occasion is resolving optional/runtime dependencies. So far I have been able to work around these issues, but was curious if there was any discussion around making it easier?

lread 2022-03-26T20:44:08.094759Z

Hi @djblue! Thanks for dropping by!

lread 2022-03-26T20:44:21.006519Z

Our current recommendation is to include optional deps as provided in your pom.xml .

👍 1
lread 2022-03-26T20:47:42.029679Z

The only option today for API analysis is dynamic analysis, your namespaces are loaded to discover your API. I am exploring adding support for static analysis via clj-kondo’s analysis data. Static analysis would not always cover the case where an API is generated at load-time, but not many libs do this, so it might be a good fallback/option if dynamic analysis fails.

💯 1
djblue 2022-03-26T20:49:45.606989Z

It would be awesome if I could opt-in to the static analysis path for some apis/namespaces 💯

lread 2022-03-26T20:49:55.451559Z

And am also looking at custom analysis. You provide the resulting API analysis edn that cljdoc normally generates. But… I don’t think this is what your use case specifically needs.

lread 2022-03-26T20:51:22.558139Z

> It would be awesome if I could opt-in to the static analysis path for some apis/namespaces Oh… hadn’t thought of doing only for some namespaces… Hmm… I’d probably start with all static or all dynamic for an analysis run.

👍 1
djblue 2022-03-26T20:51:49.847789Z

Recently I added some code for planck and had some issues, luckily planck does publish a jar to clojars so I was able to solve the issue.

djblue 2022-03-26T20:53:02.314509Z

Another option could be to exclude certain namespaces from being analyzed 🤔 Not sure what is easier

lread 2022-03-26T20:54:23.728299Z

Just remembered that cljdoc does add at least one jar to the classpath that would fall into the provided category: javax.servlet/javax.servlet-api.

lread 2022-03-26T20:54:58.032489Z

Am thinking maybe lein might be another one to add for lein plugins.

lread 2022-03-26T20:56:44.245409Z

> Another option could be to exclude certain namespaces from being analyzed 🤔 Not sure what is easier If you have control over the source, you can add :no-doc to a namespace. A recent change to analysis will not attempt to explicitly load these namespaces. But if they are loaded indirectly by other code in your lib, then… well… you’ll still have trouble.

djblue 2022-03-26T20:57:59.076819Z

Ohh, I think I might be using an older version of cljdoc locally for testing. I was hoping no-doc would do this 💯

lread 2022-03-26T20:58:55.666829Z

It should! You can thank @vemv for the idea, and blame me if it doesn’t work. simple_smile

😂 2
djblue 2022-03-26T21:00:19.513129Z

Okay, this is a great tip 🙏

djblue 2022-03-26T21:00:42.377399Z

Thanks again for all the hard work you do ❤️

❤️ 1
lread 2022-03-26T21:01:45.151599Z

Meh, it is typically lotsa fun! And always looking for feedback. It can get a little quiet in the ol’ cljdoc channel so feel free to drop by with ideas/problems/suggestions.

💯 1
Cora (she/her) 2022-03-26T22:25:50.676609Z

returns to a cljdoc branch after ages

Cora (she/her) 2022-03-26T22:25:55.963639Z

big oof

Cora (she/her) 2022-03-26T22:28:37.188669Z

I'll probably just start that over

Cora (she/her) 2022-03-26T22:30:24.391289Z

@lee iirc you use adoc? do you know of any clojure projects that use that as the readme? I'm working on client-side search again and I'm only parsing markdown at the moment and need it to work with adoc as well

Cora (she/her) 2022-03-26T22:30:49.676989Z

oh, duh, I already have your status-line project open and it has that

Cora (she/her) 2022-03-26T22:30:58.657759Z

disregard

Cora (she/her) 2022-03-26T22:31:01.375699Z

😅

Cora (she/her) 2022-03-26T22:31:09.665879Z

sorry I dropped off the face of the earth btw

lread 2022-03-26T22:31:09.903159Z

Yeah, I’m a huge fan of the adoc. All my projects (including rewrite-clj!) use adoc.

Cora (she/her) 2022-03-26T22:31:17.363069Z

thanks for leading the charge on maintenance

lread 2022-03-26T22:31:55.853989Z

And so nice to see you here!

💜 1
Cora (she/her) 2022-03-26T22:32:03.896929Z

so nice to be back!

Cora (she/her) 2022-03-26T22:32:14.294539Z

I've been working on calva maintenance

lread 2022-03-26T22:32:34.172569Z

I saw that! Very impressive.

Cora (she/her) 2022-03-26T22:32:35.030719Z

but this weekend feels like a good time to knock out this client-side search. the value to the community would be incredible

lread 2022-03-26T22:33:55.587089Z

Very awesome! And, as always, no pressure! But am quite excited to see the fruits of this PR!

Cora (she/her) 2022-03-26T22:34:20.032109Z

🥳