pyfastnoiselite-ledfx 0.0.8__tar.gz

pyfastnoiselite_ledfx-0.0.8/.github/workflows/build.yml

@@ -0,0 +1,163 @@
+name: pyfastnoiselite
+
+on:
+  push:
+    branches: [main]
+    tags: ["v*"]
+  pull_request:
+  # Weekly run: wheel tests install the newest NumPy/pytest, so this catches
+  # dependency drift between releases.
+  schedule:
+    - cron: "23 4 * * 1"
+  workflow_dispatch:
+
+permissions: {}
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build_wheels:
+    name: Build wheels on ${{ matrix.os }} ${{ matrix.arch }}
+    runs-on: ${{ matrix.os }}
+    permissions:
+      contents: read
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            arch: x86_64
+          # Native ARM64 runner, no QEMU
+          - os: ubuntu-24.04-arm
+            arch: aarch64
+          # 32-bit Raspberry Pi OS, emulated
+          - os: ubuntu-latest
+            arch: armv7l
+          - os: windows-latest
+            arch: AMD64
+          - os: macos-15-intel
+            arch: x86_64
+          - os: macos-latest
+            arch: arm64
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+          submodules: true
+          fetch-depth: 0 # setuptools-scm needs tags for the version
+
+      - uses: docker/setup-qemu-action@99012661954931238ded8c8b007157a8430204e1 # v4.4.0
+        if: matrix.arch == 'armv7l'
+        with:
+          platforms: arm
+
+      - name: Build wheels
+        uses: pypa/cibuildwheel@e090b81e30c4d855ea63bf4b6e59204c09a101ae # v4.2.1
+        with:
+          extras: uv
+        env:
+          CIBW_ARCHS: ${{ matrix.arch }}
+
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: cibw-wheels-${{ matrix.os }}-${{ matrix.arch }}
+          path: ./wheelhouse/*.whl
+          if-no-files-found: error
+
+  build_sdist:
+    name: Build and test source distribution
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+          submodules: true
+          fetch-depth: 0 # setuptools-scm needs tags for the version
+
+      # Anyone with write access can push a tag, and a tag can point at a
+      # commit that never went through a reviewed PR. Only publish from main.
+      - name: Check the release tag is on main
+        if: startsWith(github.ref, 'refs/tags/v')
+        run: git merge-base --is-ancestor "$GITHUB_SHA" origin/main
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
+        with:
+          enable-cache: false # output is published; don't restore a cache
+
+      # `uv build` builds the sdist, then a wheel *from* the sdist, so a file
+      # missing from MANIFEST.in fails here instead of on a user's machine.
+      - name: Build sdist and a wheel from it
+        run: uv build
+
+      - name: Test the wheel built from the sdist
+        run: |
+          uv venv
+          uv pip install dist/*.whl --group test
+          uv run --no-project pytest tests
+
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: cibw-sdist
+          path: dist/*.tar.gz
+          if-no-files-found: error
+
+  # Keep the NumPy floor in pyproject.toml honest: oldest supported Python
+  # with the oldest allowed NumPy.
+  numpy_oldest:
+    name: Test oldest supported NumPy
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    env:
+      UV_PYTHON: "3.11"
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+          submodules: true
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7 # v10.2.0
+        with:
+          enable-cache: false
+
+      - name: Build and install with the oldest NumPy
+        run: |
+          uv venv
+          floor=$(sed -n 's/.*"numpy>=\([0-9.]*\)".*/\1/p' pyproject.toml)
+          uv pip install . --group test "numpy==$floor"
+
+      - name: Test
+        run: |
+          uv run --no-project python -c "import numpy; print('numpy', numpy.__version__)"
+          uv run --no-project pytest tests
+
+  publish:
+    name: Publish to PyPI
+    needs: [build_wheels, build_sdist, numpy_oldest]
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/pyfastnoiselite-ledfx/
+    permissions:
+      id-token: write # Required for trusted publishing
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          path: dist
+          pattern: cibw-*
+          merge-multiple: true
+
+      - name: Display structure of downloaded files
+        run: ls -R dist
+
+      # Uses trusted publishing and uploads PEP 740 attestations for each file.
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2

pyfastnoiselite_ledfx-0.0.8/.github/workflows/zizmor.yml

