stringedit 1.0.0__tar.gz

stringedit-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Elisha Hollander
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

stringedit-1.0.0/PKG-INFO

@@ -0,0 +1,93 @@
+Metadata-Version: 2.4
+Name: stringedit
+Version: 1.0.0
+Summary: Replace strings in binary files.
+Home-page: https://github.com/donno2048/stringedit
+Author: Elisha Hollander
+Author-email: just4now666666@gmail.com
+License: MIT
+Project-URL: Documentation, https://github.com/donno2048/stringedit#readme
+Project-URL: Bug Reports, https://github.com/donno2048/stringedit/issues
+Project-URL: Source Code, https://github.com/donno2048/stringedit
+Requires-Python: >=3.0
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: prompt_toolkit
+Dynamic: author
+Dynamic: author-email
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# stringedit
+
+Replace strings in binary files.
+
+## Installation
+
+### From PyPI
+
+```sh
+pip3 install stringedit
+```
+
+### From GitHub
+
+```sh
+pip3 install git+https://github.com/donno2048/stringedit
+```
+## Usage
+
+To run the string editing use `stringed` or `python3 -m stringedit`
+
+```sh
+$ stringed -h
+usage: stringed [-h] [-n [number]] [-m {l,r,L}] filename
+
+Replace strings in binary files
+
+positional arguments:
+  filename              input filename
+
+optional arguments:
+  -h, --help            show this help message and exit
+  -n [number], --bytes [number]
+                        print amy string of at least [number] characters (default 4)
+  -m {l,r,L}, --method {l,r,L}
+                        method used to widen replacement string if it's too long l - pad with
+                        spaces from the left r - pad with spaces from the right L - leave
+                        everything after the replacement as it was
+```
+
+You can also use the `stringpr` to print all the strings, similar to the `strings` linux command.
+
+```sh
+$ stringpr -h
+usage: stringpr [-h] [-n [number]] [-t {o,d,x}] [-s <string>] filename
+
+Print strings in binary files
+
+positional arguments:
+  filename              input filename
+
+optional arguments:
+  -h, --help            show this help message and exit
+  -n [number], --bytes [number]
+                        print amy string of at least [number] characters (default 4)
+  -t {o,d,x}, --radix {o,d,x}
+                        print the location of the string in base 8, 10 or 16
+  -s <string>, --output-separator <string>
+                        string used to separate strings in output
+```
+
+## Uses
+
+- Could be used to create a modded version for a game by changing dialogues and such
+- Could theoretically be used to "steal" someones binary by just replacing any info (e.g. license) with the attacker's - removes the need to decompile, change and then recompile the binary
+- And more

stringedit-1.0.0/README.md

@@ -0,0 +1,66 @@
+# stringedit
+
+Replace strings in binary files.
+
+## Installation
+
+### From PyPI
+
+```sh
+pip3 install stringedit
+```
+
+### From GitHub
+
+```sh
+pip3 install git+https://github.com/donno2048/stringedit
+```
+## Usage
+
+To run the string editing use `stringed` or `python3 -m stringedit`
+
+```sh
+$ stringed -h
+usage: stringed [-h] [-n [number]] [-m {l,r,L}] filename
+
+Replace strings in binary files
+
+positional arguments:
+  filename              input filename
+
+optional arguments:
+  -h, --help            show this help message and exit
+  -n [number], --bytes [number]
+                        print amy string of at least [number] characters (default 4)
+  -m {l,r,L}, --method {l,r,L}
+                        method used to widen replacement string if it's too long l - pad with
+                        spaces from the left r - pad with spaces from the right L - leave
+                        everything after the replacement as it was
+```
+
+You can also use the `stringpr` to print all the strings, similar to the `strings` linux command.
+
+```sh
+$ stringpr -h
+usage: stringpr [-h] [-n [number]] [-t {o,d,x}] [-s <string>] filename
+
+Print strings in binary files
+
+positional arguments:
+  filename              input filename
+
+optional arguments:
+  -h, --help            show this help message and exit
+  -n [number], --bytes [number]
+                        print amy string of at least [number] characters (default 4)
+  -t {o,d,x}, --radix {o,d,x}
+                        print the location of the string in base 8, 10 or 16
+  -s <string>, --output-separator <string>
+                        string used to separate strings in output
+```
+
+## Uses
+
+- Could be used to create a modded version for a game by changing dialogues and such
+- Could theoretically be used to "steal" someones binary by just replacing any info (e.g. license) with the attacker's - removes the need to decompile, change and then recompile the binary
+- And more

stringedit-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

stringedit-1.0.0/setup.py

