jscope 0.4.2__tar.gz → 0.4.3__tar.gz

{jscope-0.4.2 → jscope-0.4.3}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: jscope
-Version: 0.4.2
+Version: 0.4.3
 Summary: Evidence-based JavaScript intelligence for bug bounty hunters and web app pentesters
 Author: Muhammed Ali
 License-Expression: MIT
-Project-URL: Homepage, https://github.com/LIME1Star/JScope
-Project-URL: Issues, https://github.com/LIME1Star/JScope/issues
-Project-URL: Changelog, https://github.com/LIME1Star/JScope/blob/main/CHANGELOG.md
+Project-URL: Homepage, https://github.com/Lime27-Star/JScope
+Project-URL: Issues, https://github.com/Lime27-Star/JScope/issues
+Project-URL: Changelog, https://github.com/Lime27-Star/JScope/blob/main/CHANGELOG.md
 Keywords: security,bug-bounty,pentest,javascript,static-analysis,appsec,recon
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
@@ -37,7 +37,6 @@ Requires-Dist: build; extra == "dev"
 Requires-Dist: twine; extra == "dev"
 Dynamic: license-file
 
-
 <p align="center">
   <picture>
     <source media="(prefers-color-scheme: dark)" srcset="assets/logo-dark.svg">
@@ -51,7 +50,7 @@ Dynamic: license-file
 </p>
 
 <p align="center">
-  <a href="https://github.com/LIME1Star/JScope/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/LIME1Star/JScope/actions/workflows/ci.yml/badge.svg"></a>
+  <a href="https://github.com/Lime27-Star/JScope/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/Lime27-Star/JScope/actions/workflows/ci.yml/badge.svg"></a>
   <img alt="Python 3.10+" src="https://img.shields.io/badge/python-3.10%2B-blue">
   <img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-green">
 </p>
@@ -95,11 +94,11 @@ Try it yourself on the bundled fixture (`tests/sample_react`).
 ## Install
 
 ```bash
-pip install git+https://github.com/LIME1Star/JScope.git
+pip install git+https://github.com/Lime27-Star/JScope.git
 jscope doctor        # checks your install
 ```
 
-Python 3.10+. For YAML OpenAPI specs: `pip install "jscope[yaml] @ git+https://github.com/LIME1Star/JScope.git"`.
+Python 3.10+. For YAML OpenAPI specs: `pip install "jscope[yaml] @ git+https://github.com/Lime27-Star/JScope.git"`.
 
 ## Quick start
 
@@ -166,7 +165,7 @@ JScope is a **beta development tool, not a production scanner.** Be aware of the
 ## Development
 
 ```bash
-git clone https://github.com/LIME1Star/JScope && cd JScope
+git clone https://github.com/Lime27-Star/JScope && cd JScope
 python -m venv .venv && . .venv/bin/activate
 pip install -e ".[dev]"
 pytest

{jscope-0.4.2 → jscope-0.4.3}/README.md

@@ -1,4 +1,3 @@
-
 <p align="center">
   <picture>
     <source media="(prefers-color-scheme: dark)" srcset="assets/logo-dark.svg">
@@ -12,7 +11,7 @@
 </p>
 
 <p align="center">
-  <a href="https://github.com/LIME1Star/JScope/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/LIME1Star/JScope/actions/workflows/ci.yml/badge.svg"></a>
+  <a href="https://github.com/Lime27-Star/JScope/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/Lime27-Star/JScope/actions/workflows/ci.yml/badge.svg"></a>
   <img alt="Python 3.10+" src="https://img.shields.io/badge/python-3.10%2B-blue">
   <img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-green">
 </p>
@@ -56,11 +55,11 @@ Try it yourself on the bundled fixture (`tests/sample_react`).
 ## Install
 
 ```bash
