ultralight-py 0.4.0__tar.gz

ultralight_py-0.4.0/.github/workflows/wheels.yml

@@ -0,0 +1,225 @@
+name: Wheels
+
+on:
+  workflow_dispatch:
+    inputs:
+      publish:
+        description: Publish this version tag to PyPI after environment approval
+        type: boolean
+        default: false
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  validate:
+    runs-on: ubuntu-24.04
+    outputs:
+      name: ${{ steps.validate.outputs.name }}
+      version: ${{ steps.validate.outputs.version }}
+      commit: ${{ steps.validate.outputs.commit }}
+      publish: ${{ steps.validate.outputs.publish }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ github.sha }}
+          persist-credentials: false
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+      - run: python -m pip install packaging 'pytest>=8,<10'
+      - name: Test release validation gates
+        run: python -m pytest scripts/tests -q
+      - name: Validate version and publication request
+        id: validate
+        env:
+          PUBLISH: ${{ inputs.publish || false }}
+          RELEASE_TAG: ${{ github.event.release.tag_name }}
+        run: python scripts/release.py validate
+
+  build_sdist:
+    needs: validate
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ needs.validate.outputs.commit }}
+          submodules: recursive
+          persist-credentials: false
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+      - run: python -m pip install build twine packaging
+      - name: Build and validate standalone sdist
+        env:
+          VERSION: ${{ needs.validate.outputs.version }}
+        run: |
+          python -m build --sdist
+          python scripts/release.py sdist --version "$VERSION"
+          python -m twine check --strict dist/*
+      - uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+          if-no-files-found: error
+          retention-days: 30
+
+  build_wheels:
+    needs: [validate, build_sdist]
+    runs-on: ${{ matrix.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: ubuntu-24.04
+            platform: linux-x64
+          - runner: windows-2022
+            platform: windows-x64
+          - runner: macos-14
+            platform: macos-arm64
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ needs.validate.outputs.commit }}
+          persist-credentials: false
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+      - run: python -m pip install packaging
+      - uses: actions/download-artifact@v4
+        with:
+          name: sdist
+          path: sdist
+      - name: Extract the validated sdist
+        shell: bash
+        env:
+          VERSION: ${{ needs.validate.outputs.version }}
+        run: python scripts/release.py sdist --directory sdist --version "$VERSION" --extract build-input
+      - run: python -m pip install cibuildwheel==4.3.1
+      - name: Build, repair and test installed wheels
+        working-directory: build-input/source
+        shell: bash
+        run: python -m cibuildwheel --output-dir ../../wheelhouse .
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.platform }}
+          path: wheelhouse/*.whl
+          if-no-files-found: error
+          retention-days: 30
+
+  assemble:
+    needs: [validate, build_sdist, build_wheels]
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ needs.validate.outputs.commit }}
+          persist-credentials: false
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+      - run: python -m pip install twine packaging
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-*
+          path: collected
+      - uses: actions/download-artifact@v4
+        with:
+          name: sdist
+          path: collected/sdist
+      - name: Collect packages without overwriting duplicate filenames
+        run: |
+          python - <<'PY'
+          from pathlib import Path
+          import shutil
+          output = Path('dist')
+          output.mkdir()
+          for artifact in Path('collected').iterdir():
+              for package in artifact.iterdir():
+                  target = output / package.name
+                  if target.exists():
+                      raise SystemExit(f'Duplicate package filename: {package.name}')
+                  shutil.copyfile(package, target)
+          PY
+      - name: Validate the complete matrix and create SHA-256 manifest
+        env:
+          VERSION: ${{ needs.validate.outputs.version }}
+          COMMIT: ${{ needs.validate.outputs.commit }}
+        run: |
+          python scripts/release.py assemble --version "$VERSION" --commit "$COMMIT"
+          python -m twine check --strict dist/*
+      - uses: actions/upload-artifact@v4
+        id: packages
+        with:
+          name: release-packages
+          path: dist/*
+          if-no-files-found: error
+          retention-days: 30
+      - uses: actions/upload-artifact@v4
+        id: manifest
+        with:
+          name: release-manifest
+          path: release-manifest/*
+          if-no-files-found: error
+          retention-days: 30
+      - name: Human verification instructions
+        env:
+          PACKAGES_URL: ${{ steps.packages.outputs.artifact-url }}
+          MANIFEST_URL: ${{ steps.manifest.outputs.artifact-url }}
+          VERSION: ${{ needs.validate.outputs.version }}
+          COMMIT: ${{ needs.validate.outputs.commit }}
+          PUBLISH: ${{ needs.validate.outputs.publish }}
+        run: |
+          {
+            echo "## ultralight-py $VERSION"
+            echo "Source commit: $COMMIT; SDK: 2.0.0-beta.2; publish requested: $PUBLISH"
+            echo ""
+            echo "[Download release-packages]($PACKAGES_URL) · [Download SHA-256 manifest]($MANIFEST_URL)"
+            echo ""
+            echo "15 tested wheels and one standalone sdist; artifacts expire after 30 days."
+            echo "Download both artifacts, verify SHA-256, and install the matching wheel in a fresh environment."
+            echo "Follow README's installed-wheel test instructions on all three platforms before approving pypi."
+            echo "Approval publishes these exact files without rebuilding. Reject approval if verification fails."
+          } >> "$GITHUB_STEP_SUMMARY"
+
+  publish_pypi:
+    needs: [validate, assemble]
+    if: needs.validate.outputs.publish == 'true'
+    runs-on: ubuntu-24.04
+    environment:
+      name: pypi
+      url: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: ${{ needs.validate.outputs.commit }}
+          persist-credentials: false
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+      - run: python -m pip install packaging
+      - uses: actions/download-artifact@v4
+        with:
+          name: release-packages
+          path: dist
+      - uses: actions/download-artifact@v4
+        with:
+          name: release-manifest
+          path: release-manifest
+      - name: Verify the approved files and provenance
+        env:
+          VERSION: ${{ needs.validate.outputs.version }}
+          COMMIT: ${{ needs.validate.outputs.commit }}
+        run: python scripts/release.py verify --version "$VERSION" --commit "$COMMIT"
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

ultralight_py-0.4.0/.gitignore

@@ -0,0 +1,15 @@
+# Python and local environments
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+
+# Build artifacts
+/build/
+/dist/
+/_skbuild/
+*.whl
+.DS_Store
+
+# Ruff cache
+.ruff_cache/

ultralight_py-0.4.0/.gitmodules

@@ -0,0 +1,6 @@
+[submodule "externals/pybind11"]
+	path = externals/pybind11
+	url = https://github.com/pybind/pybind11.git
+[submodule "externals/ulbind17"]
+	path = externals/ulbind17
+	url = https://github.com/shabbywu/ulbind17.git

ultralight_py-0.4.0/.python-version

@@ -0,0 +1 @@
+3.13.16

ultralight_py-0.4.0/CHANGELOG.md

@@ -0,0 +1,14 @@
+# 更新日志
+
+## 未发布
+
+- 增加多订阅事件与主框架页面状态；旧回调槽替换不影响内部等待和独立订阅。
+- 提供被动 `wait_ready/wait_settled/wait_until/wait_for_selector`、结构化 PageLoadError，处理导航、关闭、超时和取消。
+- 增加可选 ScriptDriver：宿主注入推进回调，或显式启用共享的按需循环；脚本导航跟随未完成的引擎导航链。
+- 增加 `ScriptPage.expect_navigation`，在点击/提交前登记等待；动作与新页面就绪共用超时预算。
+- Runtime 支持 `cache_path`，配置磁盘缓存及浏览器持久化存储目录，遵循首次初始化冻结规则。
+- 支持 Python 实例和容器实时代理、绑定隔离及撤销。
+- 提供 `Python.to_value()`，将 Python 容器复制为普通 JS Array／Object。
+- 支持 JS Promise 等待、异步求值和调用，以及 Python awaitable 转 JS Promise。
+- 提供 asyncio 定时驱动入口；await 不隐式调用 `Runtime.update()`。
+- 取消、解绑、导航、关闭及驱动器失败时清理相关等待和投递。

ultralight_py-0.4.0/CMakeLists.txt

@@ -0,0 +1,43 @@
+cmake_minimum_required(VERSION 3.22)
+project(ultralight_py VERSION 0.4.0 LANGUAGES CXX)
+
+set(CMAKE_CXX_STANDARD 20)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_CXX_EXTENSIONS OFF)
+set(CMAKE_POSITION_INDEPENDENT_CODE ON)
+set(BUILD_TESTING OFF CACHE BOOL "Build dependency tests")
+set(ULTRALIGHT_SDK_VERSION "2.0.0-beta.2" CACHE STRING "Ultralight SDK version")
+
+set(PYBIND11_FINDPYTHON ON)
+find_package(Python COMPONENTS Interpreter Development.Module REQUIRED)
+add_subdirectory(externals/pybind11)
+add_subdirectory(externals/ulbind17 EXCLUDE_FROM_ALL)
+
+pybind11_add_module(_native MODULE bindings/module.cpp)
+target_link_libraries(_native PRIVATE ulbind17::ulbind17)
+ulbind17_copy_runtime_files(_native INCLUDE_APPCORE OFF)
+install(TARGETS _native LIBRARY DESTINATION ultralight_py RUNTIME DESTINATION ultralight_py)
+foreach(library IN ITEMS UltralightCore WebCore Ultralight)
+  install(FILES "$<TARGET_FILE:Ultralight::${library}>" DESTINATION ultralight_py)
+endforeach()
+
+if(APPLE)
+  # SDK dylibs refer to their peers via @rpath without a usable package-local
+  # LC_RPATH. Make the installed copies self-contained, including for delocate's
+  # per-library dependency analysis, then restore their ad-hoc signatures.
+  install(CODE [[
+    set(_package "$ENV{DESTDIR}${CMAKE_INSTALL_PREFIX}/ultralight_py")
+    foreach(_library IN ITEMS UltralightCore WebCore Ultralight)
+      set(_file "${_package}/lib${_library}.dylib")
+      foreach(_dependency IN ITEMS UltralightCore WebCore Ultralight)
+        execute_process(
+          COMMAND /usr/bin/install_name_tool
+            -change "@rpath/lib${_dependency}.dylib"
+            "@loader_path/lib${_dependency}.dylib" "${_file}"
+          COMMAND_ERROR_IS_FATAL ANY)
+      endforeach()
+      execute_process(COMMAND /usr/bin/codesign --force --sign - "${_file}"
+        COMMAND_ERROR_IS_FATAL ANY)
+    endforeach()
+  ]])
+endif()