publishport-opencli 1.8.5-pp.2 → 1.8.5-pp.21

package/clis/hf/spaces.js

@@ -1,101 +1 @@
-// hf spaces — list top Hugging Face Spaces (gradio / streamlit / static demos).
-//
-// Hits `https://huggingface.co/api/spaces?sort=…&full=true`. Mirrors the shape
-// of `hf models` / `hf datasets`. The Spaces API does not expose `trending` as
-// a sort key (verified live: returns "Invalid sort parameter"), so the allowed
-// sort set is narrower.
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { ArgumentError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
-
-const SORT_OPTIONS = ['likes', 'created_at', 'last_modified'];
-const SORT_ALIAS = { lastmodified: 'last_modified', createdat: 'created_at' };
-
-cli({
-    site: 'hf',
-    name: 'spaces',
-    access: 'read',
-    description: 'Top Hugging Face Spaces (likes / created_at / last_modified).',
-    domain: 'huggingface.co',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'sort', type: 'string', default: 'likes', help: `Sort key: ${SORT_OPTIONS.join(', ')}` },
-        { name: 'search', type: 'string', required: false, help: 'Optional name/owner substring filter (e.g. "stability", "openai/")' },
-        { name: 'sdk', type: 'string', required: false, help: 'Filter by Space SDK: gradio / streamlit / docker / static' },
-        { name: 'limit', type: 'int', default: 20, help: 'Max spaces (max 100; one API page).' },
-    ],
-    columns: ['rank', 'id', 'author', 'sdk', 'likes', 'tags', 'lastModified', 'url'],
-    func: async (args) => {
-        const sortRaw = String(args.sort ?? 'likes').toLowerCase();
-        const sort = SORT_ALIAS[sortRaw] ?? sortRaw;
-        if (!SORT_OPTIONS.includes(sort)) {
-            throw new ArgumentError(`hf spaces sort must be one of ${SORT_OPTIONS.join(', ')}`);
-        }
-        const limit = Number(args.limit ?? 20);
-        if (!Number.isInteger(limit) || limit <= 0) {
-            throw new ArgumentError('hf spaces limit must be a positive integer');
-        }
-        if (limit > 100) {
-            throw new ArgumentError('hf spaces limit must be <= 100');
-        }
-        const sdk = args.sdk == null ? '' : String(args.sdk).trim().toLowerCase();
-        const allowedSdks = new Set(['', 'gradio', 'streamlit', 'docker', 'static']);
-        if (!allowedSdks.has(sdk)) {
-            throw new ArgumentError(`hf spaces sdk must be one of gradio / streamlit / docker / static`);
-        }
-
-        const url = new URL('https://huggingface.co/api/spaces');
-        url.searchParams.set('sort', sort);
-        url.searchParams.set('direction', '-1');
-        url.searchParams.set('limit', String(limit));
-        url.searchParams.set('full', 'true');
-        if (args.search) url.searchParams.set('search', String(args.search));
-        if (sdk) url.searchParams.set('sdk', sdk);
-
-        let resp;
-        try {
-            resp = await fetch(url, {
-                headers: { Accept: 'application/json', 'User-Agent': 'opencli/1.0 (+https://github.com/jackwener/opencli)' },
-            });
-        }
-        catch (err) {
-            throw new CommandExecutionError(`hf spaces request failed: ${err?.message ?? err}`);
-        }
-        if (resp.status === 429) {
-            throw new CommandExecutionError(
-                'hf spaces returned HTTP 429 (rate limited)',
-                'Hugging Face throttles unauthenticated traffic; wait a few seconds and retry.',
-            );
-        }
-        if (!resp.ok) {
-            throw new CommandExecutionError(`hf spaces failed: HTTP ${resp.status}`);
-        }
-        let data;
-        try {
-            data = await resp.json();
-        }
-        catch (err) {
-            throw new CommandExecutionError(`hf spaces returned malformed JSON: ${err?.message ?? err}`);
-        }
-        const list = Array.isArray(data) ? data : [];
-        if (!list.length) {
-            throw new EmptyResultError('hf spaces', 'No matching spaces on huggingface.co.');
-        }
-        return list.slice(0, limit).map((s, i) => {
-            const id = String(s.id ?? s._id ?? '');
-            const slash = id.indexOf('/');
-            const author = String(s.author ?? (slash > 0 ? id.slice(0, slash) : ''));
-            const tags = Array.isArray(s.tags) ? s.tags.filter((t) => !String(t).startsWith('license:')).slice(0, 10).join(', ') : '';
-            return {
-                rank: i + 1,
-                id,
-                author,
-                sdk: String(s.sdk ?? ''),
-                likes: s.likes != null ? Number(s.likes) : null,
-                tags,
-                lastModified: String(s.lastModified ?? '').slice(0, 10),
-                url: id ? `https://huggingface.co/spaces/${id}` : '',
-            };
-        });
-    },
-});
+import{cli as S,Strategy as y}from"@jackwener/opencli/registry";import{ArgumentError as o,CommandExecutionError as n,EmptyResultError as b}from"@jackwener/opencli/errors";const d=["likes","created_at","last_modified"],P={lastmodified:"last_modified",createdat:"created_at"};S({site:"hf",name:"spaces",access:"read",description:"Top Hugging Face Spaces (likes / created_at / last_modified).",domain:"huggingface.co",strategy:y.PUBLIC,browser:!1,args:[{name:"sort",type:"string",default:"likes",help:`Sort key: ${d.join(", ")}`},{name:"search",type:"string",required:!1,help:'Optional name/owner substring filter (e.g. "stability", "openai/")'},{name:"sdk",type:"string",required:!1,help:"Filter by Space SDK: gradio / streamlit / docker / static"},{name:"limit",type:"int",default:20,help:"Max spaces (max 100; one API page)."}],columns:["rank","id","author","sdk","likes","tags","lastModified","url"],func:async(s)=>{const h=String(s.sort??"likes").toLowerCase(),f=P[h]??h;if(!d.includes(f))throw new o(`hf spaces sort must be one of ${d.join(", ")}`);const a=Number(s.limit??20);if(!Number.isInteger(a)||a<=0)throw new o("hf spaces limit must be a positive integer");if(a>100)throw new o("hf spaces limit must be <= 100");const c=s.sdk==null?"":String(s.sdk).trim().toLowerCase();if(!new Set(["","gradio","streamlit","docker","static"]).has(c))throw new o("hf spaces sdk must be one of gradio / streamlit / docker / static");const t=new URL("https://huggingface.co/api/spaces");t.searchParams.set("sort",f);t.searchParams.set("direction","-1");t.searchParams.set("limit",String(a));t.searchParams.set("full","true");if(s.search)t.searchParams.set("search",String(s.search));if(c)t.searchParams.set("sdk",c);let r;try{r=await fetch(t,{headers:{Accept:"application/json","User-Agent":"opencli/1.0 (+https://github.com/jackwener/opencli)"}})}catch(e){throw new n(`hf spaces request failed: ${e?.message??e}`)}if(r.status===429)throw new n("hf spaces returned HTTP 429 (rate limited)","Hugging Face throttles unauthenticated traffic; wait a few seconds and retry.");if(!r.ok)throw new n(`hf spaces failed: HTTP ${r.status}`);let l;try{l=await r.json()}catch(e){throw new n(`hf spaces returned malformed JSON: ${e?.message??e}`)}const m=Array.isArray(l)?l:[];if(!m.length)throw new b("hf spaces","No matching spaces on huggingface.co.");return m.slice(0,a).map((e,p)=>{const i=String(e.id??e._id??""),g=i.indexOf("/"),u=String(e.author??(g>0?i.slice(0,g):"")),w=Array.isArray(e.tags)?e.tags.filter((k)=>!String(k).startsWith("license:")).slice(0,10).join(", "):"";return{rank:p+1,id:i,author:u,sdk:String(e.sdk??""),likes:e.likes!=null?Number(e.likes):null,tags:w,lastModified:String(e.lastModified??"").slice(0,10),url:i?`https://huggingface.co/spaces/${i}`:""}})}});

