import { getRegistry } from '@jackwener/opencli/registry';
import { CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
import { afterEach, describe, expect, it, vi } from 'vitest';
import './repos.js';
function loadCommand() {
const cmd = getRegistry().get('github-trending/repos');
if (!cmd?.func) throw new Error('github-trending/repos not found or has no func');
return cmd;
}
function article({ repo, desc, lang, stars, forks, since }) {
const langSpan = lang ? `${lang}` : '';
const descP = desc == null ? '' : `\n ${desc}\n
`;
return `
${descP}
`;
}
function pageHtml(articles) {
return `${articles.join('\n')}
`;
}
function mockHtmlOnce(html, { ok = true, status = 200 } = {}) {
vi.stubGlobal('fetch', vi.fn().mockResolvedValue({
ok,
status,
statusText: 'OK',
text: vi.fn().mockResolvedValue(html),
}));
}
afterEach(() => {
vi.unstubAllGlobals();
vi.restoreAllMocks();
});
describe('github-trending/repos', () => {
it('parses repos, stars, forks, language, description and url', async () => {
const html = pageHtml([
article({ repo: 'owner-a/repo-a', desc: 'Tools & toys for the web', lang: 'Rust', stars: '1,234', forks: '56', since: '78' }),
article({ repo: 'owner-b/repo-b', desc: null, lang: null, stars: '9', forks: '0', since: '3' }),
]);
mockHtmlOnce(html);
const rows = await loadCommand().func({ since: 'daily', language: '', limit: 25 });
expect(rows).toEqual([
{ rank: 1, repo: 'owner-a/repo-a', description: 'Tools & toys for the web', language: 'Rust', stars: 1234, forks: 56, starsSince: 78, url: 'https://github.com/owner-a/repo-a' },
{ rank: 2, repo: 'owner-b/repo-b', description: '', language: null, stars: 9, forks: 0, starsSince: 3, url: 'https://github.com/owner-b/repo-b' },
]);
});
it('honors --limit by truncating the result set', async () => {
const html = pageHtml([
article({ repo: 'a/a', desc: 'a', lang: 'Go', stars: '1', forks: '1', since: '1' }),
article({ repo: 'b/b', desc: 'b', lang: 'Go', stars: '2', forks: '2', since: '2' }),
article({ repo: 'c/c', desc: 'c', lang: 'Go', stars: '3', forks: '3', since: '3' }),
]);
mockHtmlOnce(html);
const rows = await loadCommand().func({ since: 'daily', language: '', limit: 2 });
expect(rows.map((r) => r.repo)).toEqual(['a/a', 'b/b']);
});
it('builds the language + since URL', async () => {
const fetchFn = vi.fn().mockResolvedValue({
ok: true,
status: 200,
text: vi.fn().mockResolvedValue(pageHtml([
article({ repo: 'x/y', desc: 'z', lang: 'Rust', stars: '1', forks: '1', since: '1' }),
])),
});
vi.stubGlobal('fetch', fetchFn);
await loadCommand().func({ since: 'weekly', language: 'rust', limit: 25 });
const calledUrl = String(fetchFn.mock.calls[0][0]);
expect(calledUrl).toBe('https://github.com/trending/rust?since=weekly');
});
it('rejects an unknown --since', async () => {
await expect(loadCommand().func({ since: 'yearly', language: '', limit: 25 }))
.rejects.toThrow(/since/i);
});
it('rejects a non-positive --limit', async () => {
await expect(loadCommand().func({ since: 'daily', language: '', limit: 0 }))
.rejects.toThrow(/limit/i);
});
it('rejects --limit above 25', async () => {
await expect(loadCommand().func({ since: 'daily', language: '', limit: 30 }))
.rejects.toThrow(/limit/i);
});
it('throws EmptyResultError when no repositories are present', async () => {
mockHtmlOnce('It looks like we don’t have any trending repositories for your choices.
');
await expect(loadCommand().func({ since: 'daily', language: '', limit: 25 }))
.rejects.toThrow(EmptyResultError);
});
it('fails closed when GitHub row selectors drift without an explicit empty marker', async () => {
mockHtmlOnce('Trending repositories
');
await expect(loadCommand().func({ since: 'daily', language: '', limit: 25 }))
.rejects.toThrow(CommandExecutionError);
});
it('fails closed when a repository row has no repo identity', async () => {
mockHtmlOnce(pageHtml([article({ repo: 'owner-a/repo-a', desc: 'x', lang: 'Rust', stars: '1', forks: '2', since: '3' })
.replace('href="/owner-a/repo-a"', 'href="https://evil.example/owner-a/repo-a"')]));
await expect(loadCommand().func({ since: 'daily', language: '', limit: 25 }))
.rejects.toThrow(CommandExecutionError);
});
it('fails closed when stars, forks, or period stars stop parsing', async () => {
const valid = article({ repo: 'owner-a/repo-a', desc: 'x', lang: 'Rust', stars: '1', forks: '2', since: '3' });
mockHtmlOnce(pageHtml([valid.replace('1', 'many')]));
await expect(loadCommand().func({ since: 'daily', language: '', limit: 25 }))
.rejects.toThrow(CommandExecutionError);
mockHtmlOnce(pageHtml([valid.replace('2', 'some')]));
await expect(loadCommand().func({ since: 'daily', language: '', limit: 25 }))
.rejects.toThrow(CommandExecutionError);
mockHtmlOnce(pageHtml([valid.replace('3 stars today', 'several stars today')]));
await expect(loadCommand().func({ since: 'daily', language: '', limit: 25 }))
.rejects.toThrow(CommandExecutionError);
});
it('throws on a non-ok HTTP response', async () => {
mockHtmlOnce('', { ok: false, status: 503 });
await expect(loadCommand().func({ since: 'daily', language: '', limit: 25 }))
.rejects.toThrow(/HTTP 503/);
});
});