qdown 1.0.0__py3-none-any.whl → 1.0.3__py3-none-any.whl

qdown/__init__.py

@@ -22,3 +22,62 @@ If you wish to use or redistribute this program under a commercial license:
 Please contact Qualiteg Inc.(https://qualiteg.com/contact) directly to obtain the terms and pricing.
 
 """
+
+import asyncio
+import re
+from .qdown import QDown
+
+
+def extract_file_id(url):
+    """
+    URLからファイルIDを抽出する
+
+    Args:
+        url (str): ファイルURL
+            例1: https://drive.qualiteg.com/file/3kMM-X9S6-bMioFU0Fn8nHjAgQgWmG
+            例2: https://drive.qualiteg.com/download/1Lki-o8QO-DCUmg60JRxGdXfif
+
+    Returns:
+        str: ファイルID
+    """
+    # /file/XXX 形式のURL
+    file_pattern = r'https://drive\.qualiteg\.com/file/([a-zA-Z0-9_-]+)'
+    file_match = re.search(file_pattern, url)
+    if file_match:
+        return file_match.group(1)
+
+    # /download/XXX 形式のURL
+    download_pattern = r'https://drive\.qualiteg\.com/download/([a-zA-Z0-9_-]+)'
+    download_match = re.search(download_pattern, url)
+    if download_match:
+        return download_match.group(1)
+
+    return url  # IDと思われる場合はそのまま返す
+
+
+def download(download_url, output_path=None, output_dir=None, server_url="https://drive.qualiteg.com", quiet=False):
+    """
+    URLを指定してファイルをダウンロード
+
+    Args:
+        download_url (str): ダウンロードURL or ファイルID
+        output_path (str, optional): 出力ファイルパス
+        output_dir (str, optional): 出力ディレクトリ
+        server_url (str, optional): サーバーURL
+        quiet (bool, optional): 進捗表示を非表示にするかどうか
+
+    Returns:
+        str: ダウンロードしたファイルのパス
+    """
+    # URLからファイルIDを抽出
+    file_id = extract_file_id(download_url)
+
+    # QDownクライアントの初期化
+    client = QDown(server_url=server_url, quiet=quiet)
+
+    # 非同期ダウンロードを実行
+    return asyncio.run(client.download_by_file_id(
+        file_id=file_id,
+        output=output_path,
+        output_dir=output_dir
+    ))

qdown/gdown.py

@@ -120,7 +120,7 @@ class QDown:
                             progress_bar.close()
                 
                 if not self.quiet:
-                    print(f"\nファイルを保存しました: {file_path}")
+                    print(f"[qdown] ファイルを保存しました: {file_path}")
                 return file_path
                 
             except httpx.RequestError as e:

qdown/qdown.py

@@ -0,0 +1,185 @@
+"""
+qdown - Client for QualitegDrive
+
+使用方法:
+  qdown ID [オプション]
+
+オプション:
+  -O FILENAME     出力ファイル名を指定
+  -o DIR          出力ディレクトリを指定
+  -s SERVER       サーバーURLを指定 (デフォルト: https://drive.qualiteg.com)
+  -q, --quiet     進捗表示を非表示
+  -h, --help      ヘルプを表示
+"""
+
+import httpx
+import os
+import sys
+import argparse
+import asyncio
+import urllib.parse
+from pathlib import Path
+from tqdm import tqdm
+
+
+class QDown:
+    """
+    ID認証付きファイルサーバー用のPythonクライアント
+    """
+
+    def __init__(self, server_url="https://drive.qualiteg.com", quiet=False):
+        """
+        クライアントの初期化
+
+        Args:
+            server_url (str): ファイルサーバーのベースURL
+            quiet (bool): 進捗表示を非表示にするかどうか
+        """
+        self.server_url = server_url.rstrip('/')
+        self.quiet = quiet
+        self.timeout = httpx.Timeout(10.0, connect=60.0)
+
+    async def download_by_file_id(self, file_id, output=None, output_dir=None):
+        """
+        ファイルIDを指定してファイルをダウンロード
+
+        Args:
+            file_id (str): ダウンロードするファイルのID (qd_id)
+            output (str, optional): 出力ファイル名
+            output_dir (str, optional): 出力ディレクトリ
+
+        Returns:
+            str: ダウンロードしたファイルのパス
+        """
+        url = f"{self.server_url}/download/{file_id}"
+
+        # 出力ディレクトリの設定
+        if output_dir:
+            os.makedirs(output_dir, exist_ok=True)
+        else:
+            output_dir = "."
+
+        async with httpx.AsyncClient(timeout=self.timeout) as client:
+            # まず、ヘッド要求を送信してファイル情報を取得
+            try:
+                head_response = await client.head(url)
+
+                if head_response.status_code == 404:
+                    print(f"エラー: ID '{file_id}' のファイルが見つかりませんでした", file=sys.stderr)
+                    return None
+
+                if head_response.status_code != 200:
+                    print(f"エラー: ステータスコード {head_response.status_code}", file=sys.stderr)
+                    return None
+
+                # Content-Dispositionヘッダーからファイル名を取得
+                original_filename = None
+                if "content-disposition" in head_response.headers:
+                    cd = head_response.headers["content-disposition"]
+                    if "filename=" in cd:
+                        # 安全なファイル名を抽出（URLエンコードの解除）
+                        filename_part = cd.split("filename=")[1].strip('"')
+
+                        # filename*=UTF-8 形式のエンコードがある場合
+                        if "filename*=UTF-8''" in cd:
+                            encoded_part = cd.split("filename*=UTF-8''")[1]
+                            # セミコロンやダブルクォートがあれば処理
+                            if '"' in encoded_part:
+                                encoded_part = encoded_part.split('"')[0]
+                            if ';' in encoded_part:
+                                encoded_part = encoded_part.split(';')[0]
+                            # URLデコードして正しいファイル名を取得
+                            original_filename = urllib.parse.unquote(encoded_part)
+                        else:
+                            # 通常のファイル名（エスケープ処理）
+                            original_filename = filename_part.replace('"', '').split(';')[0]
+
+                # 保存用のファイル名を決定
+                if not output:
+                    if original_filename:
+                        # パスとして安全なファイル名に変換
+                        safe_filename = os.path.basename(original_filename)
+                        output_filename = safe_filename
+                    else:
+                        output_filename = f"download_{file_id}"
+                else:
+                    output_filename = output
+
+                file_path = os.path.join(output_dir, output_filename)
+
+                # ファイルサイズを取得（プログレスバー用）
+                total_size = int(head_response.headers.get("content-length", 0))
+
+                # ストリーミングダウンロードを開始
+                async with client.stream("GET", url) as response:
+                    if response.status_code != 200:
+                        print(f"エラー: ダウンロード中にエラーが発生しました。ステータスコード: {response.status_code}", file=sys.stderr)
+                        return None
+
+                    with open(file_path, "wb") as f:
+                        if not self.quiet and total_size > 0:
+                            progress_bar = tqdm(
+                                total=total_size,
+                                unit="B",
+                                unit_scale=True,
+                                desc=f"ダウンロード中: {output_filename}"
+                            )
+
+                        downloaded = 0
+
+                        async for chunk in response.aiter_bytes():
+                            f.write(chunk)
+                            if not self.quiet and total_size > 0:
+                                downloaded += len(chunk)
+                                progress_bar.update(len(chunk))
+
+                        if not self.quiet and total_size > 0:
+                            progress_bar.close()
+
+                if not self.quiet:
+                    print(f"[qdown] ファイルを保存しました: {file_path}")
+                return file_path
+
+            except httpx.RequestError as e:
+                print(f"エラー: リクエストに失敗しました - {e}", file=sys.stderr)
+                return None
+            except Exception as e:
+                print(f"エラー: {e}", file=sys.stderr)
+                return None
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="qdown - IDベースファイルダウンロードツール",
+        add_help=False
+    )
+
+    parser.add_argument("id", nargs="?", help="ダウンロードするファイルのID")
+    parser.add_argument("-O", dest="output", help="出力ファイル名")
+    parser.add_argument("-o", dest="output_dir", help="出力ディレクトリ")
+    parser.add_argument("-s", dest="server", default="https://drive.qualiteg.com", help="サーバーURL")
+    parser.add_argument("-q", "--quiet", action="store_true", help="進捗表示を非表示")
+    parser.add_argument("-h", "--help", action="store_true", help="ヘルプを表示")
+
+    args = parser.parse_args()
+
+    if args.help or not args.id:
+        print(__doc__)
+        sys.exit(0)
+
+    client = QDown(server_url=args.server, quiet=args.quiet)
+
+    result = asyncio.run(client.download_by_file_id(
+        file_id=args.id,
+        output=args.output,
+        output_dir=args.output_dir
+    ))
+
+    if result:
+        sys.exit(0)
+    else:
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

qdown-1.0.3.dist-info/METADATA

@@ -0,0 +1,70 @@
+Metadata-Version: 2.1
+Name: qdown
+Version: 1.0.3
+Summary: Client for QualitegDrive
+Home-page: https://github.com/qualiteg/qdown
+Author: Qualiteg Inc.
+Author-email: qualiteger@qualiteg.com
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: httpx (>=0.23.0)
+Requires-Dist: tqdm (>=4.64.0)
+
+# qdown
+
+A Python client for downloading files from QualitegDrive operated by Qualiteg Inc.
+
+# install
+
+```
+pip install qdown
+```
+
+or 
+
+```
+pip install git+https://github.com/qualiteg/qdown.git
+```
+
+# usage
+
+```
+
+qdown ID [options]
+
+Options:
+-O FILENAME     Specify output filename
+-o DIR          Specify output directory
+-s SERVER       Specify server URL (default: https://drive.qualiteg.com)
+-q, --quiet     Hide progress display
+-h, --help      Display help
+```
+
+## download example1
+
+```
+qdown xxxxxxxxxxxxx -O my_file.txt
+```
+
+## download example2
+
+From Your Original HTTP Server
+
+```
+qdown xxxxxxxxxxxxx -O my_file.txt -s http://host.docker.internal:3000 
+```
+
+
+# uninstall
+
+```
+pip uninstall qdown -y
+```

qdown-1.0.3.dist-info/RECORD

@@ -0,0 +1,10 @@
+qdown/__init__.py,sha256=iAC1eU57pgDdmgWVyu2MdOddLXcel2BxR5fH7m2OImg,2983
+qdown/gdown.py,sha256=3MpnwlBpEFGi1rdAMzixdBETtw8q5xItaHU1QmtPrEo,6421
+qdown/qdown.py,sha256=NJhqUCgceCd9ojSQCbNuOdNOAVKJywKv_kYohpQblYg,7309
+z_examples/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+z_examples/example.py,sha256=3FQoW22Frgyx5ulb7JOgwgcEBd8K3FI_BuFZP2E54ck,137
+qdown-1.0.3.dist-info/METADATA,sha256=5_W60o0W3VTDOfhj-zDjDDB4xXZhKU-1BcJYYosai5k,1487
+qdown-1.0.3.dist-info/WHEEL,sha256=2wepM1nk4DS4eFpYrW1TTqPcoGNfHhhO_i5m4cOimbo,92
+qdown-1.0.3.dist-info/entry_points.txt,sha256=4uunDwX_8iGbNA0DKwggOftuKUXvoHxGzvXUd2SW9LM,43
+qdown-1.0.3.dist-info/top_level.txt,sha256=eVEHrbec1mx2PWv03GzKwFTbdvQqFOAps3GuveF2Ap8,17
+qdown-1.0.3.dist-info/RECORD,,

qdown-1.0.3.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+qdown = qdown.qdown:main

z_examples/example.py

@@ -0,0 +1,4 @@
+import qdown
+
+# ファイル共有リンクからダウンロード
+file_path = qdown.download("https://drive.qualiteg.com/file/xxxxxx")

qdown-1.0.0.dist-info/METADATA

@@ -1,19 +0,0 @@
-Metadata-Version: 2.1
-Name: qdown
-Version: 1.0.0
-Summary: Client for QualitegDrive
-Home-page: https://github.com/qualiteg/qdown
-Author: Qualiteg Inc.
-Author-email: qualiteger@qualiteg.com
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Requires-Python: >=3.7
-Requires-Dist: httpx (>=0.23.0)
-Requires-Dist: tqdm (>=4.64.0)
-

qdown-1.0.0.dist-info/RECORD

@@ -1,8 +0,0 @@
-qdown/__init__.py,sha256=xLF9Cf0AXdryxhj3hm9gZW432d3hpGioUfTvh8zNraI,1137
-qdown/gdown.py,sha256=c5RP0N7r1Z7lderibzCLDsiLkaPZ2-Gyrn0li2cHk34,6415
-z_examples/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-qdown-1.0.0.dist-info/METADATA,sha256=YpyMamMMB3Fvzdbf6W5wTfk_fI30A45xviuTanJcLHo,682
-qdown-1.0.0.dist-info/WHEEL,sha256=2wepM1nk4DS4eFpYrW1TTqPcoGNfHhhO_i5m4cOimbo,92
-qdown-1.0.0.dist-info/entry_points.txt,sha256=oL6bqY5z0iEMyLURdbjHtvGMTdeZgqR44MtHdlOa7ZM,43
-qdown-1.0.0.dist-info/top_level.txt,sha256=eVEHrbec1mx2PWv03GzKwFTbdvQqFOAps3GuveF2Ap8,17
-qdown-1.0.0.dist-info/RECORD,,

qdown-1.0.0.dist-info/entry_points.txt

@@ -1,2 +0,0 @@
-[console_scripts]
-qdown = qdown.gdown:main