guratan 0.3.0 → 0.4.0

package/README.md

@@ -4,13 +4,31 @@ Google Drive へファイルを送信する簡易ツール。
 
 ## Usage
 
+### send
+
 ```
 $ GOOGLE_APPLICATION_CREDENTIALS=./gha-creds-temp.json npx guratan send --parent-id 12345ABC --dest-file-name test.txt --src-file-name path/to/test.txt
 ```
 
 - `GOOGLE_APPLICATION_CREDENTIALS` にはサービスアカウントの鍵ファイルを指定
 - 送信先フォルダー(`--parent-id`) に同名ファイル(`--dest-file-name`) が存在するときは上書きされる
+- 同名ファイルが複数ある場合は最初にヒットしたものが上書きされる
+- `--parent-id` `--dest-file-name` の代わりに `--file-id` で上書きファイルを指定できる
+- 各オプションは環境変数での指定も可能(例. `--parent-id` = `GURATAN_PARENT_ID`)
+- `guratan` からは upload と update のみ可能
+
+### share
+
+```
+$ GOOGLE_APPLICATION_CREDENTIALS=./gha-creds-temp.json npx guratan share --file-id 12345ABC --type anyone --role reader
+```
+
+- `GOOGLE_APPLICATION_CREDENTIALS` にはサービスアカウントの鍵ファイルを指定
+- `--file-id` の permission を作成/上書きすることで共有設定を変更する
+- `--file-id` の代わりに `--parent-id` `--dest-file-name` で変更ファイルを指定できる
+- 同名ファイルが複数ある場合は最初にヒットしたもののみが変更される
 - 各オプションは環境変数での指定も可能(例. `--parent-id` = `GURATAN_PARENT_ID`)
+- `guratan` から permission の削除はできない
 
 ## License
 

package/dist/cli.d.ts

