crap

`rm` files without fear

Abandoned Pure Nim score 30/100 · tests present · docs generated

Summary

Latest Version Unknown
License MIT
CI Status Passing
Downloads 0
Last Indexed 2026-07-21 05:24

Installation

nimble install crap
choosenim install crap
git clone https://github.com/icyphox/crap

OS Compatibility

Platform Linux macOS Windows FreeBSD OpenBSD NetBSD Android iOS WASM Embedded
crap - - - - - - -

Source

Repository https://github.com/icyphox/crap
Homepage https://github.com/icyphox/crap
Documentation View Documentation
Registry Source nimble_official

README

rm files without fear

Why?

Ever rmed a file and instantly regretted it? Fear not, for crap is here.

How?

crap follows the FreeDesktop.org Trash spec. So instead of perma-deleting your file, crap moves it to the $XDG_DATA_HOME/Trash folder. If this environment variable isn't set, it defaults to ~/.local/share/Trash.

And obviously, this works only on Linux.

Installation

$ nimble install crap

or download the binary from the Releases page.

Tip

Alias crap to rm in your .bashrc/.zshrc. But that's kinda the point.

Usage

$ crap foo.png

$ crap *.png

$ crap a.pdf b.jpg c.mp4

Aaannddd it'll show up in your file manager's Trash.

trash

API

This package exposes a single proc: crap(path: var string)

import crap

crap("~/Pictures/*")

TODO

  • [x] support multiple files
  • [x] trashing dirs
  • [ ] support for other OSs (idk maybe)

Prior art

Contributing

Bad code? New feature in mind? Open an issue. Better still, learn Nim and shoot a PR :sparkles:

License

MIT © Anirudh Oppiliappan