SFML 2.6.2.0__tar.gz

sfml-2.6.2.0/.github/scripts/FindOpenAL.cmake

@@ -0,0 +1,143 @@
+# Distributed under the OSI-approved BSD 3-Clause License.  See accompanying
+# file Copyright.txt or https://cmake.org/licensing for details.
+
+#[=======================================================================[.rst:
+FindOpenAL
+----------
+
+Finds Open Audio Library (OpenAL).
+
+Projects using this module should use ``#include "al.h"`` to include the OpenAL
+header file, **not** ``#include <AL/al.h>``.  The reason for this is that the
+latter is not entirely portable.  Windows/Creative Labs does not by default put
+their headers in ``AL/`` and macOS uses the convention ``<OpenAL/al.h>``.
+
+Hints
+^^^^^
+
+Environment variable ``$OPENALDIR`` can be used to set the prefix of OpenAL
+installation to be found.
+
+By default on macOS, system framework is search first.  In other words,
+OpenAL is searched in the following order:
+
+1. System framework: ``/System/Library/Frameworks``, whose priority can be
+   changed via setting the :variable:`CMAKE_FIND_FRAMEWORK` variable.
+2. Environment variable ``$OPENALDIR``.
+3. System paths.
+4. User-compiled framework: ``~/Library/Frameworks``.
+5. Manually compiled framework: ``/Library/Frameworks``.
+6. Add-on package: ``/opt``.
+
+IMPORTED Targets
+^^^^^^^^^^^^^^^^
+
+.. versionadded:: 3.25
+
+This module defines the :prop_tgt:`IMPORTED` target:
+
+``OpenAL::OpenAL``
+  The OpenAL library, if found.
+
+Result Variables
+^^^^^^^^^^^^^^^^
+
+This module defines the following variables:
+
+``OPENAL_FOUND``
+  If false, do not try to link to OpenAL
+``OPENAL_INCLUDE_DIR``
+  OpenAL include directory
+``OPENAL_LIBRARY``
+  Path to the OpenAL library
+``OPENAL_VERSION_STRING``
+  Human-readable string containing the version of OpenAL
+#]=======================================================================]
+
+# For Windows, Creative Labs seems to have added a registry key for their
+# OpenAL 1.1 installer. I have added that key to the list of search paths,
+# however, the key looks like it could be a little fragile depending on
+# if they decide to change the 1.00.0000 number for bug fix releases.
+# Also, they seem to have laid down groundwork for multiple library platforms
+# which puts the library in an extra subdirectory. Currently there is only
+# Win32 and I have hardcoded that here. This may need to be adjusted as
+# platforms are introduced.
+# The OpenAL 1.0 installer doesn't seem to have a useful key I can use.
+# I do not know if the Nvidia OpenAL SDK has a registry key.
+
+find_path(OPENAL_INCLUDE_DIR al.h
+  HINTS
+    ENV OPENALDIR
+  PATHS
+    ~/Library/Frameworks
+    /Library/Frameworks
+    /opt
+    [HKEY_LOCAL_MACHINE\\SOFTWARE\\Creative\ Labs\\OpenAL\ 1.1\ Software\ Development\ Kit\\1.00.0000;InstallDir]
+  PATH_SUFFIXES include/AL include/OpenAL include AL OpenAL
+  )
+
+find_library(OPENAL_LIBRARY
+  NAMES OpenAL al openal OpenAL32 openal32
+  HINTS
+    ENV OPENALDIR
+  PATHS
+    ~/Library/Frameworks
+    /Library/Frameworks
+    /opt
+    [HKEY_LOCAL_MACHINE\\SOFTWARE\\Creative\ Labs\\OpenAL\ 1.1\ Software\ Development\ Kit\\1.00.0000;InstallDir]
+  PATH_SUFFIXES libx32 lib64 lib libs64 libs
+  )
+
+include(FindPackageHandleStandardArgs)
+find_package_handle_standard_args(
+  OpenAL
+  REQUIRED_VARS OPENAL_LIBRARY OPENAL_INCLUDE_DIR
+  VERSION_VAR OPENAL_VERSION_STRING
+  )
+
+mark_as_advanced(OPENAL_LIBRARY OPENAL_INCLUDE_DIR)
+
+if(OPENAL_INCLUDE_DIR AND OPENAL_LIBRARY)
+  if(NOT TARGET OpenAL::OpenAL)
+    if(EXISTS "${OPENAL_LIBRARY}")
+      if(WIN32)
+        get_filename_component(OPENAL_PATH ${OPENAL_LIBRARY} DIRECTORY)
+        add_library(OpenAL::OpenAL SHARED IMPORTED)
+        if (ARCH_x86)
+          set(DLL_PATH "${OPENAL_PATH}/../../bin/x86/openal32.dll")
+        elseif(ARCH_X64)
+          set(DLL_PATH "${OPENAL_PATH}/../../bin/x64/openal32.dll")
+        else()
+          set(DLL_PATH "${OPENAL_PATH}/../../bin/ARM64/openal32.dll")
+        endif()
+        set_target_properties(OpenAL::OpenAL PROPERTIES
+          IMPORTED_LOCATION "${DLL_PATH}"
+          IMPORTED_IMPLIB "${OPENAL_LIBRARY}")
+      elseif(APPLE)
+        if(IS_DIRECTORY "${OPENAL_LIBRARY}")
+          # Framework bundle directory: search for the binary inside it.
+          find_file(OPENAL_FULL_PATH OpenAL OpenAL.tbd PATHS "${OPENAL_LIBRARY}" REQUIRED)
+          add_library(OpenAL::OpenAL SHARED IMPORTED)
+          set_target_properties(OpenAL::OpenAL PROPERTIES
+            IMPORTED_LOCATION "${OPENAL_FULL_PATH}")
+        else()
+          # Plain dylib (e.g. Homebrew openal-soft on macOS 15 where
+          # OpenAL.framework is no longer present in the system).
+          add_library(OpenAL::OpenAL SHARED IMPORTED)
+          set_target_properties(OpenAL::OpenAL PROPERTIES
+            IMPORTED_LOCATION "${OPENAL_LIBRARY}")
+        endif()
+      else()
+        add_library(OpenAL::OpenAL UNKNOWN IMPORTED)
+        set_target_properties(OpenAL::OpenAL PROPERTIES
+          IMPORTED_LOCATION "${OPENAL_LIBRARY}")
+      endif()
+    else()
+      add_library(OpenAL::OpenAL INTERFACE IMPORTED)
+      set_target_properties(OpenAL::OpenAL PROPERTIES
+        IMPORTED_LIBNAME "${OPENAL_LIBRARY}")
+    endif()
+    set_target_properties(OpenAL::OpenAL PROPERTIES
+      INTERFACE_INCLUDE_DIRECTORIES "${OPENAL_INCLUDE_DIR}")
+  endif()
+endif()

