Unfucked.Windows 0.0.1-beta.6

🧰 Unfucked.Windows

Fix egregiously missing or broken functionality in .NET libraries that integrate with Windows APIs.

• Installation
• Usage
  • Arguments
  • Console
  • Internationalization
  • Processes
  • Standby and screensaver
  • UI Automation
• All Unfucked libraries

Installation

dotnet add package Unfucked.Windows

using Unfucked;
using Unfucked.Windows;

Usage

Arguments

• Command line argument marshalling with correct escaping and quoting
  • String to array

    IEnumerable<string> argv = WindowsProcesses.CommandLineToEnumerable("arg1 arg2");
    

  • Array to string

    string args = Processes.CommandLineToString(["arg1", "'argument' \"2\""]);
    

Console

• Detach a console application from its console window if you want to prevent it from receiving Ctrl+C, because it's a child process of your console application, you're handling that signal in your parent process using Console.CancelKeyPress, and you don't want the console sidestepping your parent and killing your child.

  using Process child = Process.Start("child.exe", "args")!;
  child.DetachFromConsole();
  

Internationalization

• Get locale of the operating system, rather than the user

  CultureInfo machineCulture = Cultures.CurrentMachineCulture;
  

Processes

• Easier to get program's basename without memory leaks

  string? basename = SystemWindow.ForegroundWindow.GetProcessExecutableBasename();
  

• Get parent process of a process

  Process? parent = Process.GetCurrentProcess().GetParentProcess();
  

• Get descendant processes recursively of a process

  IEnumerable<Process> decendants = Process.GetCurrentProcess().GetDescendantProcesses();
  

• Detect if a process is suspended

  bool isSuspended = Process.GetProcessById(pid).IsProcessSuspended();
  

Standby and screensaver

• Reliably detect when computer is entering and exiting standby

  using IStandbyListener standbyListener = new EventLogStandbyListener();
  standbyListener.StandingBy += (_, _) => Console.WriteLine("The computer is entering sleep mode");
  standbyListener.Resumed += (_, _) => Console.WriteLine("The computer woke up from sleep mode");
  

• Kill the running screensaver

  new ScreensaverKiller().KillScreensaver();
  

UI Automation

• Convert between Win32 window handles, UI Automation elements, and mwinapi window instances

  AutomationElement? automationElement = SystemWindow.ForegroundWindow.ToAutomationElement();
  SystemWindow foreground = foregroundUiaElementd.ToSystemWindow();
  IntPtr? foregroundHwnd = automationElement.ToHwnd();
  

• Easily get all children of a UI Automation element

  IEnumerable<AutomationElement> children = automationElement.Children();
  

• Create a UI Automation property AND or OR condition that doesn't crash if there is only one sub-condition

  IEnumerable<string> allowedNames = ["A"];
  automationElement.FindFirst(TreeScope.Children, UIAutomationExtensions.SingletonSafePropertyCondition(AutomationElement.NameProperty, false, allowedNames));
  

• Find a child or descendant UI Automation element and wait if it doesn't immediately exist, instead of returning null, to prevent UI rendering race conditions

  AutomationElement? a = automationElement.WaitForFirst(TreeScope.Children, new PropertyCondition(AutomationElement.NameProperty, "A"), TimeSpan.FromSeconds(30), cancellationToken);
  

All Unfucked libraries

• Unfucked
• Unfucked.Caching
• Unfucked.Compression
• Unfucked.DateTime
• Unfucked.DI
• Unfucked.HTTP
• Unfucked.ICS
• Unfucked.OBS
• Unfucked.PGP
• Unfucked.STUN
• Unfucked.Twitch
• Unfucked.Windows