✖convert - version 0.1.9

AIO module for bidirectional data transformations across multiple encoding formats and native object structures, eliminating dependency on multiple conversion utilities.

Its like the builtin [system.convert] but extended.

↯ Install

PowerShell Install-Module cliHelper.xconvert

⤷ Straight forward; gets the latest version.

🧑🏻‍💻 ᴜsᴀɢᴇ

Hint: xconvert is pretty much the only cmdlet you have to remember ×͜×

⤷ 1. (xconvert). Like directly using the class.

• To know what method to use, you just type xconvert From and
  Tab to see all options.

xconvert From Tab

gives this output

or xconvert To Tab

Then you can do stuff like:

```PowerShell "HelloWorld" | xconvert ToBase32

same as

(xconvert)::ToBase32("HelloWorld") ```

ie: since xconvert is an alias for the public funtion Invoke-Converter.

⤷ 2. Chain⫘⫘ing and piping public function(s)

ex: do stuff like

```PowerShell $enc_Pass = "HelloWorld" | xconvert ToBase32, ToObfuscated, ToSecurestring

then reverse it:

$txtPass = $encPass | xconvert ToString, FromObfuscated, FromBase32, ToUTF8str $txt_Pass | Should -Be "HelloWorld"

Metal 🔥 ⚡︎ 🤘

```

Some still wip:

• Argumenttransforms I'm planning to get nuts with them🤓

ʟɪᴄᴇɴsᴇ

This project is licensed under the MIT License. See the ʟɪᴄᴇɴsᴇ file for details.

Contributions are welcome.

⤷ This is still a ᴡɪᴘ 🚧. Yes its usable, but alot of cool stuff are not fully done.

• [x] Added main class (90%) 🎉.
• [ ] New methods to xconvert class: For each method you add there should be counter-method for it. There's a lot of missing methods, or new ways to do things. you just have to look for them. For example:
  • ToBase32 💱 FromBase32

You can get a quick overview by running show-MethodsOverview:

PowerShell #Requires -Modules cliHelper.xconvert function show-MethodsOverview() { $mark = @{ True = "✅"; False = "😒"} $xmethods = [xconvert].GetMethods().Where({ $_.IsStatic -and !$_.IsHideBySig }).name | Sort-Object -Unique; $analysis = $xmethods | % { $_.Replace('To', "").Replace('From', "") } | Sort-Object -Unique | Select-Object @{l="Name"; e={$_} }, @{l='HasBoth'; e={ $xmethods -contains "To$_" -and $xmethods -contains "From$_" }}; $hasBoth = $analysis.Where({ $_.HasBoth }); $doesNotHaveBoth = $analysis.Where({ !$_.HasBoth }); Write-Host "`nOverview of all static methods for [xconvert]" -f Green; ($hasBoth + $doesNotHaveBoth) | Select-Object Name, @{l="To"; e={ $mark[[string]($xmethods -contains "To$($_.Name)")] }}, @{l="From"; e={ $mark[[string]($xmethods -contains "From$($_.Name)")] } } | Format-Table } - [x] Added Private /utility classes - [x] Add Public function(s)

Note: This module intentionally uses 1 huge main class. Creating all functions for each method in [xconvert] might get tedious overtime, so only functions for Common format conversions will be created. i.e: - [x] Ansi - [x] ASCIIstr - [x] Base32 - [x] Base58 - [x] Base64str - [x] Base85 - [x] BitArray - [x] BUnicodestr - [x] Bytes - [x] Caesar - [x] Compressed - [x] Csv - [x] HexString - [x] Int32 - [x] Latin1str - [x] Obfuscated - [x] Object - [x] Polybius - [x] Protected - [x] PSObject - [x] ROT13 - [x] Unicodestr - [x] UtcDate - [x] UTF32str - [x] UTF7str - [x] UTF8str - [x] JSON-CSV - [ ] JSON-XML - [ ] JSON-Log - [x] Markdown-HTML - [ ] Powershell-Batch - [ ] Word-Pdf (why not) - [ ] Hex-RGB - [ ] Bitmaps - [x] Roman-Numbers - [X] GUID - [x] Url-encoding - [ ] DecimalIPv4 - [ ] functions convert data type to another (string, integer, datetime ...) - [x] functions to convert encodings (ASCII, UTF-8, base32 ...) - [ ] Binary manipulation - [ ] audio-video conversion (why not) - [ ] functions to convert between visualization formats - [ ] Write tests for encoder/decoder utility classes (they work. trust me bro)

• [ ] Add/improve a github workflows

Thank you.