Clojure Q&A - Recent questions tagged web site

Add example to namespaced maps for :_/foo functionality

Wed, 03 Jul 2024 01:17:02 +0000

In the section for namespaced map syntax, the middle bullet point mentions that :_/foo will treat the keyword as not having the map's current namespace, allowing for including un-namespaced keys in a namespaced map. The example given doesn't include this behavior, which has lead many (me, the entirety of the Discljord server, and I suspect many more in the wider clojure world) to not know about this behavior.

I think it would be helpful to include it in the example, making the behavior explicit and obvious. Something like:

For example, the following map literal with namespace syntax:

#:person{:_/species "Human"
         :first "Han"
         :last "Solo"
         :ship #:ship{:name "Millennium Falcon"
                      :model "YT-1300f light freighter"}}

is read as:

{:species "Human"
 :person/first "Han"
 :person/last "Solo"
 :person/ship {:ship/name "Millennium Falcon"
               :ship/model "YT-1300f light freighter"}}

I've signed the CA and can open an PR if it's acceptable.

Add example of clojure -Sdeps to Deps and CLI guide or reference

Tue, 04 Oct 2022 18:38:54 +0000

Testing libraries before adding them to a deps.edn file by using -Sdeps '{...}' is a frequent recommendation, but it's only mentioned in a single line in the Reference page.

I think it would be helpful if it (and the other flags) had examples with more detail about how they're used and why. Maybe something like:

-Sdeps - pass the config data on the command line

For example, instead of creating a new deps.edn file to experiment with a new library, you can use -Sdeps to pass in the :deps map to clojure:

$ clojure -Sdeps '{:deps {org.clojure/core.match {:mvn/version "1.0.0"}}}'
Clojure 1.11.1
user=> (require '[clojure.core.match :refer [match]])
nil

Typo in Getting Started: /etc/man_dev.conf ➡ /etc/man_db.conf

Mon, 01 Feb 2021 02:57:27 +0000

The Getting Started instructions for Linux should refer to /etc/man_db.conf instead of /etc/man_dev.conf.