repolet 0.1.0 → 0.1.2

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.
Files changed (2) hide show
  1. package/README.md +31 -86
  2. package/package.json +2 -5
package/README.md CHANGED
@@ -1,129 +1,74 @@
1
1
  Repolet
2
2
 
3
- Copy a complete GitHub repository or a specific GitHub folder directly to your local filesystem.
3
+ Copy a GitHub repository or any subfolder directly to your local machine.
4
4
 
5
- Repolet does not create a ZIP file and does not copy the .git history. It downloads the actual files into a normal local directory.
6
5
 
7
- Features
8
6
 
9
- Copy an entire GitHub repository
10
-
11
- Copy only a specific GitHub subfolder
12
-
13
- Support nested folders
14
-
15
- Preserve binary files such as PNG, PDF, MP3, SVG, etc.
16
-
17
- Custom destination folder
18
-
19
- Recursive file discovery
20
-
21
- GitHub token support
22
-
23
- Download progress
24
-
25
- Existing-folder protection
26
-
27
- Installation
28
-
29
- Using npm:
7
+ 🚀 Install
30
8
 
31
9
  npm install -g repolet
32
10
 
33
- Using pnpm:
34
-
35
- pnpm add -g repolet
36
-
37
- Or run directly with:
11
+ Or use without installing:
38
12
 
39
13
  npx repolet <github-url>
40
14
 
41
- Usage
42
-
43
- Copy an entire repository
15
+ 📦 Usage
44
16
 
45
- repolet https://github.com/user/repository
17
+ Copy a repository:
46
18
 
47
- For example:
19
+ repolet https://github.com/facebook/react
48
20
 
49
- repolet https://github.com/Devendradhote001/KODR4-React kodr-repo
21
+ Copy a specific folder:
50
22
 
51
- Creates:
23
+ repolet https://github.com/expressjs/express/tree/master/lib
52
24
 
53
- kodr-repo/
54
- ├── public/
55
- ├── src/
56
- ├── package.json
57
- └── ...
25
+ Choose a destination:
58
26
 
59
- Copy a specific folder
27
+ repolet https://github.com/expressjs/express/tree/master/lib my-lib
60
28
 
61
- repolet https://github.com/user/repository/tree/main/src my-src
29
+ Features
62
30
 
63
- For example:
31
+ Copy full repositories or selected folders
64
32
 
65
- repolet https://github.com/shivsingh78/my-portfolio/tree/main/src my-portfolio-src
33
+ Recursively copy nested directories
66
34
 
67
- Creates:
35
+ Supports binary files such as PNG, PDF, MP3, and SVG
68
36
 
69
- my-portfolio-src/
70
- ├── App.jsx
71
- ├── assets/
72
- ├── components/
73
- ├── index.css
74
- └── main.jsx
37
+ Supports GitHub branches
75
38
 
76
- Destination is optional
39
+ Optional GITHUB_TOKEN authentication
77
40
 
78
- repolet https://github.com/user/repository/tree/main/src
41
+ Protects existing destination folders
79
42
 
80
- Repolet will use the selected folder name as the destination.
43
+ No ZIP files and no .git history
81
44
 
82
- GitHub Authentication
45
+ 🔐 Authentication
83
46
 
84
- Public repositories can be downloaded without authentication.
47
+ Public repositories work without a token.
85
48
 
86
- For private repositories or higher GitHub API limits, set a GitHub fine-grained personal access token:
49
+ For private repositories:
87
50
 
88
51
  export GITHUB_TOKEN="your_token"
89
52
 
90
- Then:
91
-
92
- repolet https://github.com/user/private-repo private-repo
93
-
94
- The token is read from:
95
-
96
- GITHUB_TOKEN
97
-
98
- Repolet does not store the token.
53
+ Windows PowerShell:
99
54
 
100
- For a fine-grained token, use the minimum required repository permissions, such as:
55
+ $env:GITHUB_TOKEN="your_token"
101
56
 
102
- Contents Read-only
57
+ Use a GitHub fine-grained token with Contents: Read-only.
103
58
 
104
- Options
59
+ ⚙️ Options
105
60
 
106
61
  repolet --help
107
62
  repolet --version
108
63
 
109
- Examples
110
-
111
- Copy a complete repository:
112
-
113
- repolet https://github.com/user/repository
114
-
115
- Copy a folder:
116
-
117
- repolet https://github.com/user/repository/tree/main/components
118
-
119
- Copy to a custom directory:
64
+ 🧰 Requirements
120
65
 
121
- repolet https://github.com/user/repository/tree/main/components ui-components
66
+ Node.js 18+
122
67
 
123
- Requirements
68
+ Internet connection
124
69
 
125
- Node.js 18 or newer
70
+ 📄 License
126
71
 
127
- License
72
+ MIT
128
73
 
129
- MIT
74
+ Repolet — take the part of GitHub you actually need.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "repolet",
3
- "version": "0.1.0",
3
+ "version": "0.1.2",
4
4
  "description": "Copy a complete GitHub repository or a specific folder directly to your local filesystem",
5
5
  "type": "module",
6
6
  "main": "src/index.js",
@@ -26,8 +26,5 @@
26
26
  "engines": {
27
27
  "node": ">=18"
28
28
  },
29
- "license": "MIT",
30
- "dependencies": {
31
- "repolet": "file:/home/shivsingh/harikirat/repolet/repolet-0.1.0.tgz"
32
- }
29
+ "license": "MIT"
33
30
  }