@@ -0,0 +1,24 @@
+from setuptools import setup, find_packages
+setup(
+    name='stringedit',
+    version='1.0.0',
+    license='MIT',
+    author='Elisha Hollander',
+    author_email='just4now666666@gmail.com',
+    description='Replace strings in binary files.',
+    long_description=open('README.md').read(),
+    long_description_content_type="text/markdown",
+    url='https://github.com/donno2048/stringedit',
+    project_urls={
+        'Documentation': 'https://github.com/donno2048/stringedit#readme',
+        'Bug Reports': 'https://github.com/donno2048/stringedit/issues',
+        'Source Code': 'https://github.com/donno2048/stringedit',
+    },
+    python_requires='>=3.0',
+    packages=find_packages(),
+    install_requires=["prompt_toolkit"],
+    entry_points={ 'console_scripts': [
+        'stringed=stringedit.__main__:edit_strings',
+        'stringpr=stringedit.__main__:print_strings',
+    ] }
+)

stringedit-1.0.0/stringedit/__init__.py

@@ -0,0 +1,69 @@
+from re import finditer
+from collections import OrderedDict
+from mmap import mmap, ACCESS_READ, ACCESS_WRITE
+from argparse import ArgumentTypeError
+from prompt_toolkit.validation import Validator, ValidationError
+
+def get_strings(min_length: int, binary: bytes) -> dict:
+    strings = {}
+    for match in finditer(rf"[\n -~]{{{min_length},}}".encode(), binary):
+        strings.setdefault(match.group(), []).append(match.start())
+    return strings
+def get_strings_from_file(min_length: int, fileno: int) -> dict:
+    with mmap(fileno, 0, access=ACCESS_READ) as mm:
+        return get_strings(min_length, mm)
+def get_sorted_strings_from_file(min_length: int, fileno: int) -> OrderedDict:
+    return OrderedDict(sorted(get_strings_from_file(min_length, fileno).items()))
+
+def print_ordered_strings(min_length: int, binary: bytes, radix: str = None, sep: str = None) -> None:
+    radix_format = f"{{:{radix}}} " if radix else ""
+    print(
+        *(radix_format.format(match.start()) + match.group().decode()
+            for match in finditer(rf"[\n -~]{{{min_length},}}".encode(), binary)),
+        sep=sep if sep is not None else '\n'
+    )
+def print_ordered_strings_from_file(min_length: int, fileno: int, radix: str = None, sep: str = None) -> None:
+    with mmap(fileno, 0, access=ACCESS_READ) as mm:
+        print_ordered_strings(min_length, mm, radix, sep)
+
+def replace_all_string(binary: bytes, starts: list, replacement: bytes) -> None:
+    for i, c in enumerate(replacement):
+        for start in starts:
+            binary[start + i] = c
+def replace_all_file(starts: dict, replacement: bytes, fileno: int) -> None:
+    with mmap(fileno, 0, access=ACCESS_WRITE) as mm:
+        replace_all_string(mm, starts, replacement)
+
+def int_gt_one(value: str) -> int:
+    try:
+        ivalue = int(value)
+    except ValueError:
+        raise ArgumentTypeError(f"{value} is not an integer")
+    if ivalue <= 1:
+        raise ArgumentTypeError("minimal byte count must be > 1")
+    return ivalue
+
+def radix_type(value: str) -> str:
+    if value not in "odx" and value is not None:
+        raise ArgumentTypeError("radix must be either o, d or x")
+    return value
+
+def method_type(value: str) -> str:
+    if value not in "lrL":
+        raise ArgumentTypeError("method must be either l, r or L")
+    return value
+
+class MaxLengthValidator(Validator):
+    def __init__(self, max_len):
+        super().__init__()
+        self.max_len = max_len
+    def validate(self, document):
+        if len(document.text) > self.max_len:
+            raise ValidationError(
+                message="Replacement cannot be longer than original string",
+                cursor_position=len(document.text)
+            )
+def sanitize(replacement: str, to_size: int, method: str = "L") -> str:
+    if method == 'l': return replacement.rjust(to_size)
+    if method == 'r': return replacement.ljust(to_size)
+    return replacement

stringedit-1.0.0/stringedit/__main__.py