@@ -0,0 +1,30 @@
+name: zizmor
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  schedule:
+    - cron: "23 4 * * 1" # new audits land in zizmor over time
+  workflow_dispatch:
+
+permissions: {}
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  zizmor:
+    name: Audit GitHub Actions workflows
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - uses: zizmorcore/zizmor-action@cc914d7f3750a2d13d75c7f184a1060aa0e9d482 # v0.6.4
+        with:
+          advanced-security: false # fail the job instead of uploading SARIF

pyfastnoiselite_ledfx-0.0.8/.gitignore

@@ -0,0 +1,13 @@
+*.pyd
+*.o
+*.so
+*.egg-info
+*.egg
+dist
+build
+wheelhouse
+.venv
+.vscode
+src/pyfastnoiselite/*.cpp
+__pycache__/
+.pytest_cache/

pyfastnoiselite_ledfx-0.0.8/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "ext/FastNoise"]
+	path = ext/FastNoise
+	url = https://github.com/Auburn/FastNoiseLite.git

pyfastnoiselite_ledfx-0.0.8/.python-version

@@ -0,0 +1 @@
+3.14

pyfastnoiselite_ledfx-0.0.8/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Tiziano Bettio
+
+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.

pyfastnoiselite_ledfx-0.0.8/MAINTAINING.md

@@ -0,0 +1,80 @@
+# Maintaining pyfastnoiselite-ledfx
+
+This is a fork of [tizilogic/PyFastNoiseLite](https://github.com/tizilogic/PyFastNoiseLite)
+with a stable-ABI build, armv7l wheels and CI on top. It wraps
+[FastNoise Lite](https://github.com/Auburn/FastNoiseLite), vendored as the git
+submodule `ext/FastNoise`.
+
+## What keeps it current
+
+| What | How | Who acts |
+| --- | --- | --- |
+| GitHub Actions, uv.lock, Python deps | Renovate, from the org preset `github>LedFx/renovate-config`. Non-majors automerge on green CI after 14 days; majors wait 30 days and need a person. | Renovate; majors reviewed by a maintainer |
+| FastNoise Lite | Renovate's git-submodules manager on `ext/FastNoise`. Never automerged: it changes the compiled wheel, and possibly the noise LedFx renders. | Maintainer reviews |
+| Upstream fork | Renovate bumps the marker below when `tizilogic/PyFastNoiseLite` moves. The PR is the prompt to review upstream. | Maintainer reviews |
+| New Python releases | Nothing to rebuild: the `cp311-abi3` wheels already install on new CPython versions. Add the version to `[tool.cibuildwheel] build` so CI tests it. | Maintainer |
+| New NumPy releases | Weekly scheduled CI builds and tests every wheel against the newest NumPy. | Whoever sees the red run |
+| Workflow security | zizmor on every change to `.github/` and weekly. | CI |
+
+## Output must not drift
+
+`tests/test_noise.py` checks the output against values taken from upstream's
+0.0.7 wheel, using the settings LedFx's noise effects use. If a FastNoise Lite
+bump or a build change moves those values, the LedFx effects change how they
+look. Decide that on purpose. Don't just regenerate the numbers.
+
+## Syncing upstream
+
+Last reviewed upstream commit (Renovate updates this line):
+
+upstream: https://github.com/tizilogic/PyFastNoiseLite main@3b6390f486dd837d6f80fe1cd5bc097c752eb6aa
+
+When Renovate opens a PR bumping it:
+
+```sh
+git remote add upstream https://github.com/tizilogic/PyFastNoiseLite  # once
+git fetch upstream
+git log --oneline <old-sha>..upstream/main
+```
+
+The packaging here differs from upstream (pyproject metadata, setuptools-scm,
+abi3, tests), so port changes to `src/` by hand or `git cherry-pick -x` and
+resolve. Skip upstream CI/release changes; ours is different. Merge the marker
+bump in the same PR as the ports, or on its own if nothing applies.
+
+If upstream merges and releases
+[tizilogic/PyFastNoiseLite#3](https://github.com/tizilogic/PyFastNoiseLite/pull/3),
+LedFx can go back to depending on `pyfastnoiselite`, and this fork can be archived.
+
+## Releasing
+
+Tag `vX.Y.Z` on `main`. setuptools-scm takes the version from the tag. CI
+builds the wheels and the sdist, then publishes to PyPI through trusted
+publishing from the `pypi` environment, with attestations.
+
+## Repository settings
+
+These live in GitHub, not in this repo. Renovate's automerge relies on them:
+
+- Ruleset `main`: changes go through PRs (no approval needed), no force pushes
+  or deletion, and these checks must pass (from GitHub Actions only): the six
+  wheel builds, the sdist build, the oldest-NumPy test and zizmor. Repo admins
+  can bypass it on a PR. Rename a job and you must update the ruleset too.
+- `pypi` environment: deploys from `v*` tags only.
+- Actions: workflow token is read-only by default and can't approve PRs.
+- Security: Dependabot alerts are on, so Renovate can read them and raise
+  `[SECURITY]` PRs straight away. Dependabot security updates are off, so each
+  advisory gets only one PR. Secret scanning, push protection and private
+  vulnerability reporting are on.
+- Renovate skips forks that have no config, so `renovate.json` must stay on
+  `main`. Its runs are on the Mend dashboard (developer.mend.io).
+- Issues are enabled, for Renovate's Dependency Dashboard and for bug reports.
+
+## Supported versions
+
+CPython 3.11+ and NumPy >= 1.23.2. When a CPython version reaches end of life,
+drop it from `[tool.cibuildwheel] build`. When 3.11 goes, raise
+`requires-python`, `Py_LIMITED_API` in `setup.py` and the `py_limited_api` tag
+together. Also raise the NumPy floor to the first release with wheels for the
+new oldest Python. The `numpy_oldest` CI job reads that floor from
+pyproject.toml.

pyfastnoiselite_ledfx-0.0.8/MANIFEST.in

@@ -0,0 +1,7 @@
+recursive-include src *.pyx *.pxd
+include ext/CPPWrapper/*.h
+# Only the C++ header and its license are needed from the FastNoise Lite submodule
+prune ext/FastNoise
+include ext/FastNoise/Cpp/FastNoiseLite.h ext/FastNoise/LICENSE
+# Generated by Cython at build time
+exclude src/pyfastnoiselite/*.cpp

pyfastnoiselite_ledfx-0.0.8/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: pyfastnoiselite-ledfx
+Version: 0.0.8
+Summary: Cython wrapper for Auburn's FastNoise Lite noise library, with stable-ABI wheels (LedFx fork of pyfastnoiselite)
+Author: LedFx
+Author-email: Tiziano Bettio <tc@tizilogic.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/LedFx/pyfastnoiselite-ledfx
+Project-URL: Source, https://github.com/LedFx/pyfastnoiselite-ledfx
+Project-URL: Issues, https://github.com/LedFx/pyfastnoiselite-ledfx/issues
+Project-URL: Upstream, https://github.com/tizilogic/PyFastNoiseLite
+Keywords: noise,simplex,perlin,procedural,fastnoise
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Cython
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Multimedia :: Graphics
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: ext/FastNoise/LICENSE
+Requires-Dist: numpy>=1.23.2
+Dynamic: license-file
+
+# pyfastnoiselite-ledfx
+> **Note:** This is a fork of the original [PyFastNoiseLite](https://github.com/tizilogic/PyFastNoiseLite) maintained by the [LedFx](https://github.com/LedFx) team.
+>
+> **Why this fork exists:**
+> - The original project is sporadically active, and its 0.0.7 release has no Python 3.14 wheels and no sdist on PyPI
+> - We build against the CPython stable ABI, so one wheel per platform covers Python 3.11 and every later release
+> - We ship armv7l wheels for 32-bit Raspberry Pi OS
+> - LedFx depends on pyfastnoiselite and needs a reliable, up-to-date release
+>
+> All credit for pyfastnoiselite goes to Tiziano Bettio, and for FastNoise Lite to Jordan Peck (Auburn). This fork exists solely to provide maintained releases for projects that depend on it. The build changes are offered upstream in [tizilogic/PyFastNoiseLite#3](https://github.com/tizilogic/PyFastNoiseLite/pull/3).
+>
+> **Original project:** https://github.com/tizilogic/PyFastNoiseLite  
+> **This fork:** https://github.com/LedFx/pyfastnoiselite-ledfx
+
+[![image](https://img.shields.io/pypi/v/pyfastnoiselite-ledfx.svg)](https://pypi.org/p/pyfastnoiselite-ledfx)[![image](https://img.shields.io/pypi/l/pyfastnoiselite-ledfx.svg)](https://pypi.org/p/pyfastnoiselite-ledfx)[![image](https://img.shields.io/pypi/wheel/pyfastnoiselite-ledfx.svg)](https://pypi.org/p/pyfastnoiselite-ledfx)[![image](https://img.shields.io/pypi/pyversions/pyfastnoiselite-ledfx.svg)](https://pypi.org/p/pyfastnoiselite-ledfx)
+
+A Cython wrapper for Auburn's [FastNoise Lite](https://github.com/Auburn/FastNoiseLite) noise generation library.
+
+## Installation
+
+```bash
+pip install pyfastnoiselite-ledfx
+```
+
+Binary wheels are published for CPython 3.11+ on Windows (x86_64), macOS (x86_64, arm64) and Linux glibc/musl (x86_64, aarch64, armv7l). Building from the sdist needs a C++11 compiler.
+
+The distribution is renamed but the import name is unchanged, so it is a drop-in replacement for `pyfastnoiselite`. Don't install both: they provide the same module.
+
+> **Note:** This wrapper lacks the domain warping functionality.
+
+## Usage
+
+```py
+from pyfastnoiselite.pyfastnoiselite import FastNoiseLite, NoiseType
+
+# Initializing with seed
+noise = FastNoiseLite(seed=1337)
+# Set noise type (optional, defaults to OpenSimplex2)
+noise.noise_type = NoiseType.NoiseType_OpenSimplex2S
+
+# Get 2D noise
+print(noise.get_noise(34, 22))  # 0.7130074501037598
+print(noise.get_noise(100, 110))  # -0.3495847284793854
+
+# Get 3D noise
+print(noise.get_noise(95, 100, 30))  # -0.4522402286529541
+
+
+import numpy as np
+
+Xs = [3, 57, 95]
+Ys = [4, 13, 100]
+Zs = [0, -4, 30]
+coords = np.array([Xs, Ys, Zs], dtype=np.float32)
+# Generate noise for each coordinate
+print(noise.gen_from_coords(coords))
+```
+
+For many points, `gen_from_coords` is much faster than calling `get_noise` in a Python loop. It takes a `float32` array of shape `(2, N)` or `(3, N)` (read-only arrays and views are fine) and returns a `float32` array of shape `(N,)`.
+
+For batches of 1024 points or more, `gen_from_coords` releases the GIL, so separate `FastNoiseLite` instances can generate in parallel threads. Don't change an instance's settings from another thread while it is generating.
+
+## License
+
+This project is licensed under the [MIT license](LICENSE). FastNoise Lite is also MIT licensed.

pyfastnoiselite_ledfx-0.0.8/README.md

@@ -0,0 +1,65 @@
+# pyfastnoiselite-ledfx
+> **Note:** This is a fork of the original [PyFastNoiseLite](https://github.com/tizilogic/PyFastNoiseLite) maintained by the [LedFx](https://github.com/LedFx) team.
+>
+> **Why this fork exists:**
+> - The original project is sporadically active, and its 0.0.7 release has no Python 3.14 wheels and no sdist on PyPI
+> - We build against the CPython stable ABI, so one wheel per platform covers Python 3.11 and every later release
+> - We ship armv7l wheels for 32-bit Raspberry Pi OS
+> - LedFx depends on pyfastnoiselite and needs a reliable, up-to-date release
+>
+> All credit for pyfastnoiselite goes to Tiziano Bettio, and for FastNoise Lite to Jordan Peck (Auburn). This fork exists solely to provide maintained releases for projects that depend on it. The build changes are offered upstream in [tizilogic/PyFastNoiseLite#3](https://github.com/tizilogic/PyFastNoiseLite/pull/3).
+>
+> **Original project:** https://github.com/tizilogic/PyFastNoiseLite  
+> **This fork:** https://github.com/LedFx/pyfastnoiselite-ledfx
+
+[![image](https://img.shields.io/pypi/v/pyfastnoiselite-ledfx.svg)](https://pypi.org/p/pyfastnoiselite-ledfx)[![image](https://img.shields.io/pypi/l/pyfastnoiselite-ledfx.svg)](https://pypi.org/p/pyfastnoiselite-ledfx)[![image](https://img.shields.io/pypi/wheel/pyfastnoiselite-ledfx.svg)](https://pypi.org/p/pyfastnoiselite-ledfx)[![image](https://img.shields.io/pypi/pyversions/pyfastnoiselite-ledfx.svg)](https://pypi.org/p/pyfastnoiselite-ledfx)
+
+A Cython wrapper for Auburn's [FastNoise Lite](https://github.com/Auburn/FastNoiseLite) noise generation library.
+
+## Installation
+
+```bash
+pip install pyfastnoiselite-ledfx
+```
+
+Binary wheels are published for CPython 3.11+ on Windows (x86_64), macOS (x86_64, arm64) and Linux glibc/musl (x86_64, aarch64, armv7l). Building from the sdist needs a C++11 compiler.
+
+The distribution is renamed but the import name is unchanged, so it is a drop-in replacement for `pyfastnoiselite`. Don't install both: they provide the same module.
+
+> **Note:** This wrapper lacks the domain warping functionality.
+
+## Usage
+
+```py
+from pyfastnoiselite.pyfastnoiselite import FastNoiseLite, NoiseType
+
+# Initializing with seed
+noise = FastNoiseLite(seed=1337)
+# Set noise type (optional, defaults to OpenSimplex2)
+noise.noise_type = NoiseType.NoiseType_OpenSimplex2S
+
+# Get 2D noise
+print(noise.get_noise(34, 22))  # 0.7130074501037598
+print(noise.get_noise(100, 110))  # -0.3495847284793854
+
+# Get 3D noise
+print(noise.get_noise(95, 100, 30))  # -0.4522402286529541
+
+
+import numpy as np
+
+Xs = [3, 57, 95]
+Ys = [4, 13, 100]
+Zs = [0, -4, 30]
+coords = np.array([Xs, Ys, Zs], dtype=np.float32)
+# Generate noise for each coordinate
+print(noise.gen_from_coords(coords))
+```
+
+For many points, `gen_from_coords` is much faster than calling `get_noise` in a Python loop. It takes a `float32` array of shape `(2, N)` or `(3, N)` (read-only arrays and views are fine) and returns a `float32` array of shape `(N,)`.
+
+For batches of 1024 points or more, `gen_from_coords` releases the GIL, so separate `FastNoiseLite` instances can generate in parallel threads. Don't change an instance's settings from another thread while it is generating.
+
+## License
+
+This project is licensed under the [MIT license](LICENSE). FastNoise Lite is also MIT licensed.

pyfastnoiselite_ledfx-0.0.8/SECURITY.md

@@ -0,0 +1,8 @@
+# Security policy
+
+Only the latest release on PyPI gets fixes.
+
+Report vulnerabilities privately through
+[GitHub's private vulnerability reporting](https://github.com/LedFx/pyfastnoiselite-ledfx/security/advisories/new),
+not in a public issue. Bugs in FastNoise Lite itself belong upstream; tell us
+too so we can update the vendored copy.

pyfastnoiselite_ledfx-0.0.8/ext/CPPWrapper/FastNoiseLitePy.h

@@ -0,0 +1,15 @@
+#pragma once
+
+#include "Cpp/FastNoiseLite.h"
+
+class FastNoiseLitePy : public FastNoiseLite {
+public:
+    FastNoiseLitePy() : FastNoiseLite() {}
+    void SetNoiseTypePy(int t) { SetNoiseType(static_cast<NoiseType>(t)); }
+    void SetRotationType3DPy(int t) { SetRotationType3D(static_cast<RotationType3D>(t)); }
+    void SetFractalTypePy(int t) { SetFractalType(static_cast<FractalType>(t)); }
+    void SetCellularDistanceFunctionPy(int t) { SetCellularDistanceFunction(static_cast<CellularDistanceFunction>(t)); }
+    void SetCellularReturnTypePy(int t) { SetCellularReturnType(static_cast<CellularReturnType>(t)); }
+    void SetDomainWarpTypePy(int t) { SetDomainWarpType(static_cast<DomainWarpType>(t)); }
+
+};