ci: Upgrade to macos-15 (#139)

Bumps [pypa/cibuildwheel](https://github.com/pypa/cibuildwheel) from 4.3.4 to 4.3.5.
- [Release notes](https://github.com/pypa/cibuildwheel/releases)
- [Changelog](https://github.com/pypa/cibuildwheel/blob/main/docs/changelog.md)
- [Commits](https://github.com/pypa/cibuildwheel/compare/v4.3.4...v4.3.5)

---
updated-dependencies:
- dependency-name: pypa/cibuildwheel
  dependency-version: 4.3.5
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

.github/dependabot.yml

@@ -0,0 +1,7 @@
+version: 2
+
+updates:
+  - package-ecosystem: github-actions
+    directory: "/"
+    schedule:
+      interval: "weekly"

.github/workflows/ci.yml

@@ -1,9 +1,19 @@
 name: build
 on:
   push:
+    branches:
+      - dev
+      - stable
+      - 'ci-*'
+  pull_request:
   workflow_dispatch:
   workflow_call:
     inputs:
+      external_call:
+        description: 'To distinguish workflow_call from regular push'
+        type: boolean
+        required: false
+        default: true
       rizin_ref:
         required: false
         type: string
@@ -16,53 +26,95 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-22.04, windows-2019, macos-12]
+        os: [ubuntu-24.04, windows-2022, macos-15]
 
     steps:
-    - name: Checkout rz-bindgen
-      uses: actions/checkout@v4
+    - name: Install SWIG with Homebrew
+      if: matrix.os == 'macos-15' && matrix.enabled
+      run: brew install swig
 
+    - name: Checkout rz-bindgen
+      uses: actions/checkout@v7
+
+    # runned only from workflow_call
     - name: Checkout rizin
-      uses: actions/checkout@v4
+      if: ${{ inputs.external_call }}
+      uses: actions/checkout@v7
       with:
         repository: rizinorg/rizin
         path: rizin
         ref: ${{ inputs.rizin_ref }}
 
+    - name: Checkout rizin (stable)
+      if: ${{ !inputs.external_call && ((github.ref_name == 'stable') || (github.base_ref == 'stable')) }}
+      uses: actions/checkout@v7
+      with:
+        repository: rizinorg/rizin
+        path: rizin
+        ref: stable
+
+    - name: Checkout rizin (dev)
+      if: ${{ !inputs.external_call && ((github.ref_name != 'stable') && (github.base_ref != 'stable')) }}
+      uses: actions/checkout@v7
+      with:
+        repository: rizinorg/rizin
+        path: rizin
+        ref: dev
+
     - name: Build rz-bindgen
-      uses: pypa/cibuildwheel@v2.17.0
+      uses: pypa/cibuildwheel@v4.3.5
 
     - name: Upload sdist
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v7
       with:
         name: sdist-${{ matrix.os }}
         path: dist/*.tar.gz
 
     - name: Upload wheels
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v7
       with:
         name: wheels-${{ matrix.os }}
         path: wheelhouse/*.whl
 
   ubuntu-default-llvm:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
 
     steps:
     - name: Checkout rz-bindgen
-      uses: actions/checkout@v4
+      uses: actions/checkout@v7
       with:
         path: rz-bindgen
 
+    # runned only from workflow_call
     - name: Checkout rizin
-      uses: actions/checkout@v4
+      if: ${{ inputs.external_call }}
+      uses: actions/checkout@v7
       with:
         repository: rizinorg/rizin
         path: rizin
+        ref: ${{ inputs.rizin_ref }}
+
+    - name: Checkout rizin (stable)
+      if: ${{ !inputs.external_call && ((github.ref_name == 'stable') || (github.base_ref == 'stable')) }}
+      uses: actions/checkout@v7
+      with:
+        repository: rizinorg/rizin
+        path: rizin
+        ref: stable
+
+    - name: Checkout rizin (dev)
+      if: ${{ !inputs.external_call && ((github.ref_name != 'stable') && (github.base_ref != 'stable')) }}
+      uses: actions/checkout@v7
+      with:
+        repository: rizinorg/rizin
+        path: rizin
+        ref: dev
 
     - name: Install dependencies
       run: |
         sudo apt update
-        sudo apt-get --assume-yes install cmake swig pkg-config clang libclang-dev llvm wget unzip python3-wheel python3-setuptools build-essential python3-pip && sudo pip3 install meson ninja
+        sudo apt-get --assume-yes install cmake swig pkg-config clang libclang-dev llvm wget unzip python3-wheel python3-setuptools build-essential python3-pip
+        sudo pip3 install meson ninja
 
     - name: Install rizin
       run: |
@@ -80,7 +132,12 @@ jobs:
     - name: Test python lang plugin
       run: rizin -qc "Ll" | grep "Python SWIG"
 
-    - name: Test rizin.py
-      run: |
-        echo "import rizin" > testimport.py
-        python3 testimport.py
+    - name: Checkout our Testsuite Binaries
+      uses: actions/checkout@v7
+      with:
+        repository: rizinorg/rizin-testbins
+        path: rz-bindgen/test/bins
+
+    - name: Run rz-test
+      run: rz-test -L db/examples
+      working-directory: rz-bindgen/test

.github/workflows/lint.yml

@@ -1,25 +1,31 @@
 name: lint
-on: push
+on:
+  push:
+    branches:
+      - dev
+      - stable
+      - 'ci-*'
+  pull_request:
 jobs:
   licenses:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     steps:
     - name: Checkout rz-bindgen
-      uses: actions/checkout@v3
+      uses: actions/checkout@v7
     - name: REUSE compliance check
-      uses: fsfe/reuse-action@v1
+      uses: fsfe/reuse-action@v6
 
   python:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     steps:
     - name: Checkout rz-bindgen
-      uses: actions/checkout@v3
+      uses: actions/checkout@v7
     - name: Install tools
       run: |
         pip install mypy pyflakes pylint black
     - name: Run mypy
       run: |
-        mypy src/main.py
+        mypy --disable-error-code misc src/main.py
       if: ${{ always() }}
     - name: Run pyflakes
       run: |
@@ -35,15 +41,15 @@ jobs:
       if: ${{ always() }}
 
   codeql:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     permissions:
       security-events: write
     steps:
     - name: Checkout rz-bindgen
-      uses: actions/checkout@v3
+      uses: actions/checkout@v7
     - name: Initialize CodeQL
-      uses: github/codeql-action/init@v2
+      uses: github/codeql-action/init@v4
       with:
         languages: python
     - name: Run CodeQL
-      uses: github/codeql-action/analyze@v2
+      uses: github/codeql-action/analyze@v4

.github/workflows/release.yml

@@ -7,7 +7,7 @@ on:
 
 jobs:
   extract-rizin-version:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     outputs:
       rizin_version: ${{ steps.extract_version.outputs.result }}
     steps:
@@ -21,20 +21,20 @@ jobs:
       rizin_ref: ${{ needs.extract-rizin-version.outputs.rizin_version }}
 
   publish-pypi:
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     needs: [build]
     steps:
     - name: Download artifacts
-      uses: actions/download-artifact@v3
+      uses: actions/download-artifact@v8
       with:
         name: wheels
         path: dist
     - name: Download sdist
-      uses: actions/download-artifact@v3
+      uses: actions/download-artifact@v8
       with:
         name: sdist
         path: dist
     - name: Publish wheels
-      uses: pypa/gh-action-pypi-publish@v1.5.1
+      uses: pypa/gh-action-pypi-publish@v1.14.3
       with:
         password: ${{ secrets.PYPI_TOKEN }}

.reuse/dep5

@@ -1,32 +0,0 @@
-Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
-Upstream-Name: rz-bindgen
-Upstream-Contact: wingdeans <[email protected]>
-Source: https://github.com/rizinorg/rz-bindgen/
-
-Files: src/clang/__init__.py src/clang/cindex.py src/clang/enumerations.py
-Copyright: 2022 The LLVM Project
-License: Apache-2.0 WITH LLVM-exception
-
-Files: src/snippets_swig/*
-Copyright: 2022 wingdeans <[email protected]>
-License: LGPL-3.0-only
-
-Files: .github/workflows/* .gitignore README.md src/README.md
-Copyright: 2022 wingdeans <[email protected]>
-License: LGPL-3.0-only
-
-Files: meson.build plugin/meson.build meson_options.txt
-Copyright: 2022 wingdeans <[email protected]>
-License: LGPL-3.0-only
-
-Files: pyproject.toml mypy.ini pylintrc
-Copyright: 2022 wingdeans <[email protected]>
-License: LGPL-3.0-only
-
-Files: cutter/PythonConsole.ui cutter/CMakeLists.txt .clang-format
-Copyright: 2022 wingdeans <[email protected]>
-License: LGPL-3.0-only
-
-Files: doc/*.md
-Copyright: 2022 wingdeans <[email protected]>
-License: LGPL-3.0-only

REUSE.toml

@@ -0,0 +1,64 @@
+version = 1
+SPDX-PackageName = "rz-bindgen"
+SPDX-PackageSupplier = "wingdeans <[email protected]>"
+SPDX-PackageDownloadLocation = "https://github.com/rizinorg/rz-bindgen/"
+
+[[annotations]]
+path = ["src/clang/__init__.py", "src/clang/cindex.py", "src/clang/enumerations.py"]
+precedence = "aggregate"
+SPDX-FileCopyrightText = "2022 The LLVM Project"
+SPDX-License-Identifier = "Apache-2.0 WITH LLVM-exception"
+
+[[annotations]]
+path = "src/snippets_swig/**"
+precedence = "aggregate"
+SPDX-FileCopyrightText = "2022 wingdeans <[email protected]>"
+SPDX-License-Identifier = "LGPL-3.0-only"
+
+[[annotations]]
+path = [".github/workflows/**", ".gitignore", "README.md", "src/README.md"]
+precedence = "aggregate"
+SPDX-FileCopyrightText = "2022 wingdeans <[email protected]>"
+SPDX-License-Identifier = "LGPL-3.0-only"
+
+[[annotations]]
+path = ["meson.build", "plugin/meson.build", "meson_options.txt"]
+precedence = "aggregate"
+SPDX-FileCopyrightText = "2022 wingdeans <[email protected]>"
+SPDX-License-Identifier = "LGPL-3.0-only"
+
+[[annotations]]
+path = ["pyproject.toml", "mypy.ini", "pylintrc"]
+precedence = "aggregate"
+SPDX-FileCopyrightText = "2022 wingdeans <[email protected]>"
+SPDX-License-Identifier = "LGPL-3.0-only"
+
+[[annotations]]
+path = ["cutter/PythonConsole.ui", "cutter/CMakeLists.txt", ".clang-format"]
+precedence = "aggregate"
+SPDX-FileCopyrightText = "2022 wingdeans <[email protected]>"
+SPDX-License-Identifier = "LGPL-3.0-only"
+
+[[annotations]]
+path = "doc/**.md"
+precedence = "aggregate"
+SPDX-FileCopyrightText = "2022 wingdeans <[email protected]>"
+SPDX-License-Identifier = "LGPL-3.0-only"
+
+[[annotations]]
+path = "test/db/**"
+precedence = "aggregate"
+SPDX-FileCopyrightText = "2026 RizinOrg <[email protected]>"
+SPDX-License-Identifier = "LGPL-3.0-only"
+
+[[annotations]]
+path = "test/.gitignore"
+precedence = "aggregate"
+SPDX-FileCopyrightText = "2026 RizinOrg <[email protected]>"
+SPDX-License-Identifier = "LGPL-3.0-only"
+
+[[annotations]]
+path = ".github/**"
+precedence = "aggregate"
+SPDX-FileCopyrightText = "2026 RizinOrg <[email protected]>"
+SPDX-License-Identifier = "LGPL-3.0-only"

cibw_before_all.sh

@@ -4,23 +4,30 @@
 set -ex
 
 # Install deps
-pip3 install meson ninja meson-python build
+pygt311=$(python3 -c 'import sys; print(0) if sys.version_info.minor > 11 else print(1)' 2>&1)
+if [[ $pygt311 == '0' ]]; then
+    pip3 install --break-system-packages meson ninja meson-python build
+else
+    pip3 install meson ninja meson-python build
+fi
 
-if command -v apt; then
+if command -v brew; then
+    brew install --require-sha swig
+elif command -v apt; then
     set +e
     grep VERSION_CODENAME=stretch /etc/os-release >/dev/null 2>/dev/null
     if [[ $? == 0 ]] ; then
-	# Required because manylinux_2_24 uses Debian Stretch and the repos are not available anymore
+        # Required because manylinux_2_24 uses Debian Stretch and the repos are not available anymore
         echo "deb http://archive.debian.org/debian stretch main" > /etc/apt/sources.list
         echo "deb http://archive.debian.org/debian-security stretch/updates main" >> /etc/apt/sources.list
         echo "Acquire::Check-Valid-Until no;" > /etc/apt/apt.conf.d/99no-check-valid-until
     fi
     set -e
-    apt update && apt install --assume-yes libclang-7-dev clang-7 llvm-7
+    apt update && apt install --assume-yes libclang-7-dev clang-7 llvm-7 sudo
 elif command -v apk; then
-    apk update && apk add clang-dev
+    apk update && apk add clang-dev sudo
 elif command -v yum; then
-    yum -y install llvm-toolset-7.0 llvm-toolset-7.0-llvm-devel
+    yum -y install llvm-toolset-7.0 llvm-toolset-7.0-llvm-devel sudo
     # (CentOS 7) Uncomment following lines to see required paths in build log:
     #   yum -y install centos-release-scl
     #   source scl_source enable llvm-toolset-7.0 || true
@@ -28,13 +35,17 @@ fi
 
 pushd rizin
 
-if [[ "$OSTYPE" =~ msys* ]]; then
+if [[ "$OSTYPE" =~ msys|cygwin ]]; then
     meson setup --buildtype=release --prefix='c:/rizin' --vsenv build
+    meson install -C build
 else
+    if [[ "$OSTYPE" == linux* ]]; then
+        export CFLAGS="-include linux/limits.h"
+    fi
     meson setup --buildtype=release --libdir=lib build
+    sudo PATH="$PATH" bash -c "meson install -C build"
 fi
 
-meson install -C build
 popd
 
 if command -v apt; then

doc/bin_plugin.md

@@ -29,12 +29,12 @@ builder.enable_load_buffer = True
 plugin = builder.build(CustomBinPlugin())
 ```
 
-`RzBinPluginBuilder::build` returns an `RzBinPlugin` struct which has the enabled function pointers set to custom C functions which call into the currently active director. Enabling functions is done using variables on the builder which are named the same as their corresponding struct function pointer prefixed with `enable_`. To use the plugin, simply append the struct to `core.bin.plugins`.
+`RzBinPluginBuilder::build` returns an `RzBinPlugin` struct which has the enabled function pointers set to custom C functions which call into the currently active director. Enabling functions is done using variables on the builder which are named the same as their corresponding struct function pointer prefixed with `enable_`. To use the plugin, simply add the plugin to `core.bin`.
 
 ```py
 core = rizin.RzCore()
 plugin.thisown = False
-core.bin.plugins.append(plugin)
+core.bin.plugin_add(plugin)
 ```
 
 Now it is possible to see the `SWIGCustom` plugin when listing the binary plugins with `iL`:
@@ -72,7 +72,7 @@ plugin, plugin_struct = rizin.register_RzBinPlugin(CustomBinPlugin)
 
 core = rizin.RzCore()
 plugin_struct.thisown = False
-core.bin.plugins.append(plugin_struct)
+core.bin.plugin_add(plugin_struct)
 
 # Run rizin and load binary
 core.bin.force_plugin(plugin.name)

doc/core.md

@@ -50,6 +50,7 @@ In the SWIG bindings, these functions are mapped to methods of RzCore.
 
 ```py
 import rizin
+from rizin import RZ_CORE_CMD_EXIT as CMD_EXIT
 from sys import argv
 
 filename = argv[1]
@@ -66,8 +67,8 @@ for i, corefile in enumerate(core.files):
     for binfile in corefile.binfiles:
         print(f" * {binfile.file}")
 
-while True:
-    core.flush(input("rizin> "))
+while core.flush(input("rizin> ")) != CMD_EXIT:
+    pass
 ```
 
 Here's an example session:
@@ -86,10 +87,11 @@ rizin> aaa
 [x] Applied 0 FLIRT signatures via sigdb
 [x] Propagate noreturn information
 [x] Use -AA or aaaa to perform additional experimental analysis.
-> afl
+rizin> afl
 0x0040233e    1 6            entry0
 0x00402051    3 49   -> 16   sym.HelloWorld::Main
 0x0040205f   99 24482 -> 31854 sym.HelloWorld::.ctor
+rizin> q
 ```
 
 ### Plugins

examples/1-rz_core.py

@@ -4,6 +4,7 @@ SPDX-License-Identifier: LGPL-3.0-only
 """
 
 import rizin
+from rizin import RZ_CORE_CMD_EXIT as CMD_EXIT
 from sys import argv
 
 filename = argv[1]
@@ -20,5 +21,5 @@ for i, corefile in enumerate(core.files):
     for binfile in corefile.binfiles:
         print(f" * {binfile.file}")
 
-while True:
-    core.flush(input("rizin> "))
+while core.flush(input("rizin> ")) != CMD_EXIT:
+    pass

examples/2a-rz_bin_plugin.py

@@ -8,11 +8,10 @@ SPDX-License-Identifier: LGPL-3.0-only
 # things, see `2b-rz_bin_plugin.py`
 
 import rizin
+from rizin import RZ_CORE_CMD_EXIT as CMD_EXIT
 import sys
 
 
-import rizin
-
 class CustomBinPlugin(rizin.RzBinPluginDirector):
     def __init__(self):
         super().__init__()
@@ -23,6 +22,7 @@ class CustomBinPlugin(rizin.RzBinPluginDirector):
         print("size: ", bf.size)
         return True
 
+
 # Construct the director
 builder = rizin.RzBinPluginBuilder()
 builder.name = "SWIGCustom"
@@ -30,11 +30,11 @@ builder.enable_load_buffer = True
 plugin = builder.build(CustomBinPlugin())
 
 core = rizin.RzCore()
-core.bin.plugins.append(plugin)
+core.bin.plugin_add(plugin)
 
 # Run rizin and load binary
 core.bin.force_plugin(plugin.name)
 core.file_open_load(sys.argv[1])
 
-while True:
-    core.flush(input("> "))
+while core.flush(input("rizin> ")) != CMD_EXIT:
+    pass

examples/2b-rz_bin_plugin.py

@@ -4,6 +4,7 @@ SPDX-License-Identifier: LGPL-3.0-only
 """
 
 import rizin
+from rizin import RZ_CORE_CMD_EXIT as CMD_EXIT
 import sys
 
 
@@ -20,11 +21,11 @@ plugin, plugin_struct = rizin.register_RzBinPlugin(CustomBinPlugin)
 
 core = rizin.RzCore()
 plugin_struct.thisown = False
-core.bin.plugins.append(plugin_struct)
+core.bin.plugin_add(plugin_struct)
 
 # Run rizin and load binary
 core.bin.force_plugin(plugin.name)
 core.file_open_load(sys.argv[1])
 
-while True:
-    core.flush(input("> "))
+while core.flush(input("rizin> ")) != CMD_EXIT:
+    pass

meson.build

@@ -89,6 +89,11 @@ if target_swig or target_sphinx
     'src/lint.py',
     'src/main.py',
     'src/writer.py',
+    'src/snippets_swig/cmd_director.i',
+    'src/snippets_swig/iterators.py',
+    'src/snippets_swig/prologue.i',
+    'src/snippets_swig/register_command.py',
+    'src/snippets_swig/register_swig_command.cpp',
   )
 
   bindgen_outputs = custom_target(

plugin/plugin.c

@@ -2,6 +2,13 @@
 // SPDX-License-Identifier: LGPL-3.0-only
 
 #include <Python.h>
+/**
+ * Some defines in rz_userconf.h are conflicting with the ones in python.h
+ **/
+#undef HAVE_EXPLICIT_BZERO
+#undef HAVE_SIGACTION
+#undef HAVE_REALPATH
+
 #include <rz_core.h>
 #include <rz_util/rz_file.h>
 #include <swig_runtime.h>

py_install.py

@@ -16,6 +16,7 @@ def install_files(scheme):
         elif file.endswith(".so"):
             dest_type = 'platlib'
         install_dir = sysconfig.get_path(dest_type, scheme)
+        os.makedirs(install_dir, exist_ok=True)
         shutil.copy(file, install_dir)
         print(f"Installing {os.path.basename(file)} to {install_dir}")
 

pyproject.toml

@@ -19,13 +19,16 @@ environment = { PATH="/opt/rh/llvm-toolset-7.0/root/usr/bin:/opt/rh/llvm-toolset
 archs = ["x86_64"]
 
 [tool.cibuildwheel.windows]
-environment = { CMAKE_PREFIX_PATH="C:\\rizin" }
+environment = { CMAKE_PREFIX_PATH="C:/rizin", PATH="C:/rizin/bin;$PATH" }
 archs = ["AMD64"]
 
+[tool.cibuildwheel.macos]
+environment = { PATH="/opt/homebrew/bin:$PATH", MACOSX_DEPLOYMENT_TARGET="15.0" }
+
 [project]
 name = "rz-bindings"
 dynamic = [
   'version',
 ]
-requires-python = ">=3.8"
+requires-python = ">=3.9"
 readme = "README.md"

src/binding_generic.py

@@ -29,6 +29,7 @@ class Generic:
 
     specializations: Set[str]
 
+    c_methods: OrderedDict[str, List[str]]
     python_methods: OrderedDict[str, List[str]]
     specialization_extensions: DefaultDict[str, List[str]]
 
@@ -49,6 +50,7 @@ class Generic:
         self.methods = OrderedDict()
         self.specializations = set()
 
+        self.c_methods = OrderedDict()
         self.python_methods = OrderedDict()
         self.specialization_extensions = DefaultDict(list)
 
@@ -131,9 +133,15 @@ class Generic:
 
         return specialization
 
+    def add_c_method(self, name: str, *lines: str) -> None:
+        """
+        Add C method for name
+        """
+        self.c_methods[name] = list(lines)
+
     def add_python_method(self, decl: str, *lines: str) -> None:
         """
-        Add python function with decl
+        Add python method with decl
         """
         self.python_methods[decl] = [f"def {decl}:"] + [f"    {line}" for line in lines]
 

src/binding_generic_specializations.py

@@ -42,11 +42,19 @@ def gen_ctype_specializations(cursors: List[Cursor], ctype: CType) -> None:
             # eg. typedef RzVector /*<ut64>*/ (*func)(void)
             gen_ctype_specializations(cursors + [ctype.cursor], ctype.canonical)
     elif isinstance(ctype, CFunctionType):
+        cursor_children = list(cursors[-1].get_children())
+
+        # Handle typedef of typedef of a function pointer
+        while (
+            len(cursor_children) == 1 and cursor_children[0].kind == CursorKind.TYPE_REF
+        ):
+            cursor_children = list(
+                cursor_children[0].referenced.get_children()  # type: ignore[attr-defined]
+            )
+
         gen_ctype_specializations(cursors, ctype.result)
         cursor_args = [
-            cursor
-            for cursor in cursors[-1].get_children()
-            if cursor.kind == CursorKind.PARM_DECL
+            cursor for cursor in cursor_children if cursor.kind == CursorKind.PARM_DECL
         ]
 
         assert len(cursor_args) == len(ctype.args)

src/bindings.py

@@ -63,15 +63,15 @@ def bind_list(list_h: Header) -> None:
     """
     ### RzListIter ###
     rz_list_iter = Generic(list_h, "RzListIter", pointer=True)
-    rz_list_iter.add_method("rz_list_iter_get_next", rename="next", generic_ret=True)
-    rz_list_iter.add_method("rz_list_iter_get_data", rename="data", generic_ret=True)
+    rz_list_iter.add_method("rz_list_next", rename="next", generic_ret=True)
+    rz_list_iter.add_method("rz_list_val", rename="data", generic_ret=True)
 
     ### RzList ###
     rz_list = Generic(list_h, "RzList", dependencies=[rz_list_iter], pointer=True)
     rz_list.add_method("rz_list_length", rename="length")
 
-    rz_list.add_method("rz_list_first", rename="first", generic_ret=True)
-    rz_list.add_method("rz_list_last", rename="last", generic_ret=True)
+    rz_list.add_method("rz_list_first_val", rename="first", generic_ret=True)
+    rz_list.add_method("rz_list_last_val", rename="last", generic_ret=True)
     rz_list.add_method("rz_list_iterator", rename="iterator", generic_ret=True)
 
     rz_list.add_method(
@@ -150,8 +150,7 @@ def bind_analysis(analysis_h: Header) -> None:
     rz_analysis = Class(
         analysis_h,
         typedef="RzAnalysis",
-        ignore_fields={"leaddrs"},
-        rename_fields={},
+        struct="rz_analysis_t",
     )
 
     rz_analysis_function = Class(analysis_h, typedef="RzAnalysisFunction")
@@ -159,12 +158,10 @@ def bind_analysis(analysis_h: Header) -> None:
     rz_analysis_function.add_prefixed_methods("rz_analysis_function_")
 
     rz_analysis.add_method("rz_analysis_reflines_get", rename="get_reflines")
-    rz_analysis.add_prefixed_methods("rz_analysis_")
-    rz_analysis.add_prefixed_funcs("rz_analysis_")
+    rz_analysis.add_constructor("rz_analysis_new")
+    rz_analysis.add_destructor("rz_analysis_free")
 
-    Class(analysis_h, typedef="RzAnalysisBlock")
-    Class(analysis_h, typedef="RzAnalysisEsil")
-    Class(analysis_h, typedef="RzAnalysisEsilInterState")
+    Class(analysis_h, typedef="RzAnalysisBlock", struct="rz_analysis_bb_t")
     Class(analysis_h, typedef="RzAnalysisPlugin")
 
     Class(
@@ -180,7 +177,13 @@ def bind_asm(asm_h: Header) -> None:
     """
     RzAsm
     """
-    Class(asm_h, typedef="RzAsm")  # TODO: Add functions
+
+    rz_asm = Class(asm_h, typedef="RzAsm", struct="rz_asm_t")  # TODO: Add functions
+    rz_asm.add_constructor("rz_asm_new")
+    rz_asm.add_destructor("rz_asm_free")
+    rz_asm.add_prefixed_methods("rz_asm_")
+    rz_asm.add_prefixed_funcs("rz_asm_")
+
     Class(asm_h, typedef="RzAsmPlugin")
 
 
@@ -258,7 +261,6 @@ def bind_cons(cons_h: Header) -> None:
         typedef="RzCons",
         ignore_fields={"term_raw", "term_buf"},  # struct termios
         rename_fields={
-            "lastline": "_lastline",
             "echo": "_echo",
             "highlight": "_highlight",
             "newline": "_newline",
@@ -328,6 +330,17 @@ def bind_core(core_h: Header) -> None:
 
     Class(core_h, typedef="RzCoreFile")
 
+    MacroEnum(core_h, prefix="RZ_CORE_CMD_")
+
+
+@threaded_header("rz_esil/rz_esil.h")
+def bind_esil(esil_h: Header) -> None:
+    """
+    RzAnalysisEsil
+    """
+    Class(esil_h, typedef="RzAnalysisEsil")
+    Class(esil_h, typedef="RzAnalysisEsilInterState")
+
 
 @threaded_header("rz_flag.h")
 def bind_flag(flag_h: Header) -> None:

src/clang/cindex.py

@@ -2224,7 +2224,7 @@ class Type(Structure):
 
                 return result
 
-        assert self.kind == TypeKind.FUNCTIONPROTO
+        assert self.kind in (TypeKind.FUNCTIONPROTO, TypeKind.FUNCTIONNOPROTO)
         return ArgumentsIterator(self)
 
     @property
@@ -2320,7 +2320,7 @@ class Type(Structure):
 
     def is_function_variadic(self):
         """Determine whether this function Type is a variadic function type."""
-        assert self.kind == TypeKind.FUNCTIONPROTO
+        assert self.kind in (TypeKind.FUNCTIONPROTO, TypeKind.FUNCTIONNOPROTO)
 
         return conf.lib.clang_isFunctionTypeVariadic(self)
 

src/clang/cindex.pyi

@@ -38,6 +38,7 @@ class TypeKind(Enum):
     POINTER: TypeKind
     CONSTANTARRAY: TypeKind
     FUNCTIONPROTO: TypeKind
+    FUNCTIONNOPROTO: TypeKind
     INCOMPLETEARRAY: TypeKind
 
     RECORD: TypeKind
@@ -109,23 +110,23 @@ class Token:
     extent: SourceRange
 
 class CursorKind(Enum):
-    INCLUSION_DIRECTIVE: TypeKind
-    MACRO_INSTANTIATION: TypeKind
+    INCLUSION_DIRECTIVE: CursorKind
+    MACRO_INSTANTIATION: CursorKind
 
-    ENUM_DECL: TypeKind
-    MACRO_DEFINITION: TypeKind
-    STRUCT_DECL: TypeKind
-    TYPEDEF_DECL: TypeKind
-    FUNCTION_DECL: TypeKind
+    ENUM_DECL: CursorKind
+    MACRO_DEFINITION: CursorKind
+    STRUCT_DECL: CursorKind
+    TYPEDEF_DECL: CursorKind
+    FUNCTION_DECL: CursorKind
 
-    FIELD_DECL: TypeKind
-    UNION_DECL: TypeKind
-    PARM_DECL: TypeKind
-    ENUM_CONSTANT_DECL: TypeKind
+    FIELD_DECL: CursorKind
+    UNION_DECL: CursorKind
+    PARM_DECL: CursorKind
+    ENUM_CONSTANT_DECL: CursorKind
 
-    ANNOTATE_ATTR: TypeKind
-    TYPE_REF: TypeKind
-    PACKED_ATTR: TypeKind
+    ANNOTATE_ATTR: CursorKind
+    TYPE_REF: CursorKind
+    PACKED_ATTR: CursorKind
 
 class Cursor:
     kind: CursorKind

src/cparser_header.py

@@ -76,7 +76,7 @@ class CFunc(AttrCursor):
 
 
 ### Configuration ###
-rizin_include_path: Optional[str] = None
+rizin_include_path: Optional[str] = None  # pylint: disable=invalid-name
 clang_args: List[str] = []
 
 ### Headers ###

src/cparser_types.py

@@ -123,7 +123,7 @@ def wrap_type(type_: Type) -> CType:
             cursor=type_.get_declaration(),
         )
 
-    if type_.kind == TypeKind.FUNCTIONPROTO:
+    if type_.kind in (TypeKind.FUNCTIONPROTO, TypeKind.FUNCTIONNOPROTO):
         return CFunctionType(
             orig_type,
             result=wrap_type(type_.get_result()),

src/generator_sphinx.py

@@ -39,7 +39,7 @@ from binding_func import Func
 
 from writer import Writer
 
-doxygen_path: Optional[str] = None
+doxygen_path: Optional[str] = None  # pylint: disable=invalid-name
 
 DoxygenElements = Dict[str, Element]
 

src/generator_swig.py

@@ -114,6 +114,9 @@ def write_generic(writer: Writer, generic: Generic) -> None:
             for name, method in generic.methods.items():
                 write_func(writer, method, name, FuncKind.GENERIC)
 
+            for c_lines in generic.c_methods.values():
+                writer.line(*c_lines)
+
             for python_lines in generic.python_methods.values():
                 writer.line("%pythoncode %{")
                 with writer.indent():
@@ -265,6 +268,11 @@ def write_func(writer: Writer, func: Func, name: str, kind: FuncKind) -> None:
         if arg_name == "self":
             arg_name = "_self"
 
+        # if function arg is the same as the function name
+        # we rename the argument
+        if arg_name == name:
+            arg_name += "_arg"
+
         arg_decl = stringify_decl(
             arg_name,
             arg.ctype,

src/lint.py

@@ -30,9 +30,11 @@ import os
 import sys
 import json
 import shlex
+import re
 from argparse import ArgumentParser
 from dataclasses import dataclass
 from itertools import zip_longest
+from pathlib import Path
 
 from clang.cindex import (
     Config,
@@ -44,6 +46,30 @@ from clang.cindex import (
     SourceLocation,
 )
 
+# Detect /** ... */ or /*! ... */ style Doxygen block comments
+_DOXY_BLOCK_RE = re.compile(r"/\*[*!][\s\S]*?\*/")
+
+# Detect consecutive /// or //! style Doxygen line comments
+_DOXY_LINE_RE = re.compile(r"(?:(?:\/\/[\/!])[^\n]*\n?)+")
+
+# Match any @-prefixed Doxygen command with word boundary
+_DOXY_COMMAND_RE = re.compile(r"@(\w+)\b")
+
+# Map of @-prefixed commands to their correct backslash equivalents
+_DOXY_COMMANDS = {
+    "param": "\\param",
+    "return": "\\return",
+    "brief": "\\brief",
+    "ref": "\\ref",
+    "p": "\\p",
+    "see": "\\see",
+    "file": "\\file",
+    "ingroup": "\\ingroup",
+    "post": "\\post",
+    "sa": "\\sa",
+    "test": "\\test",
+}
+
 
 warnings = set()
 
@@ -57,6 +83,14 @@ def warn(warning: str) -> None:
         warnings.add(warning)
 
 
+def location_get_filename(location: SourceLocation) -> str:
+    """
+    Get filename for a SourceLocation
+    """
+    path = Path(os.path.abspath(location.file.name))
+    return path.name
+
+
 def stringify_location(location: SourceLocation) -> str:
     """
     Get <relpath:filename:line> for a SourceLocation
@@ -76,7 +110,25 @@ def cursor_get_annotations(cursor: Cursor) -> List[str]:
     ]
 
 
-generic_types = {"RzList", "RzListIter", "RzPVector", "RzVector", "RzGraph"}
+generic_types = {
+    "RzList",
+    "RzListIter",
+    "RzPVector",
+    "RzVector",
+    "RzGraph",
+    "HtPP",
+    "RzThreadRingBuf",
+    "RzThreadQueue",
+}
+skip_files = {
+    "ht_inc.c",
+    "ht_inc.h",
+    "rz_th_ht.h",
+    "rz_th.h",
+    "thread_hash_table.c",
+    "thread_queue.c",
+    "thread_ring_buf.c",
+}
 
 
 def cursor_get_comment(cursor: Cursor, *, packed: bool = False) -> Optional[str]:
@@ -136,7 +188,10 @@ def cursor_get_comment(cursor: Cursor, *, packed: bool = False) -> Optional[str]
     # Filter out other tokens
     comment = token.spelling
     if not comment.startswith("/*") or not comment.endswith("*/"):
-        if typeref_spelling in generic_types:
+        if (
+            typeref_spelling in generic_types
+            and location_get_filename(cursor.location) not in skip_files
+        ):
             warn(
                 f"Missing type comment at {stringify_location(cursor.location)} "
                 "(token is not a comment)"
@@ -152,20 +207,34 @@ def cursor_get_comment(cursor: Cursor, *, packed: bool = False) -> Optional[str]
         return comment
 
     # Check pointer (or lack of) and space between pointer
-    if typeref_spelling in {"RzList", "RzListIter", "RzPVector", "RzGraph"}:
+    if typeref_spelling in {"RzList", "RzListIter", "RzPVector", "RzThreadQueue"}:
         if comment[-2] != "*":
             warn(f"Type comment at {stringify_location(cursor.location)} lacks pointer")
         elif comment[-3] != " ":
             warn(
                 f"Type comment at {stringify_location(cursor.location)} lacks space between pointer"
             )
-    elif typeref_spelling in {"RzVector"}:
+    elif typeref_spelling in {"RzVector", "RzThreadRingBuf"}:
         if comment[-2] == "*":
             warn(
                 f"Type comment at {stringify_location(cursor.location)} should not have pointer"
             )
+    elif typeref_spelling in {"RzGraph", "HtPP"}:
+        if not re.match(
+            r"<(struct |const )?[A-Za-z0-9_]+ \*, (struct |const )?[A-Za-z0-9_]+ \*>",
+            comment,
+        ):
+            if typeref_spelling == "RzGraph":
+                warn(
+                    f"Type comment at {stringify_location(cursor.location)} must "
+                    f"follow exactly the pattern '/*<NodeType *, EdgeType *>*/'. Is: '{comment}'"
+                )
+            elif typeref_spelling == "HtPP":
+                warn(
+                    f"Type comment at {stringify_location(cursor.location)} must "
+                    f"follow exactly the pattern '/*<KeyType *, ValueType *>*/'. Is: '{comment}'"
+                )
     elif typeref_spelling in {
-        "HtPP",
         "HtUP",
         "HtUU",
         "HtPU",
@@ -265,6 +334,51 @@ class Function:
                     )
 
 
+def check_doxygen_syntax(file_path: str, rizin_path: str) -> None:
+    """
+    Check for incorrect Doxygen syntax in a file.
+
+    Rizin uses backslash syntax (\\param, \\return, etc.)
+    instead of at-sign syntax (@param, @return, etc.).
+    This function scans Doxygen comment blocks and reports any @-prefixed command usage.
+    """
+    if not (file_path.endswith(".c") or file_path.endswith(".h")):
+        return
+
+    try:
+        with open(file_path, "r", encoding="utf-8", errors="ignore") as f:
+            content = f.read()
+    except (OSError, IOError):
+        return
+
+    relpath = os.path.relpath(os.path.abspath(file_path), rizin_path)
+
+    comment_matches = list(_DOXY_BLOCK_RE.finditer(content)) + list(
+        _DOXY_LINE_RE.finditer(content)
+    )
+
+    comment_matches.sort(key=lambda m: m.start())
+
+    for match in comment_matches:
+        block_text = match.group(0)
+        block_start_pos = match.start()
+
+        line_offset = content[:block_start_pos].count("\n")
+
+        lines = block_text.splitlines()
+        for line_idx, line in enumerate(lines):
+            for cmd_match in _DOXY_COMMAND_RE.finditer(line):
+                command = cmd_match.group(1).lower()
+                if command in _DOXY_COMMANDS:
+                    line_num = line_offset + line_idx + 1
+                    column = cmd_match.start() + 1
+                    correct_syntax = _DOXY_COMMANDS[command]
+                    warn(
+                        f"<{relpath}:{line_num}:{column}> "
+                        f"Found @{command}, should use {correct_syntax}"
+                    )
+
+
 def check_translation_unit(
     translation_unit: TranslationUnit, *, skipped_paths: Set[str], rizin_path: str
 ) -> None:
@@ -309,6 +423,7 @@ def check_translation_unit(
                     CursorKind.STRUCT_DECL,
                     CursorKind.UNION_DECL,
                     CursorKind.ENUM_DECL,
+                    CursorKind.ALIGNED_ATTR,
                 ]:
                     warn(f"Unknown field cursor kind: {field.kind}")
 
@@ -385,6 +500,8 @@ def main() -> int:
                 for include in includes
             ]
 
+            check_doxygen_syntax(abspath, rizin_path)
+
             try:
                 check_translation_unit(
                     TranslationUnit.from_source(abspath, clang_args),

src/snippets_swig/prologue.i

@@ -9,16 +9,20 @@ bool rizin_warn_deprecate_instructions = true;
 %{
 void rizin_try_warn_deprecate(const char *name, const char *c_name) {
     if (rizin_warn_deprecate) {
-        printf("Warning: `%s` calls deprecated function `%s`\n", name, c_name);
+        fprintf(stderr, "Warning: `%s` calls deprecated function `%s`\n", name, c_name);
         if (rizin_warn_deprecate_instructions) {
-            puts("To disable this warning, set rizin_warn_deprecate to false");
-            puts("The way to do this depends on the SWIG language being used");
-            puts("For python, do `rizin.cvar.rizin_warn_deprecate = False`");
+            fprintf(stderr,
+                "To disable this warning, set rizin_warn_deprecate to false\n"
+                "The way to do this depends on the SWIG language being used\n"
+                "For python, do `rizin.cvar.rizin_warn_deprecate = False`\n");
         }
     }
 }
 %}
 
+// uint64_t, int64_t etc
+%include <stdint.i>
+
 // Buffer typemaps
 %include <pybuffer.i>
 %pybuffer_mutable_binary(unsigned char *buf, unsigned long long len);

test/.gitignore

@@ -0,0 +1 @@
+/bins

test/db/examples

@@ -0,0 +1,42 @@
+NAME=1-rz_core.py =
+FILE=--
+CMDS=<<EOF
+!echo q | python3 ../examples/1-rz_core.py =
+echo
+EOF
+EXPECT=<<EOF
+Loaded 1 file(s)
+Corefile #1 has 1 binfile(s)
+ * malloc://512
+rizin> 
+EOF
+EXPECT_ERR=
+RUN
+
+NAME=2a-rz_bin_plugin.py
+FILE=--
+CMDS=<<EOF
+!echo q | python3 ../examples/2a-rz_bin_plugin.py bins/elf/analysis/ls-linux64
+echo
+EOF
+EXPECT=<<EOF
+name:  bins/elf/analysis/ls-linux64
+size:  121584
+rizin> 
+EOF
+EXPECT_ERR=
+RUN
+
+NAME=2b-rz_bin_plugin.py
+FILE=--
+CMDS=<<EOF
+!echo q | python3 ../examples/2b-rz_bin_plugin.py bins/pe/hello_world_arm/hello_world_arm64.exe
+echo
+EOF
+EXPECT=<<EOF
+name:  bins/pe/hello_world_arm/hello_world_arm64.exe
+size:  8704
+rizin> 
+EOF
+EXPECT_ERR=
+RUN