absfuyu 3.1.1__py3-none-any.whl → 3.3.3__py3-none-any.whl

absfuyu/game/wordle.py

@@ -2,12 +2,12 @@
 Game: Wordle Solver
 -------------------
 
-Version: 1.1.2
-Date updated: 24/11/2023 (dd/mm/yyyy)
+Version: 1.1.4
+Date updated: 14/04/2024 (dd/mm/yyyy)
 
 Usage:
 ------
->>> Wordle.solve()
+>>> Wordle().solve()
 
 Credit:
 -------
@@ -15,21 +15,16 @@ Credit:
 - [Words](https://raw.githubusercontent.com/dwyl/english-words/master/words_dictionary.json)
 """
 
+__all__ = ["Wordle"]
 
-# Library
-###########################################################################
-from collections import Counter
-from itertools import chain
 import operator
 import string
+from collections import Counter
+from itertools import chain
+from typing import List, Set, Tuple
 
 import requests
 
-from absfuyu.logger import logger
-
-
-# Settings
-###########################################################################
 OFFLINE_WORDS = """\
 aahed,aalii,aargh,aaron,abaca,abaci,aback,abada,abaff,abaft,abaka,abama,abamp,aband,abase,abash,abask,abate,abaue,abave,abaze,abbas,abbes,abbey,abbie,abbot,abdal,abdat,abdom,abeam,abear,abede,abele,abend,aberr,abets,abhor,abide,abidi,abies,abilo,abime,abkar,abler,ables,ablet,ablow,abmho,abner,abnet,abode,abody,abohm,aboil,aboma,aboon,abord,abort,abote,about,above,abram,abray,abret,abrim,abrin,abris,abrus,absee,absey,absis,absit,abstr,abuna,abune,abura,abuse,abush,abuta,abuts,abuzz,abwab,abyes,abysm,abyss,acale,acana,acapu,acara,acari,acast,acate,accel,accoy,accra,accts,accum,accur,accus,acedy,acerb,aceta,achar,ached,achen,acher,aches,achoo,achor,acids,acidy,acier,acies,acing,acini,ackee,acker,ackey,aclys,acmes,acmic,acned,acnes,acock,acoin,acold,acoma,acone,acool,acorn,acost,acoup,acrab,acred,acres,acrid,acroa,acron,acrux,acryl,acted,actin,acton,actor,actos,actus,acuan,acute,acyls,adage,adagy,adams,adapa,adapt,adati,adaty,adawe,adawn,adays,adcon,addax,addda,added,adder,addie,addio,addis,addle,addnl,adead,adeem,adeep,adela,adeps,adept,adfix,adiel,adieu,adion,adios,adits,adjag,adlai,adlay,adlet,adman,admen,admin,admit,admix,admov,admrx,adnex,adobe,adobo,adolf,adopt,adore,adorn,adown,adoxa,adoxy,adoze,adpao,adrad,adret,adrip,adrop,adrue,adsum,adult,adunc,adure,adusk,adust,adyta,adzer,adzes,aecia,aedes,aeger,aegir,aegis,aegle,aeons,aequi,aeric,aerie,aeron,aesir,aesop,aetat,aevia,aevum,aface,afara,afars,afear,affix,afgod,afifi,afire,aflat,afley,aflow,afoam,afoot,afore,afoul,afray,afret,afric,afrit,afros,after,agada,agade,again,agama,agami,agamy,agape,agars,agasp,agast,agata,agate,agaty,agave,agaze,agena,agend,agene,agent,agers,agete,agger,aggie,aggro,aggry,aggur,aghan,aghas,agiel,agile,aging,agios,agism,agist,aglee,aglet,agley,aglow,agmas,agnat,agnel,agnes,agnus,agoge,agoho,agone,agons,agony,agora,agrah,agral,agree,agria,agric,agrin,agrom,agron,agsam,agues,aguey,agura,agush,agust,ahead,aheap,ahems,ahind,ahint,ahmed,ahmet,ahold,aholt,ahong,ahsan,ahull,ahunt,ahura,ahush,ahwal,aided,aider,aides,aiery,aiger,aigre,ailed,ailie,aillt,aimak,aimed,aimee,aimer,ainee,ainoi,ainus,aioli,airan,aired,airer,airns,airth,airts,aisle,aitch,aitis,aiver,aiwan,aizle,ajaja,ajari,ajava,ajhar,ajiva,ajuga,akala,akali,akasa,akebi,akees,akeki,akela,akene,aking,akkad,aknee,aknow,akpek,akron,akule,akund,alack,alada,alain,alaki,alala,alamo,aland,alane,alang,alani,alans,alant,alapa,alarm,alary,alate,alawi,alban,albas,albee,albin,album,albus,albyn,alcae,alces,alcid,alcor,alday,aldea,alden,alder,aldim,aldol,aldus,aleak,
 aleck,alecs,alefs,aleft,alenu,aleph,alert,aleut,alfas,alfet,alfin,alfur,algae,algal,algas,algic,algid,algin,algol,algor,algum,alhet,alias,alibi,alice,alick,alida,alids,alien,aliet,alife,alifs,align,alike,alima,aline,alish,aliso,alisp,alist,alite,ality,alive,aliya,alkes,alkin,alkyd,alkyl,allah,allan,allay,allen,aller,alley,allez,allie,allis,allod,alloo,allot,allow,alloy,allyl,almah,alman,almas,almeh,almes,almon,almud,almug,alnus,alody,aloed,aloes,aloft,alogy,aloha,aloid,aloin,alois,aloma,alone,along,aloof,alosa,alose,aloud,alout,alowe,alpax,alpen,alpha,alpid,altar,alter,altho,altin,altos,altun,altus,aluco,alula,alums,alure,aluta,alvah,alvan,alvar,alvia,alvin,alvus,alway,amaas,amadi,amaga,amahs,amain,amala,amalg,amang,amani,amant,amapa,amara,amass,amate,amati,amaut,amaze,amban,ambar,ambas,ambay,amber,ambit,amble,ambon,ambos,ambry,ameba,ameed,ameen,ameer,amelu,amend,amene,amens,ament,amess,amhar,amias,amice,amici,amide,amido,amids,amies,amiga,amigo,amine,amini,amino,amins,amire,amirs,amish,amiss,amita,amity,amlet,amman,ammer,ammos,amnia,amnic,amoke,amoks,amole,among,amora,amort,amour,amove,amowt,amper,amphi,ample,amply,ampul,ampyx,amrit,amsel,amuck,amula,amuse,amuze,amvis,amylo,amyls,amzel,anabo,anack,anama,anana,anasa,ancha,ancle,ancon,ancor,ancre,andes,andia,andor,andre,anear,anele,anend,anent,angas,angel,anger,angia,angie,angka,angle,anglo,angor,angry,angst,angus,anhyd,aniba,anice,anigh,anile,anils,anima,anime,animi,animo,anion,anise,anita,anjan,anjou,ankee,anker,ankhs,ankle,ankou,ankus,anlas,anlet,anlia,anmia,annal,annam,annas,annat,annet,annex,annie,anniv,annot,annoy,annul,annum,annus,anoas,anode,anoia,anoil,anole,anoli,anomy,anorn,anour,anous,anova,ansae,ansar,ansel,anser,antae,antal,antar,antas,anted,antes,antic,antiq,antis,anton,antra,antre,antsy,antum,anura,anury,anvil,anzac,aoife,aorta,aotea,aotes,aotus,aouad,apace,apaid,apair,apama,apart,apass,apast,apeak,apeek,apers,apert,aperu,apery,aphid,aphis,aphra,apian,apiin,apili,apina,aping,apiol,apios,apish,apism,apium,apnea,apoda,apods,apoop,aport,apout,appal,appar,appay,appel,appet,apple,apply,appmt,appro,apptd,appui,apres,april,apron,apses,apsid,apsis,aptal,apter,aptly,aquae,aquas,araba,arabs,araby,araca,arace,arach,arado,arage,arain,arake,araks,aramu,arank,arara,araru,arase,arati,araua,arawa,arber,arbor,arcae,arced,arces,archd,arche,archt,archy,arcos,arcus,ardea,ardeb,arder,ardor,ardri,aread,areae,areal,arean,arear,areas,areca,areek,areel,arefy,areic,arena,arend,areng,arent,arere,arest,arete,argal,argan,argas,argel,argid,argil,
@@ -84,27 +79,20 @@ zabra,zabti,zaire,zakah,zakat,zaman,zambo,zamia,zande,zante,zanza,zanze,zapas,za
 """
 
 
-# Class
-###########################################################################
 class Wordle:
     """
     Wordle class
 
     Use: ``Wordle.solve()``
     """
-    def __init__(
-            self,
-            *,
-            green: str = "G",
-            yellow: str = "Y",
-            gray: str = "?"
-        ) -> None:
+
+    def __init__(self, *, green: str = "G", yellow: str = "Y", gray: str = "?") -> None:
         # Setting
         self._ALLOWABLE_CHARACTERS = set(string.ascii_letters)
         self._ALLOWED_ATTEMPTS = 6
         self._WORD_LENGTH = 5
 
-        self._WORDS = set(OFFLINE_WORDS.replace("\n", "").split(","))
+        self._WORDS: List[str] = list(set(OFFLINE_WORDS.replace("\n", "").split(",")))
 
         self._LETTER_COUNTER = Counter(chain.from_iterable(self._WORDS))
 
@@ -117,11 +105,13 @@ class Wordle:
         self._GREEN = green
         self._YELLOW = yellow
         self._GRAY = gray
+
     def __str__(self) -> str:
-        pass
+        return self.__repr__()
+
     def __repr__(self) -> str:
-        return self.__str__()
-    
+        return self.__class__.__name__
+
     def update_words(self) -> None:
         """
         Try to fetch words list from online source
@@ -129,74 +119,94 @@ class Wordle:
         try:
             dict_link = "https://raw.githubusercontent.com/dwyl/english-words/master/words_dictionary.json"
             res = requests.get(dict_link)
-            word_list = list(res.json().keys())
-            logger.debug(word_list)
-            self._WORDS = {
-                word.lower()
-                for word in word_list
-                if len(word) == self._WORD_LENGTH and set(word) < self._ALLOWABLE_CHARACTERS 
-            }
-        except:
+            word_list: list[str] = list(res.json().keys())
+            self._WORDS = list(
+                {
+                    word.lower()
+                    for word in word_list
+                    if len(word) == self._WORD_LENGTH
+                    and set(word) < self._ALLOWABLE_CHARACTERS
+                }
+            )
+        except Exception:
             pass
 
     # Logic
-    def _calculate_word_commonality(self, word):
+    def _calculate_word_commonality(self, word: str) -> float:
         score = 0.0
         for char in word:
             score += self._LETTER_FREQUENCY[char]
         return score / (self._WORD_LENGTH - len(set(word)) + 1)
 
-    def _sort_by_word_commonality(self):
+    def _sort_by_word_commonality(self) -> List[Tuple[str, float]]:
         sort_by = operator.itemgetter(1)
         return sorted(
             [(word, self._calculate_word_commonality(word)) for word in self._WORDS],
             key=sort_by,
             reverse=True,
         )
-    
-    def _display_word_table(self, word_commonalities):
-        for (word, freq) in word_commonalities:
+
+    def _display_word_table(self, word_commonalities: List[Tuple[str, float]]) -> None:
+        for word, freq in word_commonalities:
             print(f"{word:<10} | {freq:<5.2}")
 
-    def _input_word(self):
+    def _input_word(self) -> str:
         while True:
             word = input("Input the word you entered> ")
             if len(word) == self._WORD_LENGTH and word.lower() in self._WORDS:
                 break
         return word.lower()
-    
-    def _input_response(self):
+
+    def _input_response(self) -> str:
         print("Type the color-coded reply from Wordle:")
         print(f"  {self._GREEN} for Green")
         print(f"  {self._YELLOW} for Yellow")
         print(f"  {self._GRAY} for Gray")
         while True:
             response = input("Response from Wordle> ")
-            if len(response) == self._WORD_LENGTH and set(response) <= {self._GREEN, self._YELLOW, self._GRAY}:
+            if len(response) == self._WORD_LENGTH and set(response) <= {
+                self._GREEN,
+                self._YELLOW,
+                self._GRAY,
+            }:
                 break
             else:
                 print(f"Error - invalid answer {response}")
+        if response == self._GREEN * 5:  # Win
+            return "win"
         return response
 
-    def _match_word_vector(self, word, word_vector):
+    def _match_word_vector(self, word: str, word_vector: List[Set[str]]) -> bool:
         assert len(word) == len(word_vector)
         for letter, v_letter in zip(word, word_vector):
             if letter not in v_letter:
                 return False
         return True
 
-    def _match(self, word_vector, possible_words):
-        return [word for word in possible_words if self._match_word_vector(word, word_vector)]
-    
+    def _match(
+        self, word_vector: List[Set[str]], possible_words: List[str]
+    ) -> List[str]:
+        return [
+            word
+            for word in possible_words
+            if self._match_word_vector(word, word_vector)
+        ]
+
     # Main
     def solve(self) -> None:
         """Solve Wordle"""
         word_vector = [set(string.ascii_lowercase) for _ in range(self._WORD_LENGTH)]
+
         for attempt in range(1, self._ALLOWED_ATTEMPTS + 1):
             print(f"Attempt {attempt} with {len(self._WORDS)} possible words")
             self._display_word_table(self._sort_by_word_commonality()[:15])
             word = self._input_word()
+
             response = self._input_response()
+            if response == "win":
+                print("You Won!")
+                break
+
             for idx, letter in enumerate(response):
                 if letter == self._GREEN:
                     word_vector[idx] = {word[idx]}
@@ -217,6 +227,5 @@ class Wordle:
 # Run
 ###########################################################################
 if __name__ == "__main__":
-    logger.setLevel(10) # DEBUG
     test = Wordle()
     test.solve()

absfuyu/general/__init__.py

@@ -3,8 +3,8 @@ Absfuyu: General
 ----------------
 Collection of useful classes
 
-Version: 1.1.3
-Date updated: 26/11/2023 (dd/mm/yyyy)
+Version: 1.1.4
+Date updated: 15/03/2024 (dd/mm/yyyy)
 
 Features:
 ---------
@@ -16,6 +16,8 @@ Features:
 
 # Libary
 ###########################################################################
+from typing import Any, Dict, Optional
+
 from absfuyu.general import content, data_extension, generator, human
 
 
@@ -28,10 +30,10 @@ class Dummy:
     Update attribute through dict
     """
 
-    def __init__(self, data: dict = None) -> None:
+    def __init__(self, data: Optional[Dict[Any, Any]] = None) -> None:
         try:
-            self.__dict__.update(data)
-        except:
+            self.__dict__.update(data)  # type: ignore
+        except Exception:
             pass
 
     def __str__(self) -> str:
@@ -45,7 +47,7 @@ class Dummy:
         """List ``property``"""
         return [x for x in self.__dir__() if not x.startswith("_")]
 
-    def update(self, data: dict) -> None:
+    def update(self, data: Dict[Any, Any]) -> None:
         """
         Update with dict data
 
@@ -76,9 +78,17 @@ class ClassBase:
         """
         keys = self.__dict__.keys()
         temp = filter(lambda x: not x.startswith("_"), keys)
-        out = [f"{x}={self.__dict__[x]}" for x in temp]
+        # out = [f"{x}={self.__dict__[x]}" for x in temp]
+        out = [f"{x}={self.__dict__.get(x)}" for x in temp]
         return sep.join(out)
 
+    # def _get_new_available_method(self) -> List[str]:
+    #     """
+    #     Return all new available methods in this particular class
+    #     """
+    #     available = set(dir(self.__class__)).difference(set(dir(self.__class__.__base__)))
+    #     return sorted(list(available))
+
 
 # Run
 ###########################################################################

absfuyu/general/content.py

@@ -3,15 +3,14 @@ Absfuyu: Content
 ----------------
 Handle .txt file
 
-Version: 1.2.5
-Date updated: 27/11/2023 (dd/mm/yyyy)
+Version: 1.2.6
+Date updated: 05/04/2024 (dd/mm/yyyy)
 
 Usage:
 ------
 >>> from absfuyu.general.content import ContentLoader
 """
 
-
 # Module level
 ###########################################################################
 __all__ = ["ContentLoader", "Content", "LoadedContent"]
@@ -19,12 +18,12 @@ __all__ = ["ContentLoader", "Content", "LoadedContent"]
 
 # Library
 ###########################################################################
-from collections import Counter
-from itertools import chain
 import json
-from pathlib import Path
 import random
 import re
+from collections import Counter
+from itertools import chain
+from pathlib import Path
 from typing import List, Optional
 
 from unidecode import unidecode
@@ -63,7 +62,7 @@ class Content:
         Content
             ``unidecoded`` Content
         """
-        return __class__([unidecode(self.data), list(map(unidecode, self.tag))])
+        return self.__class__([unidecode(self.data), list(map(unidecode, self.tag))])
 
     def to_text(self) -> str:
         """
@@ -140,7 +139,7 @@ class Content:
         self.tag = list(set(self.tag + new_tag))
         logger.debug(f"Final tags: {self.tag} Len: {len(self.tag)}")
 
-        return __class__([self.data, self.tag])
+        return self.__class__([self.data, self.tag])
 
 
 class LoadedContent(List[Content]):
@@ -163,7 +162,7 @@ class LoadedContent(List[Content]):
         :type func: Callable
         :rtype: LoadedContent
         """
-        return __class__(func(x.data) for x in self)
+        return self.__class__(func(x.data) for x in self)
 
     @classmethod
     def load_from_json(cls, file: Path) -> "LoadedContent":
@@ -222,7 +221,7 @@ class LoadedContent(List[Content]):
                 f"Available tags: {_avail_tag},..."
                 f"\nMore tag at: `{self.__class__.__name__}.tags`"
             )
