Add stubs for stash internal functions

Author: RogerGee

docs/DOCS.txt

@@ -2148,6 +2148,44 @@ array git2_signature_convert(resource $signature)
         - when.time
         - when.offset
 
+----------------------------------------
+[git_stash]
+----------------------------------------
+
+Stash apply options callback signature:
+
+    void callback(int $progress,mixed $payload)
+
+        The callback should return false to abort the stash.
+
+        The callback should throw on error.
+
+void git_stash_apply(resource $repo,int $index,?array $stash_apply_options)
+
+    Parameter $stash_apply_options is an associative array corresponding to
+    git_stash_apply_options. Options are defaulted using
+    git_stash_apply_options_init().
+
+void git_stash_drop(resource $repo,int $index)
+
+void git_stash_foreach(resource $repo,callable $callback,mixed $payload)
+
+    Callback signature:
+
+        void callback(int $index,string $message,string $stash_id,mixed $payload)
+
+            The callback should return false to stop iteration.
+
+            The callback should throw on error.
+
+void git_stash_pop(resource $repo,int $index,?array $stash_apply_options)
+
+    Parameter $stash_apply_options is an associative array corresponding to
+    git_stash_apply_options. Options are defaulted using
+    git_stash_apply_options_init().
+
+string git_stash_save(resource $repo,resource $signature,string $message,int $flags)
+
 ----------------------------------------
 [git_tree]
     [git_tree_entry]
@@ -2424,38 +2462,6 @@ git_status_should_ignore(resource,string)
 
     Returns bool
 
-----------------------------------------
-[git_stash]
-----------------------------------------
-
-Stash apply options callback signature:
-
-    void callback(int $progress,mixed $payload)
-
-        The callback should return false to abort the stash.
-
-        The callback should throw on error.
-
-git_stash_apply(resource,int,array|null)
-
-git_stash_drop(resource,int)
-
-git_stash_foreach(resource,callable,mixed)
-
-    Callback signature:
-
-        void callback(int $index,string $message,string $stash_id,mixed $payload)
-
-            The callback should return false to stop iteration.
-
-            The callback should throw on error.
-
-git_stash_pop(resource,int,array|null)
-
-git_stash_save(resource,resource,string,int)
-
-    Returns int
-
 ----------------------------------------
 [git_submodule]
 ----------------------------------------

stash.h

@@ -6,7 +6,9 @@
 
 #ifndef PHPGIT2_STASH_H
 #define PHPGIT2_STASH_H
+
 #include "checkout.h"
+#include "stubs/stash_arginfo.h"
 
 namespace php_git2
 {

stubs/stash.stub.php

@@ -0,0 +1,27 @@
+<?php
+
+/**
+ * @param resource $repo
+ */
+function git_stash_apply($repo,int $index,?array $stash_apply_options) : void {}
+
+/**
+ * @param resource $repo
+ */
+function git_stash_drop($repo,int $index) : void {}
+
+/**
+ * @param resource $repo
+ */
+function git_stash_foreach($repo,callable $callback,mixed $payload) : void {}
+
+/**
+ * @param resource $repo
+ */
+function git_stash_pop($repo,int $index,?array $stash_apply_options) : void {}
+
+/**
+ * @param resource $repo
+ * @param resource $signature
+ */
+function git_stash_save($repo,$signature,string $message,int $flags) : string {}

stubs/stash_arginfo.h

@@ -0,0 +1,28 @@
+/* This is a generated file, edit the .stub.php file instead.
+ * Stub hash: 98fe1134ec5fe34e45d88c6bd270a427ecf82d98 */
+
+ZEND_BEGIN_ARG_WITH_RETURN_TYPE_INFO_EX(arginfo_git_stash_apply, 0, 3, IS_VOID, 0)
+	ZEND_ARG_INFO(0, repo)
+	ZEND_ARG_TYPE_INFO(0, index, IS_LONG, 0)
+	ZEND_ARG_TYPE_INFO(0, stash_apply_options, IS_ARRAY, 1)
+ZEND_END_ARG_INFO()
+
+ZEND_BEGIN_ARG_WITH_RETURN_TYPE_INFO_EX(arginfo_git_stash_drop, 0, 2, IS_VOID, 0)
+	ZEND_ARG_INFO(0, repo)
+	ZEND_ARG_TYPE_INFO(0, index, IS_LONG, 0)
+ZEND_END_ARG_INFO()
+
+ZEND_BEGIN_ARG_WITH_RETURN_TYPE_INFO_EX(arginfo_git_stash_foreach, 0, 3, IS_VOID, 0)
+	ZEND_ARG_INFO(0, repo)
+	ZEND_ARG_TYPE_INFO(0, callback, IS_CALLABLE, 0)
+	ZEND_ARG_TYPE_INFO(0, payload, IS_MIXED, 0)
+ZEND_END_ARG_INFO()
+
+#define arginfo_git_stash_pop arginfo_git_stash_apply
+
+ZEND_BEGIN_ARG_WITH_RETURN_TYPE_INFO_EX(arginfo_git_stash_save, 0, 4, IS_STRING, 0)
+	ZEND_ARG_INFO(0, repo)
+	ZEND_ARG_INFO(0, signature)
+	ZEND_ARG_TYPE_INFO(0, message, IS_STRING, 0)
+	ZEND_ARG_TYPE_INFO(0, flags, IS_LONG, 0)
+ZEND_END_ARG_INFO()

stubs/tmp.h

@@ -187,21 +187,6 @@ ZEND_END_ARG_INFO()
 ZEND_BEGIN_ARG_INFO(arginfo_git_status_should_ignore,{})
 ZEND_END_ARG_INFO()
 
-ZEND_BEGIN_ARG_INFO(arginfo_git_stash_apply,{})
-ZEND_END_ARG_INFO()
-
-ZEND_BEGIN_ARG_INFO(arginfo_git_stash_drop,{})
-ZEND_END_ARG_INFO()
-
-ZEND_BEGIN_ARG_INFO(arginfo_git_stash_foreach,{})
-ZEND_END_ARG_INFO()
-
-ZEND_BEGIN_ARG_INFO(arginfo_git_stash_pop,{})
-ZEND_END_ARG_INFO()
-
-ZEND_BEGIN_ARG_INFO(arginfo_git_stash_save,{})
-ZEND_END_ARG_INFO()
-
 ZEND_BEGIN_ARG_INFO(arginfo_git_submodule_add_finalize,{})
 ZEND_END_ARG_INFO()