invisible-core 18.0.0__tar.gz

invisible_core-18.0.0/.gitignore

@@ -0,0 +1,11 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.pytest_cache/
+.venv/
+venv/
+*.bak
+*-bak
+*._backup

invisible_core-18.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 stealthfox contributors
+
+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.

invisible_core-18.0.0/PKG-INFO

@@ -0,0 +1,58 @@
+Metadata-Version: 2.4
+Name: invisible-core
+Version: 18.0.0
+Summary: Pure config for a stealth Firefox profile: seed -> fingerprint -> prefs, engine download, proxy, geo. Zero Playwright.
+Project-URL: Homepage, https://github.com/feder-cr/invisible_core
+Project-URL: Repository, https://github.com/feder-cr/invisible_core
+Project-URL: Issues, https://github.com/feder-cr/invisible_core/issues
+Author-email: feder-cr <85809106+feder-cr@users.noreply.github.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: anti-detect,automation,browser,fingerprint,firefox,privacy,stealth
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
+Classifier: Topic :: Software Development :: Testing
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: maxminddb>=2.2
+Requires-Dist: platformdirs>=4
+Requires-Dist: requests[socks]>=2.31
+Requires-Dist: tzdata>=2024.1
+Provides-Extra: dev
+Requires-Dist: build>=1; extra == 'dev'
+Requires-Dist: pytest-mock>=3; extra == 'dev'
+Requires-Dist: pytest>=7; extra == 'dev'
+Requires-Dist: responses>=0.24; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# invisible_core
+
+Pure config for a patched Firefox stealth profile - **zero Playwright dependency**.
+
+`seed → fingerprint profile → Firefox prefs`, plus patched-binary download,
+proxy config, and geo/timezone resolution. This is the shared foundation used by:
+
+- **invisible_playwright** - the Playwright automation wrapper (`InvisiblePlaywright`).
+- **invisible_firefox** - the antidetect profile manager (launches the binary directly).
+
+```bash
+pip install invisible-core
+```
+
+```python
+from invisible_core import generate_profile, translate_profile_to_prefs, ensure_binary
+
+profile = generate_profile(seed=42)          # deterministic Bayesian fingerprint
+prefs   = translate_profile_to_prefs(profile)  # dict of Firefox user prefs
+binary  = ensure_binary()                     # path to the patched Firefox binary
+```
+
+Same seed → same fingerprint, every time.

invisible_core-18.0.0/README.md

@@ -0,0 +1,23 @@
+# invisible_core
+
+Pure config for a patched Firefox stealth profile - **zero Playwright dependency**.
+
+`seed → fingerprint profile → Firefox prefs`, plus patched-binary download,
+proxy config, and geo/timezone resolution. This is the shared foundation used by:
+
+- **invisible_playwright** - the Playwright automation wrapper (`InvisiblePlaywright`).
+- **invisible_firefox** - the antidetect profile manager (launches the binary directly).
+
+```bash
+pip install invisible-core
+```
+
+```python
+from invisible_core import generate_profile, translate_profile_to_prefs, ensure_binary
+
+profile = generate_profile(seed=42)          # deterministic Bayesian fingerprint
+prefs   = translate_profile_to_prefs(profile)  # dict of Firefox user prefs
+binary  = ensure_binary()                     # path to the patched Firefox binary
+```
+
+Same seed → same fingerprint, every time.

invisible_core-18.0.0/pyproject.toml

