cljdoc supports markdown in docstrings

https://github.com/cljdoc/cljdoc/blob/master/doc/userguide/for-library-authors.adoc#markup-formats

I would love if we had a standard for type signatures for args and return types and multiple arities

However, there are parameter naming conventions like m , s , coll ,`xform`etc.

I don't even know those conventions lol

They might not be as strong as I thought? But they are used throughout clojure core and other libs. When you see m you know it’s probably a map and so on.

https://github.com/bbatsov/clojure-style-guide#idiomatic-names

Huh! That's awesome, thanks for sharing that, didn't know it existed, though not surprised it's from bbhatsov either!

(sorry for necromancy) I truly miss jsdoc style annotations in comments for functions. I guess clojure has better theoretical possibilities with macros - but in practice, it feels too intrusive, too much opinion - the base language is already great. comments and the base language are just in that sweet spot of being familiar enough to adopt and powerful enough to provide value.

Is your navbar in its own component? Is your main page subs dependent on things getting updated from navbar events?

Yes.

If those are both true, then why would changing the navbar make the main page refresh?

Remember that a reagent component only updates if the value of one of its "signalling" components changes (basically the things you deref)

So if your main page refreshes, it's likely the value of one of the subs you subscribe to is changing value

Huh ok. I'll try have a look through my events and subs again to see if I missed something.

Possibly also set up re-frisk to help you diagnose which subs are updating

iirc it’s the default export

@U039A5RM6SE This is documented here: https://clojurescript.org/news/2021-04-06-release#_new_core_features

Ty @U04V15CAJ ! I will take a look 😄

In Clojure JVM, the dollar sign is for accessing inner classes.

Thanks, @U04V15CAJ! It looks like that’s what I learned the hard way 😅

record instances take metadata. I'm confused by what you mean on defrecord though

Thanks @U064X3EF3 We use a variant of stuartsierra's component library to build our systems and we wanted to know whether there is a way to set a component's dependency as part of its defrecord by setting the metadata on the record itself came to mind so that later on when instantiation instances we can check the dependencies.

you can make a record constructor function that sets metadata on the record instance

Thanks

java.sql.Connection provided to you by used JDK

you don't need to add it to dependencies 🙂 it comes for free

Oh okay!

Thanks 🙂

yep! take a look into :aliases https://clojure.org/guides/deps_and_cli#extra_paths

you can use the :extra-deps key to add deps to a given alias, then use that alias when spinning up your repl/tests/whatever

Excellent thank you very much!

1. does your project have a deps.edn/project.clj? What does it look like? 2. where is the java code located? have you built it into a jar? Is the jar deployed somewhere? 3. please use threads, it's hard to follow the conversation otherwise update: https://clojurians.slack.com/archives/C053AK3F9/p1650903059274279?thread_ts=1650901344.771399&cid=C053AK3F9

Oh I think you're asking if ultimately this project is a Java project. No. It's a Clojure project with imported Java.

do you have it included in your deps.edn/project.clj file? having it on your filesystem isn’t enough for the JVM to know you need access to that dependency

Yes. I added :java-source-paths ["src/MyJavaFiles/"] to project.clj

you’ll also need to add the postgres driver to your :dependencies key

(defproject MyJavaFiles
  :dependencies
  [;; among others
   [org.postgresql/postgresql "42.3.1"]])

OMG that worked!

Thank you so much @U02EA2T7FEH 🙂

cond-> you mean?

because I checked inc and seems like a fn:

(defn inc
  "Returns a number one greater than num. Does not auto-promote
  longs, will throw on overflow. See also: inc'"
  {:inline (fn [x] `(. clojure.lang.Numbers (~(if *unchecked-math* 'unchecked_inc 'inc) ~x)))
   :added "1.2"}
  [x] (. clojure.lang.Numbers (inc x)))

I meant cond->

I'm new at this - is there a way to have my cake?

one option is to just make a named function and use that, or you can do something like this:

(cond-> 1
  true (#(* 3 (inc %))))

but I would never inflict that on my future self as a code reader

you could also

(cond-> 1
  true (->> (* 3 (inc)))

but I'm not sure how this matches with your original stated problem - multiple update-in's should be fine?

I have to do multiple update-in's for the same condition:

(cond-> {:count count
             :articles articles
             :related-terms related-terms
             :cuis cuis
             :pmids pmids
             :st-counts st-counts
             :st-counts-elem st-counts-elem
             :rel-counts rel-counts}
      name-is-not-stop-word? (fn [coll]
                               (-> coll
                                   (update-in [:cuis [name-rel]] add-value-to-set cui)
                                   (update-in [:pmids [name-rel]] add-value-to-set pmid)
                                   (update-in [:count] inc))))

I have several conditions

you could repeat the name-is-not-stop-word? condition and just do one-per

trying to get a single return instead of having code with several nested when + if's and multiple return expressions

or let the anonymous function around the cond-> to give it a name

repeating the condition should be good enough imo

or just don't use cond-> :)

did not think it would work and did not try

(let [m ...] (if name-is-not-stop-word? (-> m ...) m))

this seems also a good option

thanks, I'll try these

note where the G__145 gets threaded - just dropped in as effectively the name of the anonymous function

I would have found an idiomatic set of answers less useful than exploring different approaches and learning from those experiences I wouldn't consider my solutions a source of truth, but a journey of learning the core functions of Clojure https://youtube.com/playlist?list=PLpr9V-R8ZxiDB_KGrbliCsCUrmcBvdW16

There is a repo that aggregated the answers from the top 1000 users into a test corpus: https://github.com/mfikes/coal-mine

Searching among the most terse answers is usually informative. You should see patterns emerge and it's worth looking at outliers to see if they are elegant or other...

Thanks everybody