greenmining 0.1.10__py3-none-any.whl → 0.1.12__py3-none-any.whl

greenmining/__init__.py

@@ -1,6 +1,7 @@
 """Green Microservices Mining - GSF Pattern Analysis Tool."""
 
 from greenmining.config import Config
+from greenmining.controllers.repository_controller import RepositoryController
 from greenmining.gsf_patterns import (
     GREEN_KEYWORDS,
     GSF_PATTERNS,
@@ -8,7 +9,46 @@ from greenmining.gsf_patterns import (
     is_green_aware,
 )
 
-__version__ = "0.1.10"
+__version__ = "0.1.12"
+
+
+def fetch_repositories(
+    github_token: str,
+    max_repos: int = 100,
+    min_stars: int = 100,
+    languages: list = None,
+    keywords: str = "microservices",
+):
+    """Fetch repositories from GitHub with custom search keywords.
+
+    Args:
+        github_token: GitHub personal access token
+        max_repos: Maximum number of repositories to fetch (default: 100)
+        min_stars: Minimum GitHub stars required (default: 100)
+        languages: List of programming languages to filter (default: ["Python", "Java", "Go", "JavaScript", "TypeScript"])
+        keywords: Search keywords (default: "microservices")
+
+    Returns:
+        List of Repository model instances
+
+    Example:
+        >>> from greenmining import fetch_repositories
+        >>> repos = fetch_repositories(
+        ...     github_token="your_token",
+        ...     max_repos=50,
+        ...     keywords="kubernetes cloud-native",
+        ...     min_stars=500
+        ... )
+        >>> print(f"Found {len(repos)} repositories")
+    """
+    config = Config()
+    config.GITHUB_TOKEN = github_token
+    controller = RepositoryController(config)
+
+    return controller.fetch_repositories(
+        max_repos=max_repos, min_stars=min_stars, languages=languages, keywords=keywords
+    )
+
 
 __all__ = [
     "Config",
@@ -16,5 +56,6 @@ __all__ = [
     "GREEN_KEYWORDS",
     "is_green_aware",
     "get_pattern_by_keywords",
+    "fetch_repositories",
     "__version__",
 ]

greenmining/cli.py

@@ -29,8 +29,14 @@ def cli(config_file, verbose):
 @click.option(
     "--languages", default="Python,Java,Go,JavaScript,TypeScript", help="Comma-separated languages"
 )
-def fetch(max_repos, min_stars, languages):
-    """Fetch top microservice repositories from GitHub."""
+@click.option(
+    "--keywords",
+    default="microservices",
+    type=str,
+    help="Search keywords (e.g., 'kubernetes', 'docker', 'cloud-native')",
+)
+def fetch(max_repos, min_stars, languages, keywords):
+    """Fetch repositories from GitHub based on custom search keywords."""
     presenter.show_banner()
     colored_print(f"\n🎯 Target: {max_repos} repositories\n", "cyan")
 
@@ -39,7 +45,7 @@ def fetch(max_repos, min_stars, languages):
 
     try:
         repositories = controller.fetch_repositories(
-            max_repos=max_repos, min_stars=min_stars, languages=lang_list
+            max_repos=max_repos, min_stars=min_stars, languages=lang_list, keywords=keywords
         )
 
         # Show results

greenmining/controllers/repository_controller.py

@@ -17,7 +17,11 @@ class RepositoryController:
         self.github = Github(config.GITHUB_TOKEN)
 
     def fetch_repositories(
-        self, max_repos: int = None, min_stars: int = None, languages: list[str] = None
+        self,
+        max_repos: int = None,
+        min_stars: int = None,
+        languages: list[str] = None,
+        keywords: str = None,
     ) -> list[Repository]:
         """Fetch repositories from GitHub.
 
@@ -25,6 +29,7 @@ class RepositoryController:
             max_repos: Maximum number of repositories to fetch
             min_stars: Minimum stars filter
             languages: List of programming languages to filter
+            keywords: Custom search keywords (default: "microservices")
 
         Returns:
             List of Repository model instances
@@ -32,12 +37,14 @@ class RepositoryController:
         max_repos = max_repos or self.config.MAX_REPOS
         min_stars = min_stars or self.config.MIN_STARS
         languages = languages or self.config.SUPPORTED_LANGUAGES
+        keywords = keywords or "microservices"
 
         colored_print(f"🔍 Fetching up to {max_repos} repositories...", "cyan")
+        colored_print(f"   Keywords: {keywords}", "cyan")
         colored_print(f"   Filters: min_stars={min_stars}", "cyan")
 
-        # Build search query - simpler approach
-        query = f"microservices stars:>={min_stars}"
+        # Build search query with custom keywords
+        query = f"{keywords} stars:>={min_stars}"
 
         try:
             # Execute search