@@ -0,0 +1,88 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "invisible-core"
+# Derived from the seal (see src/invisible_core/_version.py): the tag number of
+# the engine this core is sealed to, so a binary bump always moves the version
+# string pip compares before it decides whether to reinstall. A core-only fix
+# against the same engine moves CORE_REVISION instead, by hand - and
+# scripts/version_gate.py refuses to publish content that changed under a
+# version string that did not.
+dynamic = ["version"]
+description = "Pure config for a stealth Firefox profile: seed -> fingerprint -> prefs, engine download, proxy, geo. Zero Playwright."
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "feder-cr", email = "85809106+feder-cr@users.noreply.github.com" }]
+keywords = [
+    "firefox",
+    "stealth",
+    "anti-detect",
+    "fingerprint",
+    "browser",
+    "automation",
+    "privacy",
+]
+# No `License :: OSI Approved :: MIT License` classifier: PEP 639 says the
+# License-Expression field above is the declaration, and a build tool must not
+# add the classifier beside it.
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Internet :: WWW/HTTP :: Browsers",
+    "Topic :: Software Development :: Testing",
+    "Typing :: Typed",
+]
+# No direct URL (`name @ git+https://...`) may appear here. A public index
+# rejects an upload whose Requires-Dist carries one, and a direct reference
+# carries no version specifier, so `pip check` has nothing to compare and
+# reports a definitively broken environment as healthy.
+dependencies = [
+    "platformdirs>=4",
+    "requests[socks]>=2.31",
+    "maxminddb>=2.2",
+    "tzdata>=2024.1",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=7", "pytest-mock>=3", "responses>=0.24", "build>=1"]
+
+[project.scripts]
+invisible-core = "invisible_core.__main__:main"
+
+[project.urls]
+Homepage = "https://github.com/feder-cr/invisible_core"
+Repository = "https://github.com/feder-cr/invisible_core"
+Issues = "https://github.com/feder-cr/invisible_core/issues"
+
+[tool.pytest.ini_options]
+markers = [
+    "unit: pure-logic tests, no I/O or external deps",
+    "integration: multi-module tests, no browser",
+]
+addopts = "-m 'not slow'"
+
+[tool.hatch.version]
+source = "code"
+path = "src/invisible_core/_version.py"
+expression = "__version__"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/invisible_core"]
+exclude = ["*.bak", "*-bak"]
+
+# PUBLISHED.json and scripts/ are deliberately absent from both targets. The
+# ledger records a digest of what ships, so it must never be part of what ships:
+# a self-referential ledger would invalidate its own digest on every release.
+[tool.hatch.build.targets.sdist]
+include = ["src/invisible_core", "tests", "README.md", "LICENSE", "pyproject.toml"]

invisible_core-18.0.0/src/invisible_core/__init__.py

@@ -0,0 +1,109 @@
+"""invisible_core - pure config for a patched Firefox stealth profile.
+
+Zero Playwright dependency: seed -> fingerprint profile -> Firefox prefs,
+binary download, proxy config, geo/timezone resolution. This is the shared
+foundation used by both:
+  - invisible_playwright (the Playwright automation wrapper), and
+  - invisible_firefox (the antidetect profile manager, launches the binary directly).
+
+Quickstart:
+
+    from invisible_core import generate_profile, translate_profile_to_prefs, ensure_binary
+
+    profile = generate_profile(seed=42)
+    prefs   = translate_profile_to_prefs(profile)   # dict for firefox user prefs
+    binary  = ensure_binary()                        # path to the patched Firefox
+"""
+from ._fpforge import (
+    AudioProfile,
+    CodecProfile,
+    GPUProfile,
+    HardwareProfile,
+    Profile,
+    ScreenProfile,
+    WebGLProfile,
+    generate_profile,
+)
+from ._webgl_personas import forced_gpu_class, select_persona, render_noise_seed
+from .prefs import translate_profile_to_prefs
+from .download import ensure_binary, ensure_geoip_mmdb
+from ._geo import (
+    GeoTimezoneError,
+    discover_egress_ip,
+    ip_to_timezone,
+    prepare_session_geo,
+    resolve_session_locale,
+    resolve_session_timezone,
+)
+from ._headless import cloak_prefs, make_virtual_display
+from ._proxy import configure_proxy
+from .config import get_default_args, get_default_stealth_prefs
+from .constants import BINARY_VERSION, FIREFOX_UPSTREAM_VERSION
+from .launch import LaunchPlan, build_launch_env, build_launch_plan, write_user_js
+
+# One headline version, and it is the honest one.
+#
+# `__version__` is DERIVED from the seal this package ships (invisible_core/
+# seal.json -> _version.py), so it describes the code that is about to run. That
+# is the number to put in a bug report, and the number both consumers pin with
+# `invisible-core==`.
+#
+# `__install_record_version__` is a different fact: what the installer wrote into
+# the .dist-info when the distribution was put there. It can disagree - measured
+# in this tree: record 0.1.0, files 18.0.0 - and when it does, the record is the
+# stale one while the files are what executes. It is kept because `pip`, `pip
+# check` and the doctor's "STALE RECORD" line all read it, and diagnosing that
+# skew needs both numbers. It is named so it cannot be mistaken for the version.
+from ._version import __version__
+
+from importlib.metadata import PackageNotFoundError, version as _pkg_version
+
+try:
+    __install_record_version__ = _pkg_version("invisible-core")
+except PackageNotFoundError:
+    # Running from a source checkout with no install record at all.
+    __install_record_version__ = ""
+
+__all__ = [
+    # fingerprint generation
+    "generate_profile",
+    "Profile",
+    "GPUProfile",
+    "ScreenProfile",
+    "HardwareProfile",
+    "AudioProfile",
+    "CodecProfile",
+    "WebGLProfile",
+    # webgl personas
+    "forced_gpu_class",
+    "select_persona",
+    "render_noise_seed",
+    # prefs
+    "translate_profile_to_prefs",
+    "get_default_stealth_prefs",
+    "get_default_args",
+    # binary + geoip
+    "ensure_binary",
+    "ensure_geoip_mmdb",
+    # geo / timezone
+    "resolve_session_timezone",
+    "resolve_session_locale",
+    "prepare_session_geo",
+    "discover_egress_ip",
+    "ip_to_timezone",
+    "GeoTimezoneError",
+    # proxy + headless helpers
+    "configure_proxy",
+    "cloak_prefs",
+    "make_virtual_display",
+    # direct-launch helpers (shared by the wrapper + the profile manager)
+    "build_launch_plan",
+    "LaunchPlan",
+    "build_launch_env",
+    "write_user_js",
+    # constants
+    "BINARY_VERSION",
+    "FIREFOX_UPSTREAM_VERSION",
+    "__version__",
+    "__install_record_version__",
+]