Iconvex Platforms

iconvex_platforms adds 117 pure-Elixir, vendor- and platform-qualified codecs to Iconvex. The package contributes 354 unique registry names. This total includes 117 canonical names and 237 aliases.

The runtime uses no NIFs, ports, subprocesses, or calls to iconv. The OTP application registers the complete surface and tables in one transaction. Stopping it removes those routes and providers.

Installation

def deps do
  [
    {:iconvex, "~> 0.1"},
    {:iconvex_platforms, "~> 0.1"}
  ]
end

Conversion examples

IBM-1175 is the Turkish EBCDIC euro-and-lira revision:

iex> Iconvex.convert("TRY ₺€", "UTF-8", "IBM-1175")
{:ok, <<0xE3, 0xD9, 0xE8, 0x40, 0x9A, 0x9F>>}

GNU glibc's BRF map turns Braille ASCII cells into Unicode Braille:

iex> Iconvex.convert("AB", "BRF", "UTF-8")
{:ok, "⠁⠃"}

The package keeps the four VietUnicode VNI transports distinct. This example uses the 2002 ANSI Win/Unix profile.

iex> Iconvex.convert("Việt", "UTF-8", "VIETUNICODE-2002-VNI-ANSI-WIN-UNIX")
{:ok, <<0x56, 0x69, 0x65, 0xE4, 0x74>>}

Windows best-fit mappings use directional rules.

iex> Iconvex.convert("−", "UTF-8", "WINDOWS-BESTFIT-1252")
{:ok, "-"}
iex> Iconvex.convert("-", "WINDOWS-BESTFIT-1252", "UTF-8")
{:ok, "-"}

Java Modified UTF-8 rejects a literal zero byte and accepts the two-byte NUL:

iex> Iconvex.convert(<<0xC0, 0x80>>, "JAVA-MODIFIED-UTF-8", "UTF-8")
{:ok, <<0>>}

The stateful IBM-965 and IBM-17354 codecs emit designation and shift sequences, while UTF-8-MAC implements the HFS Plus decomposition profile:

iex> {:ok, encoded} = Iconvex.convert("A一", "UTF-8", "IBM-965")
iex> Iconvex.convert(encoded, "IBM-965", "UTF-8")
{:ok, "A一"}

iex> Iconvex.convert("é", "UTF-8", "UTF-8-MAC")
{:ok, "é"}

Package contents

Use Iconvex.Platforms.encodings/0 for the canonical list. Use Iconvex.Platforms.registrations/0 for aliases, modules, and source families. SURFACE_MANIFEST.tsv provides the immutable row-by-row contract.

Archive-independent IBM tables

Earlier code routed IBM-1175, IBM-965, and IBM-17354 through ICU Archive provider IDs. IBM-934/938 and IBM-5052/5053/5055/958 also used seven internal Archive tables. Platforms copies all ten immutable tables under package-owned IDs. It does not depend on iconvex_icu_archive or claim an Archive provider. Therefore, both optional packages can run without provider ownership collisions.

The package owns 84 tables. The total includes 73 manifest providers, ten relocated IBM dependencies, and the pinned glibc IBM423 table.

Verification

The test suite contains the original source fixtures and a 1,112,064-scalar UTF-32BE corpus. It verifies each row and canonical inverse in the generated mapping families. It checks all 94×94 positions for IBM-965 and IBM-17354. It checks every byte and inverse for each single-byte profile. Additional tests cover:

• Stateful behavior and conversion policies.
• UTF-8 offsets and lifecycle behavior.
• Artifact contents, digests, and licenses.

Representative source-bound benchmarks enforce a 30× native/reference ceiling and linear reduction scaling. See BENCHMARKS.md.

Extending Iconvex

Third-party packages can use Iconvex.Extension.register/2 for transactional registration. Platforms is a leaf package. Its only runtime dependency is Iconvex Core. Its runtime does not reference the former monolithic Specs namespace.

License and provenance

The original Iconvex code uses LGPL-2.1-or-later. Retained mapping and source artifacts keep their upstream terms. See NOTICE and the shipped license files.

Complete codec catalog

The generator builds this table from the release inventories. Do not edit this section by hand. Codec names ignore ASCII letter case. You can use each alias to look up its codec. Aliases do not increase the canonical codec count.

117 canonical codecs · 237 aliases · 354 accepted names.

Registered codec names