sfml-2.6.2.0/.github/scripts/build-sfml-unix.sh

@@ -0,0 +1,117 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+version="${1:?SFML version is required}"
+prefix="${2:?install prefix is required}"
+install_deps="${3:-0}"
+openal_prefix=""
+
+cmake_args=(
+    -G Ninja
+    -DBUILD_SHARED_LIBS=ON
+    -DCMAKE_BUILD_TYPE=Release
+    "-DCMAKE_INSTALL_PREFIX=${prefix}"
+    -DCMAKE_INSTALL_LIBDIR=lib
+    -DSFML_BUILD_DOC=OFF
+    -DSFML_BUILD_EXAMPLES=OFF
+    -DSFML_BUILD_TEST_SUITE=OFF
+)
+
+if [[ -f "${prefix}/include/SFML/Config.hpp" ]]; then
+    exit 0
+fi
+
+if [[ "${install_deps}" == "1" ]]; then
+    if command -v apt-get >/dev/null 2>&1; then
+        export DEBIAN_FRONTEND=noninteractive
+        apt-get update
+        apt-get install -y \
+            build-essential \
+            cmake \
+            git \
+            libflac-dev \
+            libfreetype6-dev \
+            libgl1-mesa-dev \
+            libjpeg-dev \
+            libopenal-dev \
+            libudev-dev \
+            libvorbis-dev \
+            libx11-dev \
+            libxcursor-dev \
+            libxi-dev \
+            libxinerama-dev \
+            libxrandr-dev \
+            ninja-build \
+            pkg-config
+    elif command -v dnf >/dev/null 2>&1; then
+        dnf install -y \
+            cmake \
+            freetype-devel \
+            gcc-c++ \
+            git \
+            libX11-devel \
+            libXcursor-devel \
+            libXext-devel \
+            libXi-devel \
+            libXinerama-devel \
+            libXrandr-devel \
+            libjpeg-turbo-devel \
+            libudev-devel \
+            mesa-libGL-devel \
+            ninja-build \
+            openal-soft-devel \
+            pkgconf-pkg-config \
+            flac-devel \
+            libvorbis-devel
+    elif command -v yum >/dev/null 2>&1; then
+        yum install -y \
+            cmake \
+            freetype-devel \
+            gcc-c++ \
+            git \
+            libX11-devel \
+            libXcursor-devel \
+            libXext-devel \
+            libXi-devel \
+            libXinerama-devel \
+            libXrandr-devel \
+            libjpeg-turbo-devel \
+            libudev-devel \
+            mesa-libGL-devel \
+            ninja-build \
+            openal-soft-devel \
+            pkgconfig \
+            flac-devel \
+            libvorbis-devel
+    elif command -v brew >/dev/null 2>&1; then
+        brew update
+        brew install cmake ninja pkg-config freetype libogg libvorbis flac jpeg-turbo openal-soft
+
+        brew_prefix="$(brew --prefix)"
+        openal_prefix="$(brew --prefix openal-soft)"
+        macos_rpath="${prefix}/lib;${brew_prefix}/lib;/System/Library/Frameworks;/Library/Frameworks"
+        cmake_args+=(
+            -DCMAKE_FIND_FRAMEWORK=LAST
+            "-DCMAKE_PREFIX_PATH=${brew_prefix}"
+            "-DOPENAL_LIBRARY=${openal_prefix}/lib/libopenal.dylib"
+            "-DOPENAL_INCLUDE_DIR=${openal_prefix}/include/AL"
+            "-DCMAKE_INSTALL_RPATH=${macos_rpath}"
+            -DCMAKE_BUILD_WITH_INSTALL_RPATH=ON
+        )
+    fi
+fi
+
+src_dir="$(mktemp -d)"
+build_dir="$(mktemp -d)"
+trap 'rm -rf "${src_dir}" "${build_dir}"' EXIT
+
+git clone --branch "${version}" --depth 1 https://github.com/SFML/SFML "${src_dir}"
+
+if [[ -n "${openal_prefix:-}" ]]; then
+    cp "$(dirname "$0")/FindOpenAL.cmake" "${src_dir}/cmake/Modules/FindOpenAL.cmake"
+fi
+
+cmake -S "${src_dir}" -B "${build_dir}" "${cmake_args[@]}"
+cmake --build "${build_dir}"
+cmake --install "${build_dir}"