@@ -5,6 +5,7 @@ declare type Opts = {
     stderr: Writable;
 };
 declare type OptsSend = Opts & {
+    fileId: string;
     parentId: string;
     destFileName: string;
     srcFileName: string;
@@ -14,6 +15,8 @@ declare type OptsSend = Opts & {
 };
 declare type OptsShare = Opts & {
     fileId: string;
+    parentId: string;
+    destFileName: string;
     type: string;
     role: string;
     emailAddress: string;
@@ -26,6 +29,6 @@ declare type OptsShare = Opts & {
     emailMessage: string;
     printId: boolean;
 };
-export declare const cliSend: ({ parentId, destFileName, srcFileName, destMimeType, srcMimeType, printId, stdout, stderr }: OptsSend) => Promise<number>;
-export declare const cliShare: ({ fileId, type, role, emailAddress, domain, allowFileDiscovery, view, moveToNewOwnersRoot, transferOwnership, sendNotificationEmail, emailMessage, printId, stdout, stderr }: OptsShare) => Promise<number>;
+export declare const cliSend: ({ fileId, parentId, destFileName, srcFileName, destMimeType, srcMimeType, printId, stdout, stderr }: OptsSend) => Promise<number>;
+export declare const cliShare: ({ fileId, parentId, destFileName, type, role, emailAddress, domain, allowFileDiscovery, view, moveToNewOwnersRoot, transferOwnership, sendNotificationEmail, emailMessage, printId, stdout, stderr }: OptsShare) => Promise<number>;
 export {};

package/dist/cli.js

@@ -1,9 +1,10 @@
 import { driveClient } from './tdrive.js';
 import { sendFile } from './tsend.js';
 import { createPermisson } from './tshare.js';
-export const cliSend = async ({ parentId, destFileName, srcFileName, destMimeType, srcMimeType, printId, stdout, stderr }) => {
+export const cliSend = async ({ fileId, parentId, destFileName, srcFileName, destMimeType, srcMimeType, printId, stdout, stderr }) => {
     try {
         const id = await sendFile(driveClient(), {
+            fileId,
             parentId,
             destFileName,
             srcFileName,
@@ -21,10 +22,12 @@ export const cliSend = async ({ parentId, destFileName, srcFileName, destMimeTyp
     }
     return 0;
 };
-export const cliShare = async ({ fileId, type, role, emailAddress, domain, allowFileDiscovery, view, moveToNewOwnersRoot, transferOwnership, sendNotificationEmail, emailMessage, printId, stdout, stderr }) => {
+export const cliShare = async ({ fileId, parentId, destFileName, type, role, emailAddress, domain, allowFileDiscovery, view, moveToNewOwnersRoot, transferOwnership, sendNotificationEmail, emailMessage, printId, stdout, stderr }) => {
     try {
         const id = await createPermisson(driveClient(), {
             fileId,
+            parentId,
+            destFileName,
             type,
             role,
             emailAddress,

package/dist/main.js

@@ -8,14 +8,22 @@ const argv = await yargs(hideBin(process.argv))
     .env(envVarsPrefix)
     .command('send [OPTIONS]', 'send file to folder in Google Drive', (yargs) => {
     return yargs.options({
+        'file-id': {
+            type: 'string',
+            default: '',
+            required: false,
+            description: 'The ID of the file or shared drive.'
+        },
         'parent-id': {
             type: 'string',
-            required: true,
+            default: '',
+            required: false,
             description: 'The IDs of the parent folders which contain the file.'
         },
         'dest-file-name': {
             type: 'string',
-            required: true,
+            default: '',
+            required: false,
             description: 'The name of the file in remote'
         },
         'src-file-name': {
@@ -47,10 +55,22 @@ const argv = await yargs(hideBin(process.argv))
     return yargs.options({
         'file-id': {
             type: 'string',
-            default: 'reader',
+            default: '',
             required: false,
             description: 'The ID of the file or shared drive.'
         },
+        'parent-id': {
+            type: 'string',
+            default: '',
+            required: false,
+            description: 'The IDs of the parent folders which contain the file.'
+        },
+        'dest-file-name': {
+            type: 'string',
+            default: '',
+            required: false,
+            description: 'The name of the file in remote'
+        },
         type: {
             choices: ['user', 'group', 'domain', 'anyone'],
             required: false,
@@ -121,6 +141,7 @@ const argv = await yargs(hideBin(process.argv))
 switch (`${argv._[0]}`) {
     case 'send':
         process.exit(await cliSend({
+            fileId: argv['file-id'],
             parentId: argv['parent-id'] || '',
             destFileName: argv['dest-file-name'] || '',
             srcFileName: argv['src-file-name'] || '',
@@ -134,6 +155,8 @@ switch (`${argv._[0]}`) {
     case 'share':
         process.exit(await cliShare({
             fileId: argv['file-id'],
+            parentId: argv['parent-id'] || '',
+            destFileName: argv['dest-file-name'] || '',
             type: argv['type'],
             role: argv['role'],
             emailAddress: argv['email-address'],

package/dist/tsend.d.ts

@@ -12,6 +12,11 @@ export declare class UpdateFileError extends Error {
  * Options for sendFile().
  */
 export declare type SendFileOpts = {
+    /**
+     * @type The ID of the file or shared drive.
+     */
+    fileId: string;
+    /**
     /**
      * @type The IDs of the parent folders which contain the file.
      */

package/dist/tsend.js

@@ -123,8 +123,8 @@ export async function updateFile(drive, opts) {
  * @returns id of file in Google Drive
  */
 export async function sendFile(drive, opts) {
-    const { parentId, destFileName, srcFileName, destMimeType, srcMimeType } = opts;
-    const fileId = await getFileId(drive, parentId, destFileName);
+    const { fileId: inFileId, parentId, destFileName, srcFileName, destMimeType, srcMimeType } = opts;
+    let fileId = inFileId !== '' ? inFileId : await getFileId(drive, parentId, destFileName);
     if (fileId === '') {
         return uploadFile(drive, {
             parentId,

package/dist/tshare.d.ts

@@ -13,6 +13,14 @@ export declare type CreatePermissonOpts = {
      * @type The ID of the file or shared drive.
      */
     fileId: string;
+    /**
+     * @type The IDs of the parent folders which contain the file.
+     */
+    parentId: string;
+    /**
+     * @type The name of the file in remote
+     */
+    destFileName: string;
     /**
      * @type The type of the grantee.
      */

package/dist/tshare.js

@@ -1,3 +1,4 @@
+import { getFileId } from './tsend.js';
 export class CreatePermissonError extends Error {
     constructor(message) {
         //https://stackoverflow.com/questions/41102060/typescript-extending-error-class
@@ -21,7 +22,8 @@ export class UpdatePermissonError extends Error {
 export async function createPermisson(drive, opts) {
     let created = false;
     try {
-        const { fileId, type, role, emailAddress, domain, view, allowFileDiscovery, moveToNewOwnersRoot, transferOwnership, sendNotificationEmail, emailMessage } = opts;
+        const { fileId: inFileId, parentId, destFileName, type, role, emailAddress, domain, view, allowFileDiscovery, moveToNewOwnersRoot, transferOwnership, sendNotificationEmail, emailMessage } = opts;
+        const fileId = inFileId || (await getFileId(drive, parentId, destFileName));
         const createParams = {
             requestBody: {
                 type,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "guratan",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Tiny send tool for Google Drive",
   "author": "hankei6km <hankei6km@gmail.com> (https://github.com/hankei6km)",
   "license": "MIT",