build: generate bindings from the Frida devkit

.github/workflows/code-style.yml

@@ -4,13 +4,12 @@ jobs:
   black:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v7
       - uses: psf/black@stable
   isort:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
-      - uses: actions/setup-python@v4
-        with:
-          python-version: 3.8
-      - uses: jamescurtin/isort-action@master
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v6
+      - run: pip install isort
+      - run: isort --check-only --diff .

.github/workflows/linting.yml

@@ -4,12 +4,13 @@ jobs:
   pyflakes:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
-      - uses: lgeiger/pyflakes-action@master
+      - uses: actions/checkout@v7
+      - run: pip install pyflakes
+      - run: pyflakes $(git ls-files '*.py' | grep -v '^frida/frida_bindgen/assets/')
   mypy:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v7
       - uses: jpetrucciani/mypy-check@master
         with:
-          mypy_flags: '--exclude examples --exclude setup'
+          mypy_flags: '--exclude examples --exclude setup --exclude frida/frida_bindgen/assets'

.github/workflows/tests.yml

@@ -0,0 +1,19 @@
+name: tests
+on: [push, pull_request]
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          submodules: recursive
+      - uses: actions/setup-python@v6
+        with:
+          python-version: '3.x'
+      - name: Install build dependencies
+        run: pip install setuptools
+      - name: Build the extension
+        run: make
+      - name: Run the test suite
+        run: python3 -m unittest tests.test_bindgen -v

.gitignore

@@ -1,5 +1,7 @@
 *.pyc
 *.user
+*.abi3.so
 /*.egg-info/
+/.cache/
 /build/
 /dist/

MANIFEST.in

@@ -0,0 +1,4 @@
+include frida/extension.version
+include frida/py.typed
+recursive-include frida/frida_bindgen *.py *.c *.h
+recursive-include frida/frida_bindgen_core *.py

README.md

@@ -1,6 +1,8 @@
 # frida-python
 
-Python [bindings](https://github.com/frida/frida-python) for [Frida](https://frida.re) but with devkit.
+Python [bindings](https://github.com/frida/frida-python) for [Frida](https://frida.re), built against a Frida devkit.
+
+The extension and its Python facade are generated at install time from the devkit's `frida-core.gir`, then linked against its `libfrida-core` library. No Frida source checkout or Frida source build is needed.
 
 # Some tips during development
 
@@ -12,7 +14,7 @@ pip install --force-reinstall frida-<FRIDA_VERSION>-cp37-abi3-linux_aarch64.whl
 ```
 
 > [!NOTE]
-> Note that you use devkit of same version which you're installing for.
+> Use the devkit for the same version that you are installing. The generator also needs the system `GLib-2.0.gir`, `GObject-2.0.gir`, and `Gio-2.0.gir` files. On Termux these are normally in `$PREFIX/share/gir-1.0`. Set `FRIDA_GIR_DIR` if they are elsewhere.
 
 ## Example: