termux-playwright 1.61.0__tar.gz

termux_playwright-1.61.0/PKG-INFO

@@ -0,0 +1,69 @@
+Metadata-Version: 2.4
+Name: termux-playwright
+Version: 1.61.0
+Summary: Automated Playwright installer for Android Termux (aarch64)
+Home-page: https://github.com/uno-km/termux-playwright-demo
+Author: uno-km (쌩초보코딩단)
+Author-email: hosequelbo@gmail.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Environment :: Console
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-python
+Dynamic: summary
+
+# Termux-Playwright Automated Integration (S7 Edge Crawler)
+
+## 1. 개요 (Overview)
+본 프로젝트는 자원이 제한적인 안드로이드 디바이스(Samsung Galaxy S7)의 가상 리눅스 환경(Termux)에서 최신 동적 웹 스크래핑 프레임워크인 **Playwright**를 구동하기 위한 인프라 구축 및 자동화 데모 프로젝트입니다. 
+일반적으로 aarch64 안드로이드 환경에서는 공식 Playwright 바이너리가 호환되지 않아 구동이 불가능하지만, 본 프로젝트는 의존성 우회 설치 및 코어 엔진 패치를 통해 이 한계를 극복하고 24/7 무인 자동화 데이터 수집(Crawling)을 가능하게 합니다.
+
+## 2. 기술 (Technology Stack)
+* **OS & Environment**: Android 8.0 (Termux), Linux (aarch64)
+* **Language**: Python 3.11+, Node.js (v20+)
+* **Framework**: Playwright (Async API)
+* **Browser**: Chromium (Termux native package)
+* **Infrastructure**: Bash Shell Scripting (`node_manager.sh`)
+
+## 3. 로직 (Architecture & Logic)
+본 시스템은 안드로이드 아키텍처의 한계를 우회하기 위해 다음과 같은 3단계 핵심 로직으로 구성됩니다.
+
+1. **의존성(Dependency) 속임수 기법 (Wheel Renaming)**
+   - PyPI에서 제공하는 `manylinux_2_17_aarch64` 규격의 Playwright 휠(Wheel) 파일을 강제로 다운로드합니다.
+   - 단말기의 OS 종속성 검사를 피하기 위해 파일명을 `none-any.whl`로 변조하여 강제 설치(`--force-reinstall --no-deps`)를 수행합니다.
+
+2. **코어 엔진 런타임 패치 (Runtime Injection)**
+   - Playwright 내부의 Node.js 구동 엔진(`coreBundle.js`)은 시스템 환경이 `android`로 식별될 경우 즉시 `process.exit(1)`을 호출하여 실행을 중단합니다.
+   - Python 스크립트를 통해 `coreBundle.js` 내부 최상단에 `Object.defineProperty(process, "platform", {value: "linux"});` 코드를 주입(Inject)하여 플랫폼 검증 로직을 무력화합니다.
+
+3. **환경 변수 매핑 및 브라우저 샌드박스 비활성화**
+   - Playwright가 내장 브라우저가 아닌 Termux 패키지의 순정 Chromium(`PLAYWRIGHT_CHROMIUM_PATH`)과 Node.js(`PLAYWRIGHT_NODEJS_PATH`)를 사용하도록 환경변수를 바인딩합니다.
+   - 런타임 실행 시 안드로이드 커널과의 충돌을 방지하기 위해 샌드박스 해제 플래그(`--no-sandbox`, `--disable-setuid-sandbox`)를 반드시 포함합니다.
+
+## 4. 트러블슈팅 및 롤백 히스토리 (History of Failures)
+본 인프라가 안정화되기까지 겪었던 기술적 실패와 해결 과정의 기록입니다.
+
+* **[실패 1] 순정 `pip install playwright` 시도**
+  - **현상**: 컴파일 에러 및 브라우저 바이너리 다운로드 실패.
+  - **원인**: Playwright가 지원하는 aarch64 빌드는 Ubuntu/Debian 베이스를 상정하며, 안드로이드 Bionic libc와 호환되지 않음.
+  - **해결**: Termux 패키지 관리자(`pkg`)가 제공하는 네이티브 `chromium`을 사용하도록 경로를 수동 할당함.
+
+* **[실패 2] Node.js 실행 거부 (Platform Exception)**
+  - **현상**: Python 스크립트 실행 시 `Error: Unsupported platform: android` 발생 후 크래시.
+  - **원인**: Playwright의 Node.js 브릿지가 안드로이드를 식별하여 명시적으로 차단함.
+  - **해결**: 런타임 환경에서 `process.platform`을 `linux`로 강제 오버라이딩하는 자바스크립트 주입 패치 고안.
+
+* **[실패 3] 브라우저 Launch 시 Zombie Process 생성 및 타임아웃**
+  - **현상**: 브라우저 인스턴스는 생성되나 페이지 이동이 불가능하고 30초 후 타임아웃 됨.
+  - **원인**: 안드로이드 OS 커널의 권한 통제 메커니즘이 Chromium의 샌드박스(Sandbox) 프로세스 생성을 차단함.
+  - **해결**: Launch Args에 `--no-sandbox` 및 `--disable-setuid-sandbox` 플래그를 추가하여 권한 충돌 해소.
+
+이러한 수많은 시행착오 끝에, 단일 스크립트(`node_manager.sh`) 실행만으로 안드로이드 디바이스를 완전한 무인 크롤링 서버로 변환할 수 있는 파이프라인이 완성되었습니다.

termux_playwright-1.61.0/README.md

@@ -0,0 +1,47 @@
+# Termux-Playwright Automated Integration (S7 Edge Crawler)
+
+## 1. 개요 (Overview)
+본 프로젝트는 자원이 제한적인 안드로이드 디바이스(Samsung Galaxy S7)의 가상 리눅스 환경(Termux)에서 최신 동적 웹 스크래핑 프레임워크인 **Playwright**를 구동하기 위한 인프라 구축 및 자동화 데모 프로젝트입니다. 
+일반적으로 aarch64 안드로이드 환경에서는 공식 Playwright 바이너리가 호환되지 않아 구동이 불가능하지만, 본 프로젝트는 의존성 우회 설치 및 코어 엔진 패치를 통해 이 한계를 극복하고 24/7 무인 자동화 데이터 수집(Crawling)을 가능하게 합니다.
+
+## 2. 기술 (Technology Stack)
+* **OS & Environment**: Android 8.0 (Termux), Linux (aarch64)
+* **Language**: Python 3.11+, Node.js (v20+)
+* **Framework**: Playwright (Async API)
+* **Browser**: Chromium (Termux native package)
+* **Infrastructure**: Bash Shell Scripting (`node_manager.sh`)
+
+## 3. 로직 (Architecture & Logic)
+본 시스템은 안드로이드 아키텍처의 한계를 우회하기 위해 다음과 같은 3단계 핵심 로직으로 구성됩니다.
+
+1. **의존성(Dependency) 속임수 기법 (Wheel Renaming)**
+   - PyPI에서 제공하는 `manylinux_2_17_aarch64` 규격의 Playwright 휠(Wheel) 파일을 강제로 다운로드합니다.
+   - 단말기의 OS 종속성 검사를 피하기 위해 파일명을 `none-any.whl`로 변조하여 강제 설치(`--force-reinstall --no-deps`)를 수행합니다.
+
+2. **코어 엔진 런타임 패치 (Runtime Injection)**
+   - Playwright 내부의 Node.js 구동 엔진(`coreBundle.js`)은 시스템 환경이 `android`로 식별될 경우 즉시 `process.exit(1)`을 호출하여 실행을 중단합니다.
+   - Python 스크립트를 통해 `coreBundle.js` 내부 최상단에 `Object.defineProperty(process, "platform", {value: "linux"});` 코드를 주입(Inject)하여 플랫폼 검증 로직을 무력화합니다.
+
+3. **환경 변수 매핑 및 브라우저 샌드박스 비활성화**
+   - Playwright가 내장 브라우저가 아닌 Termux 패키지의 순정 Chromium(`PLAYWRIGHT_CHROMIUM_PATH`)과 Node.js(`PLAYWRIGHT_NODEJS_PATH`)를 사용하도록 환경변수를 바인딩합니다.
+   - 런타임 실행 시 안드로이드 커널과의 충돌을 방지하기 위해 샌드박스 해제 플래그(`--no-sandbox`, `--disable-setuid-sandbox`)를 반드시 포함합니다.
+
+## 4. 트러블슈팅 및 롤백 히스토리 (History of Failures)
+본 인프라가 안정화되기까지 겪었던 기술적 실패와 해결 과정의 기록입니다.
+
+* **[실패 1] 순정 `pip install playwright` 시도**
+  - **현상**: 컴파일 에러 및 브라우저 바이너리 다운로드 실패.
+  - **원인**: Playwright가 지원하는 aarch64 빌드는 Ubuntu/Debian 베이스를 상정하며, 안드로이드 Bionic libc와 호환되지 않음.
+  - **해결**: Termux 패키지 관리자(`pkg`)가 제공하는 네이티브 `chromium`을 사용하도록 경로를 수동 할당함.
+
+* **[실패 2] Node.js 실행 거부 (Platform Exception)**
+  - **현상**: Python 스크립트 실행 시 `Error: Unsupported platform: android` 발생 후 크래시.
+  - **원인**: Playwright의 Node.js 브릿지가 안드로이드를 식별하여 명시적으로 차단함.
+  - **해결**: 런타임 환경에서 `process.platform`을 `linux`로 강제 오버라이딩하는 자바스크립트 주입 패치 고안.
+
+* **[실패 3] 브라우저 Launch 시 Zombie Process 생성 및 타임아웃**
+  - **현상**: 브라우저 인스턴스는 생성되나 페이지 이동이 불가능하고 30초 후 타임아웃 됨.
+  - **원인**: 안드로이드 OS 커널의 권한 통제 메커니즘이 Chromium의 샌드박스(Sandbox) 프로세스 생성을 차단함.
+  - **해결**: Launch Args에 `--no-sandbox` 및 `--disable-setuid-sandbox` 플래그를 추가하여 권한 충돌 해소.
+
+이러한 수많은 시행착오 끝에, 단일 스크립트(`node_manager.sh`) 실행만으로 안드로이드 디바이스를 완전한 무인 크롤링 서버로 변환할 수 있는 파이프라인이 완성되었습니다.

