NAME

sued - the text editor of all time, a post-classic line editor

SYNOPSIS

sued [file]

DESCRIPTION

sued is a vector-oriented line editor written in Rust by Arsalan "Velocity" Kazmi in the image of the standard text editor, ed.

sued is not nearly as powerful as its inspiration, but aims to match it in the terseness department, while at the same time being quite a bit more user-friendly.

OBTAINING

sued is available on crates.io - you can get it with cargo install sued.

Go to the GitHub page if you want to check out sued for yourself, or if you want to help me work on it.

DEMO

Here's an asciinema demo showing sued in action:

COMMANDS

sued supports command history. Use ↑ and ↓ to navigate through it.

All commands start with ~. Run ~ by itself to see a list of commands.

~about - display about text

~clear - clear buffer

~copy [line] - copy line or whole buffer to clipboard

~correct - replace most recent line (interactive)

~delete [line] - immediately delete specified line

~exit - exit sued

~help - display this list

~indent [line] [level] - indent a line, negative level will outdent

~insert [line] - insert text at specified line (interactive)

~nothing - do nothing with the buffer contents

~open [filename] - load file into buffer

~prompt [prompt] - set an input prompt

~replace [line] - replace specified line (interactive)

~run [command] - run executable or shell builtin

~runhere [command] - run executable or shell builtin on file contents

~save [filename] - save buffer to file

~search [term] - perform regex search in the whole buffer

~show [start] [end] - display the contents of the buffer

~substitute [line] [pattern]/[replacement] - perform regex substitution on the specified line

~swap [source] [target] - swap two lines

~write [filename] - write buffer to file without storing filename

FAQ

• Why a line editor?

I like ed. It's really nice, and the minimalism is really what sells it. I wanted to try my hand at writing a similar text editor, just a lot less complex.

Plus, I don't want to go insane trying to develop a Vim-like editor. Especially not when projects like Helix exist.

• If it's ed-like, why not copy ed's syntax?

ed has a lot of commands, and like I said, I want sued to be more user-friendly.

Furthermore, sued inherits its command prefix (~) from my earlier project, Streakline.

• What does sued stand for?

It stands for "shut up editor," which alludes to how not-in-your-way it is.

• How do you pronounce sued?

"soo-ed". Don't pronounce it "sood," it's not a law thing, and has nothing to do with GitHub Copilot. (The context behind that statement is weird.)

• Now that you're working on QVSED, will sued be forgotten about?

Pfft. No. QVSED is a graphical editor with a completely different paradigm, and it isn't a sued replacement. It's just another project.

DIAGNOSTICS

When an error occurs that sued can't recover from, it will print an error message as follows and quit:

stop: ERROR_CODE: 0xXXXXXXXX (0xXXXXXXXX,0xXXXXXXXX,0xXXXXXXXX)

The currently implemented error codes are as follows:

• USER_IS_STUPID - The user manually initiated a crash.
• EDITOR_OVERFLOW - The editor tried to run itself and got stuck.

SEE ALSO

ed(1), streakline(1)

LIMITATIONS

sued is still 0.x software and probably isn't going to replace VS Code anytime soon.

BUGS

Yes.