feat: 增加 suc，err 函数，方便外部使用

composer.json

@@ -29,7 +29,8 @@
       "Wei\\": "lib"
     },
     "files": [
-      "lib/Wei.php"
+      "lib/Wei.php",
+      "lib/functions.php"
     ]
   },
   "autoload-dev": {

lib/functions.php

@@ -0,0 +1,31 @@
+<?php
+
+use Wei\Ret;
+
+if (!function_exists('suc')) {
+    /**
+     * Return operation successful result
+     *
+     * @param string|array|null $message
+     * @return Ret
+     */
+    function suc($message = null): Ret
+    {
+        return Ret::suc($message);
+    }
+}
+
+if (!function_exists('err')) {
+    /**
+     * Return operation failed result, and logs with an info level
+     *
+     * @param array|string $message
+     * @param int|null $code
+     * @param string|null $level
+     * @return Ret
+     */
+    function err($message, ?int $code = null, ?string $level = null): Ret
+    {
+        return Ret::err(...func_get_args());
+    }
+}

tests/unit/RetTest.php

@@ -521,4 +521,10 @@ public function testAssertSuc()
         $result = $ret->assert();
         $this->assertSame($ret, $result);
     }
+
+    public function testFn()
+    {
+        $this->assertRetSuc(suc());
+        $this->assertRetErr(err('x'));
+    }
 }