sfml-2.6.2.0/.github/scripts/build-sfml-windows.ps1

@@ -0,0 +1,77 @@
+param(
+    [Parameter(Mandatory = $true)]
+    [string]$Version,
+    [Parameter(Mandatory = $true)]
+    [string]$Prefix,
+    [string]$Architecture = "x64"
+)
+
+$ErrorActionPreference = "Stop"
+
+$cmakeExe = if ($env:CMAKE_EXE) { $env:CMAKE_EXE } else { "cmake" }
+if (Test-Path $cmakeExe -PathType Container) {
+    $cmakeExe = Join-Path $cmakeExe "cmake.exe"
+}
+
+if (-not ($cmakeExe -like "*.exe") -and $cmakeExe -ne "cmake") {
+    $candidateExe = Join-Path $cmakeExe "cmake.exe"
+    if (Test-Path $candidateExe -PathType Leaf) {
+        $cmakeExe = $candidateExe
+    }
+}
+
+if ($cmakeExe -ne "cmake" -and -not (Test-Path $cmakeExe -PathType Leaf)) {
+    throw "Configured CMake executable was not found: $cmakeExe"
+}
+
+$Prefix = [System.IO.Path]::GetFullPath($Prefix)
+$configHeader = Join-Path $Prefix "include\SFML\Config.hpp"
+
+if (Test-Path $configHeader) {
+    exit 0
+}
+
+New-Item -ItemType Directory -Force -Path $Prefix | Out-Null
+
+$cmakeInstallPrefix = $Prefix -replace '\\', '/'
+
+$generatorArch = if ($Architecture -eq "x86") { "Win32" } else { "x64" }
+$srcDir = Join-Path $env:RUNNER_TEMP "sfml-src"
+$buildDir = Join-Path $env:RUNNER_TEMP "sfml-build"
+$archivePath = Join-Path $env:RUNNER_TEMP "sfml-src.zip"
+
+if (Test-Path $srcDir) {
+    Remove-Item $srcDir -Recurse -Force
+}
+
+if (Test-Path $buildDir) {
+    Remove-Item $buildDir -Recurse -Force
+}
+
+if (Test-Path $archivePath) {
+    Remove-Item $archivePath -Force
+}
+
+$archiveUrl = "https://github.com/SFML/SFML/archive/refs/tags/$Version.zip"
+Invoke-WebRequest -Uri $archiveUrl -OutFile $archivePath
+Expand-Archive -Path $archivePath -DestinationPath $env:RUNNER_TEMP -Force
+
+$extractedDir = Join-Path $env:RUNNER_TEMP "SFML-$Version"
+if (-not (Test-Path $extractedDir)) {
+    throw "Downloaded SFML source archive did not extract to expected directory: $extractedDir"
+}
+
+Move-Item -Path $extractedDir -Destination $srcDir
+& $cmakeExe -S $srcDir -B $buildDir -G "Visual Studio 17 2022" -A $generatorArch `
+    -DBUILD_SHARED_LIBS=ON `
+    -DCMAKE_BUILD_TYPE=Release `
+    "-DCMAKE_INSTALL_PREFIX=$cmakeInstallPrefix" `
+    -DSFML_BUILD_DOC=OFF `
+    -DSFML_BUILD_EXAMPLES=OFF `
+    -DSFML_BUILD_TEST_SUITE=OFF
+& $cmakeExe --build $buildDir --config Release
+& $cmakeExe --install $buildDir --config Release
+
+if (-not (Test-Path $configHeader)) {
+    throw "SFML install did not produce expected header: $configHeader"
+}

