Cross-platform stream-line editing tool
sedpy is an open-source project being built as a cross-platform alternative of sed for easier and more flexible stream line editing across BSD and GNU systems.
What is sed and what is sedpy?
sed command, short for stream editor, performs editing operations on text coming from standard input or a file. sed edits line-by-line and in a non-interactive way.
This means that you make all of the editing decisions as you are calling the command, and sed executes the directions automatically. This may seem confusing or unintuitive, but it is a very powerful and fast way to transform text, especially as part of a script or automated workflow.
The problem with
sed is that it's not purely cross-platform. Linux uses GNU-based
sed while macOS has the BSD version of
sed.As a result - both have quite important sytnatic and usage difference. At the same time,
sed though exteremly powerful is quite complex to use.
sedpy project exactly tries to solve both these problems. The
sedpy project intially supports only stream text replacement (supports regex). The future scope of the project is huge and requires continuous feedback and support from all of you amazing folks out there!
The easiest way to install sedpy is using PyPi
pip install sedpy or pip3 install sedpy
Installation using Source:
Clone the repo:
git clone https://github.com/mritunjaysharma394/sedpy.git
pip3 install -e .
This should successfully install the
sedpy cli package.
As an alternative for Step 3, you can also use:
./install.sh fails to work, try running it after changing it's access:
$ sudo chmod a+x install.sh
How to use?
As a sample, you can download the test.txt file. We can play with it to learn about it's very basic usage:
The contents of
test.txt file as of now reads:
7 + 4 = 13
We will use
sedpy cli to change the '4' to '6' without opening the
test.txt file.Just enter below command and see the magic:
sedpy "4" "6" test.txt
test.txt argument may differ according to the location where you have stored it.
Now when you open
test.txt, file will now read as:
7 + 6 = 13
So you can observe that
sedpy can be used as:
sedpy "inital string" "string to replace it" "path to the file where changes have to be made"
Thank you so much for having fun with this! This is just the inital release. More major updates on the cards :tada:
Your contributions are welcome and highly appreciated. All you need to begin is to go through the guidelines in CONTRIBUTING.md
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.