每日代码提交

Author: PopeyeZhong

upgrading/.shared/Package.cs

@@ -39,6 +39,7 @@ public class Package
 	public Package()
 	{
 		this.Tags = [];
+		this.Executors = [];
 		this.Creation = DateTime.Now;
 		this.Platform = Utility.Platform;
 		this.Architecture = Utility.Architecture;
@@ -52,6 +53,7 @@ public Package(string name, string edition, Version version, string[] tags = nul
 		this.Edition = edition;
 		this.Version = version;
 		this.Tags = tags ?? [];
+		this.Executors = [];
 		this.Creation = DateTime.Now;
 		this.Platform = Utility.Platform;
 		this.Architecture= Utility.Architecture;
@@ -65,6 +67,7 @@ public Package(string name, string edition, Version version, Platform platform,
 		this.Edition = edition;
 		this.Version = version;
 		this.Tags = tags ?? [];
+		this.Executors = [];
 		this.Creation = DateTime.Now;
 		this.Platform = platform;
 		this.Architecture = architecture;
@@ -102,6 +105,10 @@ public Package(string name, string edition, Version version, Platform platform,
 	/// <summary>获取或设置描述信息。</summary>
 	public string Description { get; set; }
 
+	/// <summary>获取执行器集合。</summary>
+	[System.Text.Json.Serialization.JsonObjectCreationHandling(System.Text.Json.Serialization.JsonObjectCreationHandling.Populate)]
+	public ICollection<Executor> Executors { get; }
+
 	/// <summary>获取包的扩展属性集。</summary>
 	[System.Text.Json.Serialization.JsonExtensionData]
 	[System.Text.Json.Serialization.JsonObjectCreationHandling(System.Text.Json.Serialization.JsonObjectCreationHandling.Populate)]
@@ -113,4 +120,18 @@ public override string ToString() => string.IsNullOrEmpty(this.Edition) ?
 		$"{this.Name}@{this.Version}({this.GetRuntimeIdentifier()})":
 		$"{this.Name}|{this.Edition}@{this.Version}({this.GetRuntimeIdentifier()})";
 	#endregion
+
+	#region 嵌套结构
+	public struct Executor(string @event, string command)
+	{
+		#region 公共字段
+		public string Event = @event;
+		public string Command = command;
+		#endregion
+
+		#region 重写方法
+		public readonly override string ToString() => $"[{this.Event}]{this.Command}";
+		#endregion
+	}
+	#endregion
 }

upgrading/README.md

@@ -0,0 +1,12 @@
+# Zongsoft.Upgrading 自动升级插件库
+
+[English](README.md) |
+[简体中文](README-zh_CN.md)
+
+-----
+
+## 概述
+
+[**Z**ongsoft.**U**pgrading](https://github.com/Zongsoft/framework/tree/main/upgrading) 是 [_**Z**ongsoft_](https://github.com/Zongsoft/framework) 开源框架的自动升级插件库。
+
+💡 如果将本插件库部署到 [_宿主_](https://github.com/Zongsoft/hosting) 程序中，即可享有自动升级更新之功能。

upgrading/client/Executor.cs

@@ -0,0 +1,49 @@
+/*
+ *   _____                                ______
+ *  /_   /  ____  ____  ____  _________  / __/ /_
+ *    / /  / __ \/ __ \/ __ \/ ___/ __ \/ /_/ __/
+ *   / /__/ /_/ / / / / /_/ /\_ \/ /_/ / __/ /_
+ *  /____/\____/_/ /_/\__  /____/\____/_/  \__/
+ *                   /____/
+ *
+ * Authors:
+ *   钟峰(Popeye Zhong) <zongsoft@qq.com>
+ *
+ * Copyright (C) 2020-2026 Zongsoft Studio <http://www.zongsoft.com>
+ *
+ * This file is part of Zongsoft.Upgrading library.
+ *
+ * The Zongsoft.Upgrading is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Lesser General Public License as published by
+ * the Free Software Foundation, either version 3.0 of the License,
+ * or (at your option) any later version.
+ *
+ * The Zongsoft.Upgrading is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public License
+ * along with the Zongsoft.Upgrading library. If not, see <http://www.gnu.org/licenses/>.
+ */
+
+using System;
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace Zongsoft.Upgrading;
+
+public sealed partial class Executor
+{
+	public static async ValueTask ExecuteAsync(Package package, string @event, CancellationToken cancellation = default)
+	{
+		if(package == null || package.Executors == null)
+			return;
+
+		foreach(var executor in package.Executors)
+		{
+			if(executor.Event != null && executor.Event.StartsWith(@event, StringComparison.OrdinalIgnoreCase))
+				await Components.CommandExecutor.Default.ExecuteAsync(executor.Command, package, cancellation);
+		}
+	}
+}

upgrading/client/Fetcher.cs

@@ -33,6 +33,6 @@
 
 namespace Zongsoft.Upgrading;
 
-public sealed class Fetcher
+public sealed partial class Fetcher
 {
 }