refactor!: rename Titano to Chronos and move CI and releases to Gitea (#6)
CI / Build and test (push) Successful in 8m14s
CI / Windows tests and installer (push) Skipped
CI / YAML check (push) Successful in 7s
Release / Build, test and publish (push) Successful in 13m19s
CI / PostgreSQL 16 integration (push) Successful in 4m49s
CI / PostgreSQL 17 integration (push) Successful in 5m28s
CI / Docker image (push) Successful in 53s
Release / Server image (push) Failing after 10s
CI / Build and test (push) Successful in 8m14s
CI / Windows tests and installer (push) Skipped
CI / YAML check (push) Successful in 7s
Release / Build, test and publish (push) Successful in 13m19s
CI / PostgreSQL 16 integration (push) Successful in 4m49s
CI / PostgreSQL 17 integration (push) Successful in 5m28s
CI / Docker image (push) Successful in 53s
Release / Server image (push) Failing after 10s
The owner renamed the product and moved the repository to the self-hosted Gitea (https://gitea.encke-hake.ts.net/BalboSoft/Chronos) for more control, and asked for Actions and a first automatic release with the server package and the Windows exe (docs/requests/2026-10-23-chronos-gitea.md). - Chronos everywhere: a byte-exact rename of contents and paths, then a per-language review of the forms the old name's ending had dictated. - Gitea instead of GitHub: the update check, licence, issue and support links read ChronosReleasesUrl; the update check takes the highest stable version, offers a pre-release build its final release and reports a repository it cannot see as a failed check. EULA, security policy and Gitea issue forms live at the repository root. - Gitea Actions for the Linux act_runner (.gitea/workflows): CI, release, nightly image and performance gates in the .NET SDK container with git checkout and the system SQLite. The release cross-compiles the Windows programs, checks their icon, version and DPI manifest, packs installers and zips, publishes the Gitea release and pushes the server image (REGISTRY_TOKEN). Windows-only tests run in an opt-in job on a Windows runner (WINDOWS_RUNNER). - New Chronos.Tools commands: zip, gitea-release, postgres-ci (replaces the docker-exec script, which Gitea's service containers do not allow; the throw-away server runs without durability) and pe-check. - Timed tests take their budget from TestTiming (CHRONOS_TEST_TIME_FACTOR, 3 on the shared runner; the weekly performance gates keep theirs). BREAKING CHANGE: programs, settings, data folders, file types, environment variables and the Docker image use the new name; nothing is migrated from Titano, which never had a release. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Co-authored-by: Alberto Balbo <alberto.balbo.96@gmail.com>
This commit was merged in pull request #6.
This commit is contained in:
1 parent
c99842cc86
commit
f2b58522b9
1801 files changed
+11804
-10676
No files matched your search
@@ -0,0 +1,84 @@
|
||||
using Chronos.Core.IO;
|
||||
|
||||
namespace Chronos.Core.Windows.Shell;
|
||||
|
||||
/// <summary>
|
||||
/// Where the desktop programs keep their data (BRIEF §6.2, <see cref="DataLocation"/>): <c>%LOCALAPPDATA%\Chronos</c>, or
|
||||
/// <c>.\data</c> next to the executable in portable mode. SQLite corrupts inside synchronised folders, so a portable
|
||||
/// copy in a OneDrive folder keeps its data in <c>%LOCALAPPDATA%\Chronos</c> instead (<see cref="PortableSyncRoot"/>
|
||||
/// names that folder to tell the user, <see cref="EarlierPortableData"/> the data it kept there before), and a data
|
||||
/// root still under OneDrive is reported by <see cref="SyncedFolder"/> and refused by <see cref="CreateDirectories"/>.
|
||||
/// </summary>
|
||||
public sealed class AppPaths
|
||||
{
|
||||
public const string ProductFolderName = DataLocation.ProductFolderName;
|
||||
public const string DatabaseFileName = "chronos.db";
|
||||
public const string SettingsFileName = "settings.json";
|
||||
|
||||
private AppPaths(DataLocation location, string? earlierPortableData)
|
||||
{
|
||||
DataRoot = location.Root;
|
||||
IsPortable = location.IsPortable;
|
||||
SyncedFolder = location.SyncedFolder;
|
||||
PortableSyncRoot = location.PortableSyncRoot;
|
||||
EarlierPortableData = earlierPortableData;
|
||||
}
|
||||
|
||||
/// <summary>A portable copy, also when its data had to go to <c>%LOCALAPPDATA%\Chronos</c>.</summary>
|
||||
public bool IsPortable { get; }
|
||||
|
||||
public string DataRoot { get; }
|
||||
|
||||
public string DatabasePath => Path.Combine(DataRoot, DatabaseFileName);
|
||||
|
||||
public string LogsDirectory => Path.Combine(DataRoot, "logs");
|
||||
|
||||
public string CacheDirectory => Path.Combine(DataRoot, "cache");
|
||||
|
||||
public string ThumbnailsDirectory => Path.Combine(DataRoot, "thumbnails");
|
||||
|
||||
/// <summary>The OneDrive sync root containing <see cref="DataRoot"/>, or null when the location is safe.</summary>
|
||||
public string? SyncedFolder { get; }
|
||||
|
||||
public bool IsInSyncedFolder => SyncedFolder is not null;
|
||||
|
||||
/// <summary>The OneDrive sync root a portable copy runs from, whose data is in <c>%LOCALAPPDATA%\Chronos</c> instead; null otherwise.</summary>
|
||||
public string? PortableSyncRoot { get; }
|
||||
|
||||
/// <summary>
|
||||
/// The <c>.\data</c> folder of a portable copy now in a OneDrive folder when it still holds the index or the settings
|
||||
/// of an earlier start: nothing moves or deletes it, and the user is told where it is. Null otherwise.
|
||||
/// </summary>
|
||||
public string? EarlierPortableData { get; }
|
||||
|
||||
/// <summary>Paths for this process: the executable's folder decides portable mode.</summary>
|
||||
public static AppPaths Resolve() => Resolve(AppContext.BaseDirectory, KnownFolders.LocalAppData);
|
||||
|
||||
/// <summary>Paths for an executable in <paramref name="applicationDirectory"/>, checked against the user's OneDrive roots.</summary>
|
||||
public static AppPaths Resolve(string applicationDirectory, string localAppData) =>
|
||||
Resolve(applicationDirectory, localAppData, OneDriveFolders.SyncRoots());
|
||||
|
||||
/// <summary>Paths for an executable in <paramref name="applicationDirectory"/>, checked against <paramref name="syncRoots"/>.</summary>
|
||||
public static AppPaths Resolve(string applicationDirectory, string localAppData, IReadOnlyCollection<string> syncRoots)
|
||||
{
|
||||
var location = DataLocation.Choose(applicationDirectory, PortableMode.IsEnabled(applicationDirectory), localAppData, syncRoots);
|
||||
var beside = Path.GetFullPath(Path.Combine(applicationDirectory, PortableMode.DataFolderName));
|
||||
var earlier = location.PortableSyncRoot is not null
|
||||
&& (File.Exists(Path.Combine(beside, DatabaseFileName)) || File.Exists(Path.Combine(beside, SettingsFileName)))
|
||||
? beside
|
||||
: null;
|
||||
return new AppPaths(location, earlier);
|
||||
}
|
||||
|
||||
/// <summary>Creates the data, logs, cache and thumbnails folders.</summary>
|
||||
/// <exception cref="InvalidOperationException">The data root lies inside a OneDrive-synced folder.</exception>
|
||||
public void CreateDirectories()
|
||||
{
|
||||
if (SyncedFolder is not null)
|
||||
throw new InvalidOperationException($"The data folder '{DataRoot}' is inside the OneDrive folder '{SyncedFolder}'; the database would be corrupted by synchronisation.");
|
||||
Directory.CreateDirectory(DataRoot);
|
||||
Directory.CreateDirectory(LogsDirectory);
|
||||
Directory.CreateDirectory(CacheDirectory);
|
||||
Directory.CreateDirectory(ThumbnailsDirectory);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,38 @@
|
||||
using System.Runtime.InteropServices;
|
||||
|
||||
namespace Chronos.Core.Windows.Shell;
|
||||
|
||||
/// <summary>Known folder paths through SHGetKnownFolderPath (honours folder redirection).</summary>
|
||||
public static partial class KnownFolders
|
||||
{
|
||||
/// <summary>FOLDERID_LocalAppData.</summary>
|
||||
public static readonly Guid LocalAppDataId = new("f1b32785-6fba-4fcf-9d55-7b8e7f157091");
|
||||
|
||||
/// <summary>FOLDERID_Pictures.</summary>
|
||||
public static readonly Guid PicturesId = new("33e28130-4e1e-4676-835a-98395c3bc3bb");
|
||||
|
||||
/// <summary>%LOCALAPPDATA% (never synced by OneDrive).</summary>
|
||||
public static string LocalAppData => GetPath(LocalAppDataId);
|
||||
|
||||
/// <summary>The user's Pictures folder (may be redirected into OneDrive).</summary>
|
||||
public static string Pictures => GetPath(PicturesId);
|
||||
|
||||
/// <exception cref="COMException">The folder does not exist or is not available to this user.</exception>
|
||||
public static string GetPath(Guid folderId)
|
||||
{
|
||||
var hr = SHGetKnownFolderPath(folderId, 0, 0, out var buffer);
|
||||
try
|
||||
{
|
||||
Marshal.ThrowExceptionForHR(hr);
|
||||
return Marshal.PtrToStringUni(buffer) ?? string.Empty;
|
||||
}
|
||||
finally
|
||||
{
|
||||
// The buffer must be freed whether or not the call succeeded.
|
||||
Marshal.FreeCoTaskMem(buffer);
|
||||
}
|
||||
}
|
||||
|
||||
[LibraryImport("shell32.dll")]
|
||||
private static partial int SHGetKnownFolderPath(in Guid folderId, uint flags, nint token, out nint path);
|
||||
}
|
||||
@@ -0,0 +1,69 @@
|
||||
using System.Security;
|
||||
using Microsoft.Win32;
|
||||
using Chronos.Core.IO;
|
||||
|
||||
namespace Chronos.Core.Windows.Shell;
|
||||
|
||||
/// <summary>
|
||||
/// Folders synchronised by OneDrive for the current user: personal and work/school accounts, and the SharePoint and Teams
|
||||
/// libraries synced with their Sync button.
|
||||
/// </summary>
|
||||
public static class OneDriveFolders
|
||||
{
|
||||
private const string AccountsKey = @"Software\Microsoft\OneDrive\Accounts";
|
||||
|
||||
/// <summary>
|
||||
/// The sync engines' registry, which Office reads to find synchronised files: one subkey per folder OneDrive
|
||||
/// synchronises ("Personal", each work or school account, and each library synced with its Sync button, which lies
|
||||
/// beside the account's folder, not in it), its local folder in <c>MountPoint</c>.
|
||||
/// </summary>
|
||||
private const string MountPointsKey = @"Software\SyncEngines\Providers\OneDrive";
|
||||
|
||||
private static readonly string[] EnvironmentVariables = ["OneDrive", "OneDriveConsumer", "OneDriveCommercial"];
|
||||
|
||||
/// <summary>
|
||||
/// Sync roots from the OneDrive environment variables, <c>HKCU\Software\Microsoft\OneDrive\Accounts\*\UserFolder</c>
|
||||
/// and <c>HKCU\Software\SyncEngines\Providers\OneDrive\*\MountPoint</c>, as full paths without a trailing separator,
|
||||
/// distinct (case-insensitive). A key that cannot be read is skipped: the programs start all the same.
|
||||
/// </summary>
|
||||
public static IReadOnlyList<string> SyncRoots() => SyncRoots(Registry.CurrentUser);
|
||||
|
||||
/// <summary><see cref="SyncRoots()"/> with the registry keys read under <paramref name="user"/> instead of the current user's hive.</summary>
|
||||
public static IReadOnlyList<string> SyncRoots(RegistryKey user)
|
||||
{
|
||||
var roots = new List<string>();
|
||||
foreach (var variable in EnvironmentVariables) Add(roots, Environment.GetEnvironmentVariable(variable));
|
||||
AddFolders(roots, user, AccountsKey, "UserFolder");
|
||||
AddFolders(roots, user, MountPointsKey, "MountPoint");
|
||||
return roots;
|
||||
}
|
||||
|
||||
/// <summary>The sync root that contains <paramref name="path"/>, or null. Both are expected to be full paths.</summary>
|
||||
public static string? Containing(string path, IEnumerable<string> syncRoots) => DataLocation.SyncRootOf(path, syncRoots);
|
||||
|
||||
/// <summary>Adds the folder that value <paramref name="valueName"/> of each subkey of <paramref name="keyPath"/> names.</summary>
|
||||
private static void AddFolders(List<string> roots, RegistryKey user, string keyPath, string valueName)
|
||||
{
|
||||
try
|
||||
{
|
||||
using var parent = user.OpenSubKey(keyPath);
|
||||
if (parent is null) return;
|
||||
foreach (var name in parent.GetSubKeyNames())
|
||||
{
|
||||
using var entry = parent.OpenSubKey(name);
|
||||
Add(roots, entry?.GetValue(valueName) as string);
|
||||
}
|
||||
}
|
||||
catch (Exception ex) when (ex is SecurityException or IOException or UnauthorizedAccessException)
|
||||
{
|
||||
// The environment variables and the other key name the usual roots.
|
||||
}
|
||||
}
|
||||
|
||||
private static void Add(List<string> roots, string? candidate)
|
||||
{
|
||||
if (string.IsNullOrWhiteSpace(candidate) || !Path.IsPathFullyQualified(candidate)) return;
|
||||
var full = Path.GetFullPath(candidate).TrimEnd('\\', '/');
|
||||
if (!roots.Contains(full, StringComparer.OrdinalIgnoreCase)) roots.Add(full);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,12 @@
|
||||
using Chronos.Core.IO;
|
||||
|
||||
namespace Chronos.Core.Windows.Shell;
|
||||
|
||||
/// <summary>Portable mode (BRIEF §6.2): a <c>portable.txt</c> next to the executable keeps all data under <c>.\data\</c>.</summary>
|
||||
public static class PortableMode
|
||||
{
|
||||
public const string MarkerFileName = "portable.txt";
|
||||
public const string DataFolderName = DataLocation.PortableFolderName;
|
||||
|
||||
public static bool IsEnabled(string applicationDirectory) => File.Exists(Path.Combine(applicationDirectory, MarkerFileName));
|
||||
}
|
||||
@@ -0,0 +1,132 @@
|
||||
using System.Runtime.ExceptionServices;
|
||||
using System.Runtime.InteropServices;
|
||||
|
||||
namespace Chronos.Core.Windows.Shell;
|
||||
|
||||
/// <summary>
|
||||
/// The only shell verbs Chronos may invoke (BRIEF §8.6): <c>open</c> for web and Microsoft Store links and
|
||||
/// <c>explore</c>/select for revealing files. Callable from any thread: the work runs on an STA as shell
|
||||
/// extensions require (inline on a UI thread, otherwise on a short-lived STA thread).
|
||||
/// </summary>
|
||||
public static partial class ShellLauncher
|
||||
{
|
||||
private static readonly string[] AllowedSchemes = ["http", "https", "ms-windows-store"];
|
||||
|
||||
private const uint SEE_MASK_NOASYNC = 0x100;
|
||||
private const uint SEE_MASK_FLAG_NO_UI = 0x400;
|
||||
private const int SW_SHOWNORMAL = 1;
|
||||
|
||||
/// <summary>True for absolute http, https and ms-windows-store URLs, the only links handed to the shell.</summary>
|
||||
public static bool IsAllowedUrl(string url) =>
|
||||
Uri.TryCreate(url, UriKind.Absolute, out var uri)
|
||||
&& AllowedSchemes.Contains(uri.Scheme, StringComparer.OrdinalIgnoreCase);
|
||||
|
||||
/// <summary>Opens the URL with ShellExecuteEx("open"); false when the shell could not open it.</summary>
|
||||
/// <exception cref="ArgumentException">The URL is not an absolute http, https or ms-windows-store URL.</exception>
|
||||
public static bool OpenUrl(string url)
|
||||
{
|
||||
if (!IsAllowedUrl(url)) throw new ArgumentException("Only http, https and ms-windows-store URLs may be opened.", nameof(url));
|
||||
var canonical = new Uri(url, UriKind.Absolute).AbsoluteUri;
|
||||
return RunOnSta(() => Execute("open", canonical));
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Shows a file selected in its Explorer folder (SHOpenFolderAndSelectItems) or opens a folder ("explore").
|
||||
/// False when the path does not exist or the shell failed.
|
||||
/// </summary>
|
||||
public static bool RevealInExplorer(string path)
|
||||
{
|
||||
var full = Path.GetFullPath(path);
|
||||
if (Directory.Exists(full)) return RunOnSta(() => Execute("explore", full));
|
||||
return File.Exists(full) && RunOnSta(() => SelectInFolder(full));
|
||||
}
|
||||
|
||||
private static unsafe bool Execute(string verb, string file)
|
||||
{
|
||||
fixed (char* verbPointer = verb)
|
||||
fixed (char* filePointer = file)
|
||||
{
|
||||
var info = new ShellExecuteInfo
|
||||
{
|
||||
Size = (uint)sizeof(ShellExecuteInfo),
|
||||
Mask = SEE_MASK_NOASYNC | SEE_MASK_FLAG_NO_UI,
|
||||
Verb = (nint)verbPointer,
|
||||
File = (nint)filePointer,
|
||||
Show = SW_SHOWNORMAL,
|
||||
};
|
||||
return ShellExecuteExW(ref info);
|
||||
}
|
||||
}
|
||||
|
||||
private static bool SelectInFolder(string file)
|
||||
{
|
||||
if (SHParseDisplayName(file, 0, out var itemList, 0, out _) < 0) return false;
|
||||
try
|
||||
{
|
||||
// With no child items the absolute ID list names the item to select; Explorer opens its parent.
|
||||
return SHOpenFolderAndSelectItems(itemList, 0, 0, 0) >= 0;
|
||||
}
|
||||
finally
|
||||
{
|
||||
Marshal.FreeCoTaskMem(itemList);
|
||||
}
|
||||
}
|
||||
|
||||
private static bool RunOnSta(Func<bool> action)
|
||||
{
|
||||
if (Thread.CurrentThread.GetApartmentState() == ApartmentState.STA) return action();
|
||||
var result = false;
|
||||
ExceptionDispatchInfo? failure = null;
|
||||
var thread = new Thread(() =>
|
||||
{
|
||||
try
|
||||
{
|
||||
result = action();
|
||||
}
|
||||
catch (Exception ex)
|
||||
{
|
||||
failure = ExceptionDispatchInfo.Capture(ex);
|
||||
}
|
||||
})
|
||||
{
|
||||
IsBackground = true,
|
||||
Name = "Chronos shell",
|
||||
};
|
||||
thread.SetApartmentState(ApartmentState.STA);
|
||||
thread.Start();
|
||||
thread.Join();
|
||||
failure?.Throw();
|
||||
return result;
|
||||
}
|
||||
|
||||
/// <summary>SHELLEXECUTEINFOW (112 bytes on x64).</summary>
|
||||
[StructLayout(LayoutKind.Sequential)]
|
||||
private struct ShellExecuteInfo
|
||||
{
|
||||
public uint Size;
|
||||
public uint Mask;
|
||||
public nint Window;
|
||||
public nint Verb;
|
||||
public nint File;
|
||||
public nint Parameters;
|
||||
public nint Directory;
|
||||
public int Show;
|
||||
public nint InstanceApp;
|
||||
public nint ItemIdList;
|
||||
public nint Class;
|
||||
public nint ClassKey;
|
||||
public uint HotKey;
|
||||
public nint IconOrMonitor;
|
||||
public nint Process;
|
||||
}
|
||||
|
||||
[LibraryImport("shell32.dll", SetLastError = true)]
|
||||
[return: MarshalAs(UnmanagedType.Bool)]
|
||||
private static partial bool ShellExecuteExW(ref ShellExecuteInfo info);
|
||||
|
||||
[LibraryImport("shell32.dll", StringMarshalling = StringMarshalling.Utf16)]
|
||||
private static partial int SHParseDisplayName(string name, nint bindContext, out nint itemIdList, uint attributesIn, out uint attributesOut);
|
||||
|
||||
[LibraryImport("shell32.dll")]
|
||||
private static partial int SHOpenFolderAndSelectItems(nint folder, uint count, nint items, uint flags);
|
||||
}
|
||||
@@ -0,0 +1,84 @@
|
||||
using System.Runtime.InteropServices;
|
||||
using Chronos.Core.Windows.Interop;
|
||||
|
||||
namespace Chronos.Core.Windows.Shell;
|
||||
|
||||
/// <summary>TBPFLAG: the taskbar button progress style.</summary>
|
||||
public enum TaskbarProgressState
|
||||
{
|
||||
None = 0x0,
|
||||
Indeterminate = 0x1,
|
||||
Normal = 0x2,
|
||||
Error = 0x4,
|
||||
Paused = 0x8,
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// Taskbar button progress through ITaskbarList3. The taskbar object is apartment-threaded: create, use and dispose
|
||||
/// an instance on the UI thread that owns the window. Every call returns false (never throws) when the taskbar is
|
||||
/// unavailable, the window handle is null or stale, or the shell rejects the call.
|
||||
/// </summary>
|
||||
public sealed class TaskbarProgress : IDisposable
|
||||
{
|
||||
private static readonly Guid TaskbarListClsid = new("56fdf344-fd6d-11d0-958a-006097c9a090");
|
||||
private ITaskbarList3? _taskbar;
|
||||
|
||||
public TaskbarProgress()
|
||||
{
|
||||
if (Win32Com.TryCreateInstance(TaskbarListClsid, typeof(ITaskbarList3).GUID, out var instance) >= 0
|
||||
&& instance is ITaskbarList3 taskbar
|
||||
&& taskbar.HrInit() >= 0)
|
||||
{
|
||||
_taskbar = taskbar;
|
||||
return;
|
||||
}
|
||||
Win32Com.Release(instance);
|
||||
}
|
||||
|
||||
/// <summary>False when no taskbar is available (e.g. a session without Explorer).</summary>
|
||||
public bool IsAvailable => _taskbar is not null;
|
||||
|
||||
public bool SetState(nint window, TaskbarProgressState state) =>
|
||||
_taskbar is { } taskbar && Win32Window.Exists(window) && taskbar.SetProgressState(window, state) >= 0;
|
||||
|
||||
/// <summary>Sets the bar to <paramref name="completed"/>/<paramref name="total"/> (switches to <see cref="TaskbarProgressState.Normal"/> if no progress was shown).</summary>
|
||||
public bool SetValue(nint window, ulong completed, ulong total) =>
|
||||
total > 0 && _taskbar is { } taskbar && Win32Window.Exists(window) && taskbar.SetProgressValue(window, Math.Min(completed, total), total) >= 0;
|
||||
|
||||
public void Dispose()
|
||||
{
|
||||
Win32Com.Release(_taskbar);
|
||||
_taskbar = null;
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>ITaskbarList3 (ITaskbarList → ITaskbarList2 → ITaskbarList3), declared up to SetProgressState.</summary>
|
||||
[ComImport]
|
||||
[Guid("ea1afb91-9e28-4b86-90e9-9e9f8a5eefaf")]
|
||||
[InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
|
||||
internal interface ITaskbarList3
|
||||
{
|
||||
[PreserveSig]
|
||||
int HrInit();
|
||||
|
||||
[PreserveSig]
|
||||
int AddTab(nint window);
|
||||
|
||||
[PreserveSig]
|
||||
int DeleteTab(nint window);
|
||||
|
||||
[PreserveSig]
|
||||
int ActivateTab(nint window);
|
||||
|
||||
[PreserveSig]
|
||||
int SetActiveAlt(nint window);
|
||||
|
||||
[PreserveSig]
|
||||
int MarkFullscreenWindow(nint window, int fullscreen);
|
||||
|
||||
[PreserveSig]
|
||||
int SetProgressValue(nint window, ulong completed, ulong total);
|
||||
|
||||
[PreserveSig]
|
||||
int SetProgressState(nint window, TaskbarProgressState state);
|
||||
}
|
||||
Reference in new issue
Block a user