Add support for `VISCII` encoding in `codecs`

[henryivesjones]

Feature or enhancement

Proposal:

viscii is an encoding for the Vietnamese language. Support for it is included in the email charset list but it is not supported by codecs. The encoding spec can be found in rfc1456.

viscii can be found in the IANA character sets list.
https://www.iana.org/assignments/character-sets/character-sets.xhtml

import codecs
codecs.lookup('viscii')
# LookupError: unknown encoding: viscii

Has this already been discussed elsewhere?

This is a minor feature, which does not need previous discussion elsewhere

Links to previous discussion of this feature:

No response

Linked PRs

• gh-148865: Add support for viscii encoding in codecs #148866

[serhiy-storchaka]

According to Wikipedia, VISCII is an unofficial encoding which was mostly used by overseas Vietnamese speakers, while VSCII (TCVN) (official standard) and VNI were more popular in Vietnam. Each of them has several variants, so this is a complex issue.

Having an RFC is an argument in favor, but RFC 1456 does not contain a table for Unicode mapping, so it cannot be used to generate the codec. https://vietstd.sourceforge.net/document/unicode.html refers to VISCII 1.1, so the variant described in RFC 1456 is perhaps not final.

iconv supports VISCII and TCVN.

We need a Vietnamese expert to evaluate this.

[encukou]

@henryivesjones, is there a need for this in practice today?

For converting old documents, it seems that you'd commonly need other variants as well. Sounds like a job for specialized tooling rather than stdlib.

@serhiy-storchaka, the RFC describes VISCII 1.1.

[serhiy-storchaka]

Thank you, so there was only one "standard" variant.

See also #65280 for TCVN encoding.

We added important historical encodings in past. Last time it was cp1125, koi8-t and kz1048 more than 10 years ago. But we need a source file on the Unicode website or the link to public official document that specifies the encoding.

[henryivesjones]

@serhiy-storchaka in the RFC there is a table describing a mapping from VISCII to VIQR which there is in turn a mapping of VIQR to Unicode.

In the appendixes of this document there are several encoding tables that map from VISCII to VIQR to Unicode.

@encukou I came across it in an email sent in 2026.

