sfml3-rb 0.0.1-aarch64-linux-gnu

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: fdee43063f3ccfed5d7d4185b131768d6c9add6c4ad240e25dae6f74987ebfe9
+  data.tar.gz: 1cf619524ee19eb2707efea0b09f59a4f0c7673b27f6b54ceff89f12ec5fcb40
+SHA512:
+  metadata.gz: 2ac5e2840487c466ac87037daa0ac6f350962e631394c35c15b29b9da7e95041399dee8fc95bbddf703b1bc37c6f5d1e13671a58db84f33329354fe0cb167f67
+  data.tar.gz: ef7e2f248472b103dbaa03f1b003742d541feabf00c7c9bcefd8cefe0f18005de0ccf6309f0b91c8168d076aa0e3fa13de0df040addfc073ddc7b5a309421875

data/LICENSE.md

@@ -0,0 +1,14 @@
+BSD Zero Clause License
+
+Copyright (c) 2026 Algaves
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.

data/README.md

@@ -0,0 +1,110 @@
+# sfml3.rb
+
+Ruby bindings for [SFML 3](https://www.sfml-dev.org/), via its C API, [CSFML](https://github.com/SFML/CSFML).
+
+## Status
+
+Bound against **CSFML 3**. See [TODO.md](TODO.md) for which parts of the SFML 3 API are ported so
+far, and [CHANGELOG.md](CHANGELOG.md) for what changed recently.
+
+## Install
+
+```sh
+gem install sfml3-rb
+```
+
+On a platform with a precompiled gem this installs a binary with FreeType, SFML 3 and CSFML 3
+already linked in — no toolchain, no build, nothing to install system-wide:
+
+| Platform | Status |
+| --- | --- |
+| `x86_64-linux-gnu` | built, installed and tested |
+| `x64-mingw-ucrt` (Windows, RubyInstaller 3.1+) | builds and links cleanly; not yet run on Windows |
+| `aarch64-linux-gnu`, `x86_64-linux-musl`, `x86_64-darwin`, `arm64-darwin` | experimental, not yet built |
+
+Each gem carries one extension per Ruby ABI, covering Ruby 3.1 through 4.0.
+
+Anywhere else, RubyGems falls back to the source gem, which downloads and builds FreeType, SFML 3
+and CSFML 3 from pinned, checksum-verified tarballs at install time. That takes a few minutes and
+needs:
+
+* A C/C++ toolchain and CMake >= 3.22
+* On Linux, the X11/udev/OpenGL development headers SFML links against — these can't be bundled.
+  On Fedora:
+
+  ```sh
+  sudo dnf install cmake gcc-c++ libX11-devel \
+    libXrandr-devel libXcursor-devel libXi-devel systemd-devel libglvnd-devel
+  ```
+
+  or on Debian/Ubuntu:
+
+  ```sh
+  sudo apt-get install cmake build-essential libx11-dev \
+    libxrandr-dev libxcursor-dev libxi-dev libudev-dev libgl1-mesa-dev
+  ```
+
+Each installed gem version builds its own copy; there's no build cache shared across versions.
+
+To link against a system CSFML 3 instead (no download, no build):
+
+```sh
+gem install sfml3-rb -- --enable-system-libraries
+```
+
+## Usage
+
+```ruby
+require 'sfml'
+include SFML
+
+window = Window.new VideoMode.new(640, 480, 32), 'SFML'
+event = Event.new
+
+while window.is_open?
+  while window.poll_event! event
+    window.close! if event.type == 'closed'
+  end
+
+  window.clear [51, 76, 102, 255] # [r, g, b, a], 0-255
+  window.display
+end
+```
+
+See [`test/hello-world.rb`](test/hello-world.rb) for a fuller example with shapes and transforms.
+
+## Development
+
+```sh
+rake ports    # build the vendored FreeType + SFML 3 + CSFML 3 (rake compile does this too)
+rake compile  # build the C extension into lib/sfml/
+rake test     # compile, then run the test suite
+rake gem      # build the source gem into pkg/
+```
+
+`CMakeLists.txt` is a CLion/IDE convenience build against the same vendored `ports/` prefix — `rake`
+is the build of record.
+
+### Building the binary gems
+
+Cross-compilation runs in [rake-compiler-dock](https://github.com/rake-compiler/rake-compiler-dock),
+which supplies the cross toolchains and the cross-compiled rubies. It needs Docker or Podman, and
+pulls a large image per platform on first use.
+
+```sh
+rake platforms            # list the targets
+rake gem:x86_64-linux-gnu # build one platform into pkg/
+rake gem:native           # build all of them
+```
+
+Each run provisions the container with [`script/provision.sh`](script/provision.sh) — a current
+CMake everywhere, plus the target-side X11/udev/GL development files on Linux targets, which the
+images don't ship. Windows and macOS need nothing extra: SFML uses OS libraries and frameworks the
+mingw toolchain and the osxcross SDK already provide.
+
+Binary gems carry one extension per Ruby ABI under `lib/sfml/<major.minor>/`; `lib/sfml.rb` prefers
+that and falls back to the single `lib/sfml/sfml_ext.so` a source build installs.
+
+## License
+
+[0BSD](LICENSE.md)

data/lib/sfml/version.rb

@@ -0,0 +1,3 @@
+module SFML
+  VERSION = '0.0.1'.freeze
+end

data/lib/sfml.rb

@@ -0,0 +1,9 @@
+require 'sfml/version'
+
+begin
+  # Binary gems ship one extension per Ruby ABI under lib/sfml/<major.minor>/.
+  # A gem built from source installs a single lib/sfml/sfml_ext.so instead.
+  require "sfml/#{RUBY_VERSION[/\d+\.\d+/]}/sfml_ext"
+rescue LoadError
+  require 'sfml/sfml_ext'
+end

metadata

@@ -0,0 +1,56 @@
+--- !ruby/object:Gem::Specification
+name: sfml3-rb
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: aarch64-linux-gnu
+authors:
+- Sealtiel Valderrama
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: Ruby bindings for SFML 3 via CSFML. Precompiled binaries are published
+  for common platforms; elsewhere SFML and CSFML are downloaded and built from source
+  at install time, so neither needs to be installed system-wide.
+email: SealtielFreak@yandex.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.md
+- README.md
+- lib/sfml.rb
+- lib/sfml/3.1/sfml_ext.so
+- lib/sfml/3.2/sfml_ext.so
+- lib/sfml/3.3/sfml_ext.so
+- lib/sfml/3.4/sfml_ext.so
+- lib/sfml/4.0/sfml_ext.so
+- lib/sfml/version.rb
+homepage: https://github.com/algaves/sfml3.rb
+licenses:
+- 0BSD
+metadata:
+  source_code_uri: https://github.com/algaves/sfml3.rb
+  bug_tracker_uri: https://github.com/algaves/sfml3.rb/issues
+  changelog_uri: https://github.com/algaves/sfml3.rb/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.1'
+  - - "<"
+    - !ruby/object:Gem::Version
+      version: 4.1.dev
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.22
+requirements: []
+rubygems_version: 4.0.6
+specification_version: 4
+summary: SFML wrapper for Ruby
+test_files: []