package/clis/hf/top.js

@@ -1,121 +1 @@
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { CliError } from '@jackwener/opencli/errors';
-function truncate(str, max = 60) {
-    return str.length > max ? str.slice(0, max - 3) + '...' : str;
-}
-function formatAuthors(authors, max = 3) {
-    const names = authors.map((a) => a.name);
-    if (names.length <= max)
-        return names.join(', ');
-    return names.slice(0, max).join(', ') + ' et al.';
-}
-const MONTH_ABBR = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
-function getMonthRange() {
-    const now = new Date();
-    return `${MONTH_ABBR[now.getUTCMonth()]} ${now.getUTCFullYear()}`;
-}
-function getWeekRange() {
-    const now = new Date();
-    const day = now.getUTCDay(); // 0=Sun, 6=Sat
-    const daysToSat = day === 6 ? 0 : 6 - day;
-    const end = new Date(now);
-    end.setUTCDate(now.getUTCDate() + daysToSat);
-    const start = new Date(end);
-    start.setUTCDate(end.getUTCDate() - 6);
-    const sm = MONTH_ABBR[start.getUTCMonth()];
-    const em = MONTH_ABBR[end.getUTCMonth()];
-    const sd = start.getUTCDate();
-    const ed = end.getUTCDate();
-    return sm === em ? `${sm} ${sd}-${ed}` : `${sm} ${sd}-${em} ${ed}`;
-}
-cli({
-    site: 'hf',
-    name: 'top',
-    access: 'read',
-    description: 'Top upvoted Hugging Face papers',
-    domain: 'huggingface.co',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'limit', type: 'int', default: 20, help: 'Number of papers' },
-        { name: 'all', type: 'bool', default: false, help: 'Return all papers (ignore limit)' },
-        { name: 'date', type: 'str', required: false, help: 'Date (YYYY-MM-DD), defaults to most recent' },
-        { name: 'period', type: 'str', default: 'daily', choices: ['daily', 'weekly', 'monthly'], help: 'Time period: daily, weekly, or monthly' },
-    ],
-    columns: ['rank', 'id', 'title', 'upvotes', 'authors'],
-    footerExtra: (kwargs) => {
-        if (kwargs._footerDate)
-            return kwargs._footerDate;
-        if (kwargs.period === 'monthly')
-            return getMonthRange();
-        if (kwargs.period === 'weekly')
-            return getWeekRange();
-        return kwargs.date ?? new Date().toISOString().slice(0, 10);
-    },
-    func: async (kwargs) => {
-        const period = String(kwargs.period ?? 'daily');
-        const all = Boolean(kwargs.all);
-        const endpoint = process.env.HF_ENDPOINT?.replace(/\/+$/, '') || 'https://huggingface.co';
-        if (period === 'weekly' || period === 'monthly') {
-            if (kwargs.date) {
-                throw new CliError('INVALID_ARG', `--date is not supported for ${period} period`, `Omit --date when using --period ${period}`);
-            }
-            const url = `${endpoint}/api/papers?period=${period}`;
-            const res = await fetch(url);
-            if (!res.ok)
-                throw new CliError('FETCH_ERROR', `HF API error: ${res.status} ${res.statusText}`, 'Check HF_ENDPOINT or try again later');
-            const body = await res.json();
-            if (!Array.isArray(body))
-                throw new CliError('FETCH_ERROR', 'Unexpected HF API response', 'Check endpoint');
-            const data = body;
-            const dates = data.map((d) => d.publishedAt).filter(Boolean).sort();
-            if (dates.length > 0) {
-                if (period === 'monthly') {
-                    const d = new Date(dates[0]);
-                    kwargs._footerDate = `${MONTH_ABBR[d.getUTCMonth()]} ${d.getUTCFullYear()}`;
-                }
-                else {
-                    const start = new Date(dates[0]);
-                    const end = new Date(dates[dates.length - 1]);
-                    const sm = MONTH_ABBR[start.getUTCMonth()];
-                    const em = MONTH_ABBR[end.getUTCMonth()];
-                    const sd = start.getUTCDate();
-                    const ed = end.getUTCDate();
-                    kwargs._footerDate = sm === em ? `${sm} ${sd}-${ed}` : `${sm} ${sd}-${em} ${ed}`;
-                }
-            }
-            const sorted = [...data].sort((a, b) => (b.upvotes ?? 0) - (a.upvotes ?? 0));
-            const items = all ? sorted : sorted.slice(0, Number(kwargs.limit));
-            return items.map((item, i) => ({
-                rank: i + 1,
-                id: item.id ?? '',
-                title: truncate(item.title ?? ''),
-                upvotes: item.upvotes ?? 0,
-                authors: formatAuthors(item.authors ?? []),
-            }));
-        }
-        // daily
-        if (kwargs.date && !/^\d{4}-\d{2}-\d{2}$/.test(String(kwargs.date))) {
-            throw new CliError('INVALID_ARG', `Invalid date format: ${kwargs.date}`, 'Use YYYY-MM-DD');
-        }
-        const url = kwargs.date
-            ? `${endpoint}/api/daily_papers?date=${kwargs.date}`
-            : `${endpoint}/api/daily_papers`;
-        const res = await fetch(url);
-        if (!res.ok)
-            throw new CliError('FETCH_ERROR', `HF API error: ${res.status} ${res.statusText}`, 'Check HF_ENDPOINT or try again later');
-        const body = await res.json();
-        if (!Array.isArray(body))
-            throw new CliError('FETCH_ERROR', 'Unexpected HF API response', 'Check date format or endpoint');
-        const data = body;
-        const sorted = [...data].sort((a, b) => (b.paper?.upvotes ?? 0) - (a.paper?.upvotes ?? 0));
-        const items = all ? sorted : sorted.slice(0, Number(kwargs.limit));
-        return items.map((item, i) => ({
-            rank: i + 1,
-            id: item.paper?.id ?? '',
-            title: truncate(item.title ?? ''),
-            upvotes: item.paper?.upvotes ?? 0,
-            authors: formatAuthors(item.paper?.authors ?? []),
-        }));
-    },
-});
+import{cli as A,Strategy as _}from"@jackwener/opencli/registry";import{CliError as l}from"@jackwener/opencli/errors";function R(t,e=60){return t.length>e?t.slice(0,e-3)+"...":t}function w(t,e=3){const a=t.map((n)=>n.name);if(a.length<=e)return a.join(", ");return a.slice(0,e).join(", ")+" et al."}const c=["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"];function F(){const t=new Date;return`${c[t.getUTCMonth()]} ${t.getUTCFullYear()}`}function I(){const t=new Date,e=t.getUTCDay(),a=e===6?0:6-e,n=new Date(t);n.setUTCDate(t.getUTCDate()+a);const d=new Date(n);d.setUTCDate(n.getUTCDate()-6);const r=c[d.getUTCMonth()],u=c[n.getUTCMonth()],m=d.getUTCDate(),h=n.getUTCDate();return r===u?`${r} ${m}-${h}`:`${r} ${m}-${u} ${h}`}A({site:"hf",name:"top",access:"read",description:"Top upvoted Hugging Face papers",domain:"huggingface.co",strategy:_.PUBLIC,browser:!1,args:[{name:"limit",type:"int",default:20,help:"Number of papers"},{name:"all",type:"bool",default:!1,help:"Return all papers (ignore limit)"},{name:"date",type:"str",required:!1,help:"Date (YYYY-MM-DD), defaults to most recent"},{name:"period",type:"str",default:"daily",choices:["daily","weekly","monthly"],help:"Time period: daily, weekly, or monthly"}],columns:["rank","id","title","upvotes","authors"],footerExtra:(t)=>{if(t._footerDate)return t._footerDate;if(t.period==="monthly")return F();if(t.period==="weekly")return I();return t.date??new Date().toISOString().slice(0,10)},func:async(t)=>{const e=String(t.period??"daily"),a=Boolean(t.all),n=process.env.HF_ENDPOINT?.replace(/\/+$/,"")||"https://huggingface.co";if(e==="weekly"||e==="monthly"){if(t.date)throw new l("INVALID_ARG",`--date is not supported for ${e} period`,`Omit --date when using --period ${e}`);const s=`${n}/api/papers?period=${e}`,i=await fetch(s);if(!i.ok)throw new l("FETCH_ERROR",`HF API error: ${i.status} ${i.statusText}`,"Check HF_ENDPOINT or try again later");const D=await i.json();if(!Array.isArray(D))throw new l("FETCH_ERROR","Unexpected HF API response","Check endpoint");const $=D,f=$.map((o)=>o.publishedAt).filter(Boolean).sort();if(f.length>0)if(e==="monthly"){const o=new Date(f[0]);t._footerDate=`${c[o.getUTCMonth()]} ${o.getUTCFullYear()}`}else{const o=new Date(f[0]),p=new Date(f[f.length-1]),y=c[o.getUTCMonth()],g=c[p.getUTCMonth()],C=o.getUTCDate(),U=p.getUTCDate();t._footerDate=y===g?`${y} ${C}-${U}`:`${y} ${C}-${g} ${U}`}const T=[...$].sort((o,p)=>(p.upvotes??0)-(o.upvotes??0));return(a?T:T.slice(0,Number(t.limit))).map((o,p)=>({rank:p+1,id:o.id??"",title:R(o.title??""),upvotes:o.upvotes??0,authors:w(o.authors??[])}))}if(t.date&&!/^\d{4}-\d{2}-\d{2}$/.test(String(t.date)))throw new l("INVALID_ARG",`Invalid date format: ${t.date}`,"Use YYYY-MM-DD");const d=t.date?`${n}/api/daily_papers?date=${t.date}`:`${n}/api/daily_papers`,r=await fetch(d);if(!r.ok)throw new l("FETCH_ERROR",`HF API error: ${r.status} ${r.statusText}`,"Check HF_ENDPOINT or try again later");const u=await r.json();if(!Array.isArray(u))throw new l("FETCH_ERROR","Unexpected HF API response","Check date format or endpoint");const h=[...u].sort((s,i)=>(i.paper?.upvotes??0)-(s.paper?.upvotes??0));return(a?h:h.slice(0,Number(t.limit))).map((s,i)=>({rank:i+1,id:s.paper?.id??"",title:R(s.title??""),upvotes:s.paper?.upvotes??0,authors:w(s.paper?.authors??[])}))}});

