{"id":24563627,"url":"https://github.com/nrepl/lein-nrepl","last_synced_at":"2025-04-19T19:05:35.245Z","repository":{"id":62433859,"uuid":"141125075","full_name":"nrepl/lein-nrepl","owner":"nrepl","description":"A simple Leininingen plugin to start nREPL 0.4+","archived":false,"fork":false,"pushed_at":"2019-03-28T20:34:19.000Z","size":20,"stargazers_count":19,"open_issues_count":2,"forks_count":3,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-10-29T23:59:56.733Z","etag":null,"topics":["clojure","lein","lein-plugin","leiningen","nrepl"],"latest_commit_sha":null,"homepage":null,"language":"Clojure","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"epl-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nrepl.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-07-16T10:44:20.000Z","updated_at":"2022-10-05T14:39:14.000Z","dependencies_parsed_at":"2022-11-01T21:01:41.163Z","dependency_job_id":null,"html_url":"https://github.com/nrepl/lein-nrepl","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nrepl%2Flein-nrepl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nrepl%2Flein-nrepl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nrepl%2Flein-nrepl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nrepl%2Flein-nrepl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nrepl","download_url":"https://codeload.github.com/nrepl/lein-nrepl/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248671628,"owners_count":21143136,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["clojure","lein","lein-plugin","leiningen","nrepl"],"created_at":"2025-01-23T10:14:09.898Z","updated_at":"2025-04-19T19:05:35.197Z","avatar_url":"https://github.com/nrepl.png","language":"Clojure","funding_links":[],"categories":[],"sub_categories":[],"readme":"# lein-nrepl\n\nA Leiningen plugin to start an [nREPL][] server.\n\n## Why?\n\nSome of you might be wondering why is this plugin needed - after all `lein repl` starts an\nnREPL server, doesn't it?\n\nThe problem is that `lein repl` is still not updated to work with\nnREPL 0.4+ (see https://github.com/technomancy/leiningen/pull/2444),\nwhich means that in the mean time it's hard for people who want to run\nthe new nREPL to do so.\n\nThis plugin is very minimalistic, doesn't aim to replicate all of the\nfunctionality of `lein repl`, but it gets the job done (and it hopefully won't be needed\nforever).\n\n## Usage\n\nPut `[nrepl/lein-nrepl \"0.3.2\"]` into the `:plugins` vector of your `:user`\nprofile.\n\nAfterwards run the following command:\n\n    $ lein nrepl\n\nThat will start an nREPL server with on a random port and connect\na [REPLy](https://github.com/trptcolin/reply)-powered REPL to it.\n\n### Supported Options\n\n* `:port` — defaults to 0, which autoselects an open port\n\n* `:bind` — bind address, by default `\"::\"` (falling back to \"localhost\" if\n  \"::\" isn't resolved by the underlying network stack)\n\n* `:handler` — the nREPL message handler to use for each incoming connection;\n  defaults to the result of `(nrepl.server/default-handler)`\n\n* `:middleware` — a sequence of vars or string which can be resolved to vars,\nrepresenting middleware you wish to mix in to the nREPL handler. Vars can\nresolve to a sequence of vars, in which case they'll be flattened into the\nlist of middleware.\n\n* `:headless` - Defaults to `false`. Controls whether to start an interactive\nREPL (powered by REPLy) or not.\n\n* `:block` — Defaults to `true`. Set it to `false` for relinquishing control\n  to the next Leiningen task: e.g `lein do nrepl :block false, test-refresh`.\n  Note that with a `false` value and no next Lein task to run,\n  lein-nrepl will immediately close. This option is ignored unless `:headless`\n  is also true.\n\n### Using with CIDER\n\nYou can start a CIDER-capable server like this:\n\n    $ lein nrepl :middleware \"['cider.nrepl/cider-middleware]\"\n\nNote that this currently requires `cider-nrepl` 0.18.0+ to be in your deps,\nas earlier `cider-nrepl` releases depend on the legacy `tools.nrepl`. You can simply put\nthe dependency in your `:dev` profile (it should be a regular dependency, not a plugin).\n\nAfterwards you can simply do `C-c C-x c c` to connect from CIDER to the running server.\n\nUsing this with `cider-jack-in` is a bit more involved currently as\nyou can't just replace `lein repl` with `lein nrepl` in your CIDER\nconfig, because they function a bit differently.  If you want to use\n`lein nrepl` with `cider-jack-in` it's current best to simply disable\n`cider-inject-dependencies-at-jack-in` and rely on deps specified in\nyour profiles. Here's a simple Emacs config:\n\n```\n(setq cider-inject-dependencies-at-jack-in nil)\n(setq lein-parameters \"nrepl\")\n```\n\nAnd here's a sample `profiles.clj` file for you:\n\n``` clojure\n{:user\n {:dependencies [[cider/cider-nrepl \"0.18.0\"]]\n  :plugins [[nrepl/lein-nrepl \"0.3.2\"]]}}\n```\n\n## License\n\nCopyright © 2018 Bozhidar Batsov\n\nDistributed under the Eclipse Public License either version 1.0 or (at\nyour option) any later version.\n\n[nREPL]: https://github.com/nrepl/nREPL\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnrepl%2Flein-nrepl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnrepl%2Flein-nrepl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnrepl%2Flein-nrepl/lists"}