termux_playwright-1.61.0/setup.cfg

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

termux_playwright-1.61.0/setup.py

@@ -0,0 +1,39 @@
+from setuptools import setup, find_packages
+from setuptools.command.install import install
+import sys
+import os
+
+class TermuxInstallCommand(install):
+    def run(self):
+        # 1. 일반적인 설치 진행
+        install.run(self)
+        
+        # 2. 패키지가 설치된 경로를 찾아서 커스텀 설치 스크립트 실행
+        try:
+            sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+            from termux_playwright.installer import run_post_install
+            run_post_install()
+        except Exception as e:
+            print(f"[!] Termux 커스텀 설치 로직 실행 중 에러 발생 (무시됨): {e}")
+
+setup(
+    name="termux-playwright",
+    version="1.61.0",
+    description="Automated Playwright installer for Android Termux (aarch64)",
+    long_description=open("README.md", encoding="utf-8").read(),
+    long_description_content_type="text/markdown",
+    author="uno-km (쌩초보코딩단)",
+    author_email="hosequelbo@gmail.com",
+    url="https://github.com/uno-km/termux-playwright-demo",
+    packages=find_packages(),
+    cmdclass={
+        'install': TermuxInstallCommand,
+    },
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: POSIX :: Linux",
+        "Environment :: Console",
+    ],
+    python_requires=">=3.8",
+)

termux_playwright-1.61.0/termux_playwright/__init__.py

@@ -0,0 +1,2 @@
+# termux_playwright package
+__version__ = "1.61.0"

termux_playwright-1.61.0/termux_playwright/installer.py