sfml-2.6.2.0/.github/scripts/run-wheel-tests.py

@@ -0,0 +1,42 @@
+#!/usr/bin/env python3
+
+from __future__ import annotations
+
+import os
+import subprocess
+import sys
+from pathlib import Path
+
+
+TEST_FILES = [
+    "tests/test_smoke_imports.py",
+    "tests/test_typing_artifacts.py",
+]
+
+
+def sanitized_env() -> dict[str, str]:
+    env = os.environ.copy()
+
+    for name in ("SFML_HEADERS", "SFML_LIBRARIES", "PKG_CONFIG_PATH", "LD_LIBRARY_PATH", "DYLD_LIBRARY_PATH"):
+        env.pop(name, None)
+
+    if os.name == "nt":
+        blocked = ("c:/cibw-sfml-2.6.2/bin", "c:\\cibw-sfml-2.6.2\\bin")
+        path_parts = env.get("PATH", "").split(os.pathsep)
+        env["PATH"] = os.pathsep.join(
+            part
+            for part in path_parts
+            if part and all(token not in part.lower() for token in blocked)
+        )
+
+    return env
+
+
+def main() -> int:
+    project_dir = Path(sys.argv[1]).resolve() if len(sys.argv) > 1 else Path.cwd()
+    command = [sys.executable, "-m", "pytest", "-q", *[str(project_dir / test_file) for test_file in TEST_FILES]]
+    return subprocess.run(command, cwd=project_dir, env=sanitized_env(), check=False).returncode
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

sfml-2.6.2.0/.github/scripts/test-installed-package.py

