Skip to main content

Concussion Shell

It's kinda like Bash except it causes severe brain damage because it's actually a Python REPL.

Usage

$ pip install concussion
$ concussion
>>> cat + README.md | head + -n + 4
# Concussion Shell

It's kinda like Bash except it causes severe brain damage because it's actually
a Python REPL.

How it works

Everything is implemented using horrific operator overloads.

Since the commands can't be executed while they're being constructed, commands are instead executed when stringified using repr(), which works nicely with Python's interactive console.

Python doesn't support building commands from adjacent identifiers, so Concussion uses the + operator to join arguments for a command.

>>> echo + hello + world
hello world

Notice that none of these variables were never defined. Concussion uses a custom dictionary for the local variable scope such that any undefined variables create a new string-like object, which helps to improve readability.

You can pipe commands using the standard | pipe operator.

>>> ls + -l | less
# less is broken because I can't be bothered to make my shell look like a TTY
# so the output is incorrect

To create shell aliases, you simply use Python variable assignments

>>> # This makes for an epic prank
>>> bash = concussion
>>> bash
Concussion shell...

Because && and || are not supported in Python, use the and and or keywords instead.

>>> false or echo + hi
>>> false and echo + hi
hi
>>> true or echo + hi
hi
>>> true and echo + hi

You can also do file redirection like in Bash

>>> echo + hi > hi.txt
>>> cat < hi.txt
hi
>>> echo + "hi again" >> hi.txt  # append
>>> cat < hi.txt
hi
hi again

Because working with regular strings or pathlib's Path objects is tedious in a shell-like environment, Concussion provides its own CursedPath object, which simplifies many aspects of string manipulation.

>>> str(path/to/some-file.txt)
"['path/to/some-file.txt']"

Note that the /, - and . operators all result in string joining.

in order to path to files from the root of the file system, a _ can be used before the leading /, since a leading / in Python produces a SyntaxError.

>>> _/usr/bin/sl
# [epic train ASCII art]

Setting concussion as your default shell

This will almost definitely break your system.

$ sudo chsh --shell $(which concussion)
...

Known issues

  • Currently all stderr goes directly to this process's stderr, and it cannot be redirected. Maybe I'll implement this at some point.

  • Currently no support for executing tasks asynchronously. Perhaps I could use β to signify this since it looks kinda like an & but is a valid identifier.

  • Many programs don't work nicely because they think they're not running in a terminal.

Release files for concussion 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for concussion 0.2.2
File Size Uploaded
concussion-0.2.2.tar.gz 9.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for concussion 0.2.2
File Interpreter ABI Platform
concussion-0.2.2-py3-none-any.whl Python 3 none any Details

Total release size: 20.4 kB

Release files / concussion-0.2.2.tar.gz

Download URL concussion-0.2.2.tar.gz
Size 9.4 kB
Tags Source
SHA-256 checksum
How to use checksums
4cf3c72968e97bf4984d0562ae69196f6db223a2885b3b9c3da0c3f827cfb4fa
BLAKE2b-256 checksum
How to use checksums
325671424fb8854134b956bc3b9c4e119a11193b1d18da4bdc3c52f974621505
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.8.3 CPython/3.11.9 Linux/6.5.0-1024-azure

Release files / concussion-0.2.2-py3-none-any.whl

Download URL concussion-0.2.2-py3-none-any.whl
Size 11.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
133f8a98a339a833ff85159ff3f6a26e1e7a9d40bb7441e96e0cffb3353565be
BLAKE2b-256 checksum
How to use checksums
311f2ed6bfce752acce42cb5332e2c8c25f11da047ba888210567d54bce74eac
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.8.3 CPython/3.11.9 Linux/6.5.0-1024-azure

Release history Release notifications | RSS feed

This release

0.2.2 This release

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page