package/clis/homebrew/cask.js

@@ -1,39 +1 @@
-// homebrew cask — fetch a single Homebrew cask's metadata.
-//
-// Hits `https://formulae.brew.sh/api/cask/<token>.json`. Returns one row for
-// the macOS/.dmg-style package: canonical token, friendly name, version,
-// homepage, deprecated / disabled flags, download URL.
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { BREW_BASE, brewFetch, requireToken } from './utils.js';
-
-cli({
-    site: 'homebrew',
-    name: 'cask',
-    access: 'read',
-    description: 'Fetch a Homebrew cask\'s metadata (version, homepage, deprecation, download URL)',
-    domain: 'formulae.brew.sh',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'token', positional: true, required: true, help: 'Cask token (e.g. "firefox", "visual-studio-code", "google-chrome")' },
-    ],
-    columns: ['cask', 'tap', 'name', 'version', 'description', 'homepage', 'deprecated', 'disabled', 'download', 'url'],
-    func: async (args) => {
-        const token = requireToken(args.token, 'token');
-        const url = `${BREW_BASE}/cask/${encodeURIComponent(token)}.json`;
-        const body = await brewFetch(url, 'homebrew cask');
-        const friendly = Array.isArray(body?.name) ? body.name.filter(Boolean).join(', ') : String(body?.name ?? '').trim();
-        return [{
-            cask: String(body?.token ?? token).trim(),
-            tap: String(body?.tap ?? '').trim(),
-            name: friendly,
-            version: String(body?.version ?? '').trim(),
-            description: String(body?.desc ?? '').trim(),
-            homepage: String(body?.homepage ?? '').trim(),
-            deprecated: Boolean(body?.deprecated),
-            disabled: Boolean(body?.disabled),
-            download: String(body?.url ?? '').trim(),
-            url: `https://formulae.brew.sh/cask/${encodeURIComponent(token)}`,
-        }];
-    },
-});
+import{cli as n,Strategy as s}from"@jackwener/opencli/registry";import{BREW_BASE as i,brewFetch as d,requireToken as m}from"./utils.js";n({site:"homebrew",name:"cask",access:"read",description:"Fetch a Homebrew cask's metadata (version, homepage, deprecation, download URL)",domain:"formulae.brew.sh",strategy:s.PUBLIC,browser:!1,args:[{name:"token",positional:!0,required:!0,help:'Cask token (e.g. "firefox", "visual-studio-code", "google-chrome")'}],columns:["cask","tap","name","version","description","homepage","deprecated","disabled","download","url"],func:async(a)=>{const o=m(a.token,"token"),r=`${i}/cask/${encodeURIComponent(o)}.json`,e=await d(r,"homebrew cask"),t=Array.isArray(e?.name)?e.name.filter(Boolean).join(", "):String(e?.name??"").trim();return[{cask:String(e?.token??o).trim(),tap:String(e?.tap??"").trim(),name:t,version:String(e?.version??"").trim(),description:String(e?.desc??"").trim(),homepage:String(e?.homepage??"").trim(),deprecated:Boolean(e?.deprecated),disabled:Boolean(e?.disabled),download:String(e?.url??"").trim(),url:`https://formulae.brew.sh/cask/${encodeURIComponent(o)}`}]}});

