Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/binaryage/dirac
A Chrome DevTools fork for ClojureScript developers
https://github.com/binaryage/dirac
chrome-devtools chrome-extension clojurescript clojurescript-repl dirac-devtools
Last synced: 1 day ago
JSON representation
A Chrome DevTools fork for ClojureScript developers
- Host: GitHub
- URL: https://github.com/binaryage/dirac
- Owner: binaryage
- License: other
- Created: 2015-12-15T00:37:56.000Z (almost 9 years ago)
- Default Branch: master
- Last Pushed: 2022-08-26T16:03:55.000Z (about 2 years ago)
- Last Synced: 2024-10-28T05:13:22.007Z (11 days ago)
- Topics: chrome-devtools, chrome-extension, clojurescript, clojurescript-repl, dirac-devtools
- Language: Clojure
- Homepage:
- Size: 237 MB
- Stars: 769
- Watchers: 21
- Forks: 30
- Open Issues: 20
-
Metadata Files:
- Readme: readme.md
- License: license.txt
Awesome Lists containing this project
- awesome-chrome-devtools - Dirac - Debugging of ClojsureScript. (Using DevTools frontend with other platforms / Browser Adapters)
README
# Dirac DevTools
[](license.txt)
[](https://clojars.org/binaryage/dirac)
[](https://travis-ci.org/binaryage/dirac)
[](https://github.com/binaryage/dirac/tree/master/examples)
[](https://chrome.google.com/webstore/detail/dirac-devtools/kbkdngfljkchidcjpnfcgcokkbhlkogi)
Dirac is a flavored [Chrome DevTools][1] with extra tweaks for [ClojureScript](https://clojurescript.org) developers.
**DOC**
: **[Motivation](docs/motivation.md)**
| **[Installation](docs/installation.md)**
| **[Configuration](docs/configuration.md)**
| **[Integration](docs/integration.md)**
| **[Examples](https://github.com/binaryage/dirac/tree/master/examples)**
| **[FAQ](docs/faq.md)**
### Quick start
1. install [the command-line tool](docs/cli.md)
1. run `dirac` and wait for Chrome to launch
1. in Chrome navigate away from "chrome://welcome" to some normal page, e.g. [https://clojurescript.org](https://clojurescript.org)
1. in Chrome open DevTools (CTRL+SHIFT+I or CMD+OPT+I on a Mac)
1. in DevTools switch to Console => Dirac prompt should enter `dirac.playground` and let you type in cljs code
1. in Console enter `(js/console.log (str "Hello" \space "Dirac!"))`
### Introduction
Dirac project maintains [a set of patches][2] rolling on top of official Chrome DevTools.
That means you don't lose any functionality, you just sprinkle cljs enhancements on top. Additionally we
provide [a command-line tool](docs/cli.md) which allows you to launch Chrome with Dirac swapped in place of normal DevTools.
* enables [custom formatters][6] by default (for [cljs-devtools][7])
* custom formatters are displayed inline on Source Panel (during debugging)
* better [display of cljs function names][8]
* better display of cljs property names:
* macro-generated names are renamed to friendly names using sub-indexes
* properties are grouped, most important properties go first
* REPL integrated into DevTools Console
* eval cljs code in the context of currently selected stack frame (when paused on a breakpoint)
* cljs [code completion suggestions][4] (like completions in Javascript console)
* [Parinfer][5] goodness
* initialized [blackboxing patterns](https://developer.chrome.com/devtools/docs/blackboxing) of cljs core libraries for
better stack-trace experience
### Screenshots
![ClojureScript REPL][9]
[1]: https://developer.chrome.com/devtools
[2]: https://github.com/binaryage/dirac/commit/devtools-diff
[4]: https://github.com/binaryage/dirac/releases/tag/v0.4.0
[5]: https://shaunlebron.github.io/parinfer
[6]: https://docs.google.com/document/d/1FTascZXT9cxfetuPRT2eXPQKXui4nWFivUnS_335T3U
[7]: https://github.com/binaryage/cljs-devtools
[8]: https://box.binaryage.com/dirac-non-trivial-beautified-stack-trace.png
[9]: https://box.binaryage.com/dirac-main-01.png