anipy-cli 3.1.9__py3-none-any.whl → 3.1.10__py3-none-any.whl

anipy_cli/__init__.py

@@ -1,2 +1,2 @@
 __appname__ = "anipy-cli"
-__version__ = "3.1.9"
+__version__ = "3.1.10"

anipy_cli/arg_parser.py

@@ -23,6 +23,7 @@ class CliArgs:
     location: Optional[Path]
     mal_password: Optional[str]
     config: bool
+    seasonal_search: Optional[str]
 
 
 def parse_args(override_args: Optional[list[str]] = None) -> CliArgs:
@@ -107,6 +108,17 @@ def parse_args(override_args: Optional[list[str]] = None) -> CliArgs:
         help="Provide a search term to Default, Download or Binge mode in this format: {query}:{episode range}:{dub/sub}. Examples: 'frieren:1-10:sub' or 'frieren:1:sub' or 'frieren:1-3 7-12:dub', this argument may be appended to any of the modes mentioned like so: 'anipy-cli (-D/B) -s <search>'",
     )
 
+    options_group.add_argument(
+        "-ss",
+        "--seasonal-search",
+        required=False,
+        dest="seasonal_search",
+        nargs="?",  # 1 or none possible args
+        default=None,  # Used if flag is not present (added this line for clarity, because default is always None)
+        const=True,  # Used if flag is present, but no value
+        help="Provide search parameters for seasons to Default, Download, or Binge mode in this format: {year}:{season}. You can only use part of the season name if you wish. Examples: '2024:win' or '2020:fa'",
+    )
+
     options_group.add_argument(
         "-q",
         "--quality",

anipy_cli/clis/binge_cli.py

@@ -7,6 +7,7 @@ from anipy_cli.clis.base_cli import CliBase
 from anipy_cli.colors import colors, cprint
 from anipy_cli.config import Config
 from anipy_cli.prompts import (
+    parse_seasonal_search,
     pick_episode_range_prompt,
     search_show_prompt,
     lang_prompt,
@@ -34,6 +35,15 @@ class BingeCli(CliBase):
     def print_header(self):
         cprint(colors.GREEN, "***Binge Mode***")
 
+    def _get_anime_from_user(self):
+        if (ss := self.options.seasonal_search) is not None:
+            return parse_seasonal_search(
+                "binge",
+                ss,
+            )
+
+        return search_show_prompt("binge")
+
     def take_input(self):
         if self.options.search is not None:
             self.anime, self.lang, self.episodes = parse_auto_search(
@@ -41,7 +51,7 @@ class BingeCli(CliBase):
             )
             return
 
-        anime = search_show_prompt("binge")
+        anime = self._get_anime_from_user()
 
         if anime is None:
             sys.exit(0)

anipy_cli/clis/default_cli.py

@@ -11,6 +11,7 @@ from anipy_cli.prompts import (
     search_show_prompt,
     lang_prompt,
     parse_auto_search,
+    parse_seasonal_search,
 )
 from anipy_cli.util import (
     DotSpinner,
@@ -42,6 +43,15 @@ class DefaultCli(CliBase):
     def print_header(self):
         pass
 
+    def _get_anime_from_user(self):
+        if (ss := self.options.seasonal_search) is not None:
+            return parse_seasonal_search(
+                "default",
+                ss,
+            )
+
+        return search_show_prompt("default")
+
     def take_input(self):
         if self.options.search is not None:
             self.anime, self.lang, episodes = parse_auto_search(
@@ -50,7 +60,7 @@ class DefaultCli(CliBase):
             self.epsiode = episodes[0]
             return
 
-        anime = search_show_prompt("default")
+        anime = self._get_anime_from_user()
 
         if anime is None:
             return False

anipy_cli/clis/download_cli.py

@@ -6,6 +6,7 @@ from anipy_cli.clis.base_cli import CliBase
 from anipy_cli.colors import colors, cprint
 from anipy_cli.config import Config
 from anipy_cli.prompts import (
+    parse_seasonal_search,
     pick_episode_range_prompt,
     search_show_prompt,
     lang_prompt,
@@ -39,6 +40,15 @@ class DownloadCli(CliBase):
         cprint(colors.GREEN, "***Download Mode***")
         cprint(colors.GREEN, "Downloads are stored in: ", colors.END, str(self.dl_path))
 
+    def _get_anime_from_user(self):
+        if (ss := self.options.seasonal_search) is not None:
+            return parse_seasonal_search(
+                "download",
+                ss,
+            )
+
+        return search_show_prompt("download")
+
     def take_input(self):
         if self.options.search is not None:
             self.anime, self.lang, self.episodes = parse_auto_search(
@@ -46,7 +56,7 @@ class DownloadCli(CliBase):
             )
             return
 
-        anime = search_show_prompt("download")
+        anime = self._get_anime_from_user()
 
         if anime is None:
             return False

anipy_cli/config.py

@@ -358,6 +358,12 @@ class Config:
         """If this is set to true you will not be prompted to search in season."""
         return self._get_value("skip_season_search", False, bool)
 
+    @property
+    def assume_season_search(self) -> bool:
+        """If this is set to true, the system will assume you want to search in season.
+        If skip_season_search is true, this will be ignored)"""
+        return self._get_value("assume_season_search", False, bool)
+
     def _get_path_value(self, key: str, fallback: Path) -> Path:
         path = self._get_value(key, fallback, str)
         try:
@@ -385,21 +391,23 @@ class Config:
             if attribute.startswith("_"):
                 continue
 
-            if isinstance(value, property):
-                doc = inspect.getdoc(value)
-                if doc:
-                    # Add docstrings
-                    doc = Template(doc).safe_substitute(version=__version__)
-                    doc = "\n".join([f"# {line}" for line in doc.split("\n")])
-                    dump = dump + doc + "\n"
-
-                val = self.__getattribute__(attribute)
-                val = str(val) if isinstance(val, Path) else val
-                dump = (
-                    dump
-                    + yaml.dump({attribute: val}, indent=4, default_flow_style=False)
-                    + "\n"
-                )
+            if not isinstance(value, property):
+                continue
+
+            doc = inspect.getdoc(value)
+            if doc:
+                # Add docstrings
+                doc = Template(doc).safe_substitute(version=__version__)
+                doc = "\n".join([f"# {line}" for line in doc.split("\n")])
+                dump = dump + doc + "\n"
+
+            val = self.__getattribute__(attribute)
+            val = str(val) if isinstance(val, Path) else val
+            dump = (
+                dump
+                + yaml.dump({attribute: val}, indent=4, default_flow_style=False)
+                + "\n"
+            )
 
         self._config_file.write_text(dump)
 

anipy_cli/prompts.py

@@ -17,6 +17,7 @@ from anipy_cli.util import (
     get_prefered_providers,
     error,
     parse_episode_ranges,
+    convert_letter_to_season,
 )
 from anipy_cli.colors import colors
 from anipy_cli.config import Config
@@ -30,22 +31,9 @@ def search_show_prompt(
     mode: str, skip_season_search: bool = False
 ) -> Optional["Anime"]:
     if not (Config().skip_season_search or skip_season_search):
-        season_provider = None
-        for p in get_prefered_providers(mode):
-            if p.FILTER_CAPS & (
-                FilterCapabilities.SEASON
-                | FilterCapabilities.YEAR
-                | FilterCapabilities.NO_QUERY
-            ):
-                season_provider = p
-        if season_provider is not None:
-            should_search = inquirer.confirm("Do you want to search in season?", default=False).execute()  # type: ignore
-            if not should_search:
-                print(
-                    "Hint: you can set `skip_season_search` to `true` in the config to skip this prompt!"
-                )
-            else:
-                return season_search_prompt(season_provider)
+        anime = season_search_pre_prompt(mode)
+        if anime is not None:
+            return anime
 
     query = inquirer.text(  # type: ignore
         "Search Anime:",
@@ -88,41 +76,86 @@ def search_show_prompt(
     return anime
 
 
-def season_search_prompt(provider: "BaseProvider") -> Optional["Anime"]:
-    year = inquirer.number(  # type: ignore
-        message="Enter year:",
-        long_instruction="To skip this prompt press ctrl+z",
-        default=time.localtime().tm_year,
-        mandatory=False,
-    ).execute()
+def _get_season_provider(mode: str) -> Optional["BaseProvider"]:
+    season_provider = None
+    for p in get_prefered_providers(mode):
+        if p.FILTER_CAPS & (
+            FilterCapabilities.SEASON
+            | FilterCapabilities.YEAR
+            | FilterCapabilities.NO_QUERY
+        ):
+            season_provider = p
+    return season_provider
+
+
+def season_search_pre_prompt(
+    mode: str, year: Optional[int] = None, season: Optional[str] = None
+) -> Optional["Anime"]:
+    season_provider = _get_season_provider(mode)
+    assume_season_search = Config().assume_season_search
+
+    # If there is no proper season provider
+    if season_provider is None:
+        if not assume_season_search:
+            return
+        # If assume search was on, and there is no proper season provider
+        print(
+            f"`assume_season_search` was set to true, but the providers ({', '.join(Config().providers[mode])}) you have selected do not have seasonal capabilities"
+        )
+        return
+
+    if assume_season_search or (year and season):
+        return season_search_prompt(season_provider, year, season)
+
+    should_search = inquirer.confirm("Do you want to search in season?", default=False).execute()  # type: ignore
+
+    if should_search:
+        return season_search_prompt(season_provider)
+
+    print(
+        "Hint: you can set `skip_season_search` to `true` in the config to skip this prompt!"
+    )
+
+
+def season_search_prompt(
+    provider: "BaseProvider", year: Optional[int] = None, season: Optional[str] = None
+) -> Optional["Anime"]:
+    if year is None:
+        curr_year = time.localtime().tm_year
+        year = inquirer.number(  # type: ignore
+            message="Enter year:",
+            long_instruction="To skip this prompt press ctrl+z",
+            default=curr_year,
+            mandatory=False,
+        ).execute()
 
     if year is None:
         return
 
-    season = inquirer.select(  # type: ignore
-        message="Select Season:",
-        choices=["Winter", "Spring", "Summer", "Fall"],
-        instruction="The season selected by default is the current season.",
-        long_instruction="To skip this prompt press ctrl+z",
-        default=get_anime_season(time.localtime().tm_mon),
-        mandatory=False,
-    ).execute()
+    if season is None:
+        season = inquirer.select(  # type: ignore
+            message="Select Season:",
+            choices=["Winter", "Spring", "Summer", "Fall"],
+            instruction="The season selected by default is the current season.",
+            long_instruction="To skip this prompt press ctrl+z",
+            default=get_anime_season(time.localtime().tm_mon),
+            mandatory=False,
+        ).execute()
 
     if season is None:
         return
 
-    season = Season[season.upper()]
+    discovered_anime = get_anime_by_season(provider, year, Season[season.upper()])
 
-    filters = Filters(year=year, season=season)
-    results = [
-        Anime.from_search_result(provider, r)
-        for r in provider.get_search(query="", filters=filters)
-    ]
+    if not discovered_anime:
+        error(f"No anime found in {season} {year}")
+        return
 
     anime = inquirer.fuzzy(  # type: ignore
         message="Select Show:",
         choices=[
-            Choice(value=r, name=f"{n + 1}. {repr(r)}") for n, r in enumerate(results)
+            Choice(value=r, name=f"{n + 1}. {repr(r)}")
+            for n, r in enumerate(discovered_anime)
         ],
         long_instruction=(
             "\nS = Anime is available in sub\n"
@@ -136,6 +169,17 @@ def season_search_prompt(provider: "BaseProvider") -> Optional["Anime"]:
     return anime
 
 
+def get_anime_by_season(provider: "BaseProvider", year: int, season: Season):
+    with DotSpinner(
+        "Retrieving anime in ", colors.BLUE, f"{season.name} {year}", "..."
+    ):
+        filters = Filters(year=year, season=season)
+        return [
+            Anime.from_search_result(provider, r)
+            for r in provider.get_search(query="", filters=filters)
+        ]
+
+
 def pick_episode_prompt(
     anime: "Anime", lang: LanguageTypeEnum, instruction: str = ""
 ) -> Optional["Episode"]:
@@ -203,6 +247,47 @@ def lang_prompt(anime: "Anime") -> LanguageTypeEnum:
         return next(iter(anime.languages))
 
 
+def parse_seasonal_search(mode: str, passed: str | bool) -> Optional["Anime"]:
+    """
+    Takes the mode we are in, as well as the search parameters.
+    Asks the user to choose an anime.
+
+    `Mode`: The provider to use.
+    `Passed`: The search terms passed (ex: `year:season`) or True,
+    if True we'll ask the user for this information
+    """
+    if isinstance(passed, bool):
+        if not passed:
+            return
+
+        provider = _get_season_provider(mode)
+
+        if not provider:
+            error(
+                "No valid provider was found for season search in the current mode",
+                fatal=True,
+            )
+
+        return season_search_prompt(provider)
+
+    options = iter(passed.split(":"))
+    year = next(options, None)
+    season = next(options, None)
+
+    if (not year) or not year.isnumeric():
+        error("A year was either not provided, or was not a number", fatal=True)
+
+    if not season:
+        error("A season was not provided", fatal=True)
+
+    season = convert_letter_to_season(season)
+
+    if not season:
+        error("The given season was not a valid season", fatal=True)
+
+    return season_search_pre_prompt(mode, int(year), season)
+
+
 def parse_auto_search(
     mode: str, passed: str
 ) -> Tuple["Anime", LanguageTypeEnum, List["Episode"]]:

anipy_cli/util.py

@@ -182,6 +182,25 @@ def get_anime_season(month):
         return "Fall"
 
 
+def convert_letter_to_season(letter: str) -> Optional[str]:
+    """
+    Converts the beginning of the name of a season to that season name.
+
+    Ex:
+    ```
+    win -> Winter
+    su -> Summer
+    sp -> Spring
+    ```
+
+    Returns None if the letter does not correspond to a season
+    """
+    for season in ["Spring", "Summer", "Fall", "Winter"]:
+        if season.startswith(letter.capitalize()):
+            return season
+    return
+
+
 def migrate_locallist(file: Path) -> LocalListData:
     import json
     import re

{anipy_cli-3.1.9.dist-info → anipy_cli-3.1.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: anipy-cli
-Version: 3.1.9
+Version: 3.1.10
 Summary: Watch and Download anime from the comfort of your Terminal
 Home-page: https://sdaqo.github.io/anipy-cli
 License: GPL-3.0
@@ -14,7 +14,7 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Requires-Dist: anipy-api (>=3.1.9,<4.0.0)
+Requires-Dist: anipy-api (>=3.1.10,<4.0.0)
 Requires-Dist: appdirs (>=1.4.4,<2.0.0)
 Requires-Dist: inquirerpy (>=0.3.4,<0.4.0)
 Requires-Dist: pypresence (>=4.3.0,<5.0.0)

{anipy_cli-3.1.9.dist-info → anipy_cli-3.1.10.dist-info}/RECORD

@@ -1,16 +1,16 @@
-anipy_cli/__init__.py,sha256=VRAJFmcL_vqPQ-4cWly3a0ofKrKu8aVStq-AU9BG49k,48
-anipy_cli/arg_parser.py,sha256=6MdLjJANPh5u8QBvrmvsa1LREFT2yWY7BidhTETQep0,5402
+anipy_cli/__init__.py,sha256=40gJ2USi07bG9RFib1WnzE0QeSpDq-G7wK1iRR35250,49
+anipy_cli/arg_parser.py,sha256=Y_p5Sh7LR0yeqfhFVXkyAbZMjDR1-NIoY_TVuPwUnwk,6009
 anipy_cli/cli.py,sha256=Ah5BE-u_SjcuzU5dQ5cSHtUloVRApCWwTK5i49yQtH8,1922
 anipy_cli/clis/__init__.py,sha256=Y00uiPWiMvvRImxJMvfLA55BOkMUOrrx5vJUNvquNsY,411
 anipy_cli/clis/base_cli.py,sha256=xPr_J8hKs7LkDLvmK6zyL1ZTZRpyC2IuFss8KsaDstU,817
-anipy_cli/clis/binge_cli.py,sha256=eSvdOo_BRSb8-Xp48ZDcelqUBlDPdyQqu8OV0vc4szo,2281
-anipy_cli/clis/default_cli.py,sha256=yuHyDqTgnq84I522mUkY1An5c114qqIYW-Xbm1SsDl4,2806
-anipy_cli/clis/download_cli.py,sha256=y_8Txs6SSi60BvPCUcKDZg6zlN-w-eatM_O5ld0pzcQ,3187
+anipy_cli/clis/binge_cli.py,sha256=ioZ-V0WfGYBqETFkd8epGrT9dPHwsRJ1qvIdqf4waIs,2551
+anipy_cli/clis/default_cli.py,sha256=aJrJwtwdD7l-Z3dMjSHlvMvgTVnwA3_OXwS-9DZQIy8,3078
+anipy_cli/clis/download_cli.py,sha256=XO6_B2Sm2P_u34MOvvXungFZWBDPGaO937GxNidpvdE,3460
 anipy_cli/clis/history_cli.py,sha256=2ccv6BpQQpUhY4K-KM7lO9qxVLXBrmCY5lec6czipSE,2863
 anipy_cli/clis/mal_cli.py,sha256=_tSLgDUOa6GOZNyCncSSzaVj088y5GAKkHVRSndLLxk,2258
 anipy_cli/clis/seasonal_cli.py,sha256=GV2TQNm9UotG1cxfYbrFFgg7Jmy8SFa7w_GlFtPdRVE,616
 anipy_cli/colors.py,sha256=voXC7z1Fs9tHg4zzNTNMIrt9k-EVgJ3_xEf5KiW2xgo,916
-anipy_cli/config.py,sha256=RFYY388Hn62FxAem2X0E9vMVbO63nr4LB7481ZgfwFg,15698
+anipy_cli/config.py,sha256=R26KvF-mUDQ9uTqViHJn1gsrCk9TCj2ndVXW9jmQH9c,15955
 anipy_cli/discord.py,sha256=c6mdqnEdblzZBYs3cGP66oDeS4ySm59OfTRP-R-Duls,1160
 anipy_cli/mal_proxy.py,sha256=wIsku2_dl8vKD2K99L63OlzA3L5fl-VmyeiXC9VrxI4,6981
 anipy_cli/menus/__init__.py,sha256=aIzbphxAW-QGfZwR1DIegFZuTJp1O3tSUnai0f0f4lY,185
@@ -18,9 +18,9 @@ anipy_cli/menus/base_menu.py,sha256=g5b9Z7SpvCxcq_vqObcPzxLwcXeGPltLgSwa0sEzyfk,
 anipy_cli/menus/mal_menu.py,sha256=tJYq5J3k89_0BKFiWavn9Gqh5Z7uXtoUFqJaa3fT4o4,24105
 anipy_cli/menus/menu.py,sha256=UQJ1hpyDT0i03ecIjBbFRp4PFh6FTNHDhSwSBSAhQEI,7860
 anipy_cli/menus/seasonal_menu.py,sha256=Y64dRs554n-O51L5Cf-Jwtmdt2w1MM2XAErqBwsNgDM,9176
-anipy_cli/prompts.py,sha256=seNeErTP1om1wpRUN-rbUUI8bAGRmu48ScQjztzKkeE,7564
-anipy_cli/util.py,sha256=-WXc26vsdjuBsDaKAxezhBjupOdatAdu3MeRDRuTW64,7585
-anipy_cli-3.1.9.dist-info/METADATA,sha256=qcLQSqxDcjkftCNmp8d6ErviH2DWHXP0EXbFOglF5vY,3418
-anipy_cli-3.1.9.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-anipy_cli-3.1.9.dist-info/entry_points.txt,sha256=86iXpcm_ECFndrt0JAI2mqYfXC2Ar7mGi0iOaxCrNP0,51
-anipy_cli-3.1.9.dist-info/RECORD,,
+anipy_cli/prompts.py,sha256=lQDrb8IlhsQhOpLG4sflamprTSn-PlCy41tGpXIowdo,10156
+anipy_cli/util.py,sha256=YiiWaX8O-yxTT53kBA1wlTJesLudjeto6E3ZdtDMgAw,8022
+anipy_cli-3.1.10.dist-info/METADATA,sha256=O4nJywIMGn8nE3Tq4wQbZJ1_4chx-rpxonPX7rn21KE,3420
+anipy_cli-3.1.10.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+anipy_cli-3.1.10.dist-info/entry_points.txt,sha256=86iXpcm_ECFndrt0JAI2mqYfXC2Ar7mGi0iOaxCrNP0,51
+anipy_cli-3.1.10.dist-info/RECORD,,