@@ -0,0 +1,69 @@
+import os
+import sys
+import subprocess
+import urllib.request
+import site
+
+def run_post_install():
+    print("="*50)
+    print("[RUN] Termux-Playwright (aarch64) 자동 설치 시작...")
+    print("="*50)
+
+    # 1. Termux 환경 확인
+    if "com.termux" not in os.environ.get("PREFIX", ""):
+        print("[!] 현재 환경이 Termux가 아닙니다. 기본 Playwright 설치로 진행합니다.")
+        os.system(f"{sys.executable} -m pip install playwright==1.61.0")
+        return
+
+    # 2. 시스템 패키지 설치 (chromium, nodejs)
+    print("[1/4] 기본 시스템 패키지(Chromium, Node.js) 설치 중...")
+    subprocess.run(["pkg", "install", "-y", "chromium", "nodejs"], check=False)
+
+    # 3. 우회 휠 다운로드 및 설치
+    print("[2/4] Playwright 1.61.0 휠 다운로드 및 우회 설치 중...")
+    whl_original = "playwright-1.61.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl"
+    whl_renamed = "playwright-1.61.0-py3-none-any.whl"
+    url = "https://files.pythonhosted.org/packages/b7/eb/e3f922348ec17c315f98c463f72faa1181a1c3de0bfe31a8d2edf6561723/" + whl_original
+
+    try:
+        if not os.path.exists(whl_renamed):
+            urllib.request.urlretrieve(url, whl_renamed)
+        os.system(f"{sys.executable} -m pip install {whl_renamed} --force-reinstall --no-deps -q")
+        os.remove(whl_renamed)
+    except Exception as e:
+        print(f"[X] 휠 다운로드 또는 설치 실패: {e}")
+        return
+
+    # 4. 일반 패키지 종속성 해결
+    print("[3/4] 파이썬 의존성 패키지 설치 중...")
+    os.system(f"{sys.executable} -m pip install greenlet pyee")
+
+    # 5. coreBundle.js 자동 패치 (안드로이드 차단 우회)
+    print("[4/4] Playwright 안드로이드 차단 우회(coreBundle.js) 패치 중...")
+    try:
+        site_packages = [p for p in site.getsitepackages() if os.path.isdir(p)][0]
+        core_bundle = os.path.join(site_packages, "playwright", "driver", "package", "lib", "coreBundle.js")
+        
+        if os.path.exists(core_bundle):
+            with open(core_bundle, 'r', encoding='utf-8') as f:
+                content = f.read()
+            
+            injection = 'Object.defineProperty(process, "platform", {value: "linux"});\nObject.defineProperty(require("os"), "platform", {value: () => "linux"});\n'
+            
+            if injection.split('\n')[0] not in content:
+                with open(core_bundle, 'w', encoding='utf-8') as f:
+                    f.write(injection + content)
+                print("[OK] coreBundle.js 패치 성공!")
+            else:
+                print("[OK] 이미 패치되어 있습니다.")
+        else:
+            print(f"[!] coreBundle.js 파일을 찾을 수 없습니다: {core_bundle}")
+    except Exception as e:
+        print(f"[X] 패치 적용 실패: {e}")
+
+    print("\n[SUCCESS] 모든 설치가 완료되었습니다!")
+    print("[NOTICE] 사용하실 때 파이썬 코드에서 os.environ['PLAYWRIGHT_CHROMIUM_PATH']를 반드시 지정해 주세요.")
+    print("="*50 + "\n")
+
+if __name__ == "__main__":
+    run_post_install()

termux_playwright-1.61.0/termux_playwright.egg-info/PKG-INFO