package/clis/homebrew/formula.js

@@ -1,41 +1 @@
-// homebrew formula — fetch a single Homebrew core formula's metadata.
-//
-// Hits `https://formulae.brew.sh/api/formula/<name>.json`. Returns one row:
-// canonical name, latest stable version, license, dependencies, deprecated /
-// disabled flags, homepage, source tarball URL.
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { BREW_BASE, brewFetch, requireToken } from './utils.js';
-
-cli({
-    site: 'homebrew',
-    name: 'formula',
-    access: 'read',
-    description: 'Fetch a Homebrew formula\'s metadata (version, license, deps, deprecation, source)',
-    domain: 'formulae.brew.sh',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'name', positional: true, required: true, help: 'Formula name (e.g. "wget", "gcc@13", "imagemagick")' },
-    ],
-    columns: ['formula', 'tap', 'version', 'license', 'description', 'homepage', 'dependencies', 'deprecated', 'disabled', 'source', 'url'],
-    func: async (args) => {
-        const name = requireToken(args.name, 'formula');
-        const url = `${BREW_BASE}/formula/${encodeURIComponent(name)}.json`;
-        const body = await brewFetch(url, 'homebrew formula');
-        const deps = Array.isArray(body?.dependencies) ? body.dependencies.filter(Boolean) : [];
-        const stableUrl = String(body?.urls?.stable?.url ?? '').trim();
-        return [{
-            formula: String(body?.name ?? name).trim(),
-            tap: String(body?.tap ?? '').trim(),
-            version: String(body?.versions?.stable ?? '').trim(),
-            license: String(body?.license ?? '').trim(),
-            description: String(body?.desc ?? '').trim(),
-            homepage: String(body?.homepage ?? '').trim(),
-            dependencies: deps.join(', '),
-            deprecated: Boolean(body?.deprecated),
-            disabled: Boolean(body?.disabled),
-            source: stableUrl,
-            url: `https://formulae.brew.sh/formula/${encodeURIComponent(name)}`,
-        }];
-    },
-});
+import{cli as s,Strategy as i}from"@jackwener/opencli/registry";import{BREW_BASE as m,brewFetch as l,requireToken as c}from"./utils.js";s({site:"homebrew",name:"formula",access:"read",description:"Fetch a Homebrew formula's metadata (version, license, deps, deprecation, source)",domain:"formulae.brew.sh",strategy:i.PUBLIC,browser:!1,args:[{name:"name",positional:!0,required:!0,help:'Formula name (e.g. "wget", "gcc@13", "imagemagick")'}],columns:["formula","tap","version","license","description","homepage","dependencies","deprecated","disabled","source","url"],func:async(a)=>{const r=c(a.name,"formula"),o=`${m}/formula/${encodeURIComponent(r)}.json`,e=await l(o,"homebrew formula"),n=Array.isArray(e?.dependencies)?e.dependencies.filter(Boolean):[],t=String(e?.urls?.stable?.url??"").trim();return[{formula:String(e?.name??r).trim(),tap:String(e?.tap??"").trim(),version:String(e?.versions?.stable??"").trim(),license:String(e?.license??"").trim(),description:String(e?.desc??"").trim(),homepage:String(e?.homepage??"").trim(),dependencies:n.join(", "),deprecated:Boolean(e?.deprecated),disabled:Boolean(e?.disabled),source:t,url:`https://formulae.brew.sh/formula/${encodeURIComponent(r)}`}]}});

