vulpfest 1.0.0__tar.gz → 1.0.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (36) hide show
  1. vulpfest-1.0.2/.github/dependabot.yml +10 -0
  2. vulpfest-1.0.2/.github/workflows/publish.yml +49 -0
  3. {vulpfest-1.0.0 → vulpfest-1.0.2}/PKG-INFO +4 -2
  4. {vulpfest-1.0.0 → vulpfest-1.0.2}/README.md +3 -1
  5. {vulpfest-1.0.0 → vulpfest-1.0.2}/pyproject.toml +1 -1
  6. vulpfest-1.0.2/src/vulpfest/__init__.py +1 -0
  7. {vulpfest-1.0.0 → vulpfest-1.0.2}/src/vulpfest/__main__.py +31 -21
  8. vulpfest-1.0.2/src/vulpfest/banner.py +60 -0
  9. vulpfest-1.0.2/src/vulpfest/i18n.py +79 -0
  10. {vulpfest-1.0.0 → vulpfest-1.0.2}/src/vulpfest/logo.py +19 -19
  11. {vulpfest-1.0.0/src/vulpfest/tools/scanner → vulpfest-1.0.2/src/vulpfest/tools/scamcheck}/ssrf_guard.py +142 -142
  12. {vulpfest-1.0.0 → vulpfest-1.0.2}/src/vulpfest/tools/scanner/auth_scan.py +175 -175
  13. {vulpfest-1.0.0 → vulpfest-1.0.2}/src/vulpfest/tools/scanner/cli.py +167 -167
  14. {vulpfest-1.0.0 → vulpfest-1.0.2}/src/vulpfest/tools/scanner/deep_web.py +353 -353
  15. {vulpfest-1.0.0 → vulpfest-1.0.2}/src/vulpfest/tools/scanner/dns_email.py +202 -202
  16. {vulpfest-1.0.0 → vulpfest-1.0.2}/src/vulpfest/tools/scanner/manual_review.py +60 -60
  17. {vulpfest-1.0.0 → vulpfest-1.0.2}/src/vulpfest/tools/scanner/repo_scan.py +434 -434
  18. {vulpfest-1.0.0 → vulpfest-1.0.2}/src/vulpfest/tools/scanner/scanner.py +885 -885
  19. {vulpfest-1.0.0/src/vulpfest/tools/scamcheck → vulpfest-1.0.2/src/vulpfest/tools/scanner}/ssrf_guard.py +142 -142
  20. vulpfest-1.0.2/tests/test_cli.py +41 -0
  21. vulpfest-1.0.0/src/vulpfest/__init__.py +0 -1
  22. vulpfest-1.0.0/src/vulpfest/banner.py +0 -69
  23. vulpfest-1.0.0/tests/test_cli.py +0 -27
  24. {vulpfest-1.0.0 → vulpfest-1.0.2}/.github/FUNDING.yml +0 -0
  25. {vulpfest-1.0.0 → vulpfest-1.0.2}/.gitignore +0 -0
  26. {vulpfest-1.0.0 → vulpfest-1.0.2}/LICENSE +0 -0
  27. {vulpfest-1.0.0 → vulpfest-1.0.2}/SECURITY.md +0 -0
  28. {vulpfest-1.0.0 → vulpfest-1.0.2}/src/vulpfest/tools/gmapscout/cli.py +0 -0
  29. {vulpfest-1.0.0 → vulpfest-1.0.2}/src/vulpfest/tools/gmapscout/gmapscout_core.py +0 -0
  30. {vulpfest-1.0.0 → vulpfest-1.0.2}/src/vulpfest/tools/leadscout/cli.py +0 -0
  31. {vulpfest-1.0.0 → vulpfest-1.0.2}/src/vulpfest/tools/leadscout/leadscout_core.py +0 -0
  32. {vulpfest-1.0.0 → vulpfest-1.0.2}/src/vulpfest/tools/scamcheck/checker.py +0 -0
  33. {vulpfest-1.0.0 → vulpfest-1.0.2}/src/vulpfest/tools/scamcheck/cli.py +0 -0
  34. {vulpfest-1.0.0 → vulpfest-1.0.2}/src/vulpfest/ui.py +0 -0
  35. {vulpfest-1.0.0 → vulpfest-1.0.2}/tools/make_logo.py +0 -0
  36. {vulpfest-1.0.0 → vulpfest-1.0.2}/tools/sync_tools.py +0 -0
