pkg-stats 0.1.0 → 0.2.0

package/README.md

@@ -1,3 +1,16 @@
 ## PKG Stats
 
-Beautiful package download stats.
+Beautiful NPM package download stats.
+
+```
+npx pkg-stats react
+```
+
+<div align='center'>
+  <img src="https://raw.githubusercontent.com/mdjastrzebski/pkg-stats/main/docs/public/example-react.png" alt="pkg-stats" height="210" width="538" />
+</div>
+
+### Options:
+
+- version grouping: `--group major|minor|patch` (alias `-g`, `--major`, `--minor`, `--patch`)
+- top version: `--top <number>` (alias `-t`)

package/bin.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { pkgStats } from './dist/index.js';
+
+pkgStats(process.argv.slice(2));

package/dist/bin.js

@@ -1,8 +1,9 @@
 import chalk from 'chalk';
 import minimist from 'minimist';
 import { renderChart } from './chart.js';
-import { gradients } from './colors.js';
+import { getColors } from './colors.js';
 import { parseVersion, versionCompare } from './version.js';
+import { groupByType, pickTopStats } from './stats.js';
 export async function pkgStats(argv) {
     const options = parseCliOptions(argv);
     if (options.help) {
@@ -31,27 +32,20 @@ export async function pkgStats(argv) {
         };
     })
         .sort(versionCompare);
-    let groupedStats;
-    if (options.group === 'patch') {
-        groupedStats = sumByPatch(rawStats);
-    }
-    else if (options.group === 'minor') {
-        groupedStats = sumByMinor(rawStats);
-    }
-    else {
-        groupedStats = sumByMajor(rawStats);
-    }
+    let groupedStats = groupByType(options.group, rawStats);
     const totalDownloads = Object.values(groupedStats).reduce((sum, version) => sum + version.downloads, 0);
     const groupedStatsToDisplay = options.top
         ? pickTopStats(groupedStats, options.top)
         : groupedStats;
-    console.log(chalk.bold(`\nNPM weekly downloads for ${chalk.cyan(options.name)}\n`));
-    console.log(`Total: ${chalk.cyan(totalDownloads.toLocaleString())}\n`);
+    const colors = getColors(groupedStatsToDisplay.length);
+    const primaryColor = chalk.hex(colors[0]);
+    console.log(chalk.bold(`\nNPM weekly downloads for ${primaryColor(options.name)}\n`));
+    console.log(`Total: ${primaryColor(totalDownloads.toLocaleString())} last week\n`);
     console.log(options.top ? `Top ${options.top} versions:\n` : 'By version:\n');
