gitstar 1.0.0__tar.gz → 1.1.0__tar.gz

gitstar-1.1.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Imran Pollob
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

gitstar-1.1.0/PKG-INFO

@@ -0,0 +1,146 @@
+Metadata-Version: 2.4
+Name: gitstar
+Version: 1.1.0
+Summary: Calculate the total stars earned by a GitHub user or organization
+Author-email: Imran Pollob <imranpollob@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/imranpollob/github-star-calculator
+Project-URL: Repository, https://github.com/imranpollob/github-star-calculator.git
+Project-URL: Issues, https://github.com/imranpollob/github-star-calculator/issues
+Keywords: github,stars,stargazers,cli,github-api,developer-tools
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+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
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Gitstar
+
+[![PyPI version](https://img.shields.io/pypi/v/gitstar.svg)](https://pypi.org/project/gitstar/)
+[![Python versions](https://img.shields.io/pypi/pyversions/gitstar.svg)](https://pypi.org/project/gitstar/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A fast, lightweight, zero-dependency command-line tool to calculate the total number of stars earned by any GitHub user or organization.
+
+---
+
+## Features
+
+- **Fast & Zero Dependencies**: Built entirely with Python's standard library. No external runtime dependencies.
+- **Cross-Platform**: Full support for Linux, macOS, and Windows (with safe terminal encoding fallbacks).
+- **Authentication & Rate-Limit Friendly**: Supports GitHub Personal Access Tokens (`--token` or `GITHUB_TOKEN` / `GH_TOKEN` environment variables) to bypass the unauthenticated 60 requests/hour limit.
+- **Informative Output**: Clean tabular layout ranking repositories by stars.
+
+---
+
+## Installation
+
+Install via pip:
+
+```bash
+pip install gitstar
+```
+
+Or upgrade to the latest version:
+
+```bash
+pip install --upgrade gitstar
+```
+
+---
+
+## Usage
+
+### Basic Usage
+
+Find the total stars for any GitHub user or organization:
+
+```bash
+gitstar <username>
+```
+
+Example:
+
+```bash
+gitstar torvalds
+```
+
+### Limiting Results
+
+Display only the top $N$ starred repositories:
+
+```bash
+# Using positional shorthand:
+gitstar torvalds 5
+
+# Or using the -l / --limit flag:
+gitstar torvalds --limit 5
+```
+
+### Output Example
+
+```text
+Total ⭐️ 234120
+https://github.com/torvalds/linux       ⭐️ 186400
+https://github.com/torvalds/subsurface  ⭐️ 3150
+https://github.com/torvalds/pesconvert  ⭐️ 285
+```
+
+---
+
+## Authentication & Rate Limits
+
+By default, unauthenticated GitHub API requests are limited to **60 requests per hour** per IP address.
+
+To increase your limit to **5,000 requests per hour**, provide a GitHub Personal Access Token using either:
+
+1. **Environment Variable** (recommended):
+   ```bash
+   export GITHUB_TOKEN="ghp_your_token_here"
+   gitstar torvalds
+   ```
+   *(On Windows PowerShell: `$env:GITHUB_TOKEN="ghp_your_token_here"`)*
+
+2. **CLI Option**:
+   ```bash
+   gitstar torvalds --token ghp_your_token_here
+   ```
+
+---
+
+## CLI Options Reference
+
+```text
+usage: gitstar [-h] [-l LIMIT] [-t TOKEN] [-v] [username] [limit]
+
+Calculate the total stars earned by a GitHub user or organization.
+
+positional arguments:
+  username           GitHub username or organization
+  limit              Number of top repositories to display (positional shorthand)
+
+options:
+  -h, --help         show this help message and exit
+  -l, --limit LIMIT  Number of top repositories to display
+  -t, --token TOKEN  GitHub Personal Access Token (defaults to GITHUB_TOKEN or GH_TOKEN)
+  -v, --version      show program's version number and exit
+```
+
+---
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).

gitstar-1.1.0/README.md

@@ -0,0 +1,117 @@
+# Gitstar
+
+[![PyPI version](https://img.shields.io/pypi/v/gitstar.svg)](https://pypi.org/project/gitstar/)
+[![Python versions](https://img.shields.io/pypi/pyversions/gitstar.svg)](https://pypi.org/project/gitstar/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A fast, lightweight, zero-dependency command-line tool to calculate the total number of stars earned by any GitHub user or organization.
+
+---
+
+## Features
+
+- **Fast & Zero Dependencies**: Built entirely with Python's standard library. No external runtime dependencies.
+- **Cross-Platform**: Full support for Linux, macOS, and Windows (with safe terminal encoding fallbacks).
+- **Authentication & Rate-Limit Friendly**: Supports GitHub Personal Access Tokens (`--token` or `GITHUB_TOKEN` / `GH_TOKEN` environment variables) to bypass the unauthenticated 60 requests/hour limit.
+- **Informative Output**: Clean tabular layout ranking repositories by stars.
+
+---
+
+## Installation
+
+Install via pip:
+
+```bash
+pip install gitstar
+```
+
+Or upgrade to the latest version:
+
+```bash
+pip install --upgrade gitstar
+```
+
+---
+
+## Usage
+
+### Basic Usage
+
+Find the total stars for any GitHub user or organization:
+
+```bash
+gitstar <username>
+```
+
+Example:
+
+```bash
+gitstar torvalds
+```
+
+### Limiting Results
+
+Display only the top $N$ starred repositories:
+
+```bash
+# Using positional shorthand:
+gitstar torvalds 5
+
+# Or using the -l / --limit flag:
+gitstar torvalds --limit 5
+```
+
+### Output Example
+
+```text
+Total ⭐️ 234120
+https://github.com/torvalds/linux       ⭐️ 186400
+https://github.com/torvalds/subsurface  ⭐️ 3150
+https://github.com/torvalds/pesconvert  ⭐️ 285
+```
+
+---
+
+## Authentication & Rate Limits
+
+By default, unauthenticated GitHub API requests are limited to **60 requests per hour** per IP address.
+
+To increase your limit to **5,000 requests per hour**, provide a GitHub Personal Access Token using either:
+
+1. **Environment Variable** (recommended):
+   ```bash
+   export GITHUB_TOKEN="ghp_your_token_here"
+   gitstar torvalds
+   ```
+   *(On Windows PowerShell: `$env:GITHUB_TOKEN="ghp_your_token_here"`)*
+
+2. **CLI Option**:
+   ```bash
+   gitstar torvalds --token ghp_your_token_here
+   ```
+
+---
+
+## CLI Options Reference
+
+```text
+usage: gitstar [-h] [-l LIMIT] [-t TOKEN] [-v] [username] [limit]
+
+Calculate the total stars earned by a GitHub user or organization.
+
+positional arguments:
+  username           GitHub username or organization
+  limit              Number of top repositories to display (positional shorthand)
+
+options:
+  -h, --help         show this help message and exit
+  -l, --limit LIMIT  Number of top repositories to display
+  -t, --token TOKEN  GitHub Personal Access Token (defaults to GITHUB_TOKEN or GH_TOKEN)
+  -v, --version      show program's version number and exit
+```
+
+---
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).

gitstar-1.1.0/gitstar/__init__.py

@@ -0,0 +1,7 @@
+"""gitstar - Calculate the total stars earned by a GitHub user or organization."""
+
+__version__ = "1.1.0"
+
+from .core import main
+
+__all__ = ["main", "__version__"]

gitstar-1.1.0/gitstar/__main__.py

@@ -0,0 +1,5 @@
+from .core import main
+
+if __name__ == "__main__":
+    main()
+

gitstar-1.1.0/gitstar/core.py

@@ -0,0 +1,217 @@
+import argparse
+import datetime
+import json
+import math
+import os
+import sys
+from urllib.error import HTTPError, URLError
+from urllib.parse import quote
+from urllib.request import Request, urlopen
+
+VERSION = "1.1.0"
+
+
+def configure_terminal_encoding():
+    """Ensure standard output streams handle UTF-8 without crashing on Windows."""
+    if sys.platform == "win32":
+        for stream in (sys.stdout, sys.stderr):
+            if hasattr(stream, "reconfigure"):
+                try:
+                    stream.reconfigure(encoding="utf-8", errors="replace")
+                except Exception:
+                    pass
+
+
+def get_star_symbol() -> str:
+    """Return a star symbol compatible with the current terminal encoding."""
+    for symbol in ("⭐️", "★", "*"):
+        try:
+            encoding = getattr(sys.stdout, "encoding", None) or "utf-8"
+            symbol.encode(encoding)
+            return symbol
+        except (UnicodeEncodeError, LookupError):
+            continue
+    return "*"
+
+
+def fetch(endpoint: str, token: str = None):
+    """Fetch JSON from GitHub API with proper headers, timeout, and error handling."""
+    url = f"https://api.github.com/{endpoint.lstrip('/')}"
+    headers = {
+        "Accept": "application/vnd.github.v3+json",
+        "User-Agent": f"gitstar/{VERSION}",
+    }
+    if token:
+        headers["Authorization"] = f"Bearer {token}"
+
+    request = Request(url, headers=headers)
+
+    try:
+        with urlopen(request, timeout=15) as response:
+            return json.loads(response.read().decode("utf-8"))
+    except HTTPError as e:
+        try:
+            e.close()
+        except Exception:
+            pass
+        if e.code == 404:
+            print(f"Error: GitHub user or organization not found.", file=sys.stderr)
+        elif e.code == 403:
+            reset_time = e.headers.get("x-ratelimit-reset")
+            if reset_time:
+                try:
+                    reset_dt = datetime.datetime.fromtimestamp(
+                        int(reset_time), tz=datetime.timezone.utc
+                    )
+                    reset_str = reset_dt.strftime("%Y-%m-%d %H:%M:%S UTC")
+                except Exception:
+                    reset_str = reset_time
+                print(
+                    f"Error: GitHub API rate limit exceeded.\n"
+                    f"Rate limit resets at: {reset_str}\n"
+                    f"Tip: Provide a GitHub token using --token or the GITHUB_TOKEN environment variable.",
+                    file=sys.stderr,
+                )
+            else:
+                print(
+                    f"Error: Access forbidden (HTTP 403).\n"
+                    f"Reason: {e.reason}\n"
+                    f"Tip: If you hit the rate limit, provide a GitHub token using --token or GITHUB_TOKEN.",
+                    file=sys.stderr,
+                )
+        elif e.code == 401:
+            print(
+                "Error: Unauthorized (HTTP 401). Please check your GitHub token.",
+                file=sys.stderr,
+            )
+        else:
+            print(f"Error: GitHub API request failed ({e.code} {e.reason}).", file=sys.stderr)
+        sys.exit(1)
+    except URLError as e:
+        print(
+            f"Error: Network connection failed ({e.reason}). Please check your internet connection.",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    except TimeoutError:
+        print("Error: Request timed out while connecting to GitHub.", file=sys.stderr)
+        sys.exit(1)
+
+
+def build_parser() -> argparse.ArgumentParser:
+    """Build command-line argument parser."""
+    parser = argparse.ArgumentParser(
+        prog="gitstar",
+        description="Calculate the total stars earned by a GitHub user or organization.",
+    )
+    parser.add_argument(
+        "username",
+        nargs="?",
+        default=None,
+        help="GitHub username or organization",
+    )
+    parser.add_argument(
+        "pos_limit",
+        nargs="?",
+        type=int,
+        default=None,
+        metavar="limit",
+        help="Number of top repositories to display (positional shorthand)",
+    )
+    parser.add_argument(
+        "-l",
+        "--limit",
+        type=int,
+        default=None,
+        help="Number of top repositories to display",
+    )
+    parser.add_argument(
+        "-t",
+        "--token",
+        type=str,
+        default=None,
+        help="GitHub Personal Access Token (defaults to GITHUB_TOKEN or GH_TOKEN environment variable)",
+    )
+    parser.add_argument(
+        "-v",
+        "--version",
+        action="version",
+        version=f"%(prog)s {VERSION}",
+    )
+    return parser
+
+
+def main(argv=None):
+    configure_terminal_encoding()
+    parser = build_parser()
+
+    if argv is None:
+        argv = sys.argv[1:]
+
+    # Show friendly help when invoked with no arguments
+    if len(argv) == 0:
+        parser.print_help()
+        sys.exit(0)
+
+    args = parser.parse_args(argv)
+
+    if not args.username:
+        parser.print_help()
+        sys.exit(0)
+
+    # Determine limit (flag has priority over positional shorthand)
+    limit = args.limit if args.limit is not None else args.pos_limit
+    if limit is not None and limit < 0:
+        parser.error("Limit must be a non-negative integer.")
+
+    # Determine token: CLI flag -> GITHUB_TOKEN -> GH_TOKEN
+    token = (
+        args.token
+        or os.environ.get("GITHUB_TOKEN")
+        or os.environ.get("GH_TOKEN")
+    )
+
+    username = args.username.strip()
+    user = fetch(f"users/{quote(username)}", token=token)
+
+    public_repos = user.get("public_repos", 0)
+    if not public_repos:
+        print(f"'{username}' does not have any public repositories.")
+        sys.exit(0)
+
+    pages = math.ceil(public_repos / 100)
+    total_stars = 0
+    repo_star_map = {}
+    highest_name = 0
+
+    for page in range(1, pages + 1):
+        repos = fetch(
+            f"users/{quote(username)}/repos?per_page=100&page={page}",
+            token=token,
+        )
+        if not repos:
+            break
+
+        for repo in repos:
+            repo_url = repo.get("html_url", repo.get("name", "unknown"))
+            stars = repo.get("stargazers_count", 0)
+            repo_star_map[repo_url] = stars
+            total_stars += stars
+            highest_name = max(highest_name, len(repo_url))
+
+    star_symbol = get_star_symbol()
+    print(f"Total {star_symbol} {total_stars}")
+
+    if limit != 0 and repo_star_map:
+        sorted_repos = sorted(
+            repo_star_map.items(), key=lambda x: x[1], reverse=True
+        )
+        if limit is not None:
+            sorted_repos = sorted_repos[:limit]
+
+        for repo, stars in sorted_repos:
+            print(f"{repo:<{highest_name}}  {star_symbol} {stars}")
+
+
+if __name__ == "__main__":
+    main()

gitstar-1.1.0/gitstar.egg-info/PKG-INFO

@@ -0,0 +1,146 @@
+Metadata-Version: 2.4
+Name: gitstar
+Version: 1.1.0
+Summary: Calculate the total stars earned by a GitHub user or organization
+Author-email: Imran Pollob <imranpollob@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/imranpollob/github-star-calculator
+Project-URL: Repository, https://github.com/imranpollob/github-star-calculator.git
+Project-URL: Issues, https://github.com/imranpollob/github-star-calculator/issues
+Keywords: github,stars,stargazers,cli,github-api,developer-tools
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+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
+Classifier: Topic :: Software Development :: Version Control :: Git
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Gitstar
+
+[![PyPI version](https://img.shields.io/pypi/v/gitstar.svg)](https://pypi.org/project/gitstar/)
+[![Python versions](https://img.shields.io/pypi/pyversions/gitstar.svg)](https://pypi.org/project/gitstar/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+A fast, lightweight, zero-dependency command-line tool to calculate the total number of stars earned by any GitHub user or organization.
+
+---
+
+## Features
+
+- **Fast & Zero Dependencies**: Built entirely with Python's standard library. No external runtime dependencies.
+- **Cross-Platform**: Full support for Linux, macOS, and Windows (with safe terminal encoding fallbacks).
+- **Authentication & Rate-Limit Friendly**: Supports GitHub Personal Access Tokens (`--token` or `GITHUB_TOKEN` / `GH_TOKEN` environment variables) to bypass the unauthenticated 60 requests/hour limit.
+- **Informative Output**: Clean tabular layout ranking repositories by stars.
+
+---
+
+## Installation
+
+Install via pip:
+
+```bash
+pip install gitstar
+```
+
+Or upgrade to the latest version:
+
+```bash
+pip install --upgrade gitstar
+```
+
+---
+
+## Usage
+
+### Basic Usage
+
+Find the total stars for any GitHub user or organization:
+
+```bash
+gitstar <username>
+```
+
+Example:
+
+```bash
+gitstar torvalds
+```
+
+### Limiting Results
+
+Display only the top $N$ starred repositories:
+
+```bash
+# Using positional shorthand:
+gitstar torvalds 5
+
+# Or using the -l / --limit flag:
+gitstar torvalds --limit 5
+```
+
+### Output Example
+
+```text
+Total ⭐️ 234120
+https://github.com/torvalds/linux       ⭐️ 186400
+https://github.com/torvalds/subsurface  ⭐️ 3150
+https://github.com/torvalds/pesconvert  ⭐️ 285
+```
+
+---
+
+## Authentication & Rate Limits
+
+By default, unauthenticated GitHub API requests are limited to **60 requests per hour** per IP address.
+
+To increase your limit to **5,000 requests per hour**, provide a GitHub Personal Access Token using either:
+
+1. **Environment Variable** (recommended):
+   ```bash
+   export GITHUB_TOKEN="ghp_your_token_here"
+   gitstar torvalds
+   ```
+   *(On Windows PowerShell: `$env:GITHUB_TOKEN="ghp_your_token_here"`)*
+
+2. **CLI Option**:
+   ```bash
+   gitstar torvalds --token ghp_your_token_here
+   ```
+
+---
+
+## CLI Options Reference
+
+```text
+usage: gitstar [-h] [-l LIMIT] [-t TOKEN] [-v] [username] [limit]
+
+Calculate the total stars earned by a GitHub user or organization.
+
+positional arguments:
+  username           GitHub username or organization
+  limit              Number of top repositories to display (positional shorthand)
+
+options:
+  -h, --help         show this help message and exit
+  -l, --limit LIMIT  Number of top repositories to display
+  -t, --token TOKEN  GitHub Personal Access Token (defaults to GITHUB_TOKEN or GH_TOKEN)
+  -v, --version      show program's version number and exit
+```
+
+---
+
+## License
+
+This project is licensed under the [MIT License](LICENSE).

{gitstar-1.0.0 → gitstar-1.1.0}/gitstar.egg-info/SOURCES.txt

@@ -1,10 +1,13 @@
+LICENSE
 README.md
 pyproject.toml
 setup.py
 gitstar/__init__.py
+gitstar/__main__.py
 gitstar/core.py
 gitstar.egg-info/PKG-INFO
 gitstar.egg-info/SOURCES.txt
 gitstar.egg-info/dependency_links.txt
 gitstar.egg-info/entry_points.txt
-gitstar.egg-info/top_level.txt
+gitstar.egg-info/top_level.txt
+tests/test_cli.py

gitstar-1.1.0/pyproject.toml

@@ -0,0 +1,43 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "gitstar"
+version = "1.1.0"
+description = "Calculate the total stars earned by a GitHub user or organization"
+readme = "README.md"
+license = "MIT"
+authors = [
+    { name = "Imran Pollob", email = "imranpollob@gmail.com" }
+]
+requires-python = ">=3.8"
+keywords = ["github", "stars", "stargazers", "cli", "github-api", "developer-tools"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "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",
+    "Topic :: Software Development :: Version Control :: Git",
+    "Topic :: Utilities",
+]
+
+[project.urls]
+Homepage = "https://github.com/imranpollob/github-star-calculator"
+Repository = "https://github.com/imranpollob/github-star-calculator.git"
+Issues = "https://github.com/imranpollob/github-star-calculator/issues"
+
+[project.scripts]
+gitstar = "gitstar.core:main"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["gitstar*"]

{gitstar-1.0.0 → gitstar-1.1.0}/setup.cfg

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

gitstar-1.1.0/setup.py

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

gitstar-1.1.0/tests/test_cli.py

@@ -0,0 +1,157 @@
+import io
+import sys
+import unittest
+from unittest.mock import MagicMock, patch
+from urllib.error import HTTPError, URLError
+
+from gitstar.core import (
+    VERSION,
+    build_parser,
+    fetch,
+    get_star_symbol,
+    main,
+)
+
+
+class TestGitstarCLI(unittest.TestCase):
+    def test_parser_basic(self):
+        parser = build_parser()
+        args = parser.parse_args(["octocat"])
+        self.assertEqual(args.username, "octocat")
+        self.assertIsNone(args.pos_limit)
+        self.assertIsNone(args.limit)
+        self.assertIsNone(args.token)
+
+    def test_parser_positional_limit(self):
+        parser = build_parser()
+        args = parser.parse_args(["octocat", "5"])
+        self.assertEqual(args.username, "octocat")
+        self.assertEqual(args.pos_limit, 5)
+
+    def test_parser_flag_limit(self):
+        parser = build_parser()
+        args = parser.parse_args(["octocat", "-l", "10"])
+        self.assertEqual(args.username, "octocat")
+        self.assertEqual(args.limit, 10)
+
+    def test_parser_token(self):
+        parser = build_parser()
+        args = parser.parse_args(["octocat", "--token", "ghp_secret"])
+        self.assertEqual(args.token, "ghp_secret")
+
+    def test_get_star_symbol(self):
+        symbol = get_star_symbol()
+        self.assertIn(symbol, ("⭐️", "★", "*"))
+
+    def test_main_no_args_shows_help(self):
+        with patch("sys.stdout", new_callable=io.StringIO) as mock_stdout:
+            with self.assertRaises(SystemExit) as cm:
+                main([])
+            self.assertEqual(cm.exception.code, 0)
+            self.assertIn("Calculate the total stars", mock_stdout.getvalue())
+
+    @patch("gitstar.core.fetch")
+    def test_main_success(self, mock_fetch):
+        # Mock user info and repos
+        mock_fetch.side_effect = [
+            {"public_repos": 2},
+            [
+                {"html_url": "https://github.com/test/repo1", "stargazers_count": 25},
+                {"html_url": "https://github.com/test/repo2", "stargazers_count": 10},
+            ],
+        ]
+
+        with patch("sys.stdout", new_callable=io.StringIO) as mock_stdout:
+            main(["testuser"])
+            output = mock_stdout.getvalue()
+            self.assertIn("Total", output)
+            self.assertIn("35", output)
+            self.assertIn("https://github.com/test/repo1", output)
+            self.assertIn("25", output)
+            self.assertIn("https://github.com/test/repo2", output)
+            self.assertIn("10", output)
+
+    @patch("gitstar.core.fetch")
+    def test_main_with_limit(self, mock_fetch):
+        mock_fetch.side_effect = [
+            {"public_repos": 3},
+            [
+                {"html_url": "https://github.com/test/repo1", "stargazers_count": 100},
+                {"html_url": "https://github.com/test/repo2", "stargazers_count": 50},
+                {"html_url": "https://github.com/test/repo3", "stargazers_count": 10},
+            ],
+        ]
+
+        with patch("sys.stdout", new_callable=io.StringIO) as mock_stdout:
+            main(["testuser", "1"])
+            output = mock_stdout.getvalue()
+            self.assertIn("Total", output)
+            self.assertIn("160", output)
+            self.assertIn("https://github.com/test/repo1", output)
+            self.assertNotIn("https://github.com/test/repo2", output)
+            self.assertNotIn("https://github.com/test/repo3", output)
+
+    @patch("gitstar.core.fetch")
+    def test_main_no_public_repos(self, mock_fetch):
+        mock_fetch.return_value = {"public_repos": 0}
+
+        with patch("sys.stdout", new_callable=io.StringIO) as mock_stdout:
+            with self.assertRaises(SystemExit) as cm:
+                main(["emptyuser"])
+            self.assertEqual(cm.exception.code, 0)
+            self.assertIn("does not have any public repositories", mock_stdout.getvalue())
+
+    @patch("gitstar.core.urlopen")
+    def test_fetch_user_not_found(self, mock_urlopen):
+        err = HTTPError(
+            url="https://api.github.com/users/nonexistent",
+            code=404,
+            msg="Not Found",
+            hdrs={},
+            fp=io.BytesIO(b"{}"),
+        )
+        mock_urlopen.side_effect = err
+
+        with patch("sys.stderr", new_callable=io.StringIO) as mock_stderr:
+            with self.assertRaises(SystemExit) as cm:
+                fetch("users/nonexistent")
+            self.assertEqual(cm.exception.code, 1)
+            self.assertIn("not found", mock_stderr.getvalue())
+
+    @patch("gitstar.core.urlopen")
+    def test_fetch_rate_limit_exceeded(self, mock_urlopen):
+        headers = {
+            "x-ratelimit-remaining": "0",
+            "x-ratelimit-reset": "1700000000",
+        }
+        err = HTTPError(
+            url="https://api.github.com/users/ratelimited",
+            code=403,
+            msg="Forbidden",
+            hdrs=headers,
+            fp=io.BytesIO(b"{}"),
+        )
+        mock_urlopen.side_effect = err
+
+        with patch("sys.stderr", new_callable=io.StringIO) as mock_stderr:
+            with self.assertRaises(SystemExit) as cm:
+                fetch("users/ratelimited")
+            self.assertEqual(cm.exception.code, 1)
+            stderr_val = mock_stderr.getvalue()
+            self.assertIn("rate limit exceeded", stderr_val)
+            self.assertIn("Tip:", stderr_val)
+
+    @patch("gitstar.core.urlopen")
+    def test_fetch_network_error(self, mock_urlopen):
+        mock_urlopen.side_effect = URLError("DNS lookup failed")
+
+        with patch("sys.stderr", new_callable=io.StringIO) as mock_stderr:
+            with self.assertRaises(SystemExit) as cm:
+                fetch("users/test")
+            self.assertEqual(cm.exception.code, 1)
+            self.assertIn("Network connection failed", mock_stderr.getvalue())
+
+
+if __name__ == "__main__":
+    unittest.main()
+

gitstar-1.0.0/PKG-INFO

@@ -1,60 +0,0 @@
-Metadata-Version: 2.4
-Name: gitstar
-Version: 1.0.0
-Summary: Find out the total star earned by a github user
-Home-page: https://github.com/imranpollob/gitstar
-Author: Imran Pollob
-Author-email: imranpollob@gmail.com
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.6
-Description-Content-Type: text/markdown
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: requires-python
-Dynamic: summary
-
-# Gitstar
-
-A command-line tool to calculate the total number of stars earned by a GitHub user.
-
-## Installation
-
-Install via pip:
-
-```bash
-pip install gitstar
-```
-
-## Usage
-
-Basic usage:
-
-```bash
-gitstar <username>
-```
-
-Limit the output to the top N repositories:
-
-```bash
-gitstar <username> <limit>
-```
-
-### Examples
-
-Get total stars for user `pollmix`:
-
-```bash
-gitstar pollmix
-```
-
-Get total stars and list top 5 repositories:
-
-```bash
-gitstar pollmix 5
-```

gitstar-1.0.0/README.md

@@ -1,39 +0,0 @@
-# Gitstar
-
-A command-line tool to calculate the total number of stars earned by a GitHub user.
-
-## Installation
-
-Install via pip:
-
-```bash
-pip install gitstar
-```
-
-## Usage
-
-Basic usage:
-
-```bash
-gitstar <username>
-```
-
-Limit the output to the top N repositories:
-
-```bash
-gitstar <username> <limit>
-```
-
-### Examples
-
-Get total stars for user `pollmix`:
-
-```bash
-gitstar pollmix
-```
-
-Get total stars and list top 5 repositories:
-
-```bash
-gitstar pollmix 5
-```

gitstar-1.0.0/gitstar/__init__.py

@@ -1 +0,0 @@
-from .core import main

gitstar-1.0.0/gitstar/core.py

@@ -1,77 +0,0 @@
-import json
-import math
-import sys
-from urllib.error import HTTPError
-from urllib.request import Request, urlopen
-
-
-def fetch(params):
-    url = "https://api.github.com/"
-    httprequest = Request(url + params, headers={"Accept": "application/json"})
-
-    try:
-        response = urlopen(httprequest)
-        return json.loads(response.read().decode())
-    except HTTPError as e:
-        print(e.reason)
-        exit()
-
-
-USAGE = """
-Find out the total star earned by a github user.
-
-Basic command:
-gitstar theusername
-
-Add printing limit:
-gitstar theusername 5
-"""
-
-
-def main():
-    # Debug print
-    # print(f"DEBUG: sys.argv = {sys.argv}", file=sys.stderr)
-    if len(sys.argv) == 1:
-        print(USAGE)
-        exit()
-
-    limit = None
-
-    if len(sys.argv) == 3:
-        try:
-            limit = int(sys.argv[2])
-        except ValueError:
-            print("Limit must be an integer")
-            exit()
-
-    username = sys.argv[1]
-
-    user = fetch(f"users/{username}")
-
-    if not user["public_repos"]:
-        print(f"{username} doesn't have any public repository.")
-        exit()
-
-    pages = math.ceil(user["public_repos"] / 100)
-    star = 0
-    highest_name = 0
-    repo_star_map = {}
-
-    for i in range(pages):
-        repos = fetch(f"users/{username}/repos?per_page=100&page={i+1}")
-
-        for repo in repos:
-            repo_star_map[repo["html_url"]] = repo["stargazers_count"]
-            star += repo["stargazers_count"]
-            highest_name = max(highest_name, len(repo["html_url"]))
-
-    print(f"Total ⭐️ {star}")
-
-    for repo, star in sorted(repo_star_map.items(), key=lambda x: x[1], reverse=True)[
-        :limit
-    ]:
-        print(f"{repo:-<{highest_name}} ⭐️ {star}")
-
-
-if __name__ == "__main__":
-    main()

gitstar-1.0.0/gitstar.egg-info/PKG-INFO

@@ -1,60 +0,0 @@
-Metadata-Version: 2.4
-Name: gitstar
-Version: 1.0.0
-Summary: Find out the total star earned by a github user
-Home-page: https://github.com/imranpollob/gitstar
-Author: Imran Pollob
-Author-email: imranpollob@gmail.com
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.6
-Description-Content-Type: text/markdown
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: requires-python
-Dynamic: summary
-
-# Gitstar
-
-A command-line tool to calculate the total number of stars earned by a GitHub user.
-
-## Installation
-
-Install via pip:
-
-```bash
-pip install gitstar
-```
-
-## Usage
-
-Basic usage:
-
-```bash
-gitstar <username>
-```
-
-Limit the output to the top N repositories:
-
-```bash
-gitstar <username> <limit>
-```
-
-### Examples
-
-Get total stars for user `pollmix`:
-
-```bash
-gitstar pollmix
-```
-
-Get total stars and list top 5 repositories:
-
-```bash
-gitstar pollmix 5
-```

gitstar-1.0.0/pyproject.toml

@@ -1,3 +0,0 @@
-[build-system]
-requires = ["setuptools>=42", "wheel"]
-build-backend = "setuptools.build_meta"

gitstar-1.0.0/setup.py

@@ -1,27 +0,0 @@
-from setuptools import setup, find_packages
-
-with open("README.md", "r", encoding="utf-8") as fh:
-    long_description = fh.read()
-
-setup(
-    name="gitstar",
-    version="1.0.0",
-    author="Imran Pollob",
-    author_email="imranpollob@gmail.com",
-    description="Find out the total star earned by a github user",
-    long_description=long_description,
-    long_description_content_type="text/markdown",
-    url="https://github.com/imranpollob/gitstar",
-    packages=find_packages(),
-    classifiers=[
-        "Programming Language :: Python :: 3",
-        "License :: OSI Approved :: MIT License",
-        "Operating System :: OS Independent",
-    ],
-    python_requires=">=3.6",
-    entry_points={
-        "console_scripts": [
-            "gitstar=gitstar.core:main",
-        ],
-    },
-)