@@ -0,0 +1,10 @@
1
+ version: 2
2
+ updates:
3
+ - package-ecosystem: github-actions
4
+ directory: /
5
+ schedule:
6
+ interval: weekly
7
+ - package-ecosystem: pip
8
+ directory: /
9
+ schedule:
10
+ interval: weekly
@@ -0,0 +1,49 @@
1
+ name: Publish to PyPI
2
+
3
+ # Terbit otomatis saat sebuah Release dipublikasikan di GitHub.
4
+ # Tanpa token: PyPI mempercayai workflow ini lewat Trusted Publishing (OIDC).
5
+ on:
6
+ release:
7
+ types: [published]
8
+
9
+ permissions:
10
+ contents: read
11
+
12
+ jobs:
13
+ build:
14
+ runs-on: ubuntu-latest
15
+ steps:
16
+ - uses: actions/checkout@v4
17
+ - uses: actions/setup-python@v5
18
+ with:
19
+ python-version: "3.12"
20
+ - name: Tag must match package version
21
+ run: |
22
+ TAG="${GITHUB_REF_NAME#v}"
23
+ VER=$(python -c "import tomllib; print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])")
24
+ if [ "$TAG" != "$VER" ]; then echo "Release tag $GITHUB_REF_NAME does not match version $VER in pyproject.toml"; exit 1; fi
25
+ - name: Test
26
+ run: |
27
+ python -m pip install -e . pytest
28
+ python -m pytest -q tests
29
+ - name: Build
30
+ run: |
31
+ python -m pip install build
32
+ python -m build
33
+ - uses: actions/upload-artifact@v4
34
+ with:
35
+ name: dist
36
+ path: dist/
37
+
38
+ publish:
39
+ needs: build
40
+ runs-on: ubuntu-latest
41
+ environment: pypi
42
+ permissions:
43
+ id-token: write # izin sementara untuk Trusted Publishing, hanya di job ini
44
+ steps:
45
+ - uses: actions/download-artifact@v4
46
+ with:
47
+ name: dist
48
+ path: dist/
49
+ - uses: pypa/gh-action-pypi-publish@release/v1
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: vulpfest
3
- Version: 1.0.0
3
+ Version: 1.0.2
4
4
  Summary: Vulpfest Lab tools in one place: a web security scanner and a scam-link checker, from your terminal.
5
5
  Project-URL: Homepage, https://lab.vulpfest.com
6
6
  Project-URL: Source, https://github.com/vulpfest/vulpfest-cli
@@ -38,6 +38,8 @@ Description-Content-Type: text/markdown
38
38
 
39
39
  # vulpfest
40
40
 
