change default cli behavior, remove replace directive

Author: davidteather

.gitignore

@@ -5,4 +5,5 @@ build
 python_obfuscator.egg-info
 .pytest_cache
 .mypy_cache
-.ruff_cache
+.ruff_cache
+obfuscated/

README.md

@@ -18,14 +18,16 @@ pip install python-obfuscator
 
 ## Quickstart
 
-Print out obfuscated code
+By default, obfuscated code is written under an **`obfuscated/`** directory (created next to your current working directory). Paths under the current directory are preserved (e.g. `src/app.py` → `obfuscated/src/app.py`).
+
 ```
 pyobfuscate -i your_file.py
 ```
 
-Apply changes to the input file
+Print to stdout instead (e.g. for piping):
+
 ```
-pyobfuscate -i your_file.py -r True
+pyobfuscate -i your_file.py --stdout
 ```
 
 ## More Detailed Documentation
@@ -62,7 +64,7 @@ print("{} that's a great number!".format(user_value))
 [With `pyobfuscate -i file.py`](https://gist.github.com/davidteather/b6ff932140d8c174b9c6f50c9b42fdaf)
 
 
-[With `--one-liner True`](https://gist.github.com/davidteather/75e48c04bf74f0262fe2919239a74295)
+[With `--one-liner`](https://gist.github.com/davidteather/75e48c04bf74f0262fe2919239a74295)
 
 ## Authors
 

python_obfuscator/cli/__init__.py

@@ -6,6 +6,20 @@
 import python_obfuscator
 from python_obfuscator.techniques import one_liner as one_liner_technique
 
+DEFAULT_OUTPUT_DIR = "obfuscated"
+
+
+def _resolved_output_path(input_path: Path) -> Path:
+    """Write under ./obfuscated/, preserving path relative to cwd when possible."""
+    cwd = Path.cwd().resolve()
+    try:
+        rel = input_path.resolve().relative_to(cwd)
+    except ValueError:
+        rel = Path(input_path.name)
+    out = cwd / DEFAULT_OUTPUT_DIR / rel
+    out.parent.mkdir(parents=True, exist_ok=True)
+    return out
+
 
 def main(
     input_path: Annotated[
@@ -19,12 +33,11 @@ def main(
             readable=True,
         ),
     ],
-    replace: Annotated[
+    stdout: Annotated[
         bool,
         typer.Option(
-            "--replace",
-            "-r",
-            help="Overwrite the input file with obfuscated code.",
+            "--stdout",
+            help="Print obfuscated code to stdout instead of writing a file.",
         ),
     ] = False,
     include_one_liner: Annotated[
@@ -44,10 +57,12 @@ def main(
     data = input_path.read_text()
     obfuscated_data = obfuscate.obfuscate(data, remove_techniques=remove)
 
-    if replace:
-        input_path.write_text(obfuscated_data)
-    else:
+    if stdout:
         typer.echo(obfuscated_data)
+    else:
+        out_path = _resolved_output_path(input_path)
+        out_path.write_text(obfuscated_data)
+        typer.secho(f"Wrote {out_path}", err=True)
 
 
 def cli() -> None: