github-growth-plotter 0.1.0__tar.gz → 0.1.1__tar.gz

{github_growth_plotter-0.1.0 → github_growth_plotter-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: github-growth-plotter
-Version: 0.1.0
+Version: 0.1.1
 Summary: A tool to fetch GitHub stargazers and plot growth over time.
 Author: Open Source Maintainers
 Classifier: Programming Language :: Python :: 3
@@ -28,10 +28,12 @@ Dynamic: summary
 
 <div align="center">
 
+<a href="https://github.com/ishandutta2007/Awesome-Awesome-Awesome"><img src="https://img.shields.io/badge/Awesome-%E2%9C%94-blueviolet?style=flat-square&logo=github" alt="Awesome"/></a><a href="https://discord.gg/jc4xtF58Ve"><img src="https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord" /></a>
 [![Python](https://img.shields.io/badge/Python-3.x-blue?style=for-the-badge&logo=python&logoColor=white)](https://python.org)
 [![GitHub CLI](https://img.shields.io/badge/GitHub%20CLI-Required-black?style=for-the-badge&logo=github&logoColor=white)](https://cli.github.com/)
 [![Matplotlib](https://img.shields.io/badge/Matplotlib-Supported-orange?style=for-the-badge)](https://matplotlib.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)
+<a href="https://github.com/ishandutta2007"><img alt="GitHub followers" src="https://img.shields.io/github/followers/ishandutta2007?label=Follow" /></a>
 
 </div>
 
@@ -83,9 +85,15 @@ github-growth-plot --publish
 ```
 This automatically appends the following HTML snippet to the bottom of your `README.md`:
 ```html
-<p align="center">
-  <img src="./assets/<username>_<reponame>_growth.svg" alt="<owner>/<repo>" width="100%" />
-</p>
+## Star History
+
+<a href="https://star-history.com/#<username>/<reponame>&Timeline" align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="assets/<username>_<reponame>_growth.svg">
+    <img alt="Star History Chart" src="assets/<username>_<reponame>_growth.svg">
+  </picture>
+</a>
+
 ```
 
 ## 📂 Generated Files
@@ -95,6 +103,16 @@ When executed, the script generates and manages the following files:
 - 📄 **`<username>_<reponame>_stargazers.csv`**: Raw historical star data (automatically ignored via `.gitignore`).
 - 🙈 **`.gitignore`**: Updated automatically to ignore the generated CSV file.
 
+## Star History
+
+<a href="https://star-history.com/#ishandutta2007/add-github-growth-plot&Timeline" align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="assets/ishandutta2007_add-github-growth-plot_growth.svg">
+    <img alt="Star History Chart" src="assets/ishandutta2007_add-github-growth-plot_growth.svg">
+  </picture>
+</a>
+
+
 ---
 *Made with ❤️ for Open Source Maintainers.*
 

{github_growth_plotter-0.1.0 → github_growth_plotter-0.1.1}/README.md

@@ -6,10 +6,12 @@
 
 <div align="center">
 
+<a href="https://github.com/ishandutta2007/Awesome-Awesome-Awesome"><img src="https://img.shields.io/badge/Awesome-%E2%9C%94-blueviolet?style=flat-square&logo=github" alt="Awesome"/></a><a href="https://discord.gg/jc4xtF58Ve"><img src="https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord" /></a>
 [![Python](https://img.shields.io/badge/Python-3.x-blue?style=for-the-badge&logo=python&logoColor=white)](https://python.org)
 [![GitHub CLI](https://img.shields.io/badge/GitHub%20CLI-Required-black?style=for-the-badge&logo=github&logoColor=white)](https://cli.github.com/)
 [![Matplotlib](https://img.shields.io/badge/Matplotlib-Supported-orange?style=for-the-badge)](https://matplotlib.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)
+<a href="https://github.com/ishandutta2007"><img alt="GitHub followers" src="https://img.shields.io/github/followers/ishandutta2007?label=Follow" /></a>
 
 </div>
 
@@ -61,9 +63,15 @@ github-growth-plot --publish
 ```
 This automatically appends the following HTML snippet to the bottom of your `README.md`:
 ```html
-<p align="center">
-  <img src="./assets/<username>_<reponame>_growth.svg" alt="<owner>/<repo>" width="100%" />
-</p>
+## Star History
+
+<a href="https://star-history.com/#<username>/<reponame>&Timeline" align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="assets/<username>_<reponame>_growth.svg">
+    <img alt="Star History Chart" src="assets/<username>_<reponame>_growth.svg">
+  </picture>
+</a>
+
 ```
 
 ## 📂 Generated Files
@@ -73,6 +81,16 @@ When executed, the script generates and manages the following files:
 - 📄 **`<username>_<reponame>_stargazers.csv`**: Raw historical star data (automatically ignored via `.gitignore`).
 - 🙈 **`.gitignore`**: Updated automatically to ignore the generated CSV file.
 
+## Star History
+
+<a href="https://star-history.com/#ishandutta2007/add-github-growth-plot&Timeline" align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="assets/ishandutta2007_add-github-growth-plot_growth.svg">
+    <img alt="Star History Chart" src="assets/ishandutta2007_add-github-growth-plot_growth.svg">
+  </picture>
+</a>
+
+
 ---
 *Made with ❤️ for Open Source Maintainers.*
 

{github_growth_plotter-0.1.0 → github_growth_plotter-0.1.1}/github_growth_plotter/__init__.py

@@ -1,2 +1,2 @@
 # GitHub Growth Plotter
-__version__ = "0.1.0"
+__version__ = "0.1.1"

{github_growth_plotter-0.1.0 → github_growth_plotter-0.1.1}/github_growth_plotter/cli.py

@@ -4,9 +4,10 @@ import requests
 import csv
 import os
 import sys
-from datetime import datetime
+from datetime import datetime, timedelta
 import matplotlib.pyplot as plt
 import matplotlib.dates as mdates
+from matplotlib.ticker import MaxNLocator
 
 def get_github_token():
     try:
@@ -74,9 +75,12 @@ def fetch_stargazers(repo, token):
             break
             
         for item in data:
+            user = item["user"]["login"]
+            starred_at = item["starred_at"]
+            print(f"  ⭐ Found star: {user} at {starred_at}")
             stargazers.append({
-                "user": item["user"]["login"],
-                "starred_at": item["starred_at"]
+                "user": user,
+                "starred_at": starred_at
             })
             
         if "next" not in response.links:
@@ -93,24 +97,97 @@ def save_to_csv(stargazers, filename):
             writer.writerow(stargazer)
     print(f"Saved {len(stargazers)} stargazers to {filename}")
 
+def parse_date(date_str):
+    try:
+        return datetime.strptime(date_str, "%Y-%m-%dT%H:%M:%SZ")
+    except ValueError:
+        try:
+            return datetime.fromisoformat(date_str.replace('Z', '+00:00'))
+        except Exception:
+            return datetime.strptime(date_str[:19], "%Y-%m-%dT%H:%M:%S")
+
 def plot_growth(stargazers, filename, repo):
-    dates = [datetime.strptime(s["starred_at"], "%Y-%m-%dT%H:%M:%SZ") for s in stargazers]
-    dates.sort()
-    
+    parsed = []
+    print(f"\n--- Stargazer Dates (Total: {len(stargazers)}) ---")
+    for s in stargazers:
+        d = parse_date(s["starred_at"])
+        parsed.append((d, s["user"], s["starred_at"]))
+        print(f"User: {s['user']} | Starred At: {s['starred_at']} -> Parsed: {d.strftime('%Y-%m-%d %H:%M:%S UTC')}")
+    print("--------------------------------------------------\n")
+
+    parsed.sort(key=lambda x: x[0])
+    dates = [p[0] for p in parsed]
     counts = list(range(1, len(dates) + 1))
     
+    # Extend plot to today's date so the curve reflects current star count up to today
+    now = datetime.now()
+    if dates and now > dates[-1]:
+        dates.append(now)
+        counts.append(counts[-1])
+    
     plt.figure(figsize=(10, 6))
     plt.plot(dates, counts, marker='', linestyle='-', color='b')
     
-    plt.title(f"Stargazers Growth for {repo}")
-    plt.xlabel("Date")
-    plt.ylabel("Number of Stargazers")
+    vintage_fonts = 'Georgia'
+    cursive_fonts = 'Segoe Script'
+    
+    plt.title("Star history", fontfamily=vintage_fonts, fontsize=16)
+    
+    time_span = dates[-1] - dates[0] if len(dates) > 1 else timedelta(0)
+    span_days = time_span.days
+    total_seconds = time_span.total_seconds()
+        
+    if span_days >= 730:  # 2+ years
+        interval = max(1, int(span_days / 365 / 6))
+        locator = mdates.YearLocator(base=interval)
+        xlabel_text = "Years"
+        fmt = "%Y"
+    elif span_days >= 60:  # 2+ months
+        interval = max(1, int(span_days / 30 / 6))
+        locator = mdates.MonthLocator(interval=interval)
+        xlabel_text = "Months"
+        fmt = "%b, %Y"
+    elif span_days >= 14:  # 2+ weeks
+        interval = max(1, int(span_days / 7 / 6))
+        locator = mdates.WeekdayLocator(interval=interval)
+        xlabel_text = "Weeks"
+        fmt = "Week %W, %Y"
+    elif span_days >= 2:  # 2+ days
+        interval = max(1, int(span_days / 6))
+        locator = mdates.DayLocator(interval=interval)
+        xlabel_text = "Day with month"
+        fmt = "%b %d"
+    elif total_seconds >= 3600:  # Within 1-2 days, span across hours
+        interval = max(1, int(total_seconds / 3600 / 6))
+        locator = mdates.HourLocator(interval=interval)
+        xlabel_text = f"Time ({dates[0].strftime('%b %d, %Y')})" if dates[0].date() == dates[-1].date() else "Date & Time"
+        fmt = "%H:%M" if dates[0].date() == dates[-1].date() else "%b %d %H:%M"
+    else:  # Very short time or same minute
+        locator = mdates.AutoDateLocator()
+        xlabel_text = f"Time ({dates[0].strftime('%b %d, %Y')})"
+        fmt = "%H:%M:%S"
+        
+    plt.xlabel(xlabel_text, fontfamily=cursive_fonts, fontsize=12)
+    plt.ylabel("Github Stars", fontfamily=cursive_fonts, fontsize=12)
+    
+    # Ensure Y-axis only uses integer counts
+    plt.gca().yaxis.set_major_locator(MaxNLocator(integer=True))
     
     # Format the x-axis to show dates nicely
-    plt.gca().xaxis.set_major_formatter(mdates.DateFormatter('%Y-%m-%d'))
-    plt.gca().xaxis.set_major_locator(mdates.AutoDateLocator())
+    plt.gca().xaxis.set_major_formatter(mdates.DateFormatter(fmt))
+    plt.gca().xaxis.set_major_locator(locator)
     plt.gcf().autofmt_xdate()
     
+    # Set font for tick labels
+    for label in plt.gca().get_xticklabels() + plt.gca().get_yticklabels():
+        label.set_fontfamily(cursive_fonts)
+    
+    # Add repo name to top left (which is usually empty in cumulative growth plots)
+    plt.text(0.05, 0.95, repo, transform=plt.gca().transAxes, 
+             fontsize=14, fontfamily=cursive_fonts, 
+             verticalalignment='top', horizontalalignment='left',
+             bbox=dict(facecolor='white', alpha=0.8, edgecolor='none'))
+    
     plt.grid(True)
     plt.tight_layout()
     plt.savefig(filename)
@@ -134,9 +211,17 @@ def update_gitignore(filename):
 def publish_to_readme(plot_filename, repo):
     readme_path = "README.md"
     basename = os.path.basename(plot_filename)
-    img_path = f"./assets/{basename}"
+    img_path = f"assets/{basename}"
     
-    html_snippet = f'\n<p align="center">\n  <img src="{img_path}" alt="{repo}" width="100%" />\n</p>\n'
+    html_snippet = (
+        f'\n## Star History\n\n'
+        f'<a href="https://star-history.com/#{repo}&Timeline" align="center">\n'
+        f'  <picture>\n'
+        f'    <source media="(prefers-color-scheme: dark)" srcset="{img_path}">\n'
+        f'    <img alt="Star History Chart" src="{img_path}">\n'
+        f'  </picture>\n'
+        f'</a>\n'
+    )
     
     if os.path.exists(readme_path):
         with open(readme_path, 'r', encoding='utf-8') as f:

{github_growth_plotter-0.1.0 → github_growth_plotter-0.1.1}/github_growth_plotter.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: github-growth-plotter
-Version: 0.1.0
+Version: 0.1.1
 Summary: A tool to fetch GitHub stargazers and plot growth over time.
 Author: Open Source Maintainers
 Classifier: Programming Language :: Python :: 3
@@ -28,10 +28,12 @@ Dynamic: summary
 
 <div align="center">
 
+<a href="https://github.com/ishandutta2007/Awesome-Awesome-Awesome"><img src="https://img.shields.io/badge/Awesome-%E2%9C%94-blueviolet?style=flat-square&logo=github" alt="Awesome"/></a><a href="https://discord.gg/jc4xtF58Ve"><img src="https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord" /></a>
 [![Python](https://img.shields.io/badge/Python-3.x-blue?style=for-the-badge&logo=python&logoColor=white)](https://python.org)
 [![GitHub CLI](https://img.shields.io/badge/GitHub%20CLI-Required-black?style=for-the-badge&logo=github&logoColor=white)](https://cli.github.com/)
 [![Matplotlib](https://img.shields.io/badge/Matplotlib-Supported-orange?style=for-the-badge)](https://matplotlib.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)
+<a href="https://github.com/ishandutta2007"><img alt="GitHub followers" src="https://img.shields.io/github/followers/ishandutta2007?label=Follow" /></a>
 
 </div>
 
@@ -83,9 +85,15 @@ github-growth-plot --publish
 ```
 This automatically appends the following HTML snippet to the bottom of your `README.md`:
 ```html
-<p align="center">
-  <img src="./assets/<username>_<reponame>_growth.svg" alt="<owner>/<repo>" width="100%" />
-</p>
+## Star History
+
+<a href="https://star-history.com/#<username>/<reponame>&Timeline" align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="assets/<username>_<reponame>_growth.svg">
+    <img alt="Star History Chart" src="assets/<username>_<reponame>_growth.svg">
+  </picture>
+</a>
+
 ```
 
 ## 📂 Generated Files
@@ -95,6 +103,16 @@ When executed, the script generates and manages the following files:
 - 📄 **`<username>_<reponame>_stargazers.csv`**: Raw historical star data (automatically ignored via `.gitignore`).
 - 🙈 **`.gitignore`**: Updated automatically to ignore the generated CSV file.
 
+## Star History
+
+<a href="https://star-history.com/#ishandutta2007/add-github-growth-plot&Timeline" align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="assets/ishandutta2007_add-github-growth-plot_growth.svg">
+    <img alt="Star History Chart" src="assets/ishandutta2007_add-github-growth-plot_growth.svg">
+  </picture>
+</a>
+
+
 ---
 *Made with ❤️ for Open Source Maintainers.*
 

{github_growth_plotter-0.1.0 → github_growth_plotter-0.1.1}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
 
 setup(
     name="github-growth-plotter",
-    version="0.1.0",
+    version="0.1.1",
     author="Open Source Maintainers",
     description="A tool to fetch GitHub stargazers and plot growth over time.",
     long_description=long_description,