package/clis/homebrew/popular.js

@@ -1,54 +1 @@
-// homebrew popular — list the most-installed Homebrew formulae or casks.
-//
-// Hits `https://formulae.brew.sh/api/analytics/(install|cask-install)/<window>.json`.
-// Anonymous-aggregated install counts published by Homebrew themselves;
-// rows round-trip into `homebrew formula` / `homebrew cask` via the `token`
-// column. The 30/90/365-day windows are the only ones the analytics endpoint
-// publishes — anything else 404s upstream.
-import { cli, Strategy } from '@jackwener/opencli/registry';
-import { EmptyResultError } from '@jackwener/opencli/errors';
-import { BREW_BASE, brewFetch, parseInstallCount, requireBoundedInt, requireOneOf } from './utils.js';
-
-const TYPES = ['formula', 'cask'];
-const WINDOWS = ['30d', '90d', '365d'];
-
-cli({
-    site: 'homebrew',
-    name: 'popular',
-    access: 'read',
-    description: 'List most-installed Homebrew formulae or casks (Homebrew\'s analytics ranking)',
-    domain: 'formulae.brew.sh',
-    strategy: Strategy.PUBLIC,
-    browser: false,
-    args: [
-        { name: 'type', default: 'formula', help: `Package type (${TYPES.join(' / ')})` },
-        { name: 'window', default: '30d', help: `Time window (${WINDOWS.join(' / ')})` },
-        { name: 'limit', type: 'int', default: 30, help: 'Max rows (1-500)' },
-    ],
-    columns: ['rank', 'token', 'type', 'installs', 'percent', 'window', 'url'],
-    func: async (args) => {
-        const type = requireOneOf(args.type, TYPES, 'type');
-        const window = requireOneOf(args.window, WINDOWS, 'window');
-        const limit = requireBoundedInt(args.limit, 30, 500);
-        const path = type === 'cask' ? 'cask-install' : 'install';
-        const url = `${BREW_BASE}/analytics/${path}/${window}.json`;
-        const body = await brewFetch(url, 'homebrew popular');
-        const items = Array.isArray(body?.items) ? body.items : [];
-        if (!items.length) {
-            throw new EmptyResultError('homebrew popular', `Homebrew analytics returned no items for ${type}/${window}.`);
-        }
-        return items.slice(0, limit).map((row, i) => {
-            const token = String(type === 'cask' ? row.cask : row.formula ?? '').trim();
-            const detailPath = type === 'cask' ? 'cask' : 'formula';
-            return {
-                rank: row.number != null ? Number(row.number) : i + 1,
-                token,
-                type,
-                installs: parseInstallCount(row.count),
-                percent: row.percent != null ? Number(row.percent) : null,
-                window,
-                url: token ? `https://formulae.brew.sh/${detailPath}/${encodeURIComponent(token)}` : '',
-            };
-        });
-    },
-});
+import{cli as w,Strategy as h}from"@jackwener/opencli/registry";import{EmptyResultError as b}from"@jackwener/opencli/errors";import{BREW_BASE as y,brewFetch as f,parseInstallCount as k,requireBoundedInt as g,requireOneOf as l}from"./utils.js";const i=["formula","cask"],m=["30d","90d","365d"];w({site:"homebrew",name:"popular",access:"read",description:"List most-installed Homebrew formulae or casks (Homebrew's analytics ranking)",domain:"formulae.brew.sh",strategy:h.PUBLIC,browser:!1,args:[{name:"type",default:"formula",help:`Package type (${i.join(" / ")})`},{name:"window",default:"30d",help:`Time window (${m.join(" / ")})`},{name:"limit",type:"int",default:30,help:"Max rows (1-500)"}],columns:["rank","token","type","installs","percent","window","url"],func:async(n)=>{const t=l(n.type,i,"type"),s=l(n.window,m,"window"),c=g(n.limit,30,500),u=`${y}/analytics/${t==="cask"?"cask-install":"install"}/${s}.json`,o=await f(u,"homebrew popular"),r=Array.isArray(o?.items)?o.items:[];if(!r.length)throw new b("homebrew popular",`Homebrew analytics returned no items for ${t}/${s}.`);return r.slice(0,c).map((e,p)=>{const a=String(t==="cask"?e.cask:e.formula??"").trim(),d=t==="cask"?"cask":"formula";return{rank:e.number!=null?Number(e.number):p+1,token:a,type:t,installs:k(e.count),percent:e.percent!=null?Number(e.percent):null,window:s,url:a?`https://formulae.brew.sh/${d}/${encodeURIComponent(a)}`:""}})}});