@@ -0,0 +1,69 @@
+Metadata-Version: 2.4
+Name: termux-playwright
+Version: 1.61.0
+Summary: Automated Playwright installer for Android Termux (aarch64)
+Home-page: https://github.com/uno-km/termux-playwright-demo
+Author: uno-km (쌩초보코딩단)
+Author-email: hosequelbo@gmail.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Environment :: Console
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: requires-python
+Dynamic: summary
+
+# Termux-Playwright Automated Integration (S7 Edge Crawler)
+
+## 1. 개요 (Overview)
+본 프로젝트는 자원이 제한적인 안드로이드 디바이스(Samsung Galaxy S7)의 가상 리눅스 환경(Termux)에서 최신 동적 웹 스크래핑 프레임워크인 **Playwright**를 구동하기 위한 인프라 구축 및 자동화 데모 프로젝트입니다. 
+일반적으로 aarch64 안드로이드 환경에서는 공식 Playwright 바이너리가 호환되지 않아 구동이 불가능하지만, 본 프로젝트는 의존성 우회 설치 및 코어 엔진 패치를 통해 이 한계를 극복하고 24/7 무인 자동화 데이터 수집(Crawling)을 가능하게 합니다.
+
+## 2. 기술 (Technology Stack)
+* **OS & Environment**: Android 8.0 (Termux), Linux (aarch64)
+* **Language**: Python 3.11+, Node.js (v20+)
+* **Framework**: Playwright (Async API)
+* **Browser**: Chromium (Termux native package)
+* **Infrastructure**: Bash Shell Scripting (`node_manager.sh`)
+
+## 3. 로직 (Architecture & Logic)
+본 시스템은 안드로이드 아키텍처의 한계를 우회하기 위해 다음과 같은 3단계 핵심 로직으로 구성됩니다.
+
+1. **의존성(Dependency) 속임수 기법 (Wheel Renaming)**
+   - PyPI에서 제공하는 `manylinux_2_17_aarch64` 규격의 Playwright 휠(Wheel) 파일을 강제로 다운로드합니다.
+   - 단말기의 OS 종속성 검사를 피하기 위해 파일명을 `none-any.whl`로 변조하여 강제 설치(`--force-reinstall --no-deps`)를 수행합니다.
+
+2. **코어 엔진 런타임 패치 (Runtime Injection)**
+   - Playwright 내부의 Node.js 구동 엔진(`coreBundle.js`)은 시스템 환경이 `android`로 식별될 경우 즉시 `process.exit(1)`을 호출하여 실행을 중단합니다.
+   - Python 스크립트를 통해 `coreBundle.js` 내부 최상단에 `Object.defineProperty(process, "platform", {value: "linux"});` 코드를 주입(Inject)하여 플랫폼 검증 로직을 무력화합니다.
+
+3. **환경 변수 매핑 및 브라우저 샌드박스 비활성화**
+   - Playwright가 내장 브라우저가 아닌 Termux 패키지의 순정 Chromium(`PLAYWRIGHT_CHROMIUM_PATH`)과 Node.js(`PLAYWRIGHT_NODEJS_PATH`)를 사용하도록 환경변수를 바인딩합니다.
+   - 런타임 실행 시 안드로이드 커널과의 충돌을 방지하기 위해 샌드박스 해제 플래그(`--no-sandbox`, `--disable-setuid-sandbox`)를 반드시 포함합니다.
+
+## 4. 트러블슈팅 및 롤백 히스토리 (History of Failures)
+본 인프라가 안정화되기까지 겪었던 기술적 실패와 해결 과정의 기록입니다.
+
+* **[실패 1] 순정 `pip install playwright` 시도**
+  - **현상**: 컴파일 에러 및 브라우저 바이너리 다운로드 실패.
+  - **원인**: Playwright가 지원하는 aarch64 빌드는 Ubuntu/Debian 베이스를 상정하며, 안드로이드 Bionic libc와 호환되지 않음.
+  - **해결**: Termux 패키지 관리자(`pkg`)가 제공하는 네이티브 `chromium`을 사용하도록 경로를 수동 할당함.
+
+* **[실패 2] Node.js 실행 거부 (Platform Exception)**
+  - **현상**: Python 스크립트 실행 시 `Error: Unsupported platform: android` 발생 후 크래시.
+  - **원인**: Playwright의 Node.js 브릿지가 안드로이드를 식별하여 명시적으로 차단함.
+  - **해결**: 런타임 환경에서 `process.platform`을 `linux`로 강제 오버라이딩하는 자바스크립트 주입 패치 고안.
+
+* **[실패 3] 브라우저 Launch 시 Zombie Process 생성 및 타임아웃**
+  - **현상**: 브라우저 인스턴스는 생성되나 페이지 이동이 불가능하고 30초 후 타임아웃 됨.
+  - **원인**: 안드로이드 OS 커널의 권한 통제 메커니즘이 Chromium의 샌드박스(Sandbox) 프로세스 생성을 차단함.
+  - **해결**: Launch Args에 `--no-sandbox` 및 `--disable-setuid-sandbox` 플래그를 추가하여 권한 충돌 해소.
+
+이러한 수많은 시행착오 끝에, 단일 스크립트(`node_manager.sh`) 실행만으로 안드로이드 디바이스를 완전한 무인 크롤링 서버로 변환할 수 있는 파이프라인이 완성되었습니다.

termux_playwright-1.61.0/termux_playwright.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+README.md
+setup.py
+termux_playwright/__init__.py
+termux_playwright/installer.py
+termux_playwright.egg-info/PKG-INFO
+termux_playwright.egg-info/SOURCES.txt
+termux_playwright.egg-info/dependency_links.txt
+termux_playwright.egg-info/top_level.txt

termux_playwright-1.61.0/termux_playwright.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

termux_playwright-1.61.0/termux_playwright.egg-info/top_level.txt

@@ -0,0 +1 @@
+termux_playwright