@@ -0,0 +1,63 @@
+from argparse import ArgumentParser
+from prompt_toolkit.shortcuts import choice, input_dialog
+
+try:
+    from . import int_gt_one, radix_type, method_type, print_ordered_strings_from_file,\
+                  get_sorted_strings_from_file, MaxLengthValidator, replace_all_file, sanitize
+except ImportError:
+    from stringedit import int_gt_one, radix_type, method_type, print_ordered_strings_from_file,\
+                           get_sorted_strings_from_file, MaxLengthValidator, replace_all_file, sanitize
+
+def get_main_arguments() -> ArgumentParser:
+    parser = ArgumentParser(description="Replace strings in binary files")
+    parser.add_argument("filename", help="input filename")
+    parser.add_argument("-n", "--bytes", default=4, type=int_gt_one, metavar="[number]",
+                        help="print amy string of at least %(metavar)s characters (default %(default)s)")
+    return parser
+
+def get_print_arguments() -> ArgumentParser:
+    parser = get_main_arguments()
+    parser.description = "Print strings in binary files"
+    parser.add_argument("-t", "--radix", type=radix_type, metavar="{o,d,x}",
+                        help="print the location of the string in base 8, 10 or 16")
+    parser.add_argument("-s", "--output-separator", metavar="<string>",
+                        help="string used to separate strings in output")
+    return parser
+
+def get_edit_arguments() -> ArgumentParser:
+    parser = get_main_arguments()
+    parser.add_argument("-m", "--method", default='r', type=method_type, metavar="{l,r,L}",
+                        help="method used to widen replacement string if it's too long\n"
+                             "l - pad with spaces from the left\n"
+                             "r - pad with spaces from the right\n"
+                             "L - leave everything after the replacement as it was\n")
+    return parser
+
+def print_strings() -> None:
+    args = get_print_arguments().parse_args()
+    with open(args.filename, "rb") as file:
+        print_ordered_strings_from_file(args.bytes, file.fileno(), args.radix, args.output_separator)
+
+def edit_strings() -> None:
+    args = get_edit_arguments().parse_args()
+    with open(args.filename, "rb+") as file:
+        strings = get_sorted_strings_from_file(args.bytes, file.fileno())
+        while True:
+            string = choice(
+                message="The file is loaded please choose a string to edit:",
+                options=[(b'', "Save and Exit"), *((string, string.decode()) for string in strings.keys())],
+                mouse_support=True
+            )
+            if not string: break
+            replacement = input_dialog(
+                title=string.decode(),
+                text="Please enter a replacement",
+                ok_text="REPLACE",
+                validator=MaxLengthValidator(len(string))
+            ).run()
+            if replacement is not None:
+                replace_all_file(strings[string], sanitize(replacement, len(string), args.method).encode(), file.fileno())
+                strings[replacement.encode() + string[len(replacement):]] = strings.pop(string)
+
+if __name__ == '__main__':
+    edit_strings()

stringedit-1.0.0/stringedit.egg-info/PKG-INFO

@@ -0,0 +1,93 @@
+Metadata-Version: 2.4
+Name: stringedit
+Version: 1.0.0
+Summary: Replace strings in binary files.
+Home-page: https://github.com/donno2048/stringedit
+Author: Elisha Hollander
+Author-email: just4now666666@gmail.com
+License: MIT
+Project-URL: Documentation, https://github.com/donno2048/stringedit#readme
+Project-URL: Bug Reports, https://github.com/donno2048/stringedit/issues
+Project-URL: Source Code, https://github.com/donno2048/stringedit
+Requires-Python: >=3.0
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: prompt_toolkit
+Dynamic: author
+Dynamic: author-email
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# stringedit
+
+Replace strings in binary files.
+
+## Installation
+
+### From PyPI
+
+```sh
+pip3 install stringedit
+```
+
+### From GitHub
+
+```sh
+pip3 install git+https://github.com/donno2048/stringedit
+```
+## Usage
+
+To run the string editing use `stringed` or `python3 -m stringedit`
+
+```sh
+$ stringed -h
+usage: stringed [-h] [-n [number]] [-m {l,r,L}] filename
+
+Replace strings in binary files
+
+positional arguments:
+  filename              input filename
+
+optional arguments:
+  -h, --help            show this help message and exit
+  -n [number], --bytes [number]
+                        print amy string of at least [number] characters (default 4)
+  -m {l,r,L}, --method {l,r,L}
+                        method used to widen replacement string if it's too long l - pad with
+                        spaces from the left r - pad with spaces from the right L - leave
+                        everything after the replacement as it was
+```
+
+You can also use the `stringpr` to print all the strings, similar to the `strings` linux command.
+
+```sh
+$ stringpr -h
+usage: stringpr [-h] [-n [number]] [-t {o,d,x}] [-s <string>] filename
+
+Print strings in binary files
+
+positional arguments:
+  filename              input filename
+
+optional arguments:
+  -h, --help            show this help message and exit
+  -n [number], --bytes [number]
+                        print amy string of at least [number] characters (default 4)
+  -t {o,d,x}, --radix {o,d,x}
+                        print the location of the string in base 8, 10 or 16
+  -s <string>, --output-separator <string>
+                        string used to separate strings in output
+```
+
+## Uses
+
+- Could be used to create a modded version for a game by changing dialogues and such
+- Could theoretically be used to "steal" someones binary by just replacing any info (e.g. license) with the attacker's - removes the need to decompile, change and then recompile the binary
+- And more

stringedit-1.0.0/stringedit.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+setup.py
+stringedit/__init__.py
+stringedit/__main__.py
+stringedit.egg-info/PKG-INFO
+stringedit.egg-info/SOURCES.txt
+stringedit.egg-info/dependency_links.txt
+stringedit.egg-info/entry_points.txt
+stringedit.egg-info/requires.txt
+stringedit.egg-info/top_level.txt

stringedit-1.0.0/stringedit.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

stringedit-1.0.0/stringedit.egg-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+stringed = stringedit.__main__:edit_strings
+stringpr = stringedit.__main__:print_strings

stringedit-1.0.0/stringedit.egg-info/requires.txt

@@ -0,0 +1 @@
+prompt_toolkit

stringedit-1.0.0/stringedit.egg-info/top_level.txt

@@ -0,0 +1 @@
+stringedit