ggdrv.pm untested

filter: Statementstmt 0.0% 0 / 2 Branchbran n/a Conditioncond n/a MC/DCmcdc n/a Subroutinesub n/a Podpod n/a totaltotal 0.0% 0 / 2 SCAR -
1 package App::ggdrv ;
2 our $VERSION = '0.031' ;
3 our $DATE = '2023-03-16T11:45+09:00' ;
4  
5 =encoding utf8
6  
7 =head1 NAME
8  
9 App::ggdrv
10  
11 =head1 SYNOPSIS
12  
13 This module App::ggdrv provides a Unix-like command `F<ggdrv>'.
14  
15 =head1 DESCRIPTION
16  
17 =head1
18 ggdrv
19  
20 サブコマンド方式で、様々な関連する機能を実行可能としている。
21 OAuthの仕組みでGoogleドライブにファイルを自動更新で同期する機能を提供する。
22  
23 利用例 :
24  
25 ggdrv --help # --help により、このヘルプの文面が現れる。
26  
27 [設定系]
28 ggdrv # 引数無しで実行すると、最初のセットアップの仕方(ブラウザ越しで「クライアントシークレット」を作る方法)が表示される。
29 ggdrv crecord # クライアントシークレット(Client)などを、設定ファイルに書き込む方法が表示される。
30 ggdrv crecord --run # 表示される内容を実際に実行する。
31 ggdrv tokens # トークンの情報2個を単に表示する。(リフレッシュトークン(使わないと半年で無効化)とアクセストークンがある。)
32 ggdrv tokens --get # トークンを取得する(設定ファイルに書き込む)。書き込む前のファイルはバックアップは1回のみ保管。
33 ggdrv tokens --get --try # トークンを取得するが、設定ファイルには書き込まない。
34 ggdrv tokens --atoken # アクセストークンのみ更新する。60分未使用であれば、更新は必要。-try を指定すると設定ファイルに書き込まない。
35  
36 [ファイル検索]
37 ggdrv fsearch FILENAME # ファイルを最大100個まで探す(フォルダは指定不能)。ワイルドカードを指定可能。タブ区切り5列で出力。
38 ggdrv fsearchall -g10 # ファイルを100個ずつ -g で指定した回数出力(フォルダは指定不能)。1個のファイルにつき、縦に4行を出力。## <-- 時々リフレッシュトークンを更新する必要あり。
39  
40 [(単純な)アップロード/更新/ダウンロード]
41 ggdrv upload -f フォルダID(28文字) FILE [FILE] .. # アップロードする。 同名ファイルに対し複数回実行したら、その分グーグルドライブ上に現れるので注意。
42 ggdrv update ID1 FILE1 [ID2 FILE2] [ID3 FILE3] .. # 更新する。33文字のIDに対して、ローカルのファイルの名前をペアにして指定。
43 ggdrv download ファイルID(33文字) ローカルで予定するファイル名 # ダウンロードする。
44  
45 [作業対象のファイルを管理しつつアップロード/更新/ダウンロード] ※ サブコマンドに「5」が後置するのが特徴。
46 ggdrv upload5 FOLDER_ID LOCAL_DIR > VAR_FILE # アップロードする。標準出力をファイルに保管して、続くサブコマンドでも使う。
47 ggdrv download5 LOCAL_DIR < VAR_FILE # ダウンロードする。
48 ggdrv sync5 OLD_DIR NEW_DIR < VAR_FILE # 同期に使う。OLD_DIRはGoogleドライブと予め同期させ、NEW_DIRと違えば、それをアップデート。
49  
50 オプション:
51 -2 0 : 最後に2次情報を標準エラー出力に出さない。サブコマンドの後ろに置くこと。
52  
53 環境変数 : export VAR=VALUE で指定。unset VAR で解除が可能。
54  
55 GGDRV_API : クライアントIDやクライアントシークレットを保管するファイルの名前。未指定なら ~/ggdrv2303v1 である。
56
57 =head1 AUTHOR
58  
59 下野寿之 Toshiyuki SHIMONO <bin4tsv@gmail.com>
60  
61 =head1 COPYRIGHT AND LICENSE
62  
63 Copyright (c) 2023 Toshiyuki SHIMONO. All rights reserved.
64 This program is free software; you can redistribute it and/or
65 modify it under the same terms as Perl itself.
66  
67 =cut
68  
69 1 ;