-pip install git+https://github.com/LIME1Star/JScope.git
+pip install git+https://github.com/Lime27-Star/JScope.git
 jscope doctor        # checks your install
 ```
 
-Python 3.10+. For YAML OpenAPI specs: `pip install "jscope[yaml] @ git+https://github.com/LIME1Star/JScope.git"`.
+Python 3.10+. For YAML OpenAPI specs: `pip install "jscope[yaml] @ git+https://github.com/Lime27-Star/JScope.git"`.
 
 ## Quick start
 
@@ -127,7 +126,7 @@ JScope is a **beta development tool, not a production scanner.** Be aware of the
 ## Development
 
 ```bash
-git clone https://github.com/LIME1Star/JScope && cd JScope
+git clone https://github.com/Lime27-Star/JScope && cd JScope
 python -m venv .venv && . .venv/bin/activate
 pip install -e ".[dev]"
 pytest

jscope-0.4.3/jscope/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.4.3"

{jscope-0.4.2 → jscope-0.4.3}/jscope/cli.py

@@ -18,6 +18,7 @@ from jscope.core.graph import KnowledgeGraph
 from jscope import __version__
 from jscope.pipeline import run_analysis
 from jscope.reporting import human, json_report
+from jscope import terminal
 
 
 def _emit(text: str, output: str | None) -> None:
@@ -29,6 +30,14 @@ def _emit(text: str, output: str | None) -> None:
         print(text)
 
 
+def _run_analysis(paths, config, label: str = "Inspecting JavaScript and related source files"):
+    """Run the existing engine with JScope's terminal activity treatment."""
+    if sys.stderr.isatty():
+        terminal.banner()
+    with terminal.activity(label):
+        return run_analysis(paths, config)
+
+
 def _print_report(res, fmt: str, verbose: bool, output: str | None = None):
     if fmt in ("markdown", "md", "html", "sarif"):
         from jscope.reporting.formats import render_payload
@@ -57,7 +66,7 @@ def cmd_analyze(args: argparse.Namespace) -> int:
         config.data["source_maps"]["expand"] = True
     for pth in args.plugin_path or []:
         config.data["plugins"]["paths"].append(pth)
-    res = run_analysis(args.paths, config)
+    res = _run_analysis(args.paths, config)
 
     if res.file_count == 0:
         print("no analyzable files (JavaScript, HTML, OpenAPI, GraphQL schema, WASM) found at given path(s)", file=sys.stderr)
@@ -159,7 +168,7 @@ def cmd_go(args: argparse.Namespace) -> int:
 
     if local_path.exists():
         print(f"-> local path: {local_path}", file=sys.stderr)
-        res = run_analysis([str(local_path)], config)
+        res = _run_analysis([str(local_path)], config, "Inspecting local target")
         if res.file_count == 0:
             print("no analyzable files (JavaScript, HTML, OpenAPI, GraphQL schema, WASM) found at that path", file=sys.stderr)
             return 1
@@ -200,7 +209,7 @@ def cmd_go(args: argparse.Namespace) -> int:
         failed = [r for r in results if not r.ok]
         print(f"      saved {ok} file(s)" + (f", {len(failed)} failed (run `jscope download {url_list} --out <dir>` to see why)" if failed else ""), file=sys.stderr)
         print("[3/3] analyzing ...", file=sys.stderr)
-        res = run_analysis([str(site_dir)], config)
+        res = _run_analysis([str(site_dir)], config, "Analyzing downloaded source")
         if res.file_count == 0:
             print("downloaded files contained nothing analyzable", file=sys.stderr)
             return 1
@@ -415,7 +424,7 @@ def cmd_scan(args: argparse.Namespace) -> int:
             config.data["min_confidence"] = args.min_confidence
         if args.format:
             config.data["output"]["format"] = args.format
-        res = run_analysis([str(root)], config)
+        res = _run_analysis([str(root)], config, "Analyzing workspace target")
         if res.file_count == 0:
             print("downloaded files contained nothing analyzable", file=sys.stderr)
             return 1
@@ -442,7 +451,7 @@ def cmd_graph(args: argparse.Namespace) -> int:
         graph = KnowledgeGraph.from_dict(data["graph"])
     else:
         config = Config.load(args.config)
