Skip to content

Update cheatsheet for Clojure 1.10 #398

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged

Conversation

jafingerhut
Copy link
Contributor

Here is what I have already added that is new in Clojure 1.10:

Added to Namespace / From symbol section:
requiring-resolve
Added to Java Interoperation / Exceptions section:
ex-cause ex-message clojure.main/ex-str

And here are the new things in Clojure 1.10 that have not been added.
If someone would like them added to the cheatsheet, please recommend a
category (or multiple categories) to add them to, whether existing or
new.

PrintWriter-on
read+string
add-tap
remove-tap
tap>
clojure.core.protocols/Datafiable
clojure.core.protocols/Navigable
clojure.core.protocols/datafy
clojure.core.protocols/nav
clojure.core.server/io-prepl
clojure.core.server/prepl
clojure.core.server/remote-prepl
clojure.core.specs.alpha/even-number-of-forms?
clojure.spec.gen.alpha/shuffle
clojure.datafy/datafy
clojure.datafy/nav
clojure.main/renumbering-read
  • [y] Have you read the guidelines for contributing?
  • [y] Have you signed the Clojure Contributor Agreement?
  • [y] Have you verified your asciidoc markup is correct?
Here is what I have already added that is new in Clojure 1.10:

Added to Namespace / From symbol section:
    requiring-resolve
Added to Java Interoperation / Exceptions section:
    ex-cause ex-message clojure.main/ex-str

And here are the new things in Clojure 1.10 that have not been added.
If someone would like them added to the cheatsheet, please recommend a
category (or multiple categories) to add them to, whether existing or
new.

    PrintWriter-on
    read+string
    add-tap
    remove-tap
    tap>
    clojure.core.protocols/Datafiable
    clojure.core.protocols/Navigable
    clojure.core.protocols/datafy
    clojure.core.protocols/nav
    clojure.core.server/io-prepl
    clojure.core.server/prepl
    clojure.core.server/remote-prepl
    clojure.core.specs.alpha/even-number-of-forms?
    clojure.spec.gen.alpha/shuffle
    clojure.datafy/datafy
    clojure.datafy/nav
    clojure.main/renumbering-read
Copy link
Member

@puredanger puredanger left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems to be missing new stuff for datafy, prepl, clojure.main error functions. prepl is not critical to add to the cheatsheet but I would like to get the others on there.

@jafingerhut
Copy link
Contributor Author

Definitely open to adding more things here, especially if you have a preference for how it ought to be categorized and can suggest where to add it.

@puredanger
Copy link
Member

the datafy stuff is a new top-level namespace clojure.datafy so that's probably a new section that I expect will grow a bit in the future.

the clojure.main functions could be a new section on error handling tools and include clojure.core/Throwable->map, clojure.main/ex-triage,clojure.main/ex-str, clojure.main/err->msg, clojure.main/report-error (1.10.1).

Also, the tap stuff should be a new line under IO (add-tap, tap>, remove-tap).

Added new section Datafy with these functions:

    clojure.datafy/datafy
    clojure.datafy/nav

Added new section IO / tap with these functions:

    tap> add-tap remove-tap

Added these functions to section Java Interoperation / Exceptions:

    clojure.core/Throwable->map
    clojure.main/err->msg
    clojure.main/report-error
@jafingerhut
Copy link
Contributor Author

I added a second commit to this PR with most of the changes you suggested.

You suggested that I add Throwable->map and some related functions into a new section on error handling tools. I had already added some of them to an existing section "Java Interoperation / Exceptions" earlier, so I added the rest of them to that section with this commit.

If you would also like them in another new section, or in a different section instead of that one, let me know and I can take a look into it.

@jafingerhut
Copy link
Contributor Author

jafingerhut commented Jun 21, 2019

Here is a link to the change log explaining exactly what changed in v49, the most recent version, in case you want to compare it to your suggestions.

https://github.com/jafingerhut/clojure-cheatsheets/blob/master/src/clj-jvm/CHANGELOG.txt

@puredanger puredanger merged commit 6039472 into clojure:master Jun 21, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
2 participants