https://github.com/martinklepsch/prune-feature-flags.clj
A small utility script to remove no longer needed conditionals in Clojure code
https://github.com/martinklepsch/prune-feature-flags.clj
Last synced: about 2 months ago
JSON representation
A small utility script to remove no longer needed conditionals in Clojure code
- Host: GitHub
- URL: https://github.com/martinklepsch/prune-feature-flags.clj
- Owner: martinklepsch
- Created: 2021-05-09T21:44:30.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2025-01-28T14:44:32.000Z (4 months ago)
- Last Synced: 2025-03-27T02:01:53.097Z (3 months ago)
- Language: Clojure
- Size: 1.56 MB
- Stars: 9
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# feature-flags.clj
A Babashka task to prune feature flag conditionals from your codebase. Removes dead code branches based on flag evaluations, keeping your code clean.
[This blogpost explains the basic idea in a bit more detail](https://martinklepsch.org/posts/homoiconicity-and-feature-flags.html).
## Installation
In `bb.edn` add the following:
```clojure
{:deps {feature-flags {:git/url "https://github.com/martinklepsch/feature-flags.clj"
:sha "38dffe4b32fc33765bafd7e9f8aba027ba454e98"}}
:tasks {prune feature-flags.task/prune}}
```
## Usage
```sh
bb prune --file example/acme/core.cljs \
--formatter cljfmt \
--test-lookup '{(use-new-name?) true}' \
--dry-run
```
It is recommended to remove feature flags one-by-one and verify results inbetween.
More examples
```bash
# Prune flags in a single file
bb prune --file example/acme/core.cljs --test-lookup '{(use-new-name?) true}'
# Process multiple files with a glob pattern
bb prune --pattern "src/**/*.clj" --test-lookup '{(use-beta-features?) false}'
# Dry-run to see changes without saving
bb prune --file example.clj --test-lookup '{(use-new-layout?) true}' --dry-run
```
## Features
- Removes `if`, `when`, `if-not`, and `when-not` branches for resolved flags
- Supports local bindings in `let` forms
- Integrates with `cljstyle`/`cljfmt` for formatting
- Dry-run mode for safe previews
## Current Limitations (WIP)
- it will transform code like `(if true :a :b)` to `:a`
- extra forms like `and`, `not`, `or` etc. are not detected and therefore
conditionals using them are left untouched (unless one of you test-lookup forms has them)
- inconsistent namespace aliases could make specifying the `test-lookup` map
a bit more cumbersome
- `:refer-clojure :exclude [if when]` and similar configurations could lead to
unwanted results"