mobiletto 1.2.0 → 2.0.0

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 (127) hide show
  1. package/lib/cjs/index.d.ts +2 -0
  2. package/lib/cjs/index.js +30 -0
  3. package/lib/cjs/package.json +16 -0
  4. package/lib/esm/index.d.ts +2 -0
  5. package/lib/esm/index.js +12 -0
  6. package/package.json +27 -13
  7. package/.babelrc +0 -5
  8. package/.eslintrc.js +0 -14
  9. package/docs/README.md +0 -113
  10. package/docs/af/README.md +0 -481
  11. package/docs/am/README.md +0 -481
  12. package/docs/ar/README.md +0 -481
  13. package/docs/az/README.md +0 -481
  14. package/docs/be/README.md +0 -481
  15. package/docs/bg/README.md +0 -481
  16. package/docs/bn/README.md +0 -481
  17. package/docs/bs/README.md +0 -481
  18. package/docs/ca/README.md +0 -481
  19. package/docs/ceb/README.md +0 -481
  20. package/docs/co/README.md +0 -481
  21. package/docs/cs/README.md +0 -481
  22. package/docs/cy/README.md +0 -481
  23. package/docs/da/README.md +0 -481
  24. package/docs/de/README.md +0 -481
  25. package/docs/el/README.md +0 -481
  26. package/docs/eo/README.md +0 -481
  27. package/docs/es/README.md +0 -481
  28. package/docs/et/README.md +0 -481
  29. package/docs/eu/README.md +0 -481
  30. package/docs/fa/README.md +0 -481
  31. package/docs/fi/README.md +0 -481
  32. package/docs/fr/README.md +0 -481
  33. package/docs/fy/README.md +0 -481
  34. package/docs/ga/README.md +0 -481
  35. package/docs/gd/README.md +0 -481
  36. package/docs/gl/README.md +0 -481
  37. package/docs/gu/README.md +0 -481
  38. package/docs/ha/README.md +0 -481
  39. package/docs/haw/README.md +0 -481
  40. package/docs/he/README.md +0 -481
  41. package/docs/hi/README.md +0 -481
  42. package/docs/hmn/README.md +0 -481
  43. package/docs/hr/README.md +0 -481
  44. package/docs/ht/README.md +0 -481
  45. package/docs/hu/README.md +0 -481
  46. package/docs/hy/README.md +0 -481
  47. package/docs/id/README.md +0 -481
  48. package/docs/ig/README.md +0 -481
  49. package/docs/is/README.md +0 -481
  50. package/docs/it/README.md +0 -481
  51. package/docs/iw/README.md +0 -481
  52. package/docs/ja/README.md +0 -481
  53. package/docs/jv/README.md +0 -481
  54. package/docs/ka/README.md +0 -481
  55. package/docs/kk/README.md +0 -481
  56. package/docs/km/README.md +0 -481
  57. package/docs/kn/README.md +0 -481
  58. package/docs/ko/README.md +0 -481
  59. package/docs/ku/README.md +0 -481
  60. package/docs/ky/README.md +0 -481
  61. package/docs/la/README.md +0 -481
  62. package/docs/lb/README.md +0 -481
  63. package/docs/lo/README.md +0 -481
  64. package/docs/lt/README.md +0 -481
  65. package/docs/lv/README.md +0 -481
  66. package/docs/mg/README.md +0 -481
  67. package/docs/mi/README.md +0 -481
  68. package/docs/mk/README.md +0 -481
  69. package/docs/ml/README.md +0 -481
  70. package/docs/mn/README.md +0 -481
  71. package/docs/mr/README.md +0 -481
  72. package/docs/ms/README.md +0 -481
  73. package/docs/mt/README.md +0 -481
  74. package/docs/my/README.md +0 -481
  75. package/docs/ne/README.md +0 -481
  76. package/docs/nl/README.md +0 -481
  77. package/docs/no/README.md +0 -481
  78. package/docs/ny/README.md +0 -481
  79. package/docs/or/README.md +0 -481
  80. package/docs/pa/README.md +0 -481
  81. package/docs/pl/README.md +0 -481
  82. package/docs/ps/README.md +0 -481
  83. package/docs/pt/README.md +0 -481
  84. package/docs/ro/README.md +0 -481
  85. package/docs/ru/README.md +0 -481
  86. package/docs/rw/README.md +0 -481
  87. package/docs/sd/README.md +0 -481
  88. package/docs/si/README.md +0 -481
  89. package/docs/sk/README.md +0 -481
  90. package/docs/sl/README.md +0 -481
  91. package/docs/sm/README.md +0 -481
  92. package/docs/sn/README.md +0 -481
  93. package/docs/so/README.md +0 -481
  94. package/docs/sq/README.md +0 -481
  95. package/docs/sr/README.md +0 -481
  96. package/docs/st/README.md +0 -481
  97. package/docs/su/README.md +0 -481
  98. package/docs/sv/README.md +0 -481
  99. package/docs/sw/README.md +0 -481
  100. package/docs/ta/README.md +0 -481
  101. package/docs/te/README.md +0 -481
  102. package/docs/tg/README.md +0 -481
  103. package/docs/th/README.md +0 -481
  104. package/docs/tk/README.md +0 -481
  105. package/docs/tl/README.md +0 -481
  106. package/docs/tr/README.md +0 -481
  107. package/docs/tt/README.md +0 -481
  108. package/docs/ug/README.md +0 -481
  109. package/docs/uk/README.md +0 -481
  110. package/docs/ur/README.md +0 -481
  111. package/docs/uz/README.md +0 -481
  112. package/docs/vi/README.md +0 -481
  113. package/docs/xh/README.md +0 -481
  114. package/docs/yi/README.md +0 -481
  115. package/docs/yo/README.md +0 -481
  116. package/docs/zh/README.md +0 -481
  117. package/docs/zu/README.md +0 -481
  118. package/drivers/b2/index.js +0 -451
  119. package/drivers/local/index.js +0 -315
  120. package/drivers/s3/index.js +0 -316
  121. package/hokey.json +0 -16
  122. package/index.js +0 -10
  123. package/test/api.spec.js +0 -512
  124. package/test/crypt.spec.js +0 -67
  125. package/util/crypt.js +0 -80
  126. package/util/logger.js +0 -27
  127. package/util/redis.js +0 -233
