Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nubank/morse
A graphical, interactive tool for browsing Clojure data
https://github.com/nubank/morse
Last synced: 25 days ago
JSON representation
A graphical, interactive tool for browsing Clojure data
- Host: GitHub
- URL: https://github.com/nubank/morse
- Owner: nubank
- License: apache-2.0
- Created: 2023-04-11T17:06:02.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2023-11-17T16:24:25.000Z (about 1 year ago)
- Last Synced: 2024-02-17T11:34:11.153Z (10 months ago)
- Language: JavaScript
- Homepage:
- Size: 3.33 MB
- Stars: 303
- Watchers: 7
- Forks: 1
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- my-awesome-github-stars - nubank/morse - A graphical, interactive tool for browsing Clojure data (JavaScript)
README
# `Morse`
## Rationale
One of the prime value propositions in using a Lisp language is that you should be able to connect to and interact with your live program. Doing so allows you to access and explore the program state. The typical access mechanism for Clojure programs is the REPL, but its textual output is not ideal for robust data exploration. Instead, an interface that allows you to browse and navigate the data in your live program is a more ideal environment for understanding. Morse, like REBL before it, provides a browser for Clojure data that allows active traversal into and back out of nested forms. However, it's not always feasible to execute the browser process inside of the live program. Therefore, Morse provides a way to inspect the live program's data remotely, but also provides an in-process mode if needed.
This software is considered an alpha release and subject to change.
Morse runs remotely to or within your application JVM process, and can be used at dev-time without adding any runtime deps. The UI is written in JavaFX.
Quick links:
* [Install Clojure](https://clojure.org/guides/install_clojure)
* [Morse User Guide](docs/guide.adoc)
* [Morse UI Guide](docs/ui.adoc)
* [Replicant Server](https://github.com/clojure/data.alpha.replicant-server)
* [Ask Clojure Q&A forum](https://ask.clojure.org/index.php/tools/morse)
## Requirements
* Clojure, 1.10.0 or higher
* Java 11 or higher
## Release Information
Latest release:
[deps.edn](https://clojure.org/reference/deps_and_cli) dependency information:
Latest Morse Git dependency coordinate:
```clojure
io.github.nubank/morse {:git/tag "v2023.04.30.01" :git/sha "d99b09c"}
```
## Installing Morse as a Clojure CLI tool
Morse is available as a Clojure CLI tool and may be installed and upgraded via:
clj -Ttools install-latest :lib io.github.nubank/morse :as morse
## Usage:
See the [Morse Guide](docs/guide.adoc) to learn how to use Morse for your purposes.
## Docs
* [API.md](docs/API.md)
## Contributing
Morse is open source, developed internally at Nubank. Issues can be filed using GitHub issues for this project. Initially, we prefer to do development internally and are not accepting pull requests or patches.
## Copyright and License
Copyright © 2023 Nu North America, Inc
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.