Rename to ICU and pymathics.icu...

Add $Language

Author: rocky

README.rst

@@ -6,7 +6,7 @@ Example Session
 ::
 
    $ mathicsscript
-   In[1]:= LoadModule["pymathics.language"]
-   Out[1]= pymathics.language
+   In[1]:= LoadModule["pymathics.icu"]
+   Out[1]= pymathics.icu
    In[2]= Alphabet["Croatian"]
    Out[2]= {['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o', 'p', 'r', 's', 't', 'u', 'v', 'z', 'ć', 'č', 'đ', 'š', 'ž', 'dž', 'lj', 'nj']}

admin-tools/make-dist.sh

@@ -16,7 +16,7 @@ fi
 
 
 cd ..
-source pymathics/language/version.py
+source pymathics/icu/version.py
 echo $__version__
 
 pyversion=3.13

pymathics/icu/__init__.py

@@ -0,0 +1,39 @@
+"""
+ICU — International Components for Unicode
+
+Functions which provide information from the Python ICU library <url>:icu:https://pypi.org/project/pyicu/</url> library.
+
+Examples:
+
+  Load in Mathics3 Module:
+  >> LoadModule["pymathics.icu"]
+    = pymathics.natlang
+
+  Show the language in effect:
+  >> $Language
+   = "English"
+
+  Get the alphabet for that language:
+  >> Alphabet[]
+   = {a, b, c, d, e, f, g, h, i, j, k, l, m, n, o, p, q, r, s, t, u, v, w, x, y, z}
+
+  Get the alphabet for that locale "es" (Spanish):
+  >> Alphabet["es"]
+   = {a, b, c, d, e, f, g, h, i, j, k, l, m, n, o, p, q, r, s, t, u, v, w, x, y, z, á, é, í, ñ, ó, ú, ü}
+
+  You can also specify an alphabet using a name:
+  >> Alphabet["Ukrainian"]
+   = {ʼ, а, б, в, г, д, е, ж, з, и, й, к, л, м, н, о, п, р, с, т, у, ф, х, ц, ч, ш, щ, ь, ю, я, є, і, ї, ґ}
+"""
+
+from pymathics.icu.__main__ import Alphabet, Language
+from pymathics.icu.version import __version__
+
+pymathics_version_data = {
+    "author": "The Mathics3 Team",
+    "version": __version__,
+    "name": "icu",
+    "requires": ["PyICU"],
+}
+
+__all__ = ["Alphabet", "Language", "pymathics_version_data", "__version__"]

pymathics/language/__main__.py renamed to pymathics/icu/__main__.py

@@ -1,7 +1,7 @@
 # -*- coding: utf-8 -*-
 
 """
-Languages & Translations
+Languages - Human-Language Alphabets and Locales via PyICU.
 """
 
 # PYTHON MODULES USED IN HERE
@@ -13,15 +13,18 @@
 
 from icu import Locale, LocaleData
 from mathics.core.atoms import String
-from mathics.core.builtin import Builtin
+from mathics.core.builtin import Builtin, Predefined
 from mathics.core.convert.expression import to_mathics_list
+from mathics.core.evaluation import Evaluation
 
 availableLocales = Locale.getAvailableLocales()
 language2locale = {
     availableLocale.getDisplayLanguage(): locale_name
     for locale_name, availableLocale in availableLocales.items()
 }
 
+# The current value of $Language
+LANGUAGE = "English"
 
 def eval_alphabet(language_name: String) -> Optional[List[String]]:
 
@@ -38,7 +41,7 @@ class Alphabet(Builtin):
      Basic lowercase alphabet via <url>:Unicode: https://home.unicode.org/</url> and <url>:PyICU: https://pypi.org/project/PyICU/</url>
      <dl>
       <dt>'Alphabet'[]
-      <dd>gives the list of lowercase letters a-z in the English alphabet .
+      <dd>gives the list of lowercase letters a-z in the English alphabet.
 
       <dt>'Alphabet[$type$]'
       <dd> gives the alphabet for the language or class $type$.
@@ -65,7 +68,7 @@ class Alphabet(Builtin):
     }
 
     rules = {
-        "Alphabet[]": """Alphabet["English"]""",
+        "Alphabet[]": """Alphabet[Pymathics`$Language]""",
     }
 
     summary_text = "lowercase letters in an alphabet"
@@ -77,3 +80,52 @@ def eval(self, alpha: String, evaluation):
             evaluation.message("Alphabet", "nalph", alpha)
             return
         return alphabet_list
+
+## FIXME: move to mathics-core. Will have to change references to Pymathics`$Language to $Language
+class Language(Predefined):
+    """
+    <url>
+    :WMA link:
+    https://reference.wolfram.com/language/ref/\\$Language.html</url>
+
+    <dl>
+      <dt>'\\$Language'
+      <dd>is a settable global variable for the default language used in Mathics3.
+    </dl>
+
+    See the language in effect used for functions like 'Alphabet[]':
+
+    >> old_language = $Language
+     = ...
+
+    By setting its value, The letters of 'Alphabet[]' are changed:
+
+    >> $Language = "German"; Alphabet[]
+     = ...
+
+    #> $Language = old_language;
+
+    See also <url>
+    :Alphabet:
+     /doc/mathics3-modules/icu-international-components-for-unicode/languages-human-language-alphabets-and-locales-via-pyicu/alphabet/</url>.
+    """
+
+    name = "$Language"
+    messages = {
+        "notstr": "`1` is not a string. Only strings can be set as the value of $Language.",
+    }
+
+    summary_text = "settable global variable giving the default language"
+    value = f'"{LANGUAGE}"'
+    # Rules has to come after "value"
+    rules = {
+        "Pymathics`$Language": value,
+    }
+
+    def eval_set(self, value, evaluation: Evaluation):
+        """Set[Pymathics`$Language, value_]"""
+        if isinstance(value, String):
+            evaluation.definitions.set_ownvalue("$Language", value)
+        else:
+            evaluation.message("Pymathics`$Language", "notstr", value)
+        return value

pymathics/language/version.py renamed to pymathics/icu/version.py

@@ -49,8 +49,8 @@ dev = [
 
 [tool.setuptools]
 packages = [
-    "pymathics.language",
+    "pymathics.icu",
 ]
 
 [tool.setuptools.dynamic]
-version = {attr = "pymathics.language.__version__"}
+version = {attr = "pymathics.icu.__version__"}

pymathics/language/__init__.py

@@ -20,7 +20,7 @@ def check_evaluation(str_expr: str, expected: str, assert_message=""):
 
 
 def test_language():
-    session.evaluate('LoadModule["pymathics.language"]') == "pymathics.language"
+    session.evaluate('LoadModule["pymathics.icu"]') == "pymathics.icu"
     check_evaluation(
         'Alphabet["es"]',
         (