Add target template

src/chsrc.c

@@ -16,7 +16,7 @@
  * chsrc: Change Source —— 全平台通用命令行换源工具
  * ------------------------------------------------------------*/
 
-#define Chsrc_Version       "v0.1.7.2-2024/08/08"
+#define Chsrc_Version       "v0.1.7.2.dev1-2024/08/09"
 #define Chsrc_Maintain_URL  "https://github.com/RubyMetric/chsrc"
 #define Chsrc_Maintain_URL2 "https://gitee.com/RubyMetric/chsrc"
 

src/recipe/template.c

@@ -0,0 +1,90 @@
+/** ------------------------------------------------------------
+ * SPDX-License-Identifier: GPL-3.0-or-later
+ * -------------------------------------------------------------
+ * Contributors  : Null Nil <null@nil.com>
+ * Created on    : <2024-08-09>
+ * Last modified : <2024-08-09>
+ *
+ * 该模版中:
+ * <target>   为该换源目标的名称
+ * <category> 为该换源目标的类别，仅有3类: pl,   os, wr
+ *            分别对应3个子目录:         lang, os, ware
+ * ------------------------------------------------------------*/
+
+/**
+ * 定义专服务于该target的镜像站，该例数据为虚拟填充
+ */
+static MirrorSite
+RubyMetric = {"rbmt",                   // chsrc set <target> rbmt
+              "RubyMetric",             // 该镜像站的缩写
+              "RubyMetric.com",         // 该镜像站的全名
+              "https://rubymetirc.com", // 镜像站首页
+                                        // 镜像站某个较大的可下载物的下载链接，用于测速
+              "https://rubymetirc.com/target/aws/aws-sdk-go/@v/v1.45.2.zip"};
+
+/**
+ * @time 2024-08-09 更新
+ * @note 该target的各个源地址，该例数据为虚拟填充
+ */
+static SourceInfo
+<category>_<target>_sources[] = {
+  {&Upstream,      "上游地址，若维护者暂时未知，可填NULL，这个主要用于reset"},
+  {&RubyMetric,    "https://rubymetirc.com/target"},
+  {&RubyInstaller, "https://rubyinstaller.cn/target"},
+  {&Gitee,         "https://gitee.com/RubyMetric/chsrc"},
+  {&GitHub,        "https://github.com/RubyMetric/chsrc"}
+};
+def_sources_n(<category>_<target>);
+
+
+/**
+ * @required 非必需
+ */
+void
+<category>_<target>_getsrc (char* option)
+{
+  // chsrc get <target>
+}
+
+
+/**
+ * @required 必需
+ * @ref      写明换源实现的参考地址
+ */
+void
+<category>_<target>_setsrc (char* option)
+{
+  // chsrc set <target>
+
+  // 下面这3行是必须的
+  SourceInfo source;
+  chsrc_yield_source (pl_ruby);
+  chsrc_confirm_source (&source);
+
+
+  /* 具体的换源步骤，如调用第三方命令... */
+
+
+  // 最后总结输出
+  chsrc_say_lastly (&source, chsrc_type);
+}
+
+
+/**
+ * @required 非必需
+ */
+void
+<category>_<target>_resetsrc (char* option)
+{
+  // chsrc reset <target>
+
+  // 往往通过下述方式统一在 setsrc() 中实现
+  // <category>_<name>_setsrc (ChsrcTypeReset);
+}
+
+
+// 定义此 target，参考 "target.h"
+// 下列情形3选1
+def_target_full(<category>_<target>);
+def_target(<category>_<target>)
+def_target_no_get(<category>_<target>)