flake8-llm-sunset 0.0.1__tar.gz

flake8_llm_sunset-0.0.1/PKG-INFO

@@ -0,0 +1,37 @@
+Metadata-Version: 2.4
+Name: flake8-llm-sunset
+Version: 0.0.1
+Summary: A flake8 plugin that warns about expiring LLM model IDs
+Author-email: nikkie <takuyafjp+develop@gmail.com>
+License: MIT License
+Project-URL: Repository, https://github.com/ftnext/llm-sunset-lint
+Keywords: flake8
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: flake8>=7
+Provides-Extra: test
+Requires-Dist: pytest>=9; extra == "test"
+
+# flake8-llm-sunset
+
+## Install
+
+```console
+$ uv tool install flake8 --with flake8-llm-sunset
+```
+
+## Usage
+
+```console
+% flake8 --select LLS examples/adk_example_fields_output_schema_agent.py
+examples/adk_example_fields_output_schema_agent.py:14:11: LLS001 Gemini model 'gemini-2.0-flash' was shut down on 2026-06-01
+```

flake8_llm_sunset-0.0.1/README.md

@@ -0,0 +1,14 @@
+# flake8-llm-sunset
+
+## Install
+
+```console
+$ uv tool install flake8 --with flake8-llm-sunset
+```
+
+## Usage
+
+```console
+% flake8 --select LLS examples/adk_example_fields_output_schema_agent.py
+examples/adk_example_fields_output_schema_agent.py:14:11: LLS001 Gemini model 'gemini-2.0-flash' was shut down on 2026-06-01
+```