package/docs/sn/README.md DELETED
@@ -1,481 +0,0 @@
1
- Mobiletto
2
- =========
3
-
4
- Mobiletto iJavaScript yekuchengetera abstraction layer, ine sarudzo yakajeka mutengi-padivi encryption.
5
-
6
- # Zviri mukati
7
- * [Nei Mobiletto?](#Sei-Mobiletto?)
8
- * [Kurumidza kutanga](#Kurumidza-kutanga)
9
- * [Mobiletto CLI](#mobiletto-cli)
10
- * [Kwakabva](#Mabviro)
11
- * [Kuiswa](#Kuiswa)
12
- * [Kutsigira uye Mari](#Kutsigira-uye-Mari)
13
- * [Basic kushandiswa](#Basic-kushandisa)
14
- * [Metadata](#Metadata)
15
- * [Mamwe maitiro ekunze](#Alternate-import-style)
16
- * [Kuchengeta](#Kuchengeta)
17
- * [Mirroring](#Mirroring)
18
- * [Transparent encryption](#Transparent-encryption)
19
- * [Kiyi kutenderera](#Kiyi-kutenderera)
20
- * [Mutyairi interface](#Driver-interface)
21
- * [Kutema](#Logging)
22
-
23
- # Verenga izvi mune mumwe mutauro
24
- Gwaro iri README.md rakashandurwa, kuburikidza ne[hokeylization](https://github.com/cobbzilla/hokeylization), kupinda
25
- **[mitauro yese inotsigirwa neGoogle Translate](https://cloud.google.com/translate/docs/languages)!**
26
-
27
- Ndine chokwadi kuti haina kukwana, asi ndinovimba iri nani pane hapana!
28
-
29
- [🇸🇦 ChiArabic](../ar/README.md)
30
- [🇧🇩 Chibengali](../bn/README.md)
31
- [🇩🇪 ChiGerman](../de/README.md)
32
- [🇺🇸 Chirungu](../en/README.md)
33
- [🇪🇸 Spanish](../es/README.md)
34
- [🇫🇷 French](../fr/README.md)
35
- [🇹🇩 Hausa](../ha/README.md)
36
- [🇮🇳 Hindi](../hi/README.md)
37
- [🇮🇩 Indonesian](../id/README.md)
38
- [🇮🇹 Italian](../it/README.md)
39
- [🇯🇵 Japanese](../ja/README.md)
40
- [🇰🇷 Korean](../ko/README.md)
41
- [🇮🇳 Marathi](../mr/README.md)
42
- [🇵🇱 Polish](../pl/README.md)
43
- [🇧🇷 Chiputukezi](../pt/README.md)
44
- [🇷🇺 Russian](../ru/README.md)
45
- [🇰🇪 Swahili](../sw/README.md)
46
- [🇵🇭 Tagalog](../tl/README.md)
47
- [🇹🇷 Turkish](../tr/README.md)
48
- [🇵🇰 Urdu](../ur/README.md)
49
- [🇻🇳 Vietnamese](../vi/README.md)
50
- [🇨🇳 Chinese](../zh/README.md)
51
-
52
-
53
- **[📚 ... Mitauro Yese ...](../README.md)**
54
- ----
55
-
56
- ### Pane dambudziko here neshanduro iyi yeREADME?
57
- Iyi chaiyo shanduro yepakutanga [README](https://github.com/cobbzilla/mobiletto/blob/master/README.md)
58
- inogona kunge isina kukanganisa -- *kugadzirisa kunogamuchirwa!* Ndokumbira utumire [kudhonza chikumbiro paGitHub](https://github.com/cobbzilla/mobiletto/pulls),
59
- kana kuti kana usina kusununguka kuita izvozvo, [vhura nyaya](https://github.com/cobbzilla/mobiletto/issues)
60
-
61
- Kana iwe ukagadzira itsva GitHub nyaya nezve dudziro, ndapota ita:
62
- * sanganisira iyo URL peji (kopi/namira kubva kubrowser kero bar)
63
- * sanganisira iwo chaiwo mameseji asiri iwo (kopi/namira kubva kubrowser)
64
- * ndapota tsanangura kuti chii chakaipa -- shanduro haina kururama here? iyo fomati yakatyoka neimwe nzira?
65
- * nemutsa ipa zano reshanduro iri nani, kana kuti mashoko acho anofanira kurongwa zvakanaka sei
66
- * **Ndatenda!**
67
-
68
- ## Sei Mobiletto?
69
-
70
- ### Kwaziwai mutengesi kukiya-mukati!
71
- Iwo akasiyana-siyana ekuchengetedza gore ane asingaenderane APIs. Kunyangwe avo vanovavarira "S3 kuenderana"
72
- vane maitiro asina musoro.
73
-
74
- Paunosarudza imwe yekuchengetera mutengesi yeapp yako, kana iwe ukakodha zvakananga kune yavo API, yako app
75
- yava kutsamira pasevhisi iyoyo. Sezvo nguva inofamba uye kodhi inounganidza, kuchinja vatengesi kunova
76
- kuwedzera kusatendeseka. Kugamuchirwa kune inonakidza nyika yevatengesi kukiya-mukati!
77
-
78
- Mobiletto yakagadzirirwa kugadzirisa dambudziko iri. Nekukodha app yako kune mobiletto's API, unogona nyore
79
- chinja vanopa kuchengetedza uye uzive kuti dura rekuchengetedza reapp yako rinoita zvakafanana.
80
-
81
- ### Kuedza kwakadzama
82
- Vese vatyairi vanoongororwa maitiro akafanana ne60+ bvunzo kumutyairi wega wega.
83
- Isu tinoedza vese vatyairi nemusanganiswa wese we:
84
- * Encryption: ese akagoneswa uye akaremara
85
- * Redis cache: ese akagoneswa uye akaremara
86
-
87
- Iyi nzira inotipa runyararo-rwepfungwa kuti mobiletto ichaita zvimwe chete zvisinei kuti unoshandisa mutyairi upi,
88
- uye zvisinei nekuti unogonesa caching uye/kana encryption.
89
-
90
- ### Tsigiro yemutyairi
91
- Iyezvino Mobiletto kuchengetedza madhiraivha:
92
- * `s3` : Amazon S3
93
- * `b2` : Backblaze B2
94
- * `local` : yenzvimbo faira system
95
-
96
- *Mipiro yekutsigira mamwe vatariri vekuchengetedza gore inogamuchirwa kwazvo!*
97
-
98
- ## mobiletto-cli
99
- Mobiletto inotarisirwa kushandiswa seraibhurari neimwe JavaScript kodhi.
100
-
101
- Kuti ushande nemobiletto pamutsetse wekuraira, shandisa [mobiletto-cli](https://www.npmjs.com/package/mobiletto-cli)
102
-
103
- ## Source
104
- * [mobiletto paGitHub](https://github.com/cobbzilla/mobiletto)
105
- * [mobiletto pa npm](https://www.npmjs.com/package/mobiletto)
106
-
107
- ## Tsigiro uye Mari
108
- Ndiri kuyedza kuve nyanzvi yakavhurika sosi software yekuvandudza. Ndanga ndichishanda mu
109
- indasitiri yemasoftware kwemakore mazhinji, ndakatanga makambani akabudirira uye ndikaatengesa kumakambani eruzhinji.
110
- Munguva ichangopfuura ndakarasikirwa nebasa rangu, uye handina chaizvoizvo rimwe basa ripi neripi rakarongwa
111
-
112
- Saka ndichaedza kunyora software inobatsira uye kuona kana izvo zvinoshanda
113
-
114
- Kana iwe uchinakidzwa nekushandisa iyi software, ndingatenda zvikuru kunyangwe iyo
115
- diki [mupiro wepamwedzi nePatreon](https://www.patreon.com/cobbzilla)
116
-
117
- *Ndatenda!*
118
-
119
- ## Kuiswa
120
- Isa uchishandisa `npm` kana `yarn` . Iwe unogona kunge uchida iyo `lite` isingasanganisire ese
121
- mafaira akaturikirwa README:
122
-
123
- npm install mobiletto-lite
124
- yarn add mobiletto-lite
125
-
126
- Kana iwe uchinyatsoda iwo README mafaera mumitauro yese, isa iyo yakazara vhezheni:
127
-
128
- npm install mobiletto
129
- yarn add mobiletto
130
-
131
- ## Kurumidza Kutanga
132
- Muenzaniso mupfupi uchishandisa mobiletto `s3` mutyairi.
133
-
134
- Kodhi iyi yaizomhanya zvakafanana kana mutyairi ari `b2` kana `local` .
135
-
136
- const storage = require('mobiletto')
137
- const bucket = await storage.connect('s3', aws_key, aws_secret, {bucket: 'bk'})
138
-
139
- // list objects: returns array of metadata objects
140
- const listing = await bucket.list()
141
- const dirList = await bucket.list('some/dir/')
142
- const everything = await bucket.list('', {recursive: true})
143
-
144
- // write an entire file
145
- let bytesWritten = await bucket.writeFile('some/path', someBufferOfData)
146
-
147
- // write a file from a stream/generator
148
- bytesWritten = await bucket.write('some/path', streamOrGenerator)
149
-
150
- // read an entire file
151
- // returns null if an exception would otherwise be thrown
152
- const bufferOrNull = await bucket.safeReadFile('some/path')
153
-
154
- // stream-read a file, passing data to callback
155
- const bytesRead = await bucket.read('some/path', (chunk) => { ...do something with chunk... } )
156
-
157
- // remove a file, returns the path removed
158
- let removed = await bucket.remove('some/path') // removed is a string
159
-
160
- // remove a directory, returns array of paths removed
161
- removed = await bucket.remove('some/directory', {recursive: true}) // removed is now an array!
162
-
163
- ----
164
- ## Basic kushandiswa
165
- Muenzaniso wakawedzera wakawedzera, unoratidza mazhinji ezvimiro zvinopihwa:
166
-
167
- const { mobiletto } = require('mobiletto')
168
-
169
- // General usage
170
- const api = await mobiletto(driverName, key, secret, opts)
171
-
172
- // To use 'local' driver:
173
- // * key: base directory
174
- // * secret: ignored, can be null
175
- // * opts object:
176
- // * readOnly: optional, never change anything on the filesystem; default is false
177
- // * fileMode: optional, permissions used when creating new files, default is 0600. can be string or integer
178
- // * dirMode: optional, permissions used when creating new directories, default is 0700. can be string or integer
179
- const local = await mobiletto('local', '/home/ubuntu/tmp', null, {fileMode: 0o0600, dirMode: '0700'})
180
-
181
- // To use 's3' driver:
182
- // * key: AWS Access Key ID
183
- // * secret: AWS Secret Key
184
- // * opts object:
185
- // * readOnly: optional, never change anything on the bucket; default is false
186
- // * bucket: required, name of the S3 bucket
187
- // * region: optional, the AWS region to communicate with, default is us-east-1
188
- // * prefix: optional, all read/writes within the S3 bucket will be under this prefix
189
- // * delimiter: optional, directory delimiter, default is '/' (note: always '/' when encryption is enabled)
190
- const s3 = await mobiletto('s3', aws_key, aws_secret, {bucket: 'bk', region: 'us-east-1'})
191
-
192
- // To use 'b2' driver:
193
- // * key: Backblaze Key ID
194
- // * secret: Backblaze Application Key
195
- // * opts object:
196
- // * readOnly: optional, never change anything on the bucket; default is false
197
- // * bucket: required, the ID (**not the name**) of the B2 bucket
198
- // * prefix: optional, all read/writes within the B2 bucket will be under this prefix
199
- // * delimiter: optional, directory delimiter, default is '/' (note: always '/' when encryption is enabled)
200
- // * partSize: optional, large files will be split into chunks of this size when uploading
201
- const b3 = await mobiletto('b2', b2_key_id, b2_app_key, {bucket: 'bk', partSize: 10000000})
202
-
203
- // List files
204
- api.list() // --> returns an array of metadata objects
205
-
206
- // List files recursively
207
- api.list({ recursive: true })
208
-
209
- // List files in a directory
210
- const path = 'some/path'
211
- api.list(path)
212
- api.list(path, { recursive: true }) // also supports recursive flag
213
-
214
- // Visit files in a directory -- visitor function must be async
215
- api.list(path, { visitor: myAsyncFunc })
216
- api.list(path, { visitor: myAsyncFunc, recursive: true })
217
-
218
- // The `list` method throws MobilettoNotFoundError if the path does not exist
219
- // When you call `safeList` on a non-existent path, it returns an empty array
220
- api.safeList('/path/that/does/not/exist') // returns []
221
-
222
- // Read metadata for a file
223
- api.metadata(path) // returns metadata object
224
-
225
- // The `metadata` method throws MobilettoNotFoundError if the path does not exist
226
- // When you call `safeMetadata` on a non-existent path, it returns null
227
- api.safeMetadata('/tmp/does_not_exist') // returns null
228
-
229
- // Read a file
230
- // Provide a callback that writes the data someplace
231
- const callback = (chunk) => { ... write chunk somewhere ... }
232
- api.read(path, callback) // returns count of bytes read
233
-
234
- // Read an entire file at once
235
- const data = await api.readFile(path) // returns a byte Buffer of the file contents
236
-
237
- // Read an entire file at once
238
- // returns null if an exception would otherwise be thrown
239
- const bufferOrNull = await bucket.safeReadFile('some/path')
240
-
241
- // Write a file
242
- // Provide a generator function that yields chunks of data
243
- const generator = function* () {
244
- while ( ... more-data-to-return ... ) {
245
- data = ... load-data ...
246
- yield data
247
- }
248
- }
249
- local.api(path, generator) // returns count of bytes written
250
-
251
- // Write an entire file at once (convenience method)
252
- await api.writeFile(path, bufferOrString) // returns count of bytes written
253
-
254
- // Delete a file
255
- // Quiet param is optional (default false), when set errors will not be thrown if the path does not exist
256
- // Always returns a value or throws an error.
257
- // Return value may be a single string of the file removed, or an array of all files removed (driver-dependent)
258
- const quiet = true
259
- api.remove(path, {quiet}) // returns single path removed
260
-
261
- // Recursively delete a directory and do it quietly (do not report errors)
262
- const recursive = true
263
- const quiet = true
264
- api.remove(path, {recursive, quiet}) // returns array of paths removed
265
-
266
- ## Metadata
267
- Iwo `metadata` murairo unodzosa metadata nezve imwechete filesystem yekupinda.
268
- Saizvozvowo, kukosha kwekudzoka kubva ku `list` .
269
-
270
- Chinhu chemetadata chinotaridzika seizvi:
271
-
272
- {
273
- "name": "fully/qualified/path/to/file",
274
- "type": "entry-type",
275
- "size": size-in-bytes,
276
- "ctime": creation-time-epoch-millis,
277
- "mtime": modification-time-epoch-millis
278
- }
279
-
280
- The `type` pfuma inogona kuva `file` , `dir` , `link` , kana `special` .
281
-
282
- Zvichienderana nerudzi rwemutyairi, `list` command inogona kusadzosa nzvimbo dzese. The `name` uye `type` zvivakwa
283
- inofanira kuvapo nguva dzose. Murairo unotevera `metadata` uchadzosa zvese zviripo.
284
-
285
- ## Imwe nzira yekupinza
286
- Ngenisa iyo yakazara-yakakwenenzverwa module uye shandisa iyo `connect` basa:
287
-
288
- const storage = require('mobiletto')
289
- const opts = {bucket: 'bk', region: 'us-east-1'}
290
- const s3 = await storage.connect('s3', aws_key, aws_secret, opts)
291
- const objectData = await s3.readFile('some/path')
292
-
293
- ## Kuchengeta
294
- Mobiletto inoshanda zvakanyanya ne <a href="https://redis.io">redis</a> cache.
295
-
296
- Mobiletto ichaedza kubatanidza kune redis muenzaniso pa127.0.0.1:6379
297
-
298
- Iwe unogona kukanganisa chimwe cheizvi:
299
- * Seta iyo `MOBILETTO_REDIS_HOST` env var, mobiletto batanidza pano pane yemunohost
300
- * Seta iyo `MOBILETTO_REDIS_PORT` env var, chiteshi ichi chichashandiswa
301
-
302
- Mobiletto ichachengeta makiyi ayo ese eredis ane prefix `_mobiletto__` . Unogona kushandura izvi
303
- nekuisa iyo `MOBILETTO_REDIS_PREFIX` env var.
304
-
305
- Iwe unogona zvakare kuseta yega-yekubatanidza caching `opts.redisConfig` chinhu:
306
-
307
- const redisConfig = {
308
- enabled: true, // optional, default is true. if false other props are ignored
309
- host: '127.0.0.1',
310
- port: 6379,
311
- prefix: '_mobiletto__'
312
- }
313
- const opts = { redisConfig, bucket: 'bk', region: 'us-east-1' }
314
- const s3 = await storage.connect('s3', aws_key, aws_secret, opts)
315
-
316
- ### Hausi kuda redis caching?
317
- Kudzima: pfuura `enabled: false` chako `opts.redisConfig` chako.
318
-
319
- Sezvakakurukurwa pazasi, kudzima caching kuchava nemhedzisiro yakaipa pakuita uye kuunza zvimwe zvikumbiro
320
- kuti uchengete zvaunonyatsoda.
321
-
322
- ### Caching nhungamiro
323
- ** Chengetedzo yakavharidzirwa **: kuverenga / kunyora encrypted kuchengetedza kunongo nonoka pane zvakajairika,
324
- asi kufamba uchitenderedza madhairekitori (anoitwa nezvimwe zvinhu) anodhura. Kushandisa redis cache
325
- ichakupa kukosha kwekuita kwekusimudzira.
326
-
327
- Iyo default cache yakachengeteka, asi haina kuita zvakanaka kana uine yakawanda yekunyora/kubvisa maoperation.
328
- Chero kunyora kana kubvisa mashandiro anoita kuti cache yese isashande, kuve nechokwadi kuti inotevera kuverenga ichaona iyo
329
- shanduko dzichangoburwa.
330
-
331
- ### CLI zvishandiso
332
- Kana uri kushandisa CLI chishandiso senge [mobiletto-cli](https://www.npmjs.com/package/mobiletto-cli),
333
- iwe zvechokwadi uchada kuti redis cache igoneswe, sezvo inogara mukati mekukumbira kweiyo `mo` murairo.
334
-
335
- ## Mirroring
336
-
337
- // Copy a local filesystem mobiletto to S3
338
- s3.mirror(local)
339
-
340
- // Mirror a local subdirectory from one mobiletto to an S3 mobiletto, with it's own subdirectory
341
- local.mirror(s3, 'some/local-folder', 'some/s3-folder')
342
-
343
- Iwo `mirror` rairo rinoita kopi-yenguva yemafaira ese kubva kune imwe mobiletto kuenda kune imwe.
344
- Iyo haimhanyi chero nzira yekuchengetedza girazi nekufamba kwenguva. Mhanya iyo `mirror` kuraira zvakare
345
- kuwiriranisa chero mafaira asipo.
346
-
347
- Iko kukosha kwekudzoka kubva `mirror` chinhu chiri nyore chine zviverengero zvekuti mangani mafaera akabudirira
348
- mirrored uye mangani mafaera aive nezvikanganiso:
349
-
350
- {
351
- success: count-of-files-mirrored,
352
- errors: count-of-files-with-errors
353
- }
354
-
355
- YAMBIRO: Kuona maseti makuru edata anogona kutora nguva zvakanyanya uye bandwidth-yakanyanya
356
-
357
- `mirror` yekufona semantics dzimwe nguva zvinogona kuvhiringa kunzwisisa kuti ndiani
358
- muverengi uye munyori ndiani. Fungidzira kunge chirevo chekugoverwa: iyo "ruboshwe-ruboshwe mobiletto"
359
- ndicho chinhu chiri kupihwa (yakamisikidzwa data yakanyorwa), uye "kurudyi-kurudyi mobiletto" (the
360
- nharo kune `mirror` nzira) ndiko kukosha kuri kupihwa (mirrored data inoverengwa).
361
-
362
- ## Transparent encryption
363
- Gonesa transparent client-side encryption:
364
-
365
- // Pass encryption parameters
366
- const encryption = {
367
- // key is required, must be >= 16 chars
368
- key: randomstring.generate(128),
369
-
370
- // optional, the default is to derive IV from key
371
- // when set, IV must be >= 16 chars
372
- iv: randomstring.generate(128),
373
-
374
- // optional, the default is aes-256-cbc
375
- algo: 'aes-256-cbc'
376
- }
377
- const api = await mobiletto(driverName, key, secret, opts, encryption)
378
-
379
- // Subsequent write operations will encrypt data (client side) when writing
380
- // Subsequent read operations will decrypt data (client side) when reading
381
-
382
- Chii chiri kuitika? Iyo yakaparadzana "dhairekitori yekupinda" (dirent) dhairekitori (yakavharidzirwa) inoteedzera mafaera arimo
383
- dhairekitori (aka iyo dirent dhairekitori).
384
- * Iyo `list` yekupinda mafaera, decrypts yega nzira yakanyorwa; wozodzosera metadata yefaira rega rega
385
- * `list` mirairo haina kunyatso shanda, kunyanya kune madhairekitori ane nhamba huru yemafaira
386
- * Iwo `write` murairo unonyora dirent mafaera mune yega yega dhairekitori remubereki, achidzokorora; ipapo anonyora faira
387
- * `write` mirairo ichaunza O (N) inonyora, ine N = kudzika mune dhairekitori hierarchy
388
- * Murairo `remove` unobvisa faira rinoenderana, uye mubereki waro kana asina chinhu, achidzokorodza; wobva wabvisa faira
389
- * Isiri-inodzokorodza `remove` mirairo ichaunza O(N) kuverenga uye zvingangoita sekudzima kwakawanda, neN = kudzika mudhairekitori dhairekitori.
390
- * Recursive `remove` mirairo pane yakakura uye yakadzika mafaera system inogona kudhura
391
-
392
- Ziva kuti kunyangwe neclient-side encryption yakagoneswa, mhandu ine kuoneka kuzere mune yako encrypted server-side.
393
- chengetedzo, kunyangwe isina kiyi, ichiri kuona huwandu hwemadhairekitori uye kuti mangani mafaera mune imwe neimwe, uye ane
394
- kumwe kuedza, tsvaga zvimwe kana zvese zvechimiro chese chedhairekitori hierarchy.
395
- *Cherechedza: Shandisa chimiro chakati sandara kuti uchengetedze zvirinani.
396
- Muvengi haaizoziva mazita emadhairekitori / mafaera kunze kwekunge vaizivawo encryption yako
397
- kiyi kana kuti anga akwanisa kupaza encryption. Mabheti ese adzimwa ipapo!
398
-
399
- ### Kuita uye caching
400
- Mashandisirwo ekuchengetera encrypted anogona kunonoka. Recursive listings uye kubviswa kunogona kunonoka.
401
- Kuchengetedza kuburikidza ne redis kunobatsira zvikuru, asi cherechedza kuti cache inoputirwa pane chero inonyora kana kubvisa.
402
-
403
- ## Kutenderera kwakakosha
404
- Gadzira mobiletto nekiyi yako nyowani, wobva watarisa iyo yekare data mairi:
405
-
406
- const storage = require('mobiletto')
407
-
408
- const oldEncryption = { key: .... }
409
- const oldStorage = await storage.connect('s3', aws_key, aws_secret, {bucket: 'bk', region: 'us-east-1'}, oldEncryption)
410
-
411
- const newEncryption = { key: .... }
412
- const newStorage = await storage.connect('s3', aws_key, aws_secret, {bucket: 'zz', region: 'us-east-1'}, newEncryption)
413
-
414
- newStorage.mirror(oldStorage) // if oldStorage is very large, this may take a looooooong time...
415
-
416
- ## Mutyairi interface
417
- Mutyairi chero JS faira inotumira kunze kwe 'storageClient' basa neichi siginicha:
418
-
419
- function storageClient (key, secret, opts)
420
-
421
- * `key` : tambo, kiyi yako `local` iyi ndiyo base dhairekitori)
422
- * `secret` : tambo, yako API chakavanzika (inogona kusiiwa kune `local` mutyairi)
423
- * `opts` : chinhu, zvivakwa zvacho ndezvamutyairi wega wega:
424
- * Kune `local` , iyo `fileMode` uye `dirMode` zvivakwa zvinotarisa kuti matsva ekugadzira mafaera nemadhairekitori anogadzirwa sei.
425
- * Kune `s3` , iyo `bucket` pfuma inodiwa. Optional properties ndezvi:
426
- * `region`: the S3 region, default is us-east-1
427
- * `prefix`: a prefix to prepend to all S3 paths, default is the empty string
428
- * `delimiter`: the directory delimiter, default is '/'
429
-
430
- Chinhu icho chekuchengetedzaClient basa rinodzoka chinofanira kutsanangura aya mabasa:
431
-
432
- // Test the driver before using, ensure proper configuration
433
- async testConfig ()
434
-
435
- // List files in path (or from base-directory)
436
- // If recursive is true, list recursively
437
- // If visitor is defined, it will be an async function. await the visitor function on each file found
438
- // Otherwise, perform the listing and return an array of objects
439
- async list (path, recursive = false, visitor = null) // path may be omitted
440
-
441
- // Read metadata for a path
442
- async metadata (path)
443
-
444
- // Read a file
445
- // callback receives a chunk of data. endCallback is called at end-of-stream
446
- async read (path, callback, endCallback = null)
447
-
448
- // Write a file
449
- // driver must be able to handle a generator or a stream
450
- async write (path, generatorOrReadableStream)
451
-
452
- // Remove a file, or recursively delete a directory
453
- // returns a string of a single path removed, or an array of multiple paths removed
454
- async remove (path, recursive = false, quiet = false)
455
-
456
- ## Kutema
457
- Mobiletto inoshandisa [winston](https://www.npmjs.com/package/winston) raibhurari yekutema matanda.
458
-
459
- Marogi ** achave ** ane mafaera nzira uye mhosho meseji, asi ** haazombove ** ane makiyi, zvakavanzika,
460
- kana chero rumwe ruzivo rwekubatanidza gadziriso.
461
-
462
- ### Log level
463
- Shandisa `MOBILETTO_LOG_LEVEL` shanduko yenzvimbo kuseta irogi, uchishandisa imwe
464
- ye `npm` mazinga anotsanangurwa mu [https://www.npmjs.com/package/winston#logging-levels](https://www.npmjs.com/package/winston#logging-levels)
465
-
466
- Default level ndeye `error` . Chirevo chezwi chakanyanya ndeche `silly` , kunyangwe parizvino mobiletto
467
- haipindi pamatanho ari pazasi `debug`
468
-
469
- MOBILETTO_LOG_LEVEL=silly # maximum logs!
470
-
471
- ### Log file
472
- Nokusingaperi, murogi anonyora kune console. Kuti utumire magwaro kufaira, isa iyo `MOBILETTO_LOG_FILE`
473
- environment variable. Paunenge uchidhinda kufaira, matanda haachanyorwe kune iyo console.
474
-
475
- MOBILETTO_LOG_FILE=/var/my_mobiletto_log
476
-
477
- Kudzima matanda:
478
-
479
- MOBILETTO_LOG_FILE=/dev/null
480
-
481
- </pre>