zxpy
Shell scripts made simple
Inspired by Google's zx, but made much simpler and more accessible using Python.
Rationale
Bash is cool, and it's extremely powerful when paired with linux coreutils and pipes. But apart from that, it's a whole another language to learn, and has a (comparatively) unintuitive syntax for things like conditionals and loops.
zxpy aims to supercharge bash by allowing you to write scripts in Python, but with native support for bash commands and pipes:
#! /usr/bin/env zxpy
todo_comments = ~"git grep -n TODO"
for todo in todo_comments.splitlines():
filename, lineno, code = todo.split(':', 2)
*_, comment = code.partition('TODO')
print(f"{filename:<40} on line {lineno:<4}: {comment.lstrip(': ')}")
Running this, we get:
$ ./todo_check.py
README.md on line 154 : move this content somewhere more sensible.
instachat/lib/models/message.dart on line 7 : rename to uuid
instachat/lib/models/update.dart on line 13 : make int
instachat/lib/services/chat_service.dart on line 211 : error handling
server/api/api.go on line 94 : move these to /chat/@:address
server/api/user.go on line 80 : check for errors instead of relying on zero value
Installation 
pip install zxpy
Example
Make a file script.py (The name and extension can be anything):
#! /usr/bin/env zxpy
~'echo Hello world!'
file_count = ~'ls -1 | wc -l'
print("file count is:", file_count)
And then run it:
$ chmod +x ./script.py
$ ./script.py
Hello world!
file count is: 3
Run
>>> help('zx')in Python REPL to find out more ways to use zxpy.
A more involved example: run_all_tests.py
#! /usr/bin/env zxpy
test_files = (~"find -name '*_test\.py'").splitlines()
for filename in test_files:
try:
print(f'Running {filename:.<50}', end='')
output = ~f'python {filename}' # variables in your shell commands :D
assert output == ''
print('Test passed!')
except:
print(f'Test failed.')
Output:
$ ./run_all_tests.py
Running ./tests/python_version_test.py....................Test failed.
Running ./tests/platform_test.py..........................Test passed!
Running ./tests/imports_test.py...........................Test passed!
Examples are all in the examples folder.
Interactive mode
$ zxpy
zxpy shell
Python 3.8.5 (default, Jan 27 2021, 15:41:15)
[GCC 9.3.0]
>>> ~"ls | grep '\.py'"
__main__.py
setup.py
zx.py
>>>
Also works with
path/to/python -m zx
It can also be used to start a zxpy session in an already running REPL. Simply do:
>>> import zx; zx.start()
and zxpy should be enabled in the existing session.
3 Dec 26, 2021
7 Feb 28, 2022
51 Dec 22, 2022
10 Oct 07, 2022
1 Nov 26, 2021
1 Jul 13, 2022
2 Mar 05, 2022
1 Jan 05, 2022
8 Dec 04, 2021
3 Feb 02, 2022
529 Dec 31, 2022
22 Oct 18, 2022
1 Jan 15, 2022
2 Mar 01, 2022
106 Dec 19, 2022
2 Apr 23, 2022
1 Feb 06, 2022
1 Nov 24, 2021
3 Jul 30, 2022
91 Dec 28, 2022