flake8_llm_sunset-0.0.1/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["setuptools>=77.0.3"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "flake8-llm-sunset"
+version = "0.0.1"
+description = "A flake8 plugin that warns about expiring LLM model IDs"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT License" }
+authors = [{ name = "nikkie", email = "takuyafjp+develop@gmail.com" }]
+keywords = ["flake8"]
+classifiers = [
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+]
+dependencies = ["flake8>=7"]
+
+[project.urls]
+Repository = "https://github.com/ftnext/llm-sunset-lint"
+
+[project.entry-points."flake8.extension"]
+LLS = "flake8_llm_sunset:ModelExpiryChecker"
+
+[project.optional-dependencies]
+test = ["pytest>=9"]
+
+[tool.pytest]
+testpaths = ["tests"]

flake8_llm_sunset-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

flake8_llm_sunset-0.0.1/setup.py

@@ -0,0 +1,3 @@
+from setuptools import setup
+
+setup()

flake8_llm_sunset-0.0.1/src/flake8_llm_sunset/__init__.py

@@ -0,0 +1,3 @@
+from .checker import ModelExpiryChecker
+
+__all__ = ["ModelExpiryChecker"]

flake8_llm_sunset-0.0.1/src/flake8_llm_sunset/checker.py

@@ -0,0 +1,104 @@
+"""flake8 checker for model IDs with announced shutdown dates."""
+
+from __future__ import annotations
+
+import ast
+import calendar
+import re
+from datetime import date
+from typing import Iterator
+
+
+# Source: https://docs.cloud.google.com/gemini-enterprise-agent-platform/models/model-versions
+# Models whose retirement date has not been announced are omitted.
+GEMINI_SHUTDOWNS = {
+    "gemini-3.5-flash": date(2027, 5, 19),
+    "gemini-3.5-flash-lite": date(2027, 7, 21),
+    "gemini-3.1-flash-lite": date(2027, 5, 7),
+    "gemini-live-2.5-flash-native-audio": date(2026, 12, 13),
+    "gemini-2.5-pro": date(2026, 10, 16),
+    "gemini-2.5-flash": date(2026, 10, 16),
+    "gemini-2.5-flash-lite": date(2026, 10, 16),
+    "gemini-3.1-flash-image": date(2027, 5, 28),
+    "gemini-3-pro-image": date(2027, 5, 28),
+    "gemini-2.5-flash-image": date(2026, 10, 2),
+    "gemini-embedding-001": date(2028, 5, 20),
+    "gemini-2.0-flash": date(2026, 6, 1),
+    "gemini-2.0-flash-lite": date(2026, 6, 1),
+    "gemini-1.5-pro-001": date(2025, 5, 24),
+    "gemini-1.5-pro-002": date(2025, 9, 24),
+    "gemini-1.5-flash-001": date(2025, 5, 24),
+    "gemini-1.5-flash-002": date(2025, 9, 24),
+    "gemini-1.0-pro-001": date(2025, 4, 21),
+    "gemini-1.0-pro-002": date(2025, 4, 21),
+    "gemini-1.0-pro-vision-001": date(2025, 4, 21),
+}
+
+# Google Cloud publishes these as the earliest possible retirement dates ("on
+# or after"), rather than as fixed shutdown dates.
+GEMINI_EARLIEST_SHUTDOWNS = {
+    "gemini-3.5-flash",
+    "gemini-3.5-flash-lite",
+    "gemini-3.1-flash-lite",
+    "gemini-3.1-flash-image",
+    "gemini-3-pro-image",
+    "gemini-embedding-001",
+}
+
+_MODEL_IDS = sorted(GEMINI_SHUTDOWNS, key=len, reverse=True)
+_MODEL_ALTERNATIVES = "|".join(re.escape(model) for model in _MODEL_IDS)
+_MODEL_PATTERN = re.compile(
+    rf"(?<![A-Za-z0-9_.-])({_MODEL_ALTERNATIVES})(?![A-Za-z0-9_.-])"
+)
+
+
+def one_month_before(value: date) -> date:
+    """Subtract one calendar month, clamping to the target month's last day."""
+    year, month = value.year, value.month - 1
+    if month == 0:
+        year, month = year - 1, 12
+    day = min(value.day, calendar.monthrange(year, month)[1])
+    return date(year, month, day)
+
+
+class ModelExpiryChecker:
+    """Find expiring Gemini model IDs in Python string literals."""
+
+    name = "flake8-llm-sunset"
+    version = "0.0.1"
+    today = staticmethod(date.today)
+
+    def __init__(self, tree: ast.AST) -> None:
+        self.tree = tree
+
+    def run(
+        self,
+    ) -> Iterator[tuple[int, int, str, type["ModelExpiryChecker"]]]:
+        current_date = self.today()
+        for node in ast.walk(self.tree):
+            if not isinstance(node, ast.Constant) or not isinstance(node.value, str):
+                continue
+            for match in _MODEL_PATTERN.finditer(node.value):
+                model = match.group(1)
+                shutdown = GEMINI_SHUTDOWNS[model]
+                if current_date < one_month_before(shutdown):
+                    continue
+
+                if model in GEMINI_EARLIEST_SHUTDOWNS:
+                    status = f"may shut down on or after {shutdown.isoformat()}"
+                elif current_date >= shutdown:
+                    status = f"was shut down on {shutdown.isoformat()}"
+                else:
+                    days = (shutdown - current_date).days
+                    status = (
+                        f"shuts down on {shutdown.isoformat()} ({days} days remaining)"
+                    )
+
+                # col_offset points to the opening quote; the exact offset inside a
+                # string is deliberately not reconstructed from source spelling.
+                yield (
+                    node.lineno,
+                    node.col_offset,
+                    f"LLS001 Gemini model '{model}' {status}",
+                    type(self),
+                )

flake8_llm_sunset-0.0.1/src/flake8_llm_sunset.egg-info/PKG-INFO

@@ -0,0 +1,37 @@
+Metadata-Version: 2.4
+Name: flake8-llm-sunset
+Version: 0.0.1
+Summary: A flake8 plugin that warns about expiring LLM model IDs
+Author-email: nikkie <takuyafjp+develop@gmail.com>
+License: MIT License
+Project-URL: Repository, https://github.com/ftnext/llm-sunset-lint
+Keywords: flake8
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: flake8>=7
+Provides-Extra: test
+Requires-Dist: pytest>=9; extra == "test"
+
+# flake8-llm-sunset
+
+## Install
+
+```console
+$ uv tool install flake8 --with flake8-llm-sunset
+```
+
+## Usage
+
+```console
+% flake8 --select LLS examples/adk_example_fields_output_schema_agent.py
+examples/adk_example_fields_output_schema_agent.py:14:11: LLS001 Gemini model 'gemini-2.0-flash' was shut down on 2026-06-01
+```

flake8_llm_sunset-0.0.1/src/flake8_llm_sunset.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+README.md
+pyproject.toml
+setup.py
+src/flake8_llm_sunset/__init__.py
+src/flake8_llm_sunset/checker.py
+src/flake8_llm_sunset.egg-info/PKG-INFO
+src/flake8_llm_sunset.egg-info/SOURCES.txt
+src/flake8_llm_sunset.egg-info/dependency_links.txt
+src/flake8_llm_sunset.egg-info/entry_points.txt
+src/flake8_llm_sunset.egg-info/requires.txt
+src/flake8_llm_sunset.egg-info/top_level.txt
+tests/test_checker.py

flake8_llm_sunset-0.0.1/src/flake8_llm_sunset.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

flake8_llm_sunset-0.0.1/src/flake8_llm_sunset.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[flake8.extension]
+LLS = flake8_llm_sunset:ModelExpiryChecker

flake8_llm_sunset-0.0.1/src/flake8_llm_sunset.egg-info/requires.txt

@@ -0,0 +1,4 @@
+flake8>=7
+
+[test]
+pytest>=9

flake8_llm_sunset-0.0.1/src/flake8_llm_sunset.egg-info/top_level.txt

@@ -0,0 +1 @@
+flake8_llm_sunset

flake8_llm_sunset-0.0.1/tests/test_checker.py

@@ -0,0 +1,56 @@
+import ast
+from datetime import date
+
+from flake8_llm_sunset import ModelExpiryChecker
+
+
+def check(source: str, today: date):
+    checker = ModelExpiryChecker(ast.parse(source))
+    checker.today = lambda: today
+    return list(checker.run())
+
+
+def test_warns_one_calendar_month_before_shutdown():
+    errors = check('MODEL = "gemini-2.5-flash"', date(2026, 9, 16))
+
+    assert len(errors) == 1
+    assert errors[0][2] == (
+        "LLS001 Gemini model 'gemini-2.5-flash' shuts down on 2026-10-16 "
+        "(30 days remaining)"
+    )
+
+
+def test_does_not_warn_before_warning_window():
+    assert check('MODEL = "gemini-2.5-flash"', date(2026, 9, 15)) == []
+
+
+def test_warns_for_already_shutdown_model():
+    errors = check(
+        'client.models.generate_content(model="gemini-2.0-flash", contents="hi")',
+        date(2026, 7, 22),
+    )
+
+    assert "was shut down on 2026-06-01" in errors[0][2]
+
+
+def test_finds_model_inside_larger_string():
+    errors = check(
+        'URL = "https://example.test/models/gemini-3.1-flash-image:predict"',
+        date(2027, 5, 1),
+    )
+
+    assert len(errors) == 1
+
+
+def test_distinguishes_earliest_possible_shutdown_date():
+    errors = check('MODEL = "gemini-3.5-flash"', date(2027, 4, 19))
+
+    assert errors[0][2] == (
+        "LLS001 Gemini model 'gemini-3.5-flash' may shut down on or after "
+        "2027-05-19"
+    )
+
+
+def test_ignores_unknown_or_no_shutdown_date_model():
+    source = 'MODELS = ["gemini-3.6-flash", "gemini-something-new"]'
+    assert check(source, date(2030, 1, 1)) == []