Add monthly featured developer showcase (#187)

* Add monthly featured developer showcase

- Add engagement scoring algorithm (followers, stars, repos, sponsors, activity)
- Auto-select top user each month based on calculated score
- Add featured user section with gradient banner in layout
- Display avatar, stats, location, and top languages
- Responsive design for mobile/tablet/desktop
- Add generate_featured.py to regenerate featured user on demand
- Generate featured.json with sindresorhus as first featured developer

* Fix DeepSource issues: remove console calls and fix logging f-strings

- Remove console.log and console.error from loadFeaturedUser (JS-0002)
- Convert all logging f-strings to parameter substitution (PYL-W1203)
- Featured user loading now fails silently if not available

* Fix final logging f-string in select_featured_user

* Address Gemini code review feedback

- Refactored loadFeaturedUser() into smaller, focused functions:
  - renderFeaturedUser() for DOM updates
  - getFeaturedUserElements() for element retrieval
  - updateFeaturedAvatar(), updateFeaturedInfo(), updateFeaturedStats(), updateFeaturedLanguages() for specific updates
- Moved datetime imports to top of file (PEP 8)
- Created constants for engagement score weights and thresholds
- Fixed DRY violation in generate_featured.py by importing save_featured_user
- Changed broad Exception to specific (IOError, OSError)
- Added final newline to featured.json output

All code quality improvements address Gemini bot's code review on PR #187.

* Fix Python linting issues

- Remove duplicate return statement (PYL-W0101)
- Use OSError instead of overlapping (IOError, OSError) (PYL-W0714)

* Apply black and isort formatting

---------

Co-authored-by: John Bampton <jbampton@users.noreply.github.com>

Author: Aashish-Jha-11

docs/featured.json

@@ -0,0 +1 @@
+{"user":{"login":"sindresorhus","id":170270,"node_id":"MDQ6VXNlcjE3MDI3MA==","avatar_url":"https://avatars.githubusercontent.com/u/170270?v=4","gravatar_id":"","url":"https://api.github.com/users/sindresorhus","html_url":"https://github.com/sindresorhus","followers_url":"https://api.github.com/users/sindresorhus/followers","following_url":"https://api.github.com/users/sindresorhus/following{/other_user}","gists_url":"https://api.github.com/users/sindresorhus/gists{/gist_id}","starred_url":"https://api.github.com/users/sindresorhus/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/sindresorhus/subscriptions","organizations_url":"https://api.github.com/users/sindresorhus/orgs","repos_url":"https://api.github.com/users/sindresorhus/repos","events_url":"https://api.github.com/users/sindresorhus/events{/privacy}","received_events_url":"https://api.github.com/users/sindresorhus/received_events","type":"User","user_view_type":"public","site_admin":false,"score":1.0,"followers":76521,"following":31,"location":null,"name":"Sindre Sorhus","public_repos":1129,"public_gists":99,"sponsors_count":202,"sponsoring_count":13,"avatar_updated_at":"2025-12-20T02:20:38Z","followers_previous":null,"followers_growth_pct":null,"followers_snapshot_at":1766716761,"top_languages":[{"name":"JavaScript","bytes":5377121,"percent":55.4},{"name":"TypeScript","bytes":2702401,"percent":27.8},{"name":"Swift","bytes":1017726,"percent":10.5},{"name":"Rust","bytes":172395,"percent":1.8},{"name":"CSS","bytes":139381,"percent":1.4}],"total_stars":867226,"last_repo_pushed_at":"2025-12-25T18:17:03Z","last_public_commit_at":"2025-12-25T18:24:07Z"},"selected_at":"2025-12-26T07:20:25.156359","month":"December 2025"}

docs/script.js

@@ -43,7 +43,7 @@ document.addEventListener('DOMContentLoaded', initializeApp);
 async function initializeApp() {
   showLoadingState();
   setupEventListeners();
-  await fetchAndPrepareUsers();
+  await Promise.all([fetchAndPrepareUsers(), loadFeaturedUser()]);
 
   // Do these if data is loaded
   if (isDataLoaded) {
@@ -164,6 +164,110 @@ async function fetchAndPrepareUsers() {
   }
 }
 
+/**
+ * Load and display the featured user of the month
+ */
+async function loadFeaturedUser() {
+  try {
+    const res = await fetch('featured.json', { cache: 'no-store' });
+    if (!res.ok) {
+      return;
+    }
+    const data = await res.json();
+    if (data?.user?.login) {
+      renderFeaturedUser(data.user);
+    }
+  } catch (err) {
+    // Silently fail - featured user is optional
+  }
+}
+
+/**
+ * Render featured user to DOM
+ */
+function renderFeaturedUser(user) {
+  const elements = getFeaturedUserElements();
+  if (!elements.section) return;
+
+  updateFeaturedAvatar(elements, user);
+  updateFeaturedInfo(elements, user);
+  updateFeaturedStats(elements, user);
+  updateFeaturedLanguages(elements, user);
+
+  elements.section.style.display = 'block';
+}
+
+/**
+ * Get all featured user DOM elements
+ */
+function getFeaturedUserElements() {
+  return {
+    section: document.getElementById('featuredUserSection'),
+    avatar: document.getElementById('featuredUserAvatar'),
+    link: document.getElementById('featuredUserLink'),
+    name: document.getElementById('featuredUserName'),
+    loginLink: document.getElementById('featuredUserLoginLink'),
+    location: document.getElementById('featuredUserLocation'),
+    followers: document.getElementById('featuredUserFollowers'),
+    stars: document.getElementById('featuredUserStars'),
+    repos: document.getElementById('featuredUserRepos'),
+    sponsors: document.getElementById('featuredUserSponsors'),
+    languages: document.getElementById('featuredUserLanguages'),
+  };
+}
+
+/**
+ * Update featured user avatar and links
+ */
+function updateFeaturedAvatar(elements, user) {
+  const avatarUrl = `images/faces/${user.login.toLowerCase()}.png`;
+  elements.avatar.src = avatarUrl;
+  elements.avatar.alt = `${user.login}'s avatar`;
+  elements.link.href = user.html_url;
+  elements.loginLink.href = user.html_url;
+  elements.loginLink.textContent = `@${user.login}`;
+}
+
+/**
+ * Update featured user info (name and location)
+ */
+function updateFeaturedInfo(elements, user) {
+  elements.name.textContent = user.name || user.login;
+
+  if (user.location) {
+    elements.location.querySelector('.location-text').textContent =
+      user.location;
+    elements.location.style.display = 'flex';
+  } else {
+    elements.location.style.display = 'none';
+  }
+}
+
+/**
+ * Update featured user stats
+ */
+function updateFeaturedStats(elements, user) {
+  elements.followers.textContent = formatDisplay(user.followers);
+  elements.stars.textContent = formatDisplay(user.total_stars);
+  elements.repos.textContent = formatDisplay(user.public_repos);
+  elements.sponsors.textContent = formatDisplay(user.sponsors_count);
+}
+
+/**
+ * Update featured user languages
+ */
+function updateFeaturedLanguages(elements, user) {
+  elements.languages.innerHTML = '';
+  if (Array.isArray(user.top_languages) && user.top_languages.length > 0) {
+    user.top_languages.slice(0, 5).forEach((lang) => {
+      const badge = document.createElement('div');
+      badge.className = 'featured-language-badge';
+      badge.textContent = lang.name;
+      elements.languages.appendChild(badge);
+    });
+  }
+}
+
 function prepareUserFromJson(user) {
   const getNum = (v, def = 0) =>
     v === 'N/A' || v == null ? def : parseInt(v, 10);

docs/styles.css

@@ -380,6 +380,193 @@ h1 {
   padding-right: 20px;
 }
 
+/* ============================================================================ */
+/* FEATURED USER SECTION */
+/* ============================================================================ */
+.featured-user-section {
+  background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+  border-radius: 16px;
+  padding: 32px;
+  margin: 20px auto;
+  max-width: 1000px;
+  box-shadow: 0 10px 30px rgba(0, 0, 0, 0.2);
+  position: relative;
+  overflow: hidden;
+}
+
+.featured-user-section::before {
+  content: '';
+  position: absolute;
+  top: -50%;
+  right: -50%;
+  width: 200%;
+  height: 200%;
+  background: radial-gradient(circle, rgba(255, 255, 255, 0.1) 0%, transparent 70%);
+  animation: pulse 15s ease-in-out infinite;
+}
+
+@keyframes pulse {
+  0%, 100% {
+    transform: scale(1);
+    opacity: 0.5;
+  }
+  50% {
+    transform: scale(1.1);
+    opacity: 0.3;
+  }
+}
+
+.featured-badge {
+  display: inline-block;
+  background: rgba(255, 255, 255, 0.2);
+  backdrop-filter: blur(10px);
+  padding: 8px 20px;
+  border-radius: 20px;
+  font-size: 0.9rem;
+  font-weight: 600;
+  color: white;
+  margin-bottom: 20px;
+  border: 1px solid rgba(255, 255, 255, 0.3);
+}
+
+.featured-content {
+  display: flex;
+  gap: 32px;
+  align-items: center;
+  position: relative;
+  z-index: 1;
+}
+
+.featured-avatar-link {
+  flex-shrink: 0;
+}
+
+.featured-avatar {
+  width: 150px;
+  height: 150px;
+  border-radius: 50%;
+  border: 5px solid rgba(255, 255, 255, 0.3);
+  box-shadow: 0 8px 20px rgba(0, 0, 0, 0.3);
+  transition: transform 0.3s ease;
+}
+
+.featured-avatar:hover {
+  transform: scale(1.05);
+}
+
+.featured-info {
+  flex: 1;
+  color: white;
+}
+
+.featured-name {
+  font-size: 2rem;
+  font-weight: 700;
+  margin: 0 0 8px 0;
+  color: white;
+  text-shadow: 2px 2px 4px rgba(0, 0, 0, 0.2);
+}
+
+.featured-login {
+  font-size: 1.2rem;
+  color: rgba(255, 255, 255, 0.9);
+  text-decoration: none;
+  display: inline-block;
+  margin-bottom: 12px;
+  transition: color 0.2s;
+}
+
+.featured-login:hover {
+  color: white;
+  text-decoration: underline;
+}
+
+.featured-location {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  font-size: 1rem;
+  color: rgba(255, 255, 255, 0.9);
+  margin-bottom: 20px;
+}
+
+.featured-stats {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(100px, 1fr));
+  gap: 20px;
+  margin: 20px 0;
+}
+
+.featured-stat {
+  text-align: center;
+  background: rgba(255, 255, 255, 0.15);
+  backdrop-filter: blur(10px);
+  padding: 16px;
+  border-radius: 12px;
+  border: 1px solid rgba(255, 255, 255, 0.2);
+}
+
+.featured-stat .stat-value {
+  font-size: 1.8rem;
+  font-weight: 700;
+  color: white;
+  margin-bottom: 4px;
+}
+
+.featured-stat .stat-label {
+  font-size: 0.85rem;
+  color: rgba(255, 255, 255, 0.85);
+  text-transform: uppercase;
+  letter-spacing: 0.5px;
+  font-weight: 500;
+  text-shadow: 1px 1px 2px rgba(0, 0, 0, 0.2);
+}
+
+.featured-languages {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+  margin-top: 16px;
+}
+
+.featured-language-badge {
+  background: rgba(255, 255, 255, 0.2);
+  backdrop-filter: blur(10px);
+  padding: 6px 14px;
+  border-radius: 16px;
+  font-size: 0.85rem;
+  color: white;
+  font-weight: 500;
+  border: 1px solid rgba(255, 255, 255, 0.3);
+}
+
+@media (max-width: 768px) {
+  .featured-user-section {
+    padding: 24px;
+    margin: 10px;
+  }
+
+  .featured-content {
+    flex-direction: column;
+    text-align: center;
+    gap: 20px;
+  }
+
+  .featured-avatar {
+    width: 120px;
+    height: 120px;
+  }
+
+  .featured-name {
+    font-size: 1.5rem;
+  }
+
+  .featured-stats {
+    grid-template-columns: repeat(2, 1fr);
+    gap: 12px;
+  }
+}
+
 .grid {
   display: flex;
   flex-wrap: wrap;