41
+ [![PyPI](https://img.shields.io/pypi/v/vulpfest)](https://pypi.org/project/vulpfest/)
42
+
41
43
  All four free tools from [Vulpfest Lab](https://lab.vulpfest.com) in one terminal command. Type `vulpfest`,
42
44
  pick a tool from the menu, and run it — on Windows, macOS or Linux.
43
45
 
@@ -57,7 +59,7 @@ pip install vulpfest # Cyber Web Scanner + Scam Check (light)
57
59
  pip install "vulpfest[all]" # adds LeadScout and GMaps Scout
58
60
  ```
59
61
 
60
- Until the package is on PyPI, install it straight from GitHub:
62
+ Or install the latest code straight from GitHub:
61
63
 
62
64
  ```bash
63
65
  pip install "vulpfest[all] @ git+https://github.com/vulpfest/vulpfest-cli"
@@ -7,6 +7,8 @@
7
7
 
8
8
  # vulpfest
9
9
 
10
+ [![PyPI](https://img.shields.io/pypi/v/vulpfest)](https://pypi.org/project/vulpfest/)
11
+
10
12
  All four free tools from [Vulpfest Lab](https://lab.vulpfest.com) in one terminal command. Type `vulpfest`,
11
13
  pick a tool from the menu, and run it — on Windows, macOS or Linux.
12
14
 
@@ -26,7 +28,7 @@ pip install vulpfest # Cyber Web Scanner + Scam Check (light)
26
28
  pip install "vulpfest[all]" # adds LeadScout and GMaps Scout
27
29
  ```
28
30
 
29
- Until the package is on PyPI, install it straight from GitHub:
31
+ Or install the latest code straight from GitHub:
30
32
 
31
33
  ```bash
32
34
  pip install "vulpfest[all] @ git+https://github.com/vulpfest/vulpfest-cli"
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
4
4
 
5
5
  [project]
6
6
  name = "vulpfest"
7
- version = "1.0.0"
7
+ version = "1.0.2"
8
8
  description = "Vulpfest Lab tools in one place: a web security scanner and a scam-link checker, from your terminal."
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.9"
@@ -0,0 +1 @@
1
+ __version__ = "1.0.2"
@@ -1,7 +1,8 @@
1
1
  """Perintah `vulpfest`: menu interaktif + menjalankan keempat tools Vulpfest Lab.
2
2
 
3
- vulpfest menu: pilih tool dengan nomor
4
- vulpfest scan example.com Cyber Web Scanner
3
+ vulpfest menu: pilih tool dengan nomor
4
+ vulpfest --lang id menu berbahasa Indonesia (atau --lang en)
5
+ vulpfest scan example.com Cyber Web Scanner
5
6
  vulpfest check suspicious.link Scam Check
6
7
  vulpfest leads --roles ... --industries ... LeadScout
7
8
  vulpfest gmaps "coffee shop jakarta" GMaps Scout
@@ -12,6 +13,7 @@ from pathlib import Path
12
13
 
13
14
  from . import __version__
14
15
  from .banner import render
16
+ from .i18n import TEXT, detect_lang
15
17
 
16
18
  TOOLS_DIR = Path(__file__).resolve().parent / "tools"
17
19
  TOOLS = {"scan": "scanner", "check": "scamcheck", "leads": "leadscout", "gmaps": "gmapscout"}
@@ -38,11 +40,12 @@ def _utf8():
38
40
  pass
39
41
 
40
42
 
41
- def run_tool(key, args):
43
+ def run_tool(key, args, lang="en"):
44
+ t = TEXT[lang]
42
45
  if key in NEEDS and key not in available():
43
- print(f'{key} needs extra packages: pip install "vulpfest[{key}]"', file=sys.stderr)
46
+ print(t["needs_extra"].format(key, key), file=sys.stderr)
44
47
  if key == "gmaps":
45
- print("GMaps Scout also needs Google Chrome installed.", file=sys.stderr)
48
+ print(t["needs_chrome"], file=sys.stderr)
46
49
  return 2
47
50
  tool_dir = TOOLS_DIR / TOOLS[key]
48
51
  sys.path.insert(0, str(tool_dir))
@@ -59,50 +62,57 @@ def run_tool(key, args):
59
62
  return rc if isinstance(rc, int) else 0
60
63
 
61
64
 
62
- def interactive():
63
- print(render(available()))
65
+ def interactive(lang):
66
+ t = TEXT[lang]
67
+ print(render(available(), lang))
64
68
  try:
65
- choice = input("\nPilih tool (1-4), Enter untuk keluar: ").strip().lower()
69
+ choice = input("\n" + t["choose"]).strip().lower()
66
70
  if not choice:
67
71
  return 0
68
72
  key = ORDER[int(choice) - 1] if choice.isdigit() and 1 <= int(choice) <= 4 else choice
69
73
  if key not in TOOLS:
70
- print("Pilihan tidak dikenal.")
74
+ print(t["unknown_choice"])
71
75
  return 2
72
76
  if key == "scan":
73
- args = [input("Website (mis. example.com): ").strip()]
77
+ args = [input(t["ask_site"]).strip()]
74
78
  elif key == "check":
75
- args = [input("Tautan yang ingin diperiksa: ").strip()]
79
+ args = [input(t["ask_link"]).strip()]
76
80
  elif key == "leads":
77
- args = ["--roles", input("Roles, pisahkan dengan koma: ").strip(),
78
- "--industries", input("Industries, pisahkan dengan koma: ").strip()]
81
+ args = ["--roles", input(t["ask_roles"]).strip(), "--industries", input(t["ask_industries"]).strip()]
79
82
  else:
80
- args = [input("Kata kunci pencarian (mis. coffee shop jakarta): ").strip()]
83
+ args = [input(t["ask_query"]).strip()]
81
84
  except (EOFError, KeyboardInterrupt):
82
85
  print()
83
86
  return 0
84
87
  print()
85
- return run_tool(key, args)
88
+ return run_tool(key, args, lang)
86
89
 
87
90
 
88
91
  def main(argv=None):
89
92
  _utf8()
90
93
  argv = list(sys.argv[1:] if argv is None else argv)
94
+ lang = detect_lang()
95
+ if len(argv) >= 2 and argv[0] == "--lang" and argv[1].lower() in TEXT:
96
+ lang, argv = argv[1].lower(), argv[2:]
97
+ t = TEXT[lang]
91
98
  if not argv:
92
- return interactive() if sys.stdin.isatty() else (print(render(available())) or 0)
99
+ if sys.stdin.isatty():
100
+ return interactive(lang)
101
+ print(render(available(), lang))
102
+ return 0
93
103
  head = argv[0].lower()
94
104
  if head in ("-h", "--help", "help", "menu"):
95
- print(render(available()))
105
+ print(render(available(), lang))
96
106
  return 0
97
107
  if head in ("-v", "--version", "version"):
98
108
  print(f"vulpfest {__version__}")
99
109
  return 0
100
110
  if head not in TOOLS:
101
- print(f"Tool tidak dikenal: {argv[0]}\n")
102
- print(render(available()))
111
+ print(t["unknown_tool"].format(argv[0]) + "\n")
112
+ print(render(available(), lang))
103
113
  return 2
104
- return run_tool(head, argv[1:])
114
+ return run_tool(head, argv[1:], lang)
105
115
 
106
116
 
107
117
  if __name__ == "__main__":
108
- sys.exit(main())
118
+ sys.exit(main())
@@ -0,0 +1,60 @@
1
+ """Menu gaya neofetch: logo Vulpfest (dibuat dari path SVG asli) di kiri, daftar tools di kanan."""
2
+ from . import __version__
3
+ from .i18n import TEXT
4
+ from .logo import LOGO
5
+ from .ui import c, rgb
6
+
7
+ SAND, ROSE = (243, 222, 186), (232, 165, 152) # gradasi warna logo
8
+ _W = len(LOGO[0])
9
+ FOX = [l.ljust(_W) for l in LOGO + ["", "V U L P F E S T".center(_W)]]
10
+
11
+ # (perintah, nama, butuh paket tambahan?)
12
+ TOOLS = [
13
+ ("scan", "Cyber Web Scanner", None),
14
+ ("check", "Scam Check", None),
15
+ ("leads", "LeadScout", "need_leads"),
16
+ ("gmaps", "GMaps Scout", "need_gmaps"),
17
+ ]
18
+
19
+
20
+ def gradient(line):
21
+ n = max(len(line) - 1, 1)
22
+ out = []
23
+ for i, ch in enumerate(line):
24
+ if ch == " ":
25
+ out.append(ch)
26
+ continue
27
+ k = i / n
28
+ out.append(rgb(ch, *(round(SAND[j] + (ROSE[j] - SAND[j]) * k) for j in range(3))))
29
+ return "".join(out)
30
+
31
+
32
+ def render(available, lang="en"):
33
+ """available: kunci tool yang paket tambahannya sudah terpasang."""
34
+ t = TEXT.get(lang, TEXT["en"])
35
+ info = [
36
+ c("Vulpfest Lab", "fox", "bold") + c(f" v{__version__}", "gray"),
37
+ c("─" * 34, "gray"),
38
+ c(t["tagline"], "white"),
39
+ "",
40
+ c(t["tools"], "bold"),
41
+ ]
42
+ for n, (key, name, need) in enumerate(TOOLS, 1):
43
+ ok = need is None or key in available
44
+ dot = c("●", "green") if ok else c("○", "yellow")
45
+ info.append(f" {dot} {c(str(n) + '.', 'bold')} {c(name, 'bold', 'white')} " + c(f"(vulpfest {key})", "cyan"))
46
+ info.append(" " + c(t["desc"][key], "gray"))
47
+ if not ok:
48
+ info.append(" " + c(t[need], "yellow"))
49
+ info += [
50
+ "",
51
+ c(t["examples"], "bold") + c(" vulpfest scan example.com", "cyan"),
52
+ " " * (len(t["examples"]) + 2) + c("vulpfest check bca-co-id.xyz", "cyan"),
53
+ c(t["help"], "bold") + c(" vulpfest <tool> --help", "cyan"),
54
+ c(t["switch"], "gray"),
55
+ ]
56
+ fox = [gradient(line) for line in FOX]
57
+ rows = max(len(fox), len(info))
58
+ return "\n".join(
59
+ f"{fox[i] if i < len(fox) else ' ' * _W} {info[i] if i < len(info) else ''}" for i in range(rows)
60
+ )
@@ -0,0 +1,79 @@
1
+ """Bahasa menu: Inggris bawaan, Indonesia bila sistem berbahasa Indonesia atau diminta (--lang / VULPFEST_LANG)."""
2
+ import locale
3
+ import os
4
+ import warnings
5
+
6
+
7
+ def detect_lang():
8
+ env = (os.environ.get("VULPFEST_LANG") or "").strip().lower()
9
+ if env in ("en", "id"):
10
+ return env
11
+ if os.name == "nt":
12
+ try:
13
+ import ctypes
14
+ if ctypes.windll.kernel32.GetUserDefaultUILanguage() & 0x3FF == 0x21: # 0x21 = Indonesian
15
+ return "id"
16
+ except Exception:
17
+ pass
18
+ names = [os.environ.get(v, "") for v in ("LC_ALL", "LC_MESSAGES", "LANG", "LANGUAGE")]
19
+ try:
20
+ with warnings.catch_warnings():
21
+ warnings.simplefilter("ignore")
22
+ names.append(locale.getdefaultlocale()[0] or "")
23
+ except Exception:
24
+ pass
25
+ for n in names:
26
+ n = n.lower()
27
+ if n.startswith("id") or "indonesia" in n:
28
+ return "id"
29
+ return "en"
30
+
31
+
32
+ TEXT = {
33
+ "en": {
34
+ "tagline": "Free tools for web security and scam protection.",
35
+ "tools": "Tools:", "examples": "Examples:", "help": "Help:",
36
+ "need_leads": "needs: pip install vulpfest[leads]",
37
+ "need_gmaps": "needs: pip install vulpfest[gmaps] + Chrome",
38
+ "desc": {
39
+ "scan": "Check your own website (headers, SSL, exposed files, DNS).",
40
+ "check": "Check a suspicious link before you click it.",
41
+ "leads": "Research B2B prospects from public search results.",
42
+ "gmaps": "Turn public business listings into a spreadsheet.",
43
+ },
44
+ "switch": "Bahasa Indonesia: vulpfest --lang id",
45
+ "choose": "Choose a tool (1-4), Enter to quit: ",
46
+ "unknown_choice": "Unknown choice.",
47
+ "ask_site": "Website (e.g. example.com): ",
48
+ "ask_link": "Link to check: ",
49
+ "ask_roles": "Roles, comma separated: ",
50
+ "ask_industries": "Industries, comma separated: ",
51
+ "ask_query": "Search query (e.g. coffee shop in Bali): ",
52
+ "unknown_tool": "Unknown tool: {}",
53
+ "needs_extra": '{} needs extra packages: pip install "vulpfest[{}]"',
54
+ "needs_chrome": "GMaps Scout also needs Google Chrome installed.",
55
+ },
56
+ "id": {
57
+ "tagline": "Alat gratis untuk keamanan web dan anti-penipuan.",
58
+ "tools": "Tools:", "examples": "Contoh:", "help": "Bantuan:",
59
+ "need_leads": "perlu: pip install vulpfest[leads]",
60
+ "need_gmaps": "perlu: pip install vulpfest[gmaps] + Chrome",
61
+ "desc": {
62
+ "scan": "Periksa keamanan situs Anda (header, SSL, file bocor, DNS).",
63
+ "check": "Periksa tautan mencurigakan sebelum diklik.",
64
+ "leads": "Riset prospek B2B dari hasil pencarian publik.",
65
+ "gmaps": "Kumpulkan detail bisnis publik ke spreadsheet.",
66
+ },
67
+ "switch": "English: vulpfest --lang en",
68
+ "choose": "Pilih tool (1-4), Enter untuk keluar: ",
69
+ "unknown_choice": "Pilihan tidak dikenal.",
70
+ "ask_site": "Website (mis. example.com): ",
71
+ "ask_link": "Tautan yang ingin diperiksa: ",
72
+ "ask_roles": "Roles, pisahkan dengan koma: ",
73
+ "ask_industries": "Industries, pisahkan dengan koma: ",
74
+ "ask_query": "Kata kunci pencarian (mis. coffee shop jakarta): ",
75
+ "unknown_tool": "Tool tidak dikenal: {}",
76
+ "needs_extra": '{} perlu paket tambahan: pip install "vulpfest[{}]"',
77
+ "needs_chrome": "GMaps Scout juga perlu Google Chrome terpasang.",
78
+ },
79
+ }
@@ -1,19 +1,19 @@
1
- """Dibuat otomatis oleh tools/make_logo.py dari path SVG logo Vulpfest."""
2
- LOGO = [
3
- ' ▄▄ ▄▄ ',
4
- ' ████▄ ▄████ ',
5
- ' ████▀██▄ ▄██▀████ ',
6
- ' ████ ▀██▄▄ ▄▄██▀ ████ ',
7
- ' ▀███ ▀▀██▄ ██ ▄██▀▀ ███▀ ',
8
- ' ███▄ ▀███▄▀▀▄███▀ ▄███ ',
9
- ' ███ ▀██████▀ ███ ',
10
- ' ███ ▀▀ ███ ',
11
- ' ▀██▄ ▄ ▄ ▄██▀ ',
12
- ' ██████▄ ▄██████ ',
13
- ' ▀█▀██▄ ▄████▀ ',
14
- ' ▀███ ███▀ ',
15
- ' ▀███▄▄███▀ ',
16
- ' ██████ ',
17
- ' ▀██▀ ',
18
- ' ▀▀ ',
19
- ]
1
+ """Dibuat otomatis oleh tools/make_logo.py dari path SVG logo Vulpfest."""
2
+ LOGO = [
3
+ ' ▄▄ ▄▄ ',
4
+ ' ████▄ ▄████ ',
5
+ ' ████▀██▄ ▄██▀████ ',
6
+ ' ████ ▀██▄▄ ▄▄██▀ ████ ',
7
+ ' ▀███ ▀▀██▄ ██ ▄██▀▀ ███▀ ',
8
+ ' ███▄ ▀███▄▀▀▄███▀ ▄███ ',
9
+ ' ███ ▀██████▀ ███ ',
10
+ ' ███ ▀▀ ███ ',
11
+ ' ▀██▄ ▄ ▄ ▄██▀ ',
12
+ ' ██████▄ ▄██████ ',
13
+ ' ▀█▀██▄ ▄████▀ ',
14
+ ' ▀███ ███▀ ',
15
+ ' ▀███▄▄███▀ ',
16
+ ' ██████ ',
17
+ ' ▀██▀ ',
18
+ ' ▀▀ ',
19
+ ]