Giter VIP home page Giter VIP logo

rep's Introduction

rep

A single-shot nREPL client designed for shell invocation.

This connects to a running nREPL server (like kind started with lein repl, for example), sends some code to be evaluated, and prints the results and output.

$ rep '(clojure.tools.namespace.repl/refresh)'
:reloading ()
:ok

Unlike other nREPL clients, rep does not try to maintain a persistent connection, meaning that thread-local variables and bindings like *e and *1 will not persist across invocations of rep. Perhaps there are other limitations because of this?

Installation

Download the latest Linux or MacOS binaries from the GitHub releases tab above.

Usage, Options, and Examples

Building

Nix is the build tool. Weird, yes, but this project has a brittle set of peculiar dependencies and Nix allows us to pin down everything.

$ nix-build .

A result symlink will appear in the current directory point to the build output.

Running Tests

If you want to add a feature, please add tests. The nicest way to start a REPL running tests is:

$ clj -A:test
Clojure 1.10.0-master-SNAPSHOT
user=> (use 'midje.repl)
Run `(doc midje)` for Midje usage.
Run `(doc midje-repl)` for descriptions of Midje repl functions.
nil
user=> (autotest)

======================================================================
Loading (rep.test-drivers rep.format-test rep.core-test)
nil
All checks (36) succeeded.
[Completed at 22:56:48]
true
user=>

To run all the tests that CI runs, the way CI runs them (do this before issuing a pull request):

$ nix-build release.nix

Using with Kakoune

The rc/ folder contains scripts which add a ,e user mode to Kakoune. To link this to Kakoiune’s autoload directory, do the following:

$ make install

rep must be in the path for the plugin to work.

Graal/Bytecode Issues

At the moment, Graal doesn’t deal well with the way Clojure generates bytecode from its locking macro, so to build bytecode that Graal can handle, we need to apply this patch. This issue is being tracked here and here.

License

Copyright © 2018 Jason M. Felice

Distributed under the Eclipse Public License either version 1.0 or (at your option) any later version.

rep's People

Contributors

eraserhd avatar plexus avatar

Watchers

James Cloos avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.