Unfucked 0.0.0-alpha2

🧰 Unfucked

Fix egregiously broken or missing functionality in .NET libraries. Inspired by underscore, jQuery, Apache Commons, Spring, and Guava.

• Packages
  • Unfucked
  • Unfucked.Caching
  • Unfucked.Compression
  • Unfucked.DateTime
  • Unfucked.DependencyInjection
  • Unfucked.DNS
  • Unfucked.ICS
  • Unfucked.OBS
  • Unfucked.PGP
  • Unfucked.STUN
  • Unfucked.Twitch
  • Unfucked.Windows

Packages

Unfucked

• Console
  • Colored text and background in strings, not tightly coupled to Console.Write
  • Clear screen and move to top-left corner
• Cryptography
  • Random string generation
  • Is certificate temporally valid
• Decimal math
  • Math operations on 128-bit decimal values
• Directories
  • Delete without throwing an exception on missing directories
• DNS
  • Fluent resolving method
• Enumerables
  • Filter out null values
  • Add multiple values at once
  • Upsert into non-concurrent dictionary
  • Fluent set difference method
  • Filter out consecutive duplicate values
  • Convert IAsyncEnumerator to list
  • First item or null instead of default for value types
  • Head and tail
  • Delta changeset between two enumerables (created, updated, deleted, and unchanged items)
  • Atomic swap on ConcurrentDictionary to upsert new value and get old value
• Paths
  • Trim trailing slashes
  • Create new empty temporary subdirectory in specific parent directory
  • Convert DOS backslashes to Unix forward slashes
  • Match file extension against a set
• Processes
  • Command line argument marshalling with correct escaping and quoting
    • String to array
    • Array to string
  • Run program and get output and exit code
  • Get parent process of a process
  • Get descendant processes recursively of a process
• Strings
  • Coerce empty strings to null
  • Fluently check if a string has any non-whitespace characters
  • Fluently check if a string has any characters
  • Fluent join method
  • Uppercase first letter
  • Lowercase first letter
  • Trim multiple strings from start, end, or both
  • Join enumerable into an English-style list with commas an a conjunction like and
  • Fluent conversion method to byte array
  • Fluent conversion method to byte stream
  • Convert DOS CRLF line breaks to Unix LF line breaks
  • Repeat a string a certain number of times
• Tasks
  • Unbounded delay time (.NET 6 tops out at 49.7 days)
  • Await multiple tasks and proceed when any of them both completes and the return value passes a predicate, or they all fail to complete or the predicate
    • Return true if any passed or false if they all failed
    • Return the first passing task's result, or null if they all failed
  • Asynchronously await the cancellation of a CancellationToken without blocking the thread
• URIs
  • Fluent method to get URI query parameters
  • Check if a URI host belongs to a given domain (site locking)
• XML
  • Fluent method to read an XML document from an HTTP response body
  • Find all descendant elements of a parent node which have a given tag name

Unfucked.Caching

• Type-safe MemoryCache<T>

Unfucked.Compression

• TAR archives
  • Symlinks
  • Directories
  • File owner
  • File group
  • File permissions

Unfucked.DateTime

• Absolute value of a Duration or TimeSpan
• Get midnight from a ZonedDateTime as a ZonedDateTime, Period, or Duration
• Convert time zone offset to hours
• Compare two OffsetDateTimes to see which one happens first

Unfucked.DependencyInjection

• Add a colored console with column formatted data
• Search for JSON configuration files in executable directory, not just current working directory
• Allow provider functions to be injected, so long-lived consumers can depend on short-lived dependencies and control their lifecycle

Unfucked.DNS

• Interface for Gandi LiveDNS HTTP API client to allow mocked testing isolation

Unfucked.ICS

• Asynchronously serialize iCalendar files to a byte stream, to prevent Kestrel and IIS errors on synchronous I/O
• Converters between the three implementations of a datetime used by Ical.Net, NodaTime, and .NET

Unfucked.OBS

• Interface for Open Broadcaster Software Studio WebSocket API client to allow mocked testing isolation

Unfucked.PGP

• Detached signing, where an ASCII-armored PGP signature is generated in a sidecar file, not inline wrapping the file being signed like in clearsigning

Unfucked.STUN

• STUN client that retains the server that it was configured with, useful for error logging
• Multi-server STUN client that transparently picks a random public STUN server from a constantly-updated list when sending a request, with retries and fallbacks if any of them fail
• Thread-safe multi-server STUN client that can be used concurrently from multiple threads without conflicts

Unfucked.Twitch

• Interface for Twitch HTTP API client to allow mocked testing isolation

Unfucked.Windows

• Reliably detect when computer is entering and exiting standby
• Kill the running screensaver