-        res = run_analysis([args.source], config)
+        res = _run_analysis([args.source], config, "Analyzing input source")
         graph = res.graph
     chains = graph.route_chains()
     if args.format == "json":

jscope-0.4.3/jscope/terminal.py

@@ -0,0 +1,96 @@
+"""JScope's terminal presentation layer.
+
+Presentation only: analysis, findings, and report generation remain independent.
+Animations are restricted to interactive terminals; redirected output stays plain.
+"""
+from __future__ import annotations
+
+import itertools
+import os
+import sys
+import threading
+import time
+from contextlib import contextmanager
+
+
+class _Style:
+    RESET = "\x1b[0m"
+    DIM = "\x1b[2m"
+    BOLD = "\x1b[1m"
+    WHITE = "\x1b[97m"
+    SILVER = "\x1b[37m"
+    LIME = "\x1b[38;5;154m"
+    AMBER = "\x1b[38;5;214m"
+    RED = "\x1b[38;5;203m"
+
+
+def _color_enabled(stream) -> bool:
+    return bool(getattr(stream, "isatty", lambda: False)()) and not os.environ.get("NO_COLOR") and os.environ.get("TERM") != "dumb"
+
+
+def _paint(value: str, code: str, enabled: bool) -> str:
+    return f"{code}{value}{_Style.RESET}" if enabled else value
+
+
+def feather() -> str:
+    """Small ASCII-native signature: reliable across terminal fonts and encodings."""
+    enabled = _color_enabled(sys.stderr)
+    return _paint("//>", _Style.LIME + _Style.BOLD, enabled)
+
+
+def banner() -> None:
+    """Print the compact White Hawk identity; never pollute machine-readable stdout."""
+    enabled = _color_enabled(sys.stderr)
+    mark = _paint("//>", _Style.LIME + _Style.BOLD, enabled)
+    name = _paint("JSCOPE", _Style.WHITE + _Style.BOLD, enabled)
+    tagline = _paint("JavaScript Intelligence", _Style.DIM, enabled)
+    print(f"\n  {mark}  {name}  {tagline}", file=sys.stderr)
+
+
+@contextmanager
+def activity(label: str, *, announce: bool = True):
+    """Show a quiet live indicator on TTYs, and deterministic status on other streams."""
+    stream = sys.stderr
+    tty = _color_enabled(stream)
+    if announce and not tty:
+        print(f"[>] {label}...", file=stream)
+        try:
+            yield
+        except BaseException:
+            print(f"[x] {label} failed", file=stream)
+            raise
+        else:
+            print(f"[+] {label} complete", file=stream)
+        return
+
+    if not tty:
+        yield
+        return
+
+    frames = itertools.cycle(("⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"))
+    stopped = threading.Event()
+    def animate() -> None:
+        while not stopped.is_set():
+            frame = next(frames)
+            line = f"\r  {_paint(frame, _Style.LIME, True)}  {_paint(label, _Style.SILVER, True)}"
+            stream.write(line)
+            stream.flush()
+            stopped.wait(0.085)
+    thread = threading.Thread(target=animate, daemon=True)
+    if announce:
+        thread.start()
+    failed = False
+    try:
+        yield
+    except BaseException:
+        failed = True
+        raise
+    finally:
+        if announce:
+            stopped.set()
+            thread.join(timeout=0.3)
+            stream.write("\r\x1b[2K")
+            marker = _paint('x' if failed else '+', (_Style.RED if failed else _Style.LIME) + _Style.BOLD, True)
+            suffix = "failed" if failed else "complete"
+            stream.write(f"  {marker}  {_paint(label, _Style.SILVER, True)} {_paint(suffix, _Style.DIM, True)}\n")
+            stream.flush()

{jscope-0.4.2 → jscope-0.4.3}/jscope.egg-info/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.4
 Name: jscope
