countries-dictionary 3.1.3__py3-none-any.whl → 4.0.0__py3-none-any.whl

countries_dictionary/iso_finder.py

@@ -1,11 +1,36 @@
-from countries_dictionary import COUNTRIES
-
-def iso_finder(code: str):
-    """Returns a string which consists of the name of the country and its formal name, based on the provided ISO code"""
-    for x in COUNTRIES:
-        if code == COUNTRIES[x]["ISO 3166-1"]["alpha-2"]: return f"{x} — {COUNTRIES[x]["formal name"]}"
-        else:
-            if code == COUNTRIES[x]["ISO 3166-1"]["alpha-3"]: return f"{x} — {COUNTRIES[x]["formal name"]}"
-            else:
-                if code == COUNTRIES[x]["ISO 3166-1"]["numeric"]: return f"{x} — {COUNTRIES[x]["formal name"]}"
-    raise Exception("No United Nations' member or observer state has this code")
+from countries_dictionary.quick_functions import countries_iso_3166_2
+from countries_dictionary.russia import RUSSIA
+from countries_dictionary.united_states import UNITED_STATES
+from countries_dictionary.vietnam import VIETNAM
+
+countries = countries_iso_3166_2()
+
+def iso_finder(code: str, info_included: str = None):
+    """Returns the name of the country and their chosen information based on the provided ISO code"""
+    for x in countries:
+        y = countries[x].get(info_included, "") if info_included else ""
+        iso_data = countries[x]["ISO 3166-1"]
+        if code in (iso_data["alpha-2"], iso_data["alpha-3"], iso_data["numeric"], countries[x]["ISO 3166-2"]): return [x, y]
+    raise Exception("No United Nations' member or observer state has this code")
+
+def iso_ru_finder(code: str, info_included: str = None):
+    """Returns the name of the Russian federal subject and their chosen information based on the provided ISO code
+    (For occupied zones in Ukraine, check the Ukraine dictionary, it hasn't released though)"""
+    for x in RUSSIA:
+        y = RUSSIA[x].get(info_included, "") if info_included else ""
+        if code == RUSSIA[x]["ISO 3166-2:RU"]: return [x, y]
+    raise Exception("No Russian federal subject has this code")
+
+def iso_us_finder(code: str, info_included: str = None):
+    """Returns the name of the US state or territory and their chosen information based on the provided ISO code"""
+    for x in UNITED_STATES:
+        y = UNITED_STATES[x].get(info_included, "") if info_included else ""
+        if code == UNITED_STATES[x]["ISO 3166-2:US"]: return [x, y]
+    raise Exception("No US state or territory has this code")
+
+def iso_vn_finder(code: str, info_included: str = None):
+    """Returns the name of the Vietnamese province and their chosen information based on the provided ISO code"""
+    for x in VIETNAM:
+        y = VIETNAM[x].get(info_included, "") if info_included else ""
+        if code == VIETNAM[x]["ISO 3166-2:VN"]: return [x, y]
+    raise Exception("No Vietnamese province has this code")

countries_dictionary/quick_functions.py

@@ -10,7 +10,7 @@ def chosen_dictionary(dictionary="countries"):
     """Returns one of the dictionaries depends on the parameter. Used in other functions"""
     if dictionary.casefold() == "countries": return COUNTRIES
     elif dictionary.casefold() == "russia": return RUSSIA
-    elif dictionary.casefold() == "united state": return UNITED_STATES
+    elif dictionary.casefold() == "united states" or "america": return UNITED_STATES
     elif dictionary.casefold() == "vietnam": return VIETNAM
     else: raise Exception("This dictionary does not exist (yet)")
 
@@ -74,10 +74,19 @@ def countries_iso_3166_2():
     for x in COUNTRIES: new_countries[x]["ISO 3166-2"] = "ISO 3166-2:" + COUNTRIES[x]["ISO 3166-1"]["alpha-2"]
     return new_countries
 
+# Fun functions, for entertainment purposes only
+
 def countries_france_censored():
     """Returns the countries dictionary with the `France` key gets censored `Fr*nce`
-    (This is only a joke, I don't support hate against France and French people)"""
+
+    (This is just a joke, I don't support hate against France and French people)"""
     new_countries = COUNTRIES
     new_countries["Fr*nce"] = new_countries.pop("France")
     new_countries = dict(sorted(new_countries.items()))
-    return new_countries
+    return new_countries
+
+def countries_allahu_akbar():
+    """Returns the countries dictionary without most countries except the two countries whose mottos are "God is the Greatest". اَللَّٰهُ أَكْبَرُ!
+
+    (I'm not a Muslim, and this is just a joke, I don't support hate against Islam and these two countries)"""
+    return dict(filter(lambda item: item[1]["motto"] == "God is the Greatest", COUNTRIES.items()))