https://github.com/sogaiu/abridge

https://github.com/sogaiu/abridge

atom clojure editing emacs graalvm-native-image vscode

Last synced: about 1 month ago
JSON representation

• Host: GitHub
• URL: https://github.com/sogaiu/abridge
• Owner: sogaiu
• Created: 2019-07-14T09:01:28.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2022-03-25T12:36:09.000Z (almost 3 years ago)
• Last Synced: 2023-03-06T18:39:06.004Z (almost 2 years ago)
• Topics: atom, clojure, editing, emacs, graalvm-native-image, vscode
• Language: Clojure
• Size: 125 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.adoc

Awesome Lists containing this project

README

        
= Abridge Helper Program and Friends

Because you've seen that long string enough already.

== Rationale

Sufficient docstrings can become long, but long docstrings can adversely affect readability and navigability of code.

What if long strings in your code could be automatically set up for folding?

== Prerequisites

* Some Java (using >= 8 here)

* https://www.graalvm.org/docs/reference-manual/aot-compilation/#install-native-image[Native Image] (implies appropriate https://github.com/oracle/graal[GraalVM] >= 19)

* Clojure 1.9 and its clj tool

* Atom or VSCode

== Building and Setup

* Clone this repository and cd to the clone

* Ensure native-image is in your PATH -OR- +

  Set GRAALVM_HOME appropriately (e.g. on Arch Linux this might be /usr/lib/jvm/java-8-graal)

* Build the helper: `clj -A:native-image`.  After some time, this should produce a file named "abridge" in the current directory.

* Examine the atom / vscode subdirectory and follow the contained instructions for getting the Atom plugin / VSCode extension to work.

== Technical Background

See the https://github.com/sogaiu/adorn[adorn repository].

== Acknowledgments

Thanks to (at least) the following folks:

* borkdude

* lread

* mauricioszabo

* rundis

* Saikyun

* seancorfield

* taylorwood

* thheller

* xsc