-    const colors = gradients.passion(groupedStatsToDisplay.length);
     const maxDownloads = Math.max(...groupedStats.map((v) => v.downloads));
     groupedStatsToDisplay.forEach((item, i) => {
-        const version = options.group != 'patch' ? `${item.versionString}.x` : item.versionString;
+        const versionParts = item.versionString.split('.');
+        const version = versionParts.length < 3 ? `${item.versionString}.x` : item.versionString;
         const chart = renderChart(item.downloads / maxDownloads);
         const downloads = formatDownloads(item.downloads, maxDownloads);
         const color = chalk.hex(colors[i]);
@@ -65,8 +59,11 @@ function parseCliOptions(argv) {
         boolean: ['help'],
         alias: { g: 'group', h: 'help', t: 'top' },
     });
-    let group = 'major';
-    if (options.group === 'minor' || options.minor) {
+    let group;
+    if (options.group === 'major' || options.major) {
+        group = 'major';
+    }
+    else if (options.group === 'minor' || options.minor) {
         group = 'minor';
     }
     else if (options.group === 'patch' || options.patch) {
@@ -93,52 +90,6 @@ function printHelp() {
       --top <number>   Show top <number> versions
   `);
 }
-function sumByMajor(stats) {
-    const result = {};
-    for (const versionStats of stats) {
-        const key = `${versionStats.major}`;
-        const entry = result[key] ?? {
-            version: { major: versionStats.major },
-            versionString: key,
-            downloads: 0,
-        };
-        result[key] = entry;
-        entry.downloads += versionStats.downloads;
-    }
-    return Object.values(result).sort((a, b) => versionCompare(a.version, b.version));
-}
-function sumByMinor(stats) {
-    const result = {};
-    for (const versionStats of stats) {
-        const key = `${versionStats.major}.${versionStats.minor}`;
-        const entry = result[key] ?? {
-            version: { major: versionStats.major, minor: versionStats.minor },
-            versionString: key,
-            downloads: 0,
-        };
-        result[key] = entry;
-        entry.downloads += versionStats.downloads;
-    }
-    return Object.values(result).sort((a, b) => versionCompare(a.version, b.version));
-}
-function sumByPatch(stats) {
-    const result = {};
-    for (const versionStats of stats) {
-        const key = `${versionStats.major}.${versionStats.minor}.${versionStats.patch}`;
-        const entry = result[key] ?? {
-            version: {
-                major: versionStats.major,
-                minor: versionStats.minor,
-                patch: versionStats.patch,
-            },
-            versionString: key,
-            downloads: 0,
-        };
-        result[key] = entry;
-        entry.downloads += versionStats.downloads;
-    }
-    return Object.values(result).sort((a, b) => versionCompare(a.version, b.version));
-}
 function formatDownloads(downloads, maxDownloads) {
     if (maxDownloads > 1000000) {
         return `${(downloads / 1000000).toFixed(1)}M`;
@@ -148,8 +99,3 @@ function formatDownloads(downloads, maxDownloads) {
     }
     return downloads.toString();
 }
-function pickTopStats(stats, top) {
-    const sortedStats = stats.sort((a, b) => b.downloads - a.downloads);
-    const topStats = sortedStats.slice(0, top);
-    return topStats.sort((a, b) => versionCompare(a.version, b.version));
-}

package/dist/colors.js

@@ -1,11 +1,44 @@
 import tinygradient from 'tinygradient';
 // See: https://github.com/bokub/gradient-string/blob/465e86c8499a7f427c45afb1861f1444a2db74b9/src/index.ts#L166
-export const gradients = {
-    mind: (count) => toColors(tinygradient(['#473b7b', '#3584a7', '#30d2be']).rgb(count)),
-    pastel: (count) => toColors(tinygradient(['#74ebd5', '#74ecd5']).hsv(count, 'long')),
-    passion: (count) => toColors(tinygradient(['#f43b47', '#453a94']).rgb(count)),
-    retro: (count) => toColors(tinygradient(['#4150AB', '#AE6F97', '#EFCB84']).rgb(count)),
+const gradients = {
+    atlas: { colors: ['#feac5e', '#c779d0', '#4bc0c8'], options: {} },
+    cristal: { colors: ['#bdfff3', '#4ac29a'], options: {} },
+    teen: { colors: ['#77a1d3', '#79cbca', '#e684ae'], options: {} },
+    mind: { colors: ['#473b7b', '#3584a7', '#30d2be'], options: {} },
+    morning: { colors: ['#ff5f6d', '#ffc371'], options: { interpolation: 'hsv' } },
+    vice: { colors: ['#5ee7df', '#b490ca'], options: { interpolation: 'hsv' } },
+    passion: { colors: ['#f43b47', '#453a94'], options: {} },
+    fruit: { colors: ['#ff4e50', '#f9d423'], options: {} },
+    instagram: { colors: ['#833ab4', '#fd1d1d', '#fcb045'], options: {} },
+    retro: {
+        colors: [
+            '#3f51b1',
+            '#5a55ae',
+            '#7b5fac',
+            '#8f6aae',
+            '#a86aa4',
+            '#cc6b8e',
+            '#f18271',
+            '#f3a469',
+            '#f7c978',
+        ],
+        options: {},
+    },
+    summer: { colors: ['#fdbb2d', '#22c1c3'], options: {} },
+    rainbow: { colors: ['#ff0000', '#ff0100'], options: { interpolation: 'hsv', hsvSpin: 'long' } },
+    pastel: { colors: ['#74ebd5', '#74ecd5'], options: { interpolation: 'hsv', hsvSpin: 'long' } },
 };
-function toColors(colors) {
-    return colors.map((c) => c.toHexString());
+export function getColors(count, colorScheme) {
+    const { colors, options } = gradients[colorScheme ?? getRandomScheme()];
+    if (count < colors.length) {
+        return colors;
+    }
+    const gradient = tinygradient(colors);
+    const tinyColors = options.interpolation === 'hsv'
+        ? gradient.hsv(count, options.hsvSpin ?? false)
+        : gradient.rgb(count);
+    return tinyColors.map((c) => c.toHexString());
+}
+function getRandomScheme() {
+    return Object.keys(gradients)[Math.floor(Math.random() * Object.keys(gradients).length)];
 }

package/dist/stats.js

@@ -0,0 +1,72 @@
+import { versionCompare } from './version.js';
+export function groupByType(type, stats) {
+    if (type === 'major') {
+        return groupByMajor(stats);
+    }
+    if (type === 'minor') {
+        return groupByMinor(stats);
+    }
+    if (type === 'patch') {
+        return groupByPatch(stats);
+    }
+    const groupedByMajor = groupByMajor(stats);
+    if (groupedByMajor.length > 1) {
+        return groupedByMajor;
+    }
+    const groupedByMinor = groupByMinor(stats);
+    if (groupedByMinor.length > 1) {
+        return groupedByMinor;
+    }
+    return groupByPatch(stats);
+}
+function groupByMajor(stats) {
+    const result = {};
+    for (const versionStats of stats) {
+        const key = `${versionStats.major}`;
+        const entry = result[key] ?? {
+            version: { major: versionStats.major },
+            versionString: key,
+            downloads: 0,
+        };
+        result[key] = entry;
+        entry.downloads += versionStats.downloads;
+    }
+    return Object.values(result).sort((a, b) => versionCompare(a.version, b.version));
+}
+function groupByMinor(stats) {
+    const result = {};
+    for (const versionStats of stats) {
+        const key = `${versionStats.major}.${versionStats.minor}`;
+        const entry = result[key] ?? {
+            version: { major: versionStats.major, minor: versionStats.minor },
+            versionString: key,
+            downloads: 0,
+        };
+        result[key] = entry;
+        entry.downloads += versionStats.downloads;
+    }
+    return Object.values(result).sort((a, b) => versionCompare(a.version, b.version));
+}
+function groupByPatch(stats) {
+    const result = {};
+    for (const versionStats of stats) {
+        const key = `${versionStats.major}.${versionStats.minor}.${versionStats.patch}`;
+        const entry = result[key] ?? {
+            version: {
+                major: versionStats.major,
+                minor: versionStats.minor,
+                patch: versionStats.patch,
+            },
+            versionString: key,
+            downloads: 0,
+        };
+        result[key] = entry;
+        entry.downloads += versionStats.downloads;
+    }
+    return Object.values(result).sort((a, b) => versionCompare(a.version, b.version));
+}
+export function pickTopStats(stats, top) {
+    const sortedStats = stats.sort((a, b) => b.downloads - a.downloads);
+    const topStats = sortedStats.slice(0, top);
+    return topStats.sort((a, b) => versionCompare(a.version, b.version));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pkg-stats",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Beautiful NPM package download stats",
   "author": "Maciej Jastrzębski <mdjastrzebski@gmail.com> (https://github.com/mdjastrzebski)",
   "license": "MIT",
@@ -17,7 +17,7 @@
     "dist"
   ],
   "bin": {
-    "pkg-stats": "./dist/bin.js"
+    "pkg-stats": "./bin.js"
   },
   "dependencies": {
     "chalk": "^5.4.1",