-Version: 0.4.2
+Version: 0.4.3
 Summary: Evidence-based JavaScript intelligence for bug bounty hunters and web app pentesters
 Author: Muhammed Ali
 License-Expression: MIT
-Project-URL: Homepage, https://github.com/LIME1Star/JScope
-Project-URL: Issues, https://github.com/LIME1Star/JScope/issues
-Project-URL: Changelog, https://github.com/LIME1Star/JScope/blob/main/CHANGELOG.md
+Project-URL: Homepage, https://github.com/Lime27-Star/JScope
+Project-URL: Issues, https://github.com/Lime27-Star/JScope/issues
+Project-URL: Changelog, https://github.com/Lime27-Star/JScope/blob/main/CHANGELOG.md
 Keywords: security,bug-bounty,pentest,javascript,static-analysis,appsec,recon
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
@@ -37,7 +37,6 @@ Requires-Dist: build; extra == "dev"
 Requires-Dist: twine; extra == "dev"
 Dynamic: license-file
 
-
 <p align="center">
   <picture>
     <source media="(prefers-color-scheme: dark)" srcset="assets/logo-dark.svg">
@@ -51,7 +50,7 @@ Dynamic: license-file
 </p>
 
 <p align="center">
-  <a href="https://github.com/LIME1Star/JScope/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/LIME1Star/JScope/actions/workflows/ci.yml/badge.svg"></a>
+  <a href="https://github.com/Lime27-Star/JScope/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/Lime27-Star/JScope/actions/workflows/ci.yml/badge.svg"></a>
   <img alt="Python 3.10+" src="https://img.shields.io/badge/python-3.10%2B-blue">
   <img alt="License: MIT" src="https://img.shields.io/badge/license-MIT-green">
 </p>
@@ -95,11 +94,11 @@ Try it yourself on the bundled fixture (`tests/sample_react`).
 ## Install
 
 ```bash
-pip install git+https://github.com/LIME1Star/JScope.git
+pip install git+https://github.com/Lime27-Star/JScope.git
 jscope doctor        # checks your install
 ```
 
-Python 3.10+. For YAML OpenAPI specs: `pip install "jscope[yaml] @ git+https://github.com/LIME1Star/JScope.git"`.
+Python 3.10+. For YAML OpenAPI specs: `pip install "jscope[yaml] @ git+https://github.com/Lime27-Star/JScope.git"`.
 
 ## Quick start
 
@@ -166,7 +165,7 @@ JScope is a **beta development tool, not a production scanner.** Be aware of the
 ## Development
 
 ```bash
-git clone https://github.com/LIME1Star/JScope && cd JScope
+git clone https://github.com/Lime27-Star/JScope && cd JScope
 python -m venv .venv && . .venv/bin/activate
 pip install -e ".[dev]"
 pytest

{jscope-0.4.2 → jscope-0.4.3}/jscope.egg-info/SOURCES.txt

@@ -10,6 +10,7 @@ jscope/config.py
 jscope/passive_discovery.py
 jscope/pipeline.py
 jscope/security_transport.py
+jscope/terminal.py
 jscope.egg-info/PKG-INFO
 jscope.egg-info/SOURCES.txt
 jscope.egg-info/dependency_links.txt

{jscope-0.4.2 → jscope-0.4.3}/pyproject.toml

@@ -38,9 +38,9 @@ browser = ["playwright>=1.40"]
 dev = ["pytest>=7", "PyYAML>=6.0", "build", "twine"]
 
 [project.urls]
-Homepage = "https://github.com/LIME1Star/JScope"
-Issues = "https://github.com/LIME1Star/JScope/issues"
-Changelog = "https://github.com/LIME1Star/JScope/blob/main/CHANGELOG.md"
+Homepage = "https://github.com/Lime27-Star/JScope"
+Issues = "https://github.com/Lime27-Star/JScope/issues"
+Changelog = "https://github.com/Lime27-Star/JScope/blob/main/CHANGELOG.md"
 
 [project.scripts]
 jscope = "jscope.cli:main"

jscope-0.4.2/jscope/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.4.2"