+=================++==================++==================++=================+
|Chr: VIQR:VISCII || Chr: VIQR:VISCII || Chr: VIQR:VISCII || Chr: VIQR:VISCII|
+---:-----:-------++----:-----:-------++----:-----:-------++----:-----:------+
| A : A   :  065  ||  N : N   :  078  ||  a : a   :  097  ||  n : n   :  110 |
| Á : A'  :  193  ||  O : O   :  079  ||  á : a'  :  225  ||  o : o   :  111 |
| À : A`  :  192  ||  Ó : O'  :  211  ||  à : a`  :  224  ||  ó : o'  :  243 |
| Ả : A?  :  196  ||  Ò : O`  :  210  ||  ả : a?  :  228  ||  ò : o`  :  242 |
| Ã : A~  :  195  ||  Ỏ : O?  :  153  ||  ã : a~  :  227  ||  ỏ : o?  :  246 |
| Ạ : A.  :  128  ||  ạ : O~  :  213  ||  Õ : a.  :  160  ||  õ : o~  :  245 |
| Ă : A(  :  197  ||  Ọ : O.  :  154  ||  ă : a(  :  229  ||  ọ : o.  :  247 |
| Ắ : A(' :  129  ||  Ô : O^  :  212  ||  ắ : a(' :  161  ||  ô : o^  :  244 |
| Ằ : A(` :  130  ||  Ố : O^' :  143  ||  ằ : a(` :  162  ||  ố : o^' :  175 |
| Ẳ : A(? :  002  ||  Ồ : O^` :  144  ||  ẳ : a(? :  198  ||  ồ : o^` :  176 |
| Ẵ : A(~ :  005  ||  Ổ : O^? :  145  ||  ẵ : a(~ :  199  ||  ổ : o^? :  177 |
| Ặ : A(. :  131  ||  Ỗ : O^~ :  146  ||  ặ : a(. :  163  ||  ỗ : o^~ :  178 |
| Â : A^  :  194  ||  Ộ : O^. :  147  ||  â : a^  :  226  ||  ộ : o^. :  181 |
| Ấ : A^' :  132  ||  Ơ : O+  :  180  ||  ấ : a^' :  164  ||  ơ : o+  :  189 |
| Ầ : A^` :  133  ||  Ớ : O+' :  149  ||  ầ : a^` :  165  ||  ớ : o+' :  190 |
| Ẩ : A^? :  134  ||  Ờ : O+` :  150  ||  ẩ : a^? :  166  ||  ờ : o+` :  182 |
| Ẫ : A^~ :  006  ||  Ở : O+? :  151  ||  ẫ : a^~ :  231  ||  ở : o+? :  183 |
| Ậ : A^. :  135  ||  Ỡ : O+~ :  179  ||  ậ : a^. :  167  ||  ỡ : o+~ :  222 |
| B : B   :  066  ||  Ợ : O+. :  148  ||  b : b   :  098  ||  ợ : o+. :  254 |
| C : C   :  067  ||  P : P   :  080  ||  c : c   :  099  ||  p : p   :  112 |
| D : D   :  068  ||  Q : Q   :  081  ||  d : d   :  100  ||  q : q   :  113 |
| Đ : DD  :  208  ||  R : R   :  082  ||  đ : dd  :  240  ||  r : r   :  114 |
| E : E   :  069  ||  S : S   :  083  ||  e : e   :  101  ||  s : s   :  115 |
| É : E'  :  201  ||  T : T   :  084  ||  é : e'  :  233  ||  t : t   :  116 |
| È : E`  :  200  ||  U : U   :  085  ||  è : e`  :  232  ||  u : u   :  117 |
| Ẻ : E?  :  203  ||  Ú : U'  :  218  ||  ẻ : e?  :  235  ||  ú : u'  :  250 |
| Ẽ : E~  :  136  ||  Ù : U`  :  217  ||  ẽ : e~  :  168  ||  ù : u`  :  249 |
| Ẹ : E.  :  137  ||  Ủ : U?  :  156  ||  ẹ : e.  :  169  ||  ủ : u?  :  252 |
| Ê : E^  :  202  ||  Ũ : U~  :  157  ||  ê : e^  :  234  ||  ũ : u~  :  251 |
| Ế : E^' :  138  ||  Ụ : U.  :  158  ||  ế : e^' :  170  ||  ụ : u.  :  248 |
| Ề : E^` :  139  ||  Ư : U+  :  191  ||  ề : e^` :  171  ||  ư : u+  :  223 |
| Ể : E^? :  140  ||  Ứ : U+' :  186  ||  ể : e^? :  172  ||  ứ : u+' :  209 |
| Ễ : E^~ :  141  ||  Ừ : U+` :  187  ||  ễ : e^~ :  173  ||  ừ : u+` :  215 |
| Ệ : E^. :  142  ||  Ử : U+? :  188  ||  ệ : e^. :  174  ||  ử : u+? :  216 |
| F : F   :  070  ||  Ữ : U+~ :  255  ||  f : f   :  102  ||  ữ : u+~ :  230 |
| G : G   :  071  ||  Ự : U+. :  185  ||  g : g   :  103  ||  ự : u+. :  241 |
| H : H   :  072  ||  V : V   :  086  ||  h : h   :  104  ||  v : v   :  118 |
| I : I   :  073  ||  W : W   :  087  ||  i : i   :  105  ||  w : w   :  119 |
| Í : I'  :  205  ||  X : X   :  088  ||  í : i'  :  237  ||  x : x   :  120 |
| Ì : I`  :  204  ||  Y : Y   :  089  ||  ì : i`  :  236  ||  y : y   :  121 |
| Ỉ : I?  :  155  ||  Ý : Y'  :  221  ||  ỉ : i?  :  239  ||  ý : y'  :  253 |
| Ĩ : I~  :  206  ||  Ỳ : Y`  :  159  ||  ĩ : i~  :  238  ||  ỳ : y`  :  207 |
| Ị : I.  :  152  ||  Ỷ : Y?  :  020  ||  ị : i.  :  184  ||  ỷ : y?  :  214 |
| J : J   :  074  ||  Ỹ : Y~  :  025  ||  j : j   :  106  ||  ỹ : y~  :  219 |
| K : K   :  075  ||  Ỵ : Y.  :  030  ||  k : k   :  107  ||  ỵ : y.  :  220 |
| L : L   :  076  ||  Z : Z   :  090  ||  l : l   :  108  ||  z : z   :  122 |
| M : M   :  077  ||    :     :       ||  m : m   :  109  ||    :     :      |
+=================++==================++==================++=================+