스킵 구현

DPP-master/buildtools/classes/Generator/CoroGenerator.php

@@ -0,0 +1,135 @@
+<?php
+
+namespace Dpp\Generator;
+
+use Dpp\StructGeneratorInterface;
+
+/**
+ * Generate header and .cpp file for coroutine calls (starting with 'co_')
+ */
+class CoroGenerator implements StructGeneratorInterface
+{
+
+    /**
+     * @inheritDoc
+     */
+    public function generateHeaderStart(): string
+    {
+return <<<EOT
+/************************************************************************************
+ *
+ * D++, A Lightweight C++ library for Discord
+ *
+ * Copyright 2022 Craig Edwards and D++ contributors
+ * (https://github.com/brainboxdotcc/DPP/graphs/contributors)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ ************************************************************************************/
+
+
+/* Auto @generated by buildtools/make_coro_struct.php.
+ *
+ * DO NOT EDIT BY HAND!
+ *
+ * To re-generate this header file re-run the script!
+ */
+
+EOT;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function generateCppStart(): string
+    {
+        return $this->generateHeaderStart() . <<<EOT
+#ifdef DPP_CORO
+
+#include <dpp/export.h>
+#include <dpp/snowflake.h>
+#include <dpp/cluster.h>
+#include <dpp/coro.h>
+
+namespace dpp {
+
+
+EOT;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function checkForChanges(): bool
+    {
+        /* Check if we need to re-generate by comparing modification times */
+        $us = file_exists('include/dpp/cluster_coro_calls.h') ? filemtime('include/dpp/cluster_coro_calls.h') : 0;
+        $them = filemtime('include/dpp/cluster.h');
+        if ($them <= $us) {
+            echo "-- No change required.\n";
+            return false;
+        }
+
+        echo "-- Autogenerating include/dpp/cluster_coro_calls.h\n";
+        echo "-- Autogenerating src/dpp/cluster_coro_calls.cpp\n";
+        return true;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function generateHeaderDef(string $returnType, string $currentFunction, string $parameters, string $noDefaults, string $parameterTypes, string $parameterNames): string
+    {
+        return "[[nodiscard]] async<confirmation_callback_t> co_{$currentFunction}($parameters);\n\n";
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function generateCppDef(string $returnType, string $currentFunction, string $parameters, string $noDefaults, string $parameterTypes, string $parameterNames): string
+    {
+        /* if (substr($parameterNames, 0, 2) === ", ")
+            $parameterNames = substr($parameterNames, 2); */
+        return "async<confirmation_callback_t> cluster::co_${currentFunction}($noDefaults) {\n\treturn async{ this, static_cast<void (cluster::*)($parameterTypes". (!empty($parameterTypes) ? ", " : "") . "command_completion_event_t)>(&cluster::$currentFunction)$parameterNames };\n}\n\n";
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function getCommentArray(): array
+    {
+        return [" * \memberof dpp::cluster"];
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function saveHeader(string $content): void
+    {
+        $content .= "[[nodiscard]] async<http_request_completion_t> co_request(const std::string &url, http_method method, const std::string &postdata = \"\", const std::string &mimetype = \"text/plain\", const std::multimap<std::string, std::string> &headers = {});\n\n";
+        file_put_contents('include/dpp/cluster_coro_calls.h', $content);
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function saveCpp(string $cppcontent): void
+    {
+        $cppcontent .= "dpp::async<dpp::http_request_completion_t> dpp::cluster::co_request(const std::string &url, http_method method, const std::string &postdata, const std::string &mimetype, const std::multimap<std::string, std::string> &headers) {\n\treturn async<http_request_completion_t>{ [&, this] <typename C> (C &&cc) { return this->request(url, method, std::forward<C>(cc), postdata, mimetype, headers); }};\n}
+
+#endif
+";
+        file_put_contents('src/dpp/cluster_coro_calls.cpp', $cppcontent);
+    }
+
+}

DPP-master/buildtools/classes/Generator/SyncGenerator.php

@@ -0,0 +1,130 @@
+<?php
+
+namespace Dpp\Generator;
+
+use Dpp\StructGeneratorInterface;
+
+/**
+ * Generate header and .cpp file for synchronous calls (ending in '_sync')
+ */
+class SyncGenerator implements StructGeneratorInterface
+{
+
+    /**
+     * @inheritDoc
+     */
+    public function generateHeaderStart(): string
+    {
+return <<<EOT
+/************************************************************************************
+ *
+ * D++, A Lightweight C++ library for Discord
+ *
+ * Copyright 2022 Craig Edwards and D++ contributors
+ * (https://github.com/brainboxdotcc/DPP/graphs/contributors)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ ************************************************************************************/
+
+
+/* Auto @generated by buildtools/make_sync_struct.php.
+ *
+ * DO NOT EDIT BY HAND!
+ *
+ * To re-generate this header file re-run the script!
+ */
+
+EOT;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function generateCppStart(): string
+    {
+        return $this->generateHeaderStart() . <<<EOT
+
+#include <dpp/export.h>
+#include <dpp/snowflake.h>
+#include <dpp/cluster.h>
+
+namespace dpp {
+
+
+EOT;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function checkForChanges(): bool
+    {
+        /* Check if we need to re-generate by comparing modification times */
+        $us = file_exists('include/dpp/cluster_sync_calls.h') ? filemtime('include/dpp/cluster_sync_calls.h') : 0;
+        $them = filemtime('include/dpp/cluster.h');
+        if ($them <= $us) {
+            echo "-- No change required.\n";
+            return false;
+        }
+
+        echo "-- Autogenerating include/dpp/cluster_sync_calls.h\n";
+        echo "-- Autogenerating src/dpp/cluster_sync_calls.cpp\n";
+        return true;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function generateHeaderDef(string $returnType, string $currentFunction, string $parameters, string $noDefaults, string $parameterTypes, string $parameterNames): string
+    {
+        return "$returnType {$currentFunction}_sync($parameters);\n\n";
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function generateCppDef(string $returnType, string $currentFunction, string $parameters, string $noDefaults, string $parameterTypes, string $parameterNames): string
+    {
+        return "$returnType cluster::{$currentFunction}_sync($noDefaults) {\n\treturn dpp::sync<$returnType>(this, static_cast<void (cluster::*)($parameterTypes". (!empty($parameterTypes) ? ", " : "") . "command_completion_event_t)>(&cluster::$currentFunction)$parameterNames);\n}\n\n";
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function getCommentArray(): array
+    {
+        return [
+            " * \memberof dpp::cluster",
+            " * @throw dpp::rest_exception upon failure to execute REST function",
+            " * @warning This function is a blocking (synchronous) call and should only be used from within a separate thread.",
+            " * Avoid direct use of this function inside an event handler.",
+        ];
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function saveHeader(string $content): void
+    {
+        file_put_contents('include/dpp/cluster_sync_calls.h', $content);
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function saveCpp(string $cppcontent): void
+    {
+        file_put_contents('src/dpp/cluster_sync_calls.cpp', $cppcontent);
+    }    
+}

DPP-master/buildtools/classes/Packager/Vcpkg.php

@@ -0,0 +1,284 @@
+<?php
+
+namespace Dpp\Packager;
+
+use \RuntimeException;
+
+const GREEN = "\033[32m";
+const RED   = "\033[31m";
+const WHITE = "\033[0m";
+
+class Vcpkg
+{
+    /**
+     * @var string Git Tag
+     */
+    private string $latestTag;
+
+    /**
+     * @var string Semver version
+     */
+    private string $version;
+
+    /**
+     * @var string Path to GIT
+     */
+    private string $git;
+
+    /**
+     * @var string Path to SUDO
+     */
+    private string $sudo;
+
+    /**
+     * @var bool True when we have done the first build to get the SHA512 sum
+     */
+    private bool $firstBuildComplete = false;
+
+    /**
+     * Constructor
+     * 
+     * Examines current diretory's git repository to get latest tag and version.
+     */
+    public function __construct()
+    {
+        global $argv;
+        if (count($argv) < 2) {
+            throw new RuntimeException(RED . "Missing github repository owner and access token\n" . WHITE);
+        }
+        echo GREEN . "Starting vcpkg updater...\n" . WHITE;
+            
+        /* Get the latest tag from the version of the repository checked out by default into the action */
+        $this->latestTag = preg_replace("/\n/", "", shell_exec("git describe --tags `git rev-list --tags --max-count=1`"));
+        $this->version = preg_replace('/^v/', '', $this->getTag());
+        echo GREEN . "Latest tag: " . $this->getTag() . " version: " . $this->getVersion() . "\n" . WHITE;
+
+	$this->git = trim(`which git`);
+	$this->sudo = trim(`which sudo`);
+    }
+
+    /**
+     * Get semver version
+     *
+     * @return string
+     */
+    public function getVersion(): string
+    {
+        return $this->version;
+    }
+
+    /**
+     * Get the git tag we are building
+     * 
+     * @return string
+     */
+    public function getTag(): string
+    {
+        return $this->latestTag;
+    }
+
+    private function git(string $parameters, bool $sudo = false): void
+    {
+        system(($sudo ? $this->sudo . ' ' : '') . $this->git . ' ' . $parameters);
+    }
+
+    private function sudo(string $command): void
+    {
+        system($this->sudo . ' ' . $command);
+    }
+
+    /**
+     * Check out a repository by tag or branch name to ~/dpp,
+     * using the personal access token and username passed in as command line parameters.
+     * 
+     * @param string $tag Tag to clone
+     * @return bool false if the repository could not be cloned
+     */
+    function checkoutRepository(string $tag = ""): bool
+    {
+        global $argv;
+
+        if (empty($tag)) {
+            /* Empty tag means use the main branch */
+            $tag = `{$this->git} config --get init.defaultBranch || echo master`;
+        }
+	$repositoryUrl = 'https://' . urlencode($argv[1]) . ':' . urlencode($argv[2]) . '@github.com/brainboxdotcc/DPP';
+
+        echo GREEN . "Check out repository: $tag (user: ". $argv[1] . " branch: " . $tag . ")\n" . WHITE;
+
+        chdir(getenv('HOME'));
+        system('rm -rf ./dpp');
+        $this->git('config --global user.email "noreply@dpp.dev"');
+        $this->git('config --global user.name "DPP VCPKG Bot"');
+        $this->git('clone ' . escapeshellarg($repositoryUrl) . ' ./dpp --depth=1');
+        
+        /* This is noisy, silence it */
+	$status = chdir(getenv("HOME") . '/dpp');
+        $this->git('fetch -at 2>/dev/null');
+        $this->git('checkout ' . escapeshellarg($tag) . ' 2>/dev/null');
+	
+	return $status;
+    }
+
+    /**
+     * Create ./vcpkg/ports/dpp/vcpkg.json and return the portfile contents to
+     * build the branch that is cloned at ~/dpp
+     * 
+     * @param string $sha512 The SHA512 sum of the tagged download, or initially
+     * zero, which means that the vcpkg install command should obtain it the
+     * second time around.
+     * @return string The portfile content
+     */
+    function constructPortAndVersionFile(string $sha512 = "0"): string
+    {
+        echo GREEN . "Construct portfile for " . $this->getVersion() . ", sha512: $sha512\n" . WHITE;
+        chdir(getenv("HOME") . '/dpp');
+
+        $portFileContent = 'vcpkg_from_github(
+    OUT_SOURCE_PATH SOURCE_PATH
+    REPO brainboxdotcc/DPP
+    REF "v${VERSION}"
+    SHA512 ' . $sha512 . '
+)
+
+vcpkg_cmake_configure(
+    SOURCE_PATH "${SOURCE_PATH}"
+    DISABLE_PARALLEL_CONFIGURE
+)
+
+vcpkg_cmake_install()
+
+vcpkg_cmake_config_fixup(NO_PREFIX_CORRECTION)
+
+file(REMOVE_RECURSE "${CURRENT_PACKAGES_DIR}/debug/share/dpp")
+file(REMOVE_RECURSE "${CURRENT_PACKAGES_DIR}/debug/include")
+
+if(VCPKG_LIBRARY_LINKAGE STREQUAL "static")
+    file(REMOVE_RECURSE "${CURRENT_PACKAGES_DIR}/bin" "${CURRENT_PACKAGES_DIR}/debug/bin")
+endif()
+
+vcpkg_install_copyright(FILE_LIST "${SOURCE_PATH}/LICENSE")
+
+file(COPY "${CMAKE_CURRENT_LIST_DIR}/usage" DESTINATION "${CURRENT_PACKAGES_DIR}/share/${PORT}")
+';
+        // ./vcpkg/ports/dpp/vcpkg.json
+        $versionFileContent = '{
+  "name": "dpp",
+  "version": ' . json_encode($this->getVersion()) . ',
+  "description": "D++ Extremely Lightweight C++ Discord Library.",
+  "homepage": "https://dpp.dev/",
+  "license": "Apache-2.0",
+  "supports": "((windows & !static & !uwp) | linux | osx)",
+  "dependencies": [
+    "libsodium",
+    "nlohmann-json",
+    "openssl",
+    "opus",
+    "zlib",
+    {
+      "name": "vcpkg-cmake",
+      "host": true
+    },
+    {
+      "name": "vcpkg-cmake-config",
+      "host": true
+    }
+  ]
+}';
+        echo GREEN . "Writing portfile...\n" . WHITE;
+        file_put_contents('./vcpkg/ports/dpp/vcpkg.json', $versionFileContent);
+        return $portFileContent;
+    }
+
+    /**
+     * Attempt the first build of the vcpkg port. This will always fail, as it is given
+     * an SHA512 sum of 0. When it fails the output contains the SHA512 sum, which is then
+     * extracted from the error output using a regular expression, and saved for a second
+     * attempt.
+     * @param string $portFileContent Portfile content from constructPortAndVersionFile()
+     * with an SHA512 sum of 0 passed in.
+     * @return string SHA512 sum of build output
+     */
+    function firstBuild(string $portFileContent): string
+    {
+        echo GREEN . "Starting first build\n" . WHITE;
+
+        chdir(getenv("HOME") . '/dpp');
+        echo GREEN . "Create /usr/local/share/vcpkg/ports/dpp/\n" . WHITE;
+        $this->sudo('mkdir -p /usr/local/share/vcpkg/ports/dpp/');
+        echo GREEN . "Copy vcpkg.json to /usr/local/share/vcpkg/ports/dpp/vcpkg.json\n" . WHITE;
+        $this->sudo('cp -v -R ./vcpkg/ports/dpp/vcpkg.json /usr/local/share/vcpkg/ports/dpp/vcpkg.json');
+        file_put_contents('/tmp/portfile', $portFileContent);
+        $this->sudo('cp -v -R /tmp/portfile /usr/local/share/vcpkg/ports/dpp/portfile.cmake');
+        unlink('/tmp/portfile');
+        $buildResults = shell_exec($this->sudo . ' /usr/local/share/vcpkg/vcpkg install dpp:x64-linux');
+        $matches = [];
+        if (preg_match('/Actual hash:\s+([0-9a-fA-F]+)/', $buildResults, $matches)) {
+            echo GREEN . "Obtained SHA512 for first build: " . $matches[1] . "\n" . WHITE;
+            $this->firstBuildComplete = true;
+            return $matches[1];
+        }
+        echo RED . "No SHA512 found during first build :(\n" . WHITE;
+        return '';
+    }
+
+    /**
+     * Second build using a valid SHA512 sum. This attempt should succeed, allowing us to push
+     * the changed vcpkg portfiles into the master branch, where they can be used in a PR to
+     * microsoft/vcpkg repository later.
+     * 
+     * @param string $portFileContent the contents of the portfile, containing a valid SHA512
+     * sum from the first build attempt.
+     * @return bool False if the build failed
+     */
+    function secondBuild(string $portFileContent): bool
+    {
+
+        if (!$this->firstBuildComplete) {
+            throw new RuntimeException("No SHA512 sum is available, first build has not been run!");
+        }
+
+        echo GREEN . "Executing second build\n" . WHITE;
+        echo GREEN . "Copy local port files to /usr/local/share...\n" . WHITE;
+        chdir(getenv("HOME") . '/dpp');
+        file_put_contents('./vcpkg/ports/dpp/portfile.cmake', $portFileContent);
+        $this->sudo('cp -v -R ./vcpkg/ports/dpp/vcpkg.json /usr/local/share/vcpkg/ports/dpp/vcpkg.json');
+        $this->sudo('cp -v -R ./vcpkg/ports/dpp/portfile.cmake /usr/local/share/vcpkg/ports/dpp/portfile.cmake');
+        $this->sudo('cp -v -R ./vcpkg/ports/* /usr/local/share/vcpkg/ports/');
+
+        echo GREEN . "vcpkg x-add-version...\n" . WHITE;
+        chdir('/usr/local/share/vcpkg');
+        $this->sudo('./vcpkg format-manifest ./ports/dpp/vcpkg.json');
+        /* Note: We commit this in /usr/local, but we never push it (we can't) */
+        $this->git('add .', true);
+        $this->git('-c user.name="DPP VCPKG Bot" -c user.email=noreply@dpp.dev commit -m "[bot] VCPKG info update"', true);
+        $this->sudo('/usr/local/share/vcpkg/vcpkg x-add-version dpp');
+
+        echo GREEN . "Copy back port files from /usr/local/share...\n" . WHITE;
+        chdir(getenv('HOME') . '/dpp');
+        system('cp -v -R /usr/local/share/vcpkg/ports/dpp/vcpkg.json ./vcpkg/ports/dpp/vcpkg.json');
+        system('cp -v -R /usr/local/share/vcpkg/versions/baseline.json ./vcpkg/versions/baseline.json');
+        system('cp -v -R /usr/local/share/vcpkg/versions/d-/dpp.json ./vcpkg/versions/d-/dpp.json');
+
+        echo GREEN . "Commit and push changes to master branch\n" . WHITE;
+        $this->git('config --global user.email "noreply@dpp.dev"');
+        $this->git('config --global user.name "DPP VCPKG Bot"');
+        $this->git('add .');
+        $this->git('commit -m "[bot] VCPKG info update [skip ci]"');
+        $this->git('config pull.rebase false');
+        $this->git('pull');
+        $this->git('push origin master');
+
+        echo GREEN . "vcpkg install...\n" . WHITE;
+        $resultCode = 0;
+        $output = [];
+        exec($this->sudo . ' /usr/local/share/vcpkg/vcpkg install dpp:x64-linux', $output, $resultCode);
+
+        if ($resultCode != 0) {
+            echo RED . "There were build errors!\n\nBuild log:\n" . WHITE;
+            readfile("/usr/local/share/vcpkg/buildtrees/dpp/install-x64-linux-dbg-out.log");
+        }
+
+	return $resultCode == 0;
+    }
+};

DPP-master/buildtools/classes/StructGeneratorInterface.php

@@ -0,0 +1,75 @@
+<?php
+
+namespace Dpp;
+
+/**
+ * Represents a header/cpp generator used to auto-generate cpp/.h files.
+ */
+interface StructGeneratorInterface
+{
+    /**
+     * Generate the start of the header file
+     *
+     * @return string header content
+     */
+    public function generateHeaderStart(): string;
+
+    /**
+     * Generate the start of the cpp file
+     *
+     * @return string cpp content
+     */
+    public function generateCppStart(): string;
+
+    /**
+     * Check if the script should run and re-generate content or not
+     *
+     * @return string true if the script should run, false to exit
+     */
+    public function checkForchanges(): bool;
+
+    /**
+     * Generate header definition for a function
+     *
+     * @param string $returnType Return type of function
+     * @param string $currentFunction Current function name
+     * @param string $parameters Current function parameters with default values
+     * @param string $noDefaults Current function parameters without default values
+     * @param string $parameterNames Parameter names only
+     * @return string header content to append
+     */
+    public function generateHeaderDef(string $returnType, string $currentFunction, string $parameters, string $noDefaults, string $parameterTypes, string $parameterNames): string;
+
+    /**
+     * Generate cpp definition for a function
+     *
+     * @param string $returnType Return type of function
+     * @param string $currentFunction Current function name
+     * @param string $parameters Current function parameters with default values
+     * @param string $noDefaults Current function parameters without default values
+     * @param string $parameterNames Parameter names only
+     * @return string cpp content to append
+     */
+    public function generateCppDef(string $returnType, string $currentFunction, string $parameters, string $noDefaults, string $parameterTypes, string $parameterNames): string;
+    
+    /**
+     * Return comment lines to add to each header definition
+     *
+     * @return array Comment lines to add
+     */
+    public function getCommentArray(): array;
+
+    /**
+     * Save the .h file
+     *
+     * @param string $content Content to save
+     */
+    public function saveHeader(string $content): void;
+
+    /**
+     * Save the .cpp file
+     *
+     * @param string $cppcontent Content to save
+     */
+    public function saveCpp(string $cppcontent): void;
+};