-        return __class__([x for x in self if tag in x.tag])
+        return self.__class__([x for x in self if tag in x.tag])
 
     def find(self, keyword: str) -> "LoadedContent":
         """
@@ -232,7 +231,9 @@ class LoadedContent(List[Content]):
         :type keyword: str
         :rtype: LoadedContent
         """
-        temp = __class__([x for x in self if x.data.lower().find(keyword.lower()) >= 0])
+        temp = self.__class__(
+            [x for x in self if x.data.lower().find(keyword.lower()) >= 0]
+        )
         if temp:
             logger.debug(f"Found {len(temp)} {'entries' if len(temp) > 1 else 'entry'}")
         else:
@@ -306,7 +307,7 @@ class LoadedContent(List[Content]):
         >>> # After handle_address(first_item_not_address = False)
         ["22 ABC Street", "DEF District", "GHI City"]
         """
-        return __class__(
+        return self.__class__(
             [
                 x.handle_address(
                     address_separator=address_separator,
@@ -373,7 +374,7 @@ class ContentLoader:
         self,
         file_path: Path,
         characteristic_detect: bool = True,
-        tag_dictionary: dict = None,
+        tag_dictionary: Optional[dict] = None,
         *,
         comment_symbol: str = "#",
         split_symbol: str = "|",
@@ -423,7 +424,7 @@ class ContentLoader:
                 f"({len(set(tag_dictionary.values()))} unique "
                 f"{'tags' if len(set(tag_dictionary.values())) > 1 else 'tag'})"
             )
-            self.tag_dictionary: dict = tag_dictionary
+            self.tag_dictionary = tag_dictionary
 
         # symbol stuff
         assert (
@@ -528,7 +529,7 @@ class ContentLoader:
                             tag.strip() for tag in temp[1].strip().lower().split(",")
                         ]  # separate and strip tags
                         logger.debug(f"Tags: {tags}")
-                    except:
+                    except Exception:
                         logger.warning("No tag found in the original string")
                         if additional_tags:
                             tags = additional_tags