@@ -0,0 +1,92 @@
+#!/usr/bin/env python3
+
+from __future__ import annotations
+
+import os
+from importlib import import_module, resources
+from pathlib import Path
+
+
+MODULES = [
+    "sfml",
+    "sfml.system",
+    "sfml.window",
+    "sfml.graphics",
+    "sfml.audio",
+    "sfml.network",
+]
+
+
+def configure_runtime_environment() -> None:
+    if os.name != "nt":
+        os.environ.setdefault("ALSOFT_DRIVERS", "null")
+
+
+def main() -> int:
+    configure_runtime_environment()
+
+    loaded_modules = {name: import_module(name) for name in MODULES}
+    sfml = loaded_modules["sfml"]
+    system = loaded_modules["sfml.system"]
+    window = loaded_modules["sfml.window"]
+    graphics = loaded_modules["sfml.graphics"]
+    audio = loaded_modules["sfml.audio"]
+    network = loaded_modules["sfml.network"]
+
+    package_root = Path(sfml.__file__).resolve().parent
+
+    print(f"sfml package root: {package_root}")
+    print(f"configured ALSOFT_DRIVERS: {os.environ.get('ALSOFT_DRIVERS')!r}")
+
+    assert hasattr(system, "Time")
+    assert hasattr(window, "VideoMode")
+    assert hasattr(graphics, "Color")
+    assert hasattr(audio, "Listener")
+    assert hasattr(network, "IpAddress")
+
+    clock = system.Clock()
+    elapsed = clock.elapsed_time
+    print(f"clock elapsed seconds: {elapsed.seconds}")
+
+    video_mode = window.VideoMode(640, 480, 32)
+    print(f"video mode: {video_mode.width}x{video_mode.height}x{video_mode.bits_per_pixel}")
+
+    context_settings = window.ContextSettings(depth=24, stencil=8, antialiasing=0, major=3, minor=0)
+    print(f"context depth bits: {context_settings.depth_bits}")
+
+    color = graphics.Color(10, 20, 30, 255)
+    rect = graphics.Rect((0, 0), (10, 20))
+    print(f"graphics objects: color={tuple(color)} rect={tuple(rect)}")
+
+    chunk = audio.Chunk(b"\x00\x00\x01\x00")
+    chunk[0] = 0
+    print(f"audio chunk samples: {len(chunk)}")
+
+    ip_address = network.IpAddress.from_string("127.0.0.1")
+    print(f"network address bytes: {ip_address.string!r}")
+
+    sfml_package = resources.files("sfml")
+    typing_artifacts = [
+        "py.typed",
+        "__init__.pyi",
+        "audio.pyi",
+        "graphics.pyi",
+        "network.pyi",
+        "sf.pyi",
+        "system.pyi",
+        "window.pyi",
+    ]
+    missing = [path for path in typing_artifacts if not sfml_package.joinpath(path).is_file()]
+    if missing:
+        raise RuntimeError(f"missing typing artifacts: {', '.join(missing)}")
+
+    signature_line = next(iter((system.seconds.__doc__ or "").splitlines()), "")
+    if not signature_line.startswith("seconds("):
+        raise RuntimeError(f"unexpected system.seconds signature doc: {signature_line!r}")
+
+    print("installed-package validation passed")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

sfml-2.6.2.0/.github/scripts/validate-dist.py

@@ -0,0 +1,87 @@
+#!/usr/bin/env python3
+
+from __future__ import annotations
+
+import argparse
+import sys
+import tarfile
+import zipfile
+from pathlib import Path
+
+
+REQUIRED_TYPING_ARTIFACTS = {
+    "sfml/py.typed",
+    "sfml/__init__.pyi",
+    "sfml/audio.pyi",
+    "sfml/graphics.pyi",
+    "sfml/network.pyi",
+    "sfml/sf.pyi",
+    "sfml/system.pyi",
+    "sfml/window.pyi",
+}
+
+SDIST_TYPING_ARTIFACTS = {f"src/{path}" for path in REQUIRED_TYPING_ARTIFACTS}
+
+
+def wheel_members(path: Path) -> set[str]:
+    with zipfile.ZipFile(path) as archive:
+        return set(archive.namelist())
+
+
+def sdist_members(path: Path) -> set[str]:
+    with tarfile.open(path, "r:gz") as archive:
+        members = set()
+        for member in archive.getnames():
+            parts = member.split("/", 1)
+            if len(parts) == 2:
+                members.add(parts[1])
+        return members
+
+
+def validate_members(path: Path, members: set[str]) -> list[str]:
+    required_paths = SDIST_TYPING_ARTIFACTS if path.suffixes[-2:] == [".tar", ".gz"] else REQUIRED_TYPING_ARTIFACTS
+    missing = sorted(required for required in required_paths if required not in members)
+    errors: list[str] = []
+
+    if missing:
+        errors.append(f"missing typing artifacts: {', '.join(missing)}")
+
+    if path.suffix == ".whl" and not any(name.startswith("sfml/") and (name.endswith(".so") or name.endswith(".pyd")) for name in members):
+        errors.append("wheel does not contain a compiled extension module under sfml/")
+
+    return errors
+
+
+def validate_artifact(path: Path) -> int:
+    if path.suffix == ".whl":
+        members = wheel_members(path)
+    elif path.suffixes[-2:] == [".tar", ".gz"]:
+        members = sdist_members(path)
+    else:
+        print(f"unsupported artifact type: {path}", file=sys.stderr)
+        return 1
+
+    errors = validate_members(path, members)
+    if errors:
+        print(f"artifact validation failed for {path}:", file=sys.stderr)
+        for error in errors:
+            print(f"- {error}", file=sys.stderr)
+        return 1
+
+    print(f"validated {path}")
+    return 0
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="Validate PySFML wheel and sdist contents")
+    parser.add_argument("artifacts", nargs="+", help="wheel and/or sdist paths")
+    args = parser.parse_args()
+
+    exit_code = 0
+    for artifact in args.artifacts:
+        exit_code |= validate_artifact(Path(artifact))
+    return exit_code
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())