gitpick 4.15.0-canary.2 ā 4.15.0-canary.20
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +23 -5
- package/dist/index.mjs +22 -23
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
**Clone exactly what you need aka straightforward project scaffolding!**
|
|
6
6
|
|
|
7
|
-
š¦ `Zero dependencies` / `Un/packed (
|
|
7
|
+
š¦ `Zero dependencies` / `Un/packed (19/8kb)` / `Faster and more features` yet drop-in replacement for `degit`
|
|
8
8
|
|
|
9
9
|
[](https://twitter.com/nrjdalal_dev)
|
|
10
10
|
[](https://www.npmjs.com/package/gitpick)
|
|
@@ -122,9 +122,28 @@ Create a `.gitpick.json` or `.gitpick.jsonc` in your project to pick multiple fi
|
|
|
122
122
|
```jsonc
|
|
123
123
|
// .gitpick.jsonc
|
|
124
124
|
[
|
|
125
|
-
|
|
126
|
-
"owner/repo
|
|
127
|
-
"
|
|
125
|
+
// clone a repo without .git
|
|
126
|
+
"owner/repo",
|
|
127
|
+
"https://github.com/owner/repo",
|
|
128
|
+
// clone a folder aka tree
|
|
129
|
+
"owner/repo/tree/main/path/to/folder",
|
|
130
|
+
"https://github.com/owner/repo/tree/main/path/to/folder",
|
|
131
|
+
// clone a file aka blob
|
|
132
|
+
"owner/repo/blob/main/path/to/file",
|
|
133
|
+
"https://github.com/owner/repo/blob/main/path/to/file",
|
|
134
|
+
// clone a branch
|
|
135
|
+
"owner/repo -b canary",
|
|
136
|
+
"https://github.com/owner/repo -b canary",
|
|
137
|
+
"owner/repo/tree/canary",
|
|
138
|
+
"https://github.com/owner/repo/tree/canary",
|
|
139
|
+
// clone a commit SHA
|
|
140
|
+
"owner/repo -b cc8e93",
|
|
141
|
+
"https://github.com/owner/repo/commit/cc8e93",
|
|
142
|
+
// clone submodules
|
|
143
|
+
"owner/repo -r",
|
|
144
|
+
"https://github.com/owner/repo -r",
|
|
145
|
+
// clone a private repo
|
|
146
|
+
"https://<token>@github.com/owner/repo",
|
|
128
147
|
]
|
|
129
148
|
```
|
|
130
149
|
|
|
@@ -165,7 +184,6 @@ Contributions welcome ā any help is appreciated!
|
|
|
165
184
|
- Fork the repo and create a branch (use descriptive names, e.g. feat/<name> or fix/<name>).
|
|
166
185
|
- Make your changes, add tests if applicable, and run the checks:
|
|
167
186
|
- bun install
|
|
168
|
-
- bun run sync:external
|
|
169
187
|
- bun test
|
|
170
188
|
- Follow the existing code style and commit message conventions (use conventional commits: feat, fix, docs, chore).
|
|
171
189
|
- Open a PR describing the change, motivation, and any migration notes; link related issues.
|
package/dist/index.mjs
CHANGED
|
@@ -1,39 +1,38 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import e from"node:fs";import t from"node:path";import{parseArgs as n,stripVTControlCharacters as r}from"node:util";import i from"node:
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
`),this
|
|
6
|
-
`)
|
|
7
|
-
`)
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
With ${k(`${$(`GitPick`,`https://github.com/nrjdalal/gitpick`)}`)} clone specific directories or files from GitHub!
|
|
2
|
+
import e from"node:fs";import t from"node:path";import{parseArgs as n,stripVTControlCharacters as r}from"node:util";import i from"node:tty";import a from"node:os";import{spawn as o}from"node:child_process";import{once as s}from"node:events";import c from"node:fs/promises";import l from"node:process";import{fileURLToPath as u}from"node:url";const d=i?.WriteStream?.prototype?.hasColors?.()??!1,f=(e,t)=>{if(!d)return e=>e;let n=`\u001B[${e}m`,r=`\u001B[${t}m`;return e=>{let i=e+``,a=i.indexOf(r);if(a===-1)return n+i+r;let o=n,s=0,c=(t===22?r:``)+n;for(;a!==-1;)o+=i.slice(s,a)+c,s=a+r.length,a=i.indexOf(r,s);return o+=i.slice(s)+r,o}},p=f(1,22),m=f(31,39),h=f(32,39),g=f(33,39),_=f(36,39);var v=class extends Error{constructor(...e){super(...e),this.name=`SubprocessError`,this.stdout=``,this.stderr=``}};const y=[`.exe`,`.com`],b={},x=e=>(...t)=>b[t.join(`\0`)]??=e(...t),S=x(async(...e)=>{try{return await c.access(e[0]),!0}catch{return!1}}),C=x(async(e,n,r)=>{let i=r.split(t.delimiter).filter(Boolean).map(e=>e.replace(/^"(.*)"$/,`$1`));try{await Promise.any([n,...i].flatMap(n=>y.map(r=>S(`${t.resolve(n,e)}${r}`))))}catch{return!1}return!0}),w=async(e,t)=>l.platform===`win32`&&!t.shell&&!y.some(t=>e.toLowerCase().endsWith(t))&&!await C(e,t.cwd??`.`,(l.env.PATH||l.env.Path)??``),T=e=>e.replaceAll(/([()\][%!^"`<>&|;, *?])/g,`^$1`),E=e=>T(T(`"${e.replaceAll(/(\\*)"/g,`$1$1\\"`).replace(/(\\*)$/,`$1$1`)}"`)),D=e=>/[^\w./-]/.test(e)?`'${e.replaceAll(`'`,`'\\''`)}'`:e;async function O(e,n=[],i={}){let{stdin:a,stdout:c,stderr:d,stdio:f,cwd:p=`.`,env:m,...h}=i,g=p instanceof URL?u(p):t.resolve(p),_=m?{...l.env,...m}:void 0,y=f??[a,c,d],b=[e,...n].map(e=>D(r(e))).join(` `);[`node`,`node.exe`].includes(e.toLowerCase())&&(e=l.execPath,n=[...l.execArgv.filter(e=>!e.startsWith(`--inspect`)),...n]);let x={...h,stdio:y,env:_,cwd:g};await w(e,x)&&(n=n.map(e=>E(e)),e=T(e),x={...x,shell:!0}),x.shell&&n.length>0&&(e=[e,...n].join(` `),n=[]);let S=o(e,n,x),C=``,O=``;S.stdout&&(S.stdout.setEncoding(`utf8`),S.stdout.on(`data`,e=>C+=e)),S.stderr&&(S.stderr.setEncoding(`utf8`),S.stderr.on(`data`,e=>O+=e)),S.once(`error`,()=>{});try{await s(S,`spawn`)}catch(e){throw Object.assign(new v(`Command failed: ${b}`,{cause:e}),{stdout:C,stderr:O})}await s(S,`close`);let k=e=>e.at(-1)===`
|
|
3
|
+
`?e.slice(0,e.at(-2)===`\r`?-2:-1):e;if(S.exitCode&&S.exitCode>0)throw Object.assign(new v(`Command failed with exit code ${S.exitCode}: ${b}`),{stdout:k(C),stderr:k(O),exitCode:S.exitCode});if(S.signalCode)throw Object.assign(new v(`Command was terminated with ${S.signalCode}: ${b}`),{stdout:k(C),stderr:k(O)});return{stdout:k(C),stderr:k(O)}}const k=l.platform!==`win32`||!!l.env.WT_SESSION||l.env.TERM_PROGRAM===`vscode`,A=e=>!!(e.isTTY&&l.env.TERM!==`dumb`&&!(`CI`in l.env)),j=h(k?`ā`:`ā`),M=k?[`ā `,`ā `,`ā ¹`,`ā ø`,`ā ¼`,`ā “`,`ā ¦`,`ā §`,`ā `,`ā `]:[`-`,`\\`,`|`,`/`],N=(e={})=>{let t=-1,n,i=e.text??``,a=e.stream??l.stderr,o=A(a),s=0,c=0,u=!1,d=e=>a.write(e),f=()=>{if(!(!o||s===0)){a.cursorTo(0);for(let e=0;e<s;e++)e>0&&a.moveCursor(0,-1),a.clearLine(1);s=0}},p=e=>{let t=a.columns??80,n=r(e).split(`
|
|
4
|
+
`),i=0;for(let e of n)i+=Math.max(1,Math.ceil(e.length/t));return i},m=()=>{let e=Date.now();(t===-1||e-c>=80)&&(t=++t%M.length,c=e);let n=M[t],r=`${_(n)} ${i}`;o?(f(),d(r),s=p(r)):d(r+`
|
|
5
|
+
`)};return{start(e){return i=e,u=!0,o&&d(`\x1B[?25l`),m(),o&&(n=setInterval(m,80)),this},success(e){return u?(u=!1,n&&=(clearInterval(n),void 0),f(),o&&d(`\x1B[?25h`),d(`${j} ${e??i}\n`),this):this}}},P=async(n,r)=>{let i=await e.promises.readdir(n,{withFileTypes:!0});await e.promises.mkdir(r,{recursive:!0});for(let a of i){if(a.name===`.git`)continue;let i=t.join(n,a.name),o=t.join(r,a.name);if(a.isDirectory())await P(i,o);else if(a.isSymbolicLink()){let t=await e.promises.readlink(i);await e.promises.symlink(t,o)}else await e.promises.copyFile(i,o)}},F=async(n,r,i)=>{process.platform===`win32`&&await O(`git`,[`config`,`--global`,`core.longpaths`,`true`]);let o=`https://${n.token?n.token+`@`:n.token}github.com/${n.owner}/${n.repository}.git`,s=t.resolve(a.tmpdir(),`${n.repository}-${Date.now()}${Math.random().toString(16).slice(2,6)}`),c=N(),l=performance.now();r.watch||c.start(`Picking ${n.type}${n.type===`repository`?` without .git`:` from repository`}...`);try{await O(`git`,[`clone`,o,s,`--branch`,n.branch,`--depth`,`1`,`--single-branch`,...r.recursive?[`--recursive`]:[]])}catch{await O(`git`,[`clone`,o,s,...r.recursive?[`--recursive`]:[]]),await O(`git`,[`checkout`,n.branch],{cwd:s})}let u=t.resolve(s,n.path);(await e.promises.stat(u)).isDirectory()?(await e.promises.mkdir(i,{recursive:!0}),await P(u,i)):(await e.promises.mkdir(t.dirname(i),{recursive:!0}),await e.promises.copyFile(u,i)),r.watch?console.log(`- Synced at `+new Date().toLocaleTimeString()):c.success(`Picked ${n.type}${n.type===`repository`?` without .git`:` from repository`} in ${((performance.now()-l)/1e3).toFixed(2)} seconds.`),await e.promises.rm(s,{recursive:!0,force:!0})};function I(e){if(typeof e==`number`||/^\d+$/.test(e))return typeof e==`number`?e:parseInt(e,10);let t=/(\d+)([hms])/g,n=0,r;for(;(r=t.exec(e))!==null;){let e=parseInt(r[1],10);switch(r[2]){case`h`:n+=e*36e5;break;case`m`:n+=e*6e4;break;case`s`:n+=e*1e3;break}}return n}const L=async e=>{let t=(await O(`git`,[`ls-remote`,e])).stdout,n=t.match(/(.+)\s+HEAD/)?.[1],r=t.match(RegExp(`${n}\\s+refs/heads/(.+)`))?.[1];if(!r)throw Error(`Could not determine default branch!`);return r};async function R(e,{branch:t,target:n}){let r=/^https:\/\/([^@]+)@github\.com/,i=e.match(r),a=``;i&&(a=i[1],e=e.replace(r,`https://github.com`));for(let t of[`git@github.com:`,`https://github.com/`,`https://raw.githubusercontent.com/`])if(e.startsWith(t)){e=e.replace(t,``);break}let o=e.split(`/`),s=o[0],c=o[1].endsWith(`.git`)?o[1].slice(0,-4):o[1],l=o[2]===`blob`?`blob`:o[2]===`tree`?`tree`:o[2]+o[3]===`refsheads`?`raw`:`repository`,u=t||(l===`repository`?await L(`https://${a&&a+`@`}github.com/${s}/${c}`):l===`raw`?o[4]:o[3]),d=l?l===`raw`?o.slice(5).join(`/`):o.slice(4).join(`/`):o.slice(2).join(`/`)||`/`,f=n||(l===`blob`?`.`:d.split(`/`).pop()||c);return{token:a,owner:s,repository:c,type:l,branch:u,path:d,target:f}}const z=Symbol(`singleComment`),B=Symbol(`multiComment`),V=(e,t,n)=>e.slice(t,n).replace(/[^ \t\r\n]/g,` `),H=(e,t)=>{let n=t-1,r=0;for(;e[n]===`\\`;)--n,r+=1;return!!(r%2)};function U(e){if(typeof e!=`string`)throw TypeError(`Expected argument \`jsonString\` to be a \`string\`, got \`${typeof e}\``);let t=!1,n=!1,r=0,i=``,a=``,o=-1;for(let s=0;s<e.length;s++){let c=e[s],l=e[s+1];if(!n&&c===`"`&&(H(e,s)||(t=!t)),!t)if(!n&&c+l===`//`)i+=e.slice(r,s),r=s,n=z,s++;else if(n===z&&c+l===`\r
|
|
6
|
+
`){s++,n=!1,i+=V(e,r,s),r=s;continue}else if(n===z&&c===`
|
|
7
|
+
`)n=!1,i+=V(e,r,s),r=s;else if(!n&&c+l===`/*`){i+=e.slice(r,s),r=s,n=B,s++;continue}else if(n===B&&c+l===`*/`){s++,n=!1,i+=V(e,r,s+1),r=s+1;continue}else n||(o===-1?c===`,`&&(a+=i+e.slice(r,s),i=``,r=s,o=s):c===`}`||c===`]`?(i+=e.slice(r,s),a+=V(i,0,1)+i.slice(1),i=``,r=s,o=-1):c!==` `&&c!==` `&&c!==`\r`&&c!==`
|
|
8
|
+
`&&(i+=e.slice(r,s),r=s,o=-1))}let s=n===z?V(e,r):e.slice(r);return a+i+s}const W=[`.gitpick.json`,`.gitpick.jsonc`],G=async()=>{let n;for(let r of W){let i=t.resolve(r);if(e.existsSync(i)){n=i;break}}if(!n)return!1;let r=await e.promises.readFile(n,`utf-8`),i=JSON.parse(U(r));if(!Array.isArray(i)||!i.every(e=>typeof e==`string`))throw Error(`${t.basename(n)} must be an array of strings`);for(let e of i)await O(process.argv[0],[...process.argv.slice(1),...e.split(/\s+/),`-o`],{stdio:`inherit`});return!0};var K=`gitpick`,q=`4.15.0-canary.20`;const J=(e,t)=>`\x1b]8;;${t}\x07${e}\x1b]8;;\x07`,Y=`
|
|
9
|
+
With ${p(`${J(`GitPick`,`https://github.com/nrjdalal/gitpick`)}`)} clone specific directories or files from GitHub!
|
|
11
10
|
|
|
12
|
-
$ gitpick ${
|
|
11
|
+
$ gitpick ${g(`<url>`)} ${h(`[target]`)} ${_(`[options]`)}
|
|
13
12
|
|
|
14
|
-
${
|
|
13
|
+
${p(`Hint:`)}
|
|
15
14
|
[target] and [options] are optional and if not specified,
|
|
16
15
|
GitPick fallbacks to the default behavior of \`git clone\`
|
|
17
16
|
|
|
18
|
-
${
|
|
19
|
-
${
|
|
20
|
-
${
|
|
17
|
+
${p(`Arguments:`)}
|
|
18
|
+
${g(`url`)} GitHub URL with path to file/folder/repository
|
|
19
|
+
${h(`target`)} Directory to clone into (optional)
|
|
21
20
|
|
|
22
|
-
${
|
|
23
|
-
${
|
|
24
|
-
${
|
|
25
|
-
${
|
|
26
|
-
${
|
|
21
|
+
${p(`Options:`)}
|
|
22
|
+
${_(`-b, --branch `)} Branch/SHA to clone
|
|
23
|
+
${_(`-o, --overwrite`)} Skip overwrite prompt
|
|
24
|
+
${_(`-r, --recursive`)} Clone submodules
|
|
25
|
+
${_(`-w, --watch [time]`)} Watch the repository and sync every [time]
|
|
27
26
|
(e.g. 1h, 30m, 15s)
|
|
28
|
-
${
|
|
29
|
-
${
|
|
27
|
+
${_(`-h, --help`)} display help for command
|
|
28
|
+
${_(`-v, --version`)} display the version number
|
|
30
29
|
|
|
31
|
-
${
|
|
30
|
+
${p(`Examples:`)}
|
|
32
31
|
$ gitpick <url>
|
|
33
32
|
$ gitpick <url> [target]
|
|
34
33
|
$ gitpick <url> [target] -b [branch/SHA]
|
|
35
34
|
$ gitpick <url> [target] -w [time]
|
|
36
35
|
$ gitpick <url> [target] -b [branch/SHA] -w [time]
|
|
37
36
|
|
|
38
|
-
š More awesome tools at ${
|
|
37
|
+
š More awesome tools at ${_(`https://github.com/nrjdalal`)}`,X=e=>{try{return n(e)}catch(e){throw Error(`Error parsing arguments: ${e.message}`)}};(async()=>{try{let{positionals:n,values:r}=X({allowPositionals:!0,options:{branch:{type:`string`,short:`b`},force:{type:`boolean`,short:`f`},help:{type:`boolean`,short:`h`},overwrite:{type:`boolean`,short:`o`},recursive:{type:`boolean`,short:`r`},version:{type:`boolean`,short:`v`},watch:{type:`string`,short:`w`}}});n.length||(r.version&&(console.log(`\n${K}@${q}`),process.exit(0)),await G()&&process.exit(0),console.log(Y),process.exit(0)),n[0]===`clone`&&n.shift();let[i,a]=n,o={branch:r.branch,force:r.force,overwrite:r.overwrite,recursive:r.recursive,watch:r.watch};console.log(`\nWith ${p(`${J(`GitPick`,`https://github.com/nrjdalal/gitpick`)}`)} clone specific files, folders, branches, commits and more from GitHub!`);let s=await R(i,{branch:o.branch,target:a});if(s.type===`blob`){let e=s.target.split(`/`).filter(e=>e!==``),t=e[e.length-1];t!==`.`&&t!==`..`&&t.includes(`.`)?e.pop():t=s.path.split(`/`).pop()||t,s.target=[...e,t].join(`/`)}console.info(`\n${h(`ā`)} ${s.owner}/${s.repository} ${_(s.type+`:`+s.branch)} ${s.type===`repository`?`> ${h(s.target)}`:`${s.path.length?g(s.path)+` >`:`>`} ${h(s.target)}`}`);let c=t.resolve(s.target);if(o.overwrite=o.overwrite||o.force,o.watch&&(o.overwrite=!0),e.existsSync(c)&&!o.overwrite&&(s.type===`blob`&&(console.log(`${g(`\nWarning: The target file exists at ${h(s.target)}. Use ${_(`-f`)} or ${_(`-o`)} to overwrite.`)}`),process.exit(1)),(await e.promises.readdir(c)).length&&(console.log(`${g(`\nWarning: The target directory exists at ${h(s.target)} and is not empty. Use ${_(`-f`)} or ${_(`-o`)} to overwrite.`)}`),process.exit(1))),o.watch){console.log(`\nš Watching every ${I(o.watch)/1e3+`s`}\n`),await F(s,o,c);let e=I(o.watch);setInterval(async()=>await F(s,o,c),e)}else await F(s,o,c),process.exit(0)}catch(e){e instanceof Error?console.log(p(`\n${m(`Error: `)}`)+e.message):console.log(p(`${m(`
|
|
39
38
|
Unexpected Error: `)}`)+JSON.stringify(e,null,2)),process.exit(1)}})();export{};
|