package/clis/homebrew/utils.js

@@ -1,100 +1 @@
-// Shared helpers for the Homebrew adapters.
-//
-// Hits the public, unauthenticated `formulae.brew.sh/api` JSON endpoints
-// (served as static files from GitHub Pages, regenerated daily). No auth.
-// Formula / cask tokens are lowercase ASCII + `-_.+@` per Homebrew's own
-// validation; they round-trip into `homebrew formula` / `homebrew cask`.
-import { ArgumentError, CommandExecutionError, EmptyResultError } from '@jackwener/opencli/errors';
-
-export const BREW_BASE = 'https://formulae.brew.sh/api';
-const UA = 'opencli-homebrew-adapter (+https://github.com/jackwener/opencli)';
-
-// Homebrew formula / cask tokens — letters / digits / `_-.+@` (`gcc@13`,
-// `imagemagick@6`, `c++`, `0-ad`, `php-cs-fixer`).
-const TOKEN = /^[A-Za-z0-9][A-Za-z0-9._+@-]*$/;
-
-export function requireString(value, label) {
-    const s = String(value ?? '').trim();
-    if (!s) throw new ArgumentError(`homebrew ${label} cannot be empty`);
-    return s;
-}
-
-export function requireBoundedInt(value, defaultValue, maxValue, label = 'limit') {
-    const raw = value ?? defaultValue;
-    const n = typeof raw === 'number' ? raw : Number(raw);
-    if (!Number.isInteger(n) || n <= 0) {
-        throw new ArgumentError(`homebrew ${label} must be a positive integer`);
-    }
-    if (n > maxValue) {
-        throw new ArgumentError(`homebrew ${label} must be <= ${maxValue}`);
-    }
-    return n;
-}
-
-export function requireToken(value, label) {
-    const s = String(value ?? '').trim();
-    if (!s) {
-        throw new ArgumentError(`homebrew ${label} is required (e.g. "wget", "gcc@13", "firefox")`);
-    }
-    if (s.length > 100 || !TOKEN.test(s)) {
-        throw new ArgumentError(
-            `homebrew ${label} "${value}" is not a valid token`,
-            'Use letters / digits / "_-.+@", starting with a letter or digit (max 100 chars).',
-        );
-    }
-    return s;
-}
-
-export function requireOneOf(value, allowed, label) {
-    const s = String(value ?? '').trim().toLowerCase();
-    if (!s) throw new ArgumentError(`homebrew ${label} is required`);
-    if (!allowed.includes(s)) {
-        throw new ArgumentError(
-            `homebrew ${label} "${value}" is not supported`,
-            `Allowed: ${allowed.join(', ')}.`,
-        );
-    }
-    return s;
-}
-
-export async function brewFetch(url, label) {
-    let resp;
-    try {
-        resp = await fetch(url, { headers: { 'user-agent': UA, accept: 'application/json' } });
-    }
-    catch (err) {
-        throw new CommandExecutionError(
-            `${label} request failed: ${err?.message ?? err}`,
-            'Check that formulae.brew.sh is reachable from this network.',
-        );
-    }
-    if (resp.status === 404) {
-        throw new EmptyResultError(label, `Homebrew API returned 404 for ${url}.`);
-    }
-    if (resp.status === 429) {
-        throw new CommandExecutionError(
-            `${label} returned HTTP 429 (rate limited)`,
-            'Homebrew throttles bursts; wait a few seconds and retry.',
-        );
-    }
-    if (!resp.ok) {
-        throw new CommandExecutionError(`${label} returned HTTP ${resp.status}`);
-    }
-    let body;
-    try {
-        body = await resp.json();
-    }
-    catch (err) {
-        throw new CommandExecutionError(`${label} returned malformed JSON: ${err?.message ?? err}`);
-    }
-    return body;
-}
-
-/** Coerce a count value (which Homebrew analytics serves as `"139,972"`) to a plain number. */
-export function parseInstallCount(value) {
-    if (value == null) return null;
-    const s = String(value).replace(/,/g, '').trim();
-    if (!s) return null;
-    const n = Number(s);
-    return Number.isFinite(n) ? n : null;
-}
+import{ArgumentError as G,CommandExecutionError as J,EmptyResultError as L}from"@jackwener/opencli/errors";export const BREW_BASE="https://formulae.brew.sh/api";const M="opencli-homebrew-adapter (+https://github.com/jackwener/opencli)",P=/^[A-Za-z0-9][A-Za-z0-9._+@-]*$/;export function requireString(B,z){const q=String(B??"").trim();if(!q)throw new G(`homebrew ${z} cannot be empty`);return q}export function requireBoundedInt(B,z,q,D="limit"){const F=B??z,I=typeof F==="number"?F:Number(F);if(!Number.isInteger(I)||I<=0)throw new G(`homebrew ${D} must be a positive integer`);if(I>q)throw new G(`homebrew ${D} must be <= ${q}`);return I}export function requireToken(B,z){const q=String(B??"").trim();if(!q)throw new G(`homebrew ${z} is required (e.g. "wget", "gcc@13", "firefox")`);if(q.length>100||!P.test(q))throw new G(`homebrew ${z} "${B}" is not a valid token`,'Use letters / digits / "_-.+@", starting with a letter or digit (max 100 chars).');return q}export function requireOneOf(B,z,q){const D=String(B??"").trim().toLowerCase();if(!D)throw new G(`homebrew ${q} is required`);if(!z.includes(D))throw new G(`homebrew ${q} "${B}" is not supported`,`Allowed: ${z.join(", ")}.`);return D}export async function brewFetch(B,z){let q;try{q=await fetch(B,{headers:{"user-agent":M,accept:"application/json"}})}catch(F){throw new J(`${z} request failed: ${F?.message??F}`,"Check that formulae.brew.sh is reachable from this network.")}if(q.status===404)throw new L(z,`Homebrew API returned 404 for ${B}.`);if(q.status===429)throw new J(`${z} returned HTTP 429 (rate limited)`,"Homebrew throttles bursts; wait a few seconds and retry.");if(!q.ok)throw new J(`${z} returned HTTP ${q.status}`);let D;try{D=await q.json()}catch(F){throw new J(`${z} returned malformed JSON: ${F?.message??F}`)}return D}export function parseInstallCount(B){if(B==null)return null;const z=String(B).replace(/,/g,"").trim();if(!z)return null;const q=Number(z);return Number.isFinite(q)?q:null}