flashdata-youtube-cloud-storage 0.2.0__tar.gz → 0.2.1__tar.gz

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 (14) hide show
  1. {flashdata_youtube_cloud_storage-0.2.0 → flashdata_youtube_cloud_storage-0.2.1}/.gitignore +9 -9
  2. {flashdata_youtube_cloud_storage-0.2.0 → flashdata_youtube_cloud_storage-0.2.1}/LICENSE +21 -21
  3. {flashdata_youtube_cloud_storage-0.2.0 → flashdata_youtube_cloud_storage-0.2.1}/PKG-INFO +19 -19
  4. {flashdata_youtube_cloud_storage-0.2.0 → flashdata_youtube_cloud_storage-0.2.1}/README.md +105 -105
  5. flashdata_youtube_cloud_storage-0.2.1/flashdata_youtube_cloud_storage_cli/__init__.py +1 -0
  6. {flashdata_youtube_cloud_storage-0.2.0 → flashdata_youtube_cloud_storage-0.2.1}/flashdata_youtube_cloud_storage_cli/_capability.py +2 -2
  7. {flashdata_youtube_cloud_storage-0.2.0 → flashdata_youtube_cloud_storage-0.2.1}/flashdata_youtube_cloud_storage_cli/cli.py +201 -201
  8. {flashdata_youtube_cloud_storage-0.2.0 → flashdata_youtube_cloud_storage-0.2.1}/input.schema.json +152 -152
  9. {flashdata_youtube_cloud_storage-0.2.0 → flashdata_youtube_cloud_storage-0.2.1}/pyproject.toml +29 -29
  10. flashdata_youtube_cloud_storage-0.2.0/flashdata_youtube_cloud_storage_cli/__init__.py +0 -1
  11. {flashdata_youtube_cloud_storage-0.2.0 → flashdata_youtube_cloud_storage-0.2.1}/flashdata_youtube_cloud_storage_cli/_client.py +0 -0
  12. {flashdata_youtube_cloud_storage-0.2.0 → flashdata_youtube_cloud_storage-0.2.1}/flashdata_youtube_cloud_storage_cli/_inputs.py +0 -0
  13. {flashdata_youtube_cloud_storage-0.2.0 → flashdata_youtube_cloud_storage-0.2.1}/flashdata_youtube_cloud_storage_cli/_storage.py +0 -0
  14. {flashdata_youtube_cloud_storage-0.2.0 → flashdata_youtube_cloud_storage-0.2.1}/flashdata_youtube_cloud_storage_cli/storage.schema.json +0 -0
@@ -1,9 +1,9 @@
1
- .venv/
2
- __pycache__/
3
- .pytest_cache/
4
- .ruff_cache/
5
- packages/
6
- dist/
7
- evidence/
8
-
9
- publish-dist/
1
+ .venv/
2
+ __pycache__/
3
+ .pytest_cache/
4
+ .ruff_cache/
5
+ packages/
6
+ dist/
7
+ evidence/
8
+
9
+ publish-dist/
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2026 FlashData contributors
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2026 FlashData contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -1,11 +1,11 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: flashdata-youtube-cloud-storage
3
- Version: 0.2.0
3
+ Version: 0.2.1
4
4
  Summary: Deliver authorized YouTube media to your cloud storage with the FlashData JSON CLI
5
- Project-URL: Homepage, https://flashdata.dev/docs/sources/youtube_download
6
- Project-URL: Documentation, https://flashdata.dev/docs/sources/youtube_download
7
- Project-URL: Pricing, https://flashdata.dev/pricing
8
- Project-URL: Support, https://flashdata.dev
5
+ Project-URL: Homepage, https://flashdata.dev/docs/sources/youtube_download?utm_source=pypi&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task
6
+ Project-URL: Documentation, https://flashdata.dev/docs/sources/youtube_download?utm_source=pypi&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task
7
+ Project-URL: Pricing, https://flashdata.dev/pricing?utm_source=pypi&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task
8
+ Project-URL: Support, https://flashdata.dev?utm_source=pypi&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task
9
9
  Project-URL: Source, https://github.com/flashdatadev/flashdata-mcp/tree/main/packages/python-cli
10
10
  Author-email: FlashData <support@flashdata.dev>
11
11
  License-Expression: MIT
@@ -32,13 +32,13 @@ Paid asynchronous job. Requires customer storage. Save the receipt; never submit
32
32
  Requires Python 3.10 or newer. [uv installation](https://docs.astral.sh/uv/getting-started/installation/)
33
33
  provides `uvx`, which runs this package in an isolated environment.
34
34
 
35
- 1. [Create a FlashData account](https://flashdata.dev/signup), obtain an API Key and fund Credits.
35
+ 1. [Create a FlashData account](https://flashdata.dev/signup?utm_source=pypi&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task), obtain an API Key and fund Credits.
36
36
  2. Set `FLASHDATA_API_KEY` using your shell or secret manager. The CLI does not accept a key flag
37
- or persist credentials. [Authentication and source documentation](https://flashdata.dev/docs/sources/youtube_download).
37
+ or persist credentials. [Authentication and source documentation](https://flashdata.dev/docs/sources/youtube_download?utm_source=pypi&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task).
38
38
  3. Run this example after reviewing the input and cost:
39
39
 
40
40
  ```sh
41
- uvx flashdata-youtube-cloud-storage@0.2.0 --operation result --job-id job_YOUR_SAVED_ID --output result.json
41
+ uvx flashdata-youtube-cloud-storage@0.2.1 --operation result --job-id job_YOUR_SAVED_ID --output result.json
42
42
  ```
43
43
 
44
44
  `--output` creates a new file with owner-only permissions where supported and refuses existing
@@ -46,8 +46,8 @@ files before making a paid request. Without it, the full JSON response goes to s
46
46
  go to stderr. Exit 0 means the response was exported, 2 means local input/configuration failure,
47
47
  and 1 means request or output failure. For downloads, exit 0 can describe an unfinished job.
48
48
 
49
- For repeated use, install `uv tool install flashdata-youtube-cloud-storage==0.2.0`; the command name is `flashdata-youtube-cloud-storage`.
50
- Alternatively use `python -m pip install flashdata-youtube-cloud-storage==0.2.0` in your virtual environment.
49
+ For repeated use, install `uv tool install flashdata-youtube-cloud-storage==0.2.1`; the command name is `flashdata-youtube-cloud-storage`.
50
+ Alternatively use `python -m pip install flashdata-youtube-cloud-storage==0.2.1` in your virtual environment.
51
51
 
52
52
  ## Inputs and output
53
53
 
@@ -68,13 +68,13 @@ this package. Google count and locale options remain omitted unless supplied.
68
68
  | `start_at` | Source-specific option; see --schema. Default: `null`. |
69
69
  | `end_at` | Source-specific option; see --schema. Default: `null`. |
70
70
 
71
- Run `uvx flashdata-youtube-cloud-storage@0.2.0 --schema` to inspect all fields, nested filters, allowed values and
71
+ Run `uvx flashdata-youtube-cloud-storage@0.2.1 --schema` to inspect all fields, nested filters, allowed values and
72
72
  defaults without a Key or an API call. `--help` and `--version` are also local-only.
73
73
 
74
74
  The JSON output preserves the API result envelope and optional fields: submit: id/status receipt; reads: job lifecycle; completed result: output JSON delivery manifest.
75
75
  Missing fields remain missing; empty results remain empty. No article text, translated captions,
76
76
  model conclusions, rights grants or keyword volumes are invented. Exact source contracts are
77
- documented [here](https://flashdata.dev/docs/sources/youtube_download).
77
+ documented [here](https://flashdata.dev/docs/sources/youtube_download?utm_source=pypi&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task).
78
78
 
79
79
  ## Submit once and keep the job ID
80
80
 
@@ -84,7 +84,7 @@ and never submit a paid query. A pending/running response does not mean delivery
84
84
  For a new delivery, supply your own authorized video and storage configuration:
85
85
 
86
86
  ```sh
87
- uvx flashdata-youtube-cloud-storage@0.2.0 --operation submit --allow-submit \
87
+ uvx flashdata-youtube-cloud-storage@0.2.1 --operation submit --allow-submit \
88
88
  --video-id YOUR_VIDEO_ID \
89
89
  --options-json '{"download_type":"audio","output_format":"m4a"}' \
90
90
  --output delivery-receipt.json
@@ -94,7 +94,7 @@ Set `FLASHDATA_DOWNLOAD_STORAGE` through your secret manager, containing the doc
94
94
  storage JSON. Never paste it into command arguments or source code. The supported providers
95
95
  are s3, s3_compatible, gcs, azure, oss, bos, cos and tos. Use your own bucket/container,
96
96
  optional object_prefix, and the provider-specific credentials. S3-compatible endpoints must
97
- use HTTPS. [Storage fields and examples](https://flashdata.dev/docs/sources/youtube_download).
97
+ use HTTPS. [Storage fields and examples](https://flashdata.dev/docs/sources/youtube_download?utm_source=pypi&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task).
98
98
 
99
99
  Keep the returned `id`. Read that same job with `--operation status --job-id ID` or
100
100
  `--operation result --job-id ID`. Omit submission inputs when resuming. There is no automatic
@@ -106,22 +106,22 @@ are excluded from CLI output.
106
106
  ## Fees and failure handling
107
107
 
108
108
  This MIT-licensed CLI is free to install. FlashData API requests consume paid Credits;
109
- [current pricing](https://flashdata.dev/pricing) applies. Extended YouTube Search has a separate
109
+ [current pricing](https://flashdata.dev/pricing?utm_source=pypi&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task) applies. Extended YouTube Search has a separate
110
110
  rate. Media delivery is billed by delivered volume, and your cloud-storage costs are separate.
111
111
  There is no automatic pagination, retry, polling, scheduled execution or model call.
112
112
 
113
113
  Each HTTP request has a 120-second network timeout (15-second connect timeout) and a 20-MiB response
114
114
  limit. A timeout or failure may occur after a paid request has been accepted. Check Jobs in
115
- the [FlashData console](https://flashdata.dev) before resubmitting. HTTP 401 means check the Key;
115
+ the [FlashData console](https://flashdata.dev?utm_source=pypi&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task) before resubmitting. HTTP 401 means check the Key;
116
116
  402 means insufficient Credits; 429 means rate/quota limit. A partial output file is retained
117
117
  on failure. Do not retry a paid query just because output handling failed.
118
118
 
119
119
  Input values and your API Key are sent to FlashData to perform the request. A completed
120
120
  download-result read may fetch a signed JSON object from the result origin returned by
121
121
  FlashData; the API Key is never sent to that object URL. Only process data appropriate for
122
- your output destination. [Privacy policy](https://flashdata.dev/legal/privacy).
122
+ your output destination. [Privacy policy](https://flashdata.dev/legal/privacy?utm_source=pypi&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task).
123
123
 
124
124
  Source and MIT license are included in the source distribution.
125
125
 
126
- [Source documentation](https://flashdata.dev/docs/sources/youtube_download) ·
127
- [Pricing](https://flashdata.dev/pricing) · [Sign up](https://flashdata.dev/signup)
126
+ [Source documentation](https://flashdata.dev/docs/sources/youtube_download?utm_source=pypi&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task) ·
127
+ [Pricing](https://flashdata.dev/pricing?utm_source=pypi&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task) · [Sign up](https://flashdata.dev/signup?utm_source=pypi&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task)
@@ -1,105 +1,105 @@
1
- # YouTube Download to Cloud Storage CLI — FlashData
2
-
3
- Deliver authorized YouTube media to your cloud storage. This command calls the `youtube_download` API and returns JSON for your
4
- shell script, data pipeline or agent tool runner. It does not invoke a language model.
5
-
6
- Paid asynchronous job. Requires customer storage. Save the receipt; never submit again to poll. Result JSON expires after 24 hours; media retention depends on storage.
7
-
8
- ## Install and run
9
-
10
- Requires Python 3.10 or newer. [uv installation](https://docs.astral.sh/uv/getting-started/installation/)
11
- provides `uvx`, which runs this package in an isolated environment.
12
-
13
- 1. [Create a FlashData account](https://flashdata.dev/signup), obtain an API Key and fund Credits.
14
- 2. Set `FLASHDATA_API_KEY` using your shell or secret manager. The CLI does not accept a key flag
15
- or persist credentials. [Authentication and source documentation](https://flashdata.dev/docs/sources/youtube_download).
16
- 3. Run this example after reviewing the input and cost:
17
-
18
- ```sh
19
- uvx flashdata-youtube-cloud-storage@0.2.0 --operation result --job-id job_YOUR_SAVED_ID --output result.json
20
- ```
21
-
22
- `--output` creates a new file with owner-only permissions where supported and refuses existing
23
- files before making a paid request. Without it, the full JSON response goes to stdout. Errors
24
- go to stderr. Exit 0 means the response was exported, 2 means local input/configuration failure,
25
- and 1 means request or output failure. For downloads, exit 0 can describe an unfinished job.
26
-
27
- For repeated use, install `uv tool install flashdata-youtube-cloud-storage==0.2.0`; the command name is `flashdata-youtube-cloud-storage`.
28
- Alternatively use `python -m pip install flashdata-youtube-cloud-storage==0.2.0` in your virtual environment.
29
-
30
- ## Inputs and output
31
-
32
- Use `--video-id` for the primary input. Additional options use
33
- `--options-json` as a JSON object, with strict field/type/range validation. Source is fixed by
34
- this package. Google count and locale options remain omitted unless supplied.
35
-
36
- | Option | Meaning |
37
- | --- | --- |
38
- | `download_type` | Source-specific option; see --schema. Default: `"audio_video"`. |
39
- | `video_quality` | Source-specific option; see --schema. Default: `null`. |
40
- | `fps` | Source-specific option; see --schema. Default: `null`. |
41
- | `audio_language` | Source-specific option; see --schema. Default: `null`. |
42
- | `audio_quality` | Source-specific option; see --schema. Default: `null`. |
43
- | `yt_dlp_format` | Source-specific option; see --schema. Default: `null`. |
44
- | `upload_metadata` | Source-specific option; see --schema. Default: `false`. |
45
- | `output_format` | Source-specific option; see --schema. Default: `null`. |
46
- | `start_at` | Source-specific option; see --schema. Default: `null`. |
47
- | `end_at` | Source-specific option; see --schema. Default: `null`. |
48
-
49
- Run `uvx flashdata-youtube-cloud-storage@0.2.0 --schema` to inspect all fields, nested filters, allowed values and
50
- defaults without a Key or an API call. `--help` and `--version` are also local-only.
51
-
52
- The JSON output preserves the API result envelope and optional fields: submit: id/status receipt; reads: job lifecycle; completed result: output JSON delivery manifest.
53
- Missing fields remain missing; empty results remain empty. No article text, translated captions,
54
- model conclusions, rights grants or keyword volumes are invented. Exact source contracts are
55
- documented [here](https://flashdata.dev/docs/sources/youtube_download).
56
-
57
- ## Submit once and keep the job ID
58
-
59
- The default operation is `status`. Status and result accept only a saved job ID,
60
- and never submit a paid query. A pending/running response does not mean delivery is complete.
61
-
62
- For a new delivery, supply your own authorized video and storage configuration:
63
-
64
- ```sh
65
- uvx flashdata-youtube-cloud-storage@0.2.0 --operation submit --allow-submit \
66
- --video-id YOUR_VIDEO_ID \
67
- --options-json '{"download_type":"audio","output_format":"m4a"}' \
68
- --output delivery-receipt.json
69
- ```
70
-
71
- Set `FLASHDATA_DOWNLOAD_STORAGE` through your secret manager, containing the documented
72
- storage JSON. Never paste it into command arguments or source code. The supported providers
73
- are s3, s3_compatible, gcs, azure, oss, bos, cos and tos. Use your own bucket/container,
74
- optional object_prefix, and the provider-specific credentials. S3-compatible endpoints must
75
- use HTTPS. [Storage fields and examples](https://flashdata.dev/docs/sources/youtube_download).
76
-
77
- Keep the returned `id`. Read that same job with `--operation status --job-id ID` or
78
- `--operation result --job-id ID`. Omit submission inputs when resuming. There is no automatic
79
- polling or resubmission. Only the lifecycle receipt and delivery JSON are exported; media is
80
- written by FlashData to your storage. Result JSON expires after 24 hours. Delivery manifests
81
- can contain signed private URLs; protect the output file. Storage credentials from job params
82
- are excluded from CLI output.
83
-
84
- ## Fees and failure handling
85
-
86
- This MIT-licensed CLI is free to install. FlashData API requests consume paid Credits;
87
- [current pricing](https://flashdata.dev/pricing) applies. Extended YouTube Search has a separate
88
- rate. Media delivery is billed by delivered volume, and your cloud-storage costs are separate.
89
- There is no automatic pagination, retry, polling, scheduled execution or model call.
90
-
91
- Each HTTP request has a 120-second network timeout (15-second connect timeout) and a 20-MiB response
92
- limit. A timeout or failure may occur after a paid request has been accepted. Check Jobs in
93
- the [FlashData console](https://flashdata.dev) before resubmitting. HTTP 401 means check the Key;
94
- 402 means insufficient Credits; 429 means rate/quota limit. A partial output file is retained
95
- on failure. Do not retry a paid query just because output handling failed.
96
-
97
- Input values and your API Key are sent to FlashData to perform the request. A completed
98
- download-result read may fetch a signed JSON object from the result origin returned by
99
- FlashData; the API Key is never sent to that object URL. Only process data appropriate for
100
- your output destination. [Privacy policy](https://flashdata.dev/legal/privacy).
101
-
102
- Source and MIT license are included in the source distribution.
103
-
104
- [Source documentation](https://flashdata.dev/docs/sources/youtube_download) ·
105
- [Pricing](https://flashdata.dev/pricing) · [Sign up](https://flashdata.dev/signup)
1
+ # YouTube Download to Cloud Storage CLI — FlashData
2
+
3
+ Deliver authorized YouTube media to your cloud storage. This command calls the `youtube_download` API and returns JSON for your
4
+ shell script, data pipeline or agent tool runner. It does not invoke a language model.
5
+
6
+ Paid asynchronous job. Requires customer storage. Save the receipt; never submit again to poll. Result JSON expires after 24 hours; media retention depends on storage.
7
+
8
+ ## Install and run
9
+
10
+ Requires Python 3.10 or newer. [uv installation](https://docs.astral.sh/uv/getting-started/installation/)
11
+ provides `uvx`, which runs this package in an isolated environment.
12
+
13
+ 1. [Create a FlashData account](https://flashdata.dev/signup?utm_source=pypi&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task), obtain an API Key and fund Credits.
14
+ 2. Set `FLASHDATA_API_KEY` using your shell or secret manager. The CLI does not accept a key flag
15
+ or persist credentials. [Authentication and source documentation](https://flashdata.dev/docs/sources/youtube_download?utm_source=pypi&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task).
16
+ 3. Run this example after reviewing the input and cost:
17
+
18
+ ```sh
19
+ uvx flashdata-youtube-cloud-storage@0.2.1 --operation result --job-id job_YOUR_SAVED_ID --output result.json
20
+ ```
21
+
22
+ `--output` creates a new file with owner-only permissions where supported and refuses existing
23
+ files before making a paid request. Without it, the full JSON response goes to stdout. Errors
24
+ go to stderr. Exit 0 means the response was exported, 2 means local input/configuration failure,
25
+ and 1 means request or output failure. For downloads, exit 0 can describe an unfinished job.
26
+
27
+ For repeated use, install `uv tool install flashdata-youtube-cloud-storage==0.2.1`; the command name is `flashdata-youtube-cloud-storage`.
28
+ Alternatively use `python -m pip install flashdata-youtube-cloud-storage==0.2.1` in your virtual environment.
29
+
30
+ ## Inputs and output
31
+
32
+ Use `--video-id` for the primary input. Additional options use
33
+ `--options-json` as a JSON object, with strict field/type/range validation. Source is fixed by
34
+ this package. Google count and locale options remain omitted unless supplied.
35
+
36
+ | Option | Meaning |
37
+ | --- | --- |
38
+ | `download_type` | Source-specific option; see --schema. Default: `"audio_video"`. |
39
+ | `video_quality` | Source-specific option; see --schema. Default: `null`. |
40
+ | `fps` | Source-specific option; see --schema. Default: `null`. |
41
+ | `audio_language` | Source-specific option; see --schema. Default: `null`. |
42
+ | `audio_quality` | Source-specific option; see --schema. Default: `null`. |
43
+ | `yt_dlp_format` | Source-specific option; see --schema. Default: `null`. |
44
+ | `upload_metadata` | Source-specific option; see --schema. Default: `false`. |
45
+ | `output_format` | Source-specific option; see --schema. Default: `null`. |
46
+ | `start_at` | Source-specific option; see --schema. Default: `null`. |
47
+ | `end_at` | Source-specific option; see --schema. Default: `null`. |
48
+
49
+ Run `uvx flashdata-youtube-cloud-storage@0.2.1 --schema` to inspect all fields, nested filters, allowed values and
50
+ defaults without a Key or an API call. `--help` and `--version` are also local-only.
51
+
52
+ The JSON output preserves the API result envelope and optional fields: submit: id/status receipt; reads: job lifecycle; completed result: output JSON delivery manifest.
53
+ Missing fields remain missing; empty results remain empty. No article text, translated captions,
54
+ model conclusions, rights grants or keyword volumes are invented. Exact source contracts are
55
+ documented [here](https://flashdata.dev/docs/sources/youtube_download?utm_source=pypi&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task).
56
+
57
+ ## Submit once and keep the job ID
58
+
59
+ The default operation is `status`. Status and result accept only a saved job ID,
60
+ and never submit a paid query. A pending/running response does not mean delivery is complete.
61
+
62
+ For a new delivery, supply your own authorized video and storage configuration:
63
+
64
+ ```sh
65
+ uvx flashdata-youtube-cloud-storage@0.2.1 --operation submit --allow-submit \
66
+ --video-id YOUR_VIDEO_ID \
67
+ --options-json '{"download_type":"audio","output_format":"m4a"}' \
68
+ --output delivery-receipt.json
69
+ ```
70
+
71
+ Set `FLASHDATA_DOWNLOAD_STORAGE` through your secret manager, containing the documented
72
+ storage JSON. Never paste it into command arguments or source code. The supported providers
73
+ are s3, s3_compatible, gcs, azure, oss, bos, cos and tos. Use your own bucket/container,
74
+ optional object_prefix, and the provider-specific credentials. S3-compatible endpoints must
75
+ use HTTPS. [Storage fields and examples](https://flashdata.dev/docs/sources/youtube_download?utm_source=pypi&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task).
76
+
77
+ Keep the returned `id`. Read that same job with `--operation status --job-id ID` or
78
+ `--operation result --job-id ID`. Omit submission inputs when resuming. There is no automatic
79
+ polling or resubmission. Only the lifecycle receipt and delivery JSON are exported; media is
80
+ written by FlashData to your storage. Result JSON expires after 24 hours. Delivery manifests
81
+ can contain signed private URLs; protect the output file. Storage credentials from job params
82
+ are excluded from CLI output.
83
+
84
+ ## Fees and failure handling
85
+
86
+ This MIT-licensed CLI is free to install. FlashData API requests consume paid Credits;
87
+ [current pricing](https://flashdata.dev/pricing?utm_source=pypi&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task) applies. Extended YouTube Search has a separate
88
+ rate. Media delivery is billed by delivered volume, and your cloud-storage costs are separate.
89
+ There is no automatic pagination, retry, polling, scheduled execution or model call.
90
+
91
+ Each HTTP request has a 120-second network timeout (15-second connect timeout) and a 20-MiB response
92
+ limit. A timeout or failure may occur after a paid request has been accepted. Check Jobs in
93
+ the [FlashData console](https://flashdata.dev?utm_source=pypi&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task) before resubmitting. HTTP 401 means check the Key;
94
+ 402 means insufficient Credits; 429 means rate/quota limit. A partial output file is retained
95
+ on failure. Do not retry a paid query just because output handling failed.
96
+
97
+ Input values and your API Key are sent to FlashData to perform the request. A completed
98
+ download-result read may fetch a signed JSON object from the result origin returned by
99
+ FlashData; the API Key is never sent to that object URL. Only process data appropriate for
100
+ your output destination. [Privacy policy](https://flashdata.dev/legal/privacy?utm_source=pypi&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task).
101
+
102
+ Source and MIT license are included in the source distribution.
103
+
104
+ [Source documentation](https://flashdata.dev/docs/sources/youtube_download?utm_source=pypi&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task) ·
105
+ [Pricing](https://flashdata.dev/pricing?utm_source=pypi&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task) · [Sign up](https://flashdata.dev/signup?utm_source=pypi&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task)
@@ -1,2 +1,2 @@
1
- SOURCE = 'youtube_download'
2
- COMMAND = 'flashdata-youtube-cloud-storage'
1
+ SOURCE = 'youtube_download'
2
+ COMMAND = 'flashdata-youtube-cloud-storage'
@@ -1,201 +1,201 @@
1
- """CLI entry point shared at build time by fifteen independently named packages."""
2
-
3
- import argparse
4
- import json
5
- import os
6
- import sys
7
- from pathlib import Path
8
- from urllib.parse import urlsplit
9
-
10
- from pydantic import ValidationError
11
-
12
- from . import __version__
13
- from ._client import UNKNOWN_OUTCOME, Client, FlashDataError
14
- from ._inputs import (
15
- DownloadJobInput,
16
- GoogleInput,
17
- YouTubeCaptionsInput,
18
- YouTubeChannelInput,
19
- YouTubeDownloadInput,
20
- YouTubeExtendedSearchInput,
21
- YouTubeMetadataInput,
22
- YouTubeSearchInput,
23
- YouTubeSuggestionsInput,
24
- YouTubeTrainabilityInput,
25
- YouTubeTranscriptInput,
26
- )
27
- from ._storage import storage_config
28
-
29
- CONTRACTS = {
30
- **{
31
- f"google_{kind}": GoogleInput
32
- for kind in ("search", "news", "images", "shopping", "videos", "places")
33
- },
34
- "youtube_search": YouTubeSearchInput,
35
- "youtube_search_extended": YouTubeExtendedSearchInput,
36
- "youtube_metadata": YouTubeMetadataInput,
37
- "youtube_transcript": YouTubeTranscriptInput,
38
- "youtube_captions": YouTubeCaptionsInput,
39
- "youtube_trainability": YouTubeTrainabilityInput,
40
- "youtube_channel": YouTubeChannelInput,
41
- "youtube_suggestions": YouTubeSuggestionsInput,
42
- "youtube_download": YouTubeDownloadInput,
43
- }
44
-
45
-
46
- class Parser(argparse.ArgumentParser):
47
- def error(self, message):
48
- raise FlashDataError("Invalid command arguments. Use --help for supported options.")
49
-
50
-
51
- def parser_for(source, command):
52
- parser = Parser(
53
- prog=command,
54
- description=(
55
- f"Run the {source} FlashData API and export JSON. API calls use paid Credits. "
56
- "Read FLASHDATA_API_KEY from the environment; never pass credentials as arguments."
57
- ),
58
- )
59
- parser.add_argument("--version", action="version", version=f"{command} {__version__}")
60
- parser.add_argument(
61
- "--schema", action="store_true", help="Print the input schema; no API call."
62
- )
63
- parser.add_argument(
64
- "--output", type=Path, help="New JSON file (0600); existing files are refused."
65
- )
66
- primary = (
67
- "handle"
68
- if source == "youtube_channel"
69
- else "query"
70
- if (
71
- source.startswith("google_")
72
- or source in ("youtube_search", "youtube_search_extended", "youtube_suggestions")
73
- )
74
- else "video-id"
75
- )
76
- parser.add_argument("--" + primary, help="Primary query, channel handle, or YouTube ID/URL.")
77
- parser.add_argument(
78
- "--options-json", help="Source options as a JSON object, without credentials."
79
- )
80
- if source == "youtube_download":
81
- parser.add_argument("--operation", choices=["status", "result", "submit"], default="status")
82
- parser.add_argument("--job-id", help="Previously saved job ID for status/result.")
83
- parser.add_argument(
84
- "--allow-submit", action="store_true", help="Permit one paid storage write."
85
- )
86
- return parser
87
-
88
-
89
- def payload_for(source, args, environ):
90
- operation = getattr(args, "operation", "query")
91
- if operation in ("status", "result"):
92
- if args.video_id or args.options_json or args.allow_submit:
93
- raise FlashDataError("Status/result accepts --job-id, without submission inputs.")
94
- return operation, DownloadJobInput(job_id=args.job_id).model_dump()
95
- try:
96
- options = json.loads(args.options_json) if args.options_json is not None else {}
97
- except ValueError:
98
- raise FlashDataError("--options-json must be a JSON object.") from None
99
- if not isinstance(options, dict) or any(
100
- field in options for field in ("source", "query", "video_id", "handle", "storage")
101
- ):
102
- raise FlashDataError(
103
- "Use dedicated primary inputs; source is fixed and secrets use env vars."
104
- )
105
- values = dict(options)
106
- for primary in ("query", "video_id", "handle"):
107
- value = getattr(args, primary, None)
108
- if value is not None:
109
- values[primary] = value
110
- data = CONTRACTS[source].model_validate(values).model_dump(exclude_none=True, by_alias=True)
111
- primary = next(key for key in ("query", "video_id", "handle") if key in data)
112
- payload = {"source": source, primary: data.pop(primary), "params": data}
113
- if operation == "submit":
114
- if args.job_id or not args.allow_submit:
115
- raise FlashDataError(
116
- "New delivery requires --allow-submit; saved jobs use status/result."
117
- )
118
- storage = storage_config(environ.get("FLASHDATA_DOWNLOAD_STORAGE", ""))
119
- endpoint = storage.get("endpoint_url")
120
- if endpoint:
121
- url = urlsplit(endpoint)
122
- if (
123
- url.scheme != "https"
124
- or not url.hostname
125
- or url.username
126
- or url.password
127
- or url.query
128
- or url.fragment
129
- ):
130
- raise FlashDataError("Storage endpoint must be an HTTPS URL without credentials.")
131
- payload["params"]["storage"] = storage
132
- return operation, payload
133
-
134
-
135
- def run(
136
- source, command, argv=None, *, environ=None, stdout=None, stderr=None, client_factory=Client
137
- ):
138
- environ = os.environ if environ is None else environ
139
- stdout = sys.stdout if stdout is None else stdout
140
- stderr = sys.stderr if stderr is None else stderr
141
- output = None
142
- request_started = False
143
- output_complete = False
144
- try:
145
- args = parser_for(source, command).parse_args(argv)
146
- if args.schema:
147
- stdout.write(json.dumps(CONTRACTS[source].model_json_schema(), indent=2) + "\n")
148
- return 0
149
- operation, payload = payload_for(source, args, environ)
150
- key = environ.get("FLASHDATA_API_KEY", "").strip()
151
- if not key or any(ord(c) < 32 or ord(c) == 127 for c in key):
152
- raise FlashDataError("Set a valid FLASHDATA_API_KEY environment variable.")
153
- if args.output:
154
- # Reserve the new path before spending Credits, without replacing user files.
155
- fd = os.open(args.output, os.O_WRONLY | os.O_CREAT | os.O_EXCL, 0o600)
156
- output = os.fdopen(fd, "w", encoding="utf-8")
157
- client = client_factory(key)
158
- request_started = True
159
- result = (
160
- client.query(payload)
161
- if operation == "query"
162
- else client.submit(payload)
163
- if operation == "submit"
164
- else client.status(payload["job_id"])
165
- if operation == "status"
166
- else client.result(payload["job_id"])
167
- )
168
- destination = output if output else stdout
169
- destination.write(json.dumps(result, ensure_ascii=False, allow_nan=False, indent=2) + "\n")
170
- destination.flush()
171
- output_complete = True
172
- return 0
173
- except ValidationError:
174
- stderr.write("Invalid source input. See --schema for fields, types, ranges and defaults.\n")
175
- return 2
176
- except FlashDataError as error:
177
- stderr.write(str(error) + "\n")
178
- return 1 if request_started else 2
179
- except (OSError, ValueError, TypeError):
180
- stderr.write(
181
- (
182
- "Could not save the response. " + UNKNOWN_OUTCOME
183
- if request_started
184
- else "Could not prepare output or inputs. Check the new output path."
185
- )
186
- + "\n"
187
- )
188
- return 1 if request_started else 2
189
- finally:
190
- if output:
191
- output.close()
192
- if not output_complete:
193
- stderr.write(
194
- "The newly reserved output file is incomplete; check Jobs before retrying.\n"
195
- )
196
-
197
-
198
- def main():
199
- from ._capability import COMMAND, SOURCE
200
-
201
- raise SystemExit(run(SOURCE, COMMAND))
1
+ """CLI entry point shared at build time by fifteen independently named packages."""
2
+
3
+ import argparse
4
+ import json
5
+ import os
6
+ import sys
7
+ from pathlib import Path
8
+ from urllib.parse import urlsplit
9
+
10
+ from pydantic import ValidationError
11
+
12
+ from . import __version__
13
+ from ._client import UNKNOWN_OUTCOME, Client, FlashDataError
14
+ from ._inputs import (
15
+ DownloadJobInput,
16
+ GoogleInput,
17
+ YouTubeCaptionsInput,
18
+ YouTubeChannelInput,
19
+ YouTubeDownloadInput,
20
+ YouTubeExtendedSearchInput,
21
+ YouTubeMetadataInput,
22
+ YouTubeSearchInput,
23
+ YouTubeSuggestionsInput,
24
+ YouTubeTrainabilityInput,
25
+ YouTubeTranscriptInput,
26
+ )
27
+ from ._storage import storage_config
28
+
29
+ CONTRACTS = {
30
+ **{
31
+ f"google_{kind}": GoogleInput
32
+ for kind in ("search", "news", "images", "shopping", "videos", "places")
33
+ },
34
+ "youtube_search": YouTubeSearchInput,
35
+ "youtube_search_extended": YouTubeExtendedSearchInput,
36
+ "youtube_metadata": YouTubeMetadataInput,
37
+ "youtube_transcript": YouTubeTranscriptInput,
38
+ "youtube_captions": YouTubeCaptionsInput,
39
+ "youtube_trainability": YouTubeTrainabilityInput,
40
+ "youtube_channel": YouTubeChannelInput,
41
+ "youtube_suggestions": YouTubeSuggestionsInput,
42
+ "youtube_download": YouTubeDownloadInput,
43
+ }
44
+
45
+
46
+ class Parser(argparse.ArgumentParser):
47
+ def error(self, message):
48
+ raise FlashDataError("Invalid command arguments. Use --help for supported options.")
49
+
50
+
51
+ def parser_for(source, command):
52
+ parser = Parser(
53
+ prog=command,
54
+ description=(
55
+ f"Run the {source} FlashData API and export JSON. API calls use paid Credits. "
56
+ "Read FLASHDATA_API_KEY from the environment; never pass credentials as arguments."
57
+ ),
58
+ )
59
+ parser.add_argument("--version", action="version", version=f"{command} {__version__}")
60
+ parser.add_argument(
61
+ "--schema", action="store_true", help="Print the input schema; no API call."
62
+ )
63
+ parser.add_argument(
64
+ "--output", type=Path, help="New JSON file (0600); existing files are refused."
65
+ )
66
+ primary = (
67
+ "handle"
68
+ if source == "youtube_channel"
69
+ else "query"
70
+ if (
71
+ source.startswith("google_")
72
+ or source in ("youtube_search", "youtube_search_extended", "youtube_suggestions")
73
+ )
74
+ else "video-id"
75
+ )
76
+ parser.add_argument("--" + primary, help="Primary query, channel handle, or YouTube ID/URL.")
77
+ parser.add_argument(
78
+ "--options-json", help="Source options as a JSON object, without credentials."
79
+ )
80
+ if source == "youtube_download":
81
+ parser.add_argument("--operation", choices=["status", "result", "submit"], default="status")
82
+ parser.add_argument("--job-id", help="Previously saved job ID for status/result.")
83
+ parser.add_argument(
84
+ "--allow-submit", action="store_true", help="Permit one paid storage write."
85
+ )
86
+ return parser
87
+
88
+
89
+ def payload_for(source, args, environ):
90
+ operation = getattr(args, "operation", "query")
91
+ if operation in ("status", "result"):
92
+ if args.video_id or args.options_json or args.allow_submit:
93
+ raise FlashDataError("Status/result accepts --job-id, without submission inputs.")
94
+ return operation, DownloadJobInput(job_id=args.job_id).model_dump()
95
+ try:
96
+ options = json.loads(args.options_json) if args.options_json is not None else {}
97
+ except ValueError:
98
+ raise FlashDataError("--options-json must be a JSON object.") from None
99
+ if not isinstance(options, dict) or any(
100
+ field in options for field in ("source", "query", "video_id", "handle", "storage")
101
+ ):
102
+ raise FlashDataError(
103
+ "Use dedicated primary inputs; source is fixed and secrets use env vars."
104
+ )
105
+ values = dict(options)
106
+ for primary in ("query", "video_id", "handle"):
107
+ value = getattr(args, primary, None)
108
+ if value is not None:
109
+ values[primary] = value
110
+ data = CONTRACTS[source].model_validate(values).model_dump(exclude_none=True, by_alias=True)
111
+ primary = next(key for key in ("query", "video_id", "handle") if key in data)
112
+ payload = {"source": source, primary: data.pop(primary), "params": data}
113
+ if operation == "submit":
114
+ if args.job_id or not args.allow_submit:
115
+ raise FlashDataError(
116
+ "New delivery requires --allow-submit; saved jobs use status/result."
117
+ )
118
+ storage = storage_config(environ.get("FLASHDATA_DOWNLOAD_STORAGE", ""))
119
+ endpoint = storage.get("endpoint_url")
120
+ if endpoint:
121
+ url = urlsplit(endpoint)
122
+ if (
123
+ url.scheme != "https"
124
+ or not url.hostname
125
+ or url.username
126
+ or url.password
127
+ or url.query
128
+ or url.fragment
129
+ ):
130
+ raise FlashDataError("Storage endpoint must be an HTTPS URL without credentials.")
131
+ payload["params"]["storage"] = storage
132
+ return operation, payload
133
+
134
+
135
+ def run(
136
+ source, command, argv=None, *, environ=None, stdout=None, stderr=None, client_factory=Client
137
+ ):
138
+ environ = os.environ if environ is None else environ
139
+ stdout = sys.stdout if stdout is None else stdout
140
+ stderr = sys.stderr if stderr is None else stderr
141
+ output = None
142
+ request_started = False
143
+ output_complete = False
144
+ try:
145
+ args = parser_for(source, command).parse_args(argv)
146
+ if args.schema:
147
+ stdout.write(json.dumps(CONTRACTS[source].model_json_schema(), indent=2) + "\n")
148
+ return 0
149
+ operation, payload = payload_for(source, args, environ)
150
+ key = environ.get("FLASHDATA_API_KEY", "").strip()
151
+ if not key or any(ord(c) < 32 or ord(c) == 127 for c in key):
152
+ raise FlashDataError("Set a valid FLASHDATA_API_KEY environment variable.")
153
+ if args.output:
154
+ # Reserve the new path before spending Credits, without replacing user files.
155
+ fd = os.open(args.output, os.O_WRONLY | os.O_CREAT | os.O_EXCL, 0o600)
156
+ output = os.fdopen(fd, "w", encoding="utf-8")
157
+ client = client_factory(key)
158
+ request_started = True
159
+ result = (
160
+ client.query(payload)
161
+ if operation == "query"
162
+ else client.submit(payload)
163
+ if operation == "submit"
164
+ else client.status(payload["job_id"])
165
+ if operation == "status"
166
+ else client.result(payload["job_id"])
167
+ )
168
+ destination = output if output else stdout
169
+ destination.write(json.dumps(result, ensure_ascii=False, allow_nan=False, indent=2) + "\n")
170
+ destination.flush()
171
+ output_complete = True
172
+ return 0
173
+ except ValidationError:
174
+ stderr.write("Invalid source input. See --schema for fields, types, ranges and defaults.\n")
175
+ return 2
176
+ except FlashDataError as error:
177
+ stderr.write(str(error) + "\n")
178
+ return 1 if request_started else 2
179
+ except (OSError, ValueError, TypeError):
180
+ stderr.write(
181
+ (
182
+ "Could not save the response. " + UNKNOWN_OUTCOME
183
+ if request_started
184
+ else "Could not prepare output or inputs. Check the new output path."
185
+ )
186
+ + "\n"
187
+ )
188
+ return 1 if request_started else 2
189
+ finally:
190
+ if output:
191
+ output.close()
192
+ if not output_complete:
193
+ stderr.write(
194
+ "The newly reserved output file is incomplete; check Jobs before retrying.\n"
195
+ )
196
+
197
+
198
+ def main():
199
+ from ._capability import COMMAND, SOURCE
200
+
201
+ raise SystemExit(run(SOURCE, COMMAND))
@@ -1,152 +1,152 @@
1
- {
2
- "additionalProperties": false,
3
- "description": "Media options only. Storage credentials are injected by the application.",
4
- "properties": {
5
- "video_id": {
6
- "description": "11-character YouTube video ID or a YouTube video URL.",
7
- "title": "Video Id",
8
- "type": "string"
9
- },
10
- "download_type": {
11
- "default": "audio_video",
12
- "enum": [
13
- "audio_video",
14
- "video",
15
- "audio"
16
- ],
17
- "title": "Download Type",
18
- "type": "string"
19
- },
20
- "video_quality": {
21
- "anyOf": [
22
- {
23
- "pattern": "^(best|worst|(?:<=|==|>=)(?:144|360|480|720|1080|1440|2160|4320))$",
24
- "type": "string"
25
- },
26
- {
27
- "type": "null"
28
- }
29
- ],
30
- "default": null,
31
- "title": "Video Quality"
32
- },
33
- "fps": {
34
- "anyOf": [
35
- {
36
- "pattern": "^(?:>=|<=|==)(?:[1-9]\\d?|1\\d\\d|2[0-3]\\d|240)$",
37
- "type": "string"
38
- },
39
- {
40
- "type": "null"
41
- }
42
- ],
43
- "default": null,
44
- "title": "Fps"
45
- },
46
- "audio_language": {
47
- "anyOf": [
48
- {
49
- "enum": [
50
- "default",
51
- "original"
52
- ],
53
- "type": "string"
54
- },
55
- {
56
- "type": "null"
57
- }
58
- ],
59
- "default": null,
60
- "title": "Audio Language"
61
- },
62
- "audio_quality": {
63
- "anyOf": [
64
- {
65
- "enum": [
66
- "best",
67
- "320",
68
- "256",
69
- "192",
70
- "128"
71
- ],
72
- "type": "string"
73
- },
74
- {
75
- "type": "null"
76
- }
77
- ],
78
- "default": null,
79
- "title": "Audio Quality"
80
- },
81
- "yt_dlp_format": {
82
- "anyOf": [
83
- {
84
- "maxLength": 1024,
85
- "minLength": 1,
86
- "type": "string"
87
- },
88
- {
89
- "type": "null"
90
- }
91
- ],
92
- "default": null,
93
- "title": "Yt Dlp Format"
94
- },
95
- "upload_metadata": {
96
- "default": false,
97
- "title": "Upload Metadata",
98
- "type": "boolean"
99
- },
100
- "output_format": {
101
- "anyOf": [
102
- {
103
- "enum": [
104
- "mp4",
105
- "webm",
106
- "mkv",
107
- "m4a",
108
- "mp3",
109
- "opus"
110
- ],
111
- "type": "string"
112
- },
113
- {
114
- "type": "null"
115
- }
116
- ],
117
- "default": null,
118
- "title": "Output Format"
119
- },
120
- "start_at": {
121
- "anyOf": [
122
- {
123
- "pattern": "^\\d{1,2}:[0-5]\\d:[0-5]\\d$",
124
- "type": "string"
125
- },
126
- {
127
- "type": "null"
128
- }
129
- ],
130
- "default": null,
131
- "title": "Start At"
132
- },
133
- "end_at": {
134
- "anyOf": [
135
- {
136
- "pattern": "^\\d{1,2}:[0-5]\\d:[0-5]\\d$",
137
- "type": "string"
138
- },
139
- {
140
- "type": "null"
141
- }
142
- ],
143
- "default": null,
144
- "title": "End At"
145
- }
146
- },
147
- "required": [
148
- "video_id"
149
- ],
150
- "title": "YouTubeDownloadInput",
151
- "type": "object"
152
- }
1
+ {
2
+ "additionalProperties": false,
3
+ "description": "Media options only. Storage credentials are injected by the application.",
4
+ "properties": {
5
+ "video_id": {
6
+ "description": "11-character YouTube video ID or a YouTube video URL.",
7
+ "title": "Video Id",
8
+ "type": "string"
9
+ },
10
+ "download_type": {
11
+ "default": "audio_video",
12
+ "enum": [
13
+ "audio_video",
14
+ "video",
15
+ "audio"
16
+ ],
17
+ "title": "Download Type",
18
+ "type": "string"
19
+ },
20
+ "video_quality": {
21
+ "anyOf": [
22
+ {
23
+ "pattern": "^(best|worst|(?:<=|==|>=)(?:144|360|480|720|1080|1440|2160|4320))$",
24
+ "type": "string"
25
+ },
26
+ {
27
+ "type": "null"
28
+ }
29
+ ],
30
+ "default": null,
31
+ "title": "Video Quality"
32
+ },
33
+ "fps": {
34
+ "anyOf": [
35
+ {
36
+ "pattern": "^(?:>=|<=|==)(?:[1-9]\\d?|1\\d\\d|2[0-3]\\d|240)$",
37
+ "type": "string"
38
+ },
39
+ {
40
+ "type": "null"
41
+ }
42
+ ],
43
+ "default": null,
44
+ "title": "Fps"
45
+ },
46
+ "audio_language": {
47
+ "anyOf": [
48
+ {
49
+ "enum": [
50
+ "default",
51
+ "original"
52
+ ],
53
+ "type": "string"
54
+ },
55
+ {
56
+ "type": "null"
57
+ }
58
+ ],
59
+ "default": null,
60
+ "title": "Audio Language"
61
+ },
62
+ "audio_quality": {
63
+ "anyOf": [
64
+ {
65
+ "enum": [
66
+ "best",
67
+ "320",
68
+ "256",
69
+ "192",
70
+ "128"
71
+ ],
72
+ "type": "string"
73
+ },
74
+ {
75
+ "type": "null"
76
+ }
77
+ ],
78
+ "default": null,
79
+ "title": "Audio Quality"
80
+ },
81
+ "yt_dlp_format": {
82
+ "anyOf": [
83
+ {
84
+ "maxLength": 1024,
85
+ "minLength": 1,
86
+ "type": "string"
87
+ },
88
+ {
89
+ "type": "null"
90
+ }
91
+ ],
92
+ "default": null,
93
+ "title": "Yt Dlp Format"
94
+ },
95
+ "upload_metadata": {
96
+ "default": false,
97
+ "title": "Upload Metadata",
98
+ "type": "boolean"
99
+ },
100
+ "output_format": {
101
+ "anyOf": [
102
+ {
103
+ "enum": [
104
+ "mp4",
105
+ "webm",
106
+ "mkv",
107
+ "m4a",
108
+ "mp3",
109
+ "opus"
110
+ ],
111
+ "type": "string"
112
+ },
113
+ {
114
+ "type": "null"
115
+ }
116
+ ],
117
+ "default": null,
118
+ "title": "Output Format"
119
+ },
120
+ "start_at": {
121
+ "anyOf": [
122
+ {
123
+ "pattern": "^\\d{1,2}:[0-5]\\d:[0-5]\\d$",
124
+ "type": "string"
125
+ },
126
+ {
127
+ "type": "null"
128
+ }
129
+ ],
130
+ "default": null,
131
+ "title": "Start At"
132
+ },
133
+ "end_at": {
134
+ "anyOf": [
135
+ {
136
+ "pattern": "^\\d{1,2}:[0-5]\\d:[0-5]\\d$",
137
+ "type": "string"
138
+ },
139
+ {
140
+ "type": "null"
141
+ }
142
+ ],
143
+ "default": null,
144
+ "title": "End At"
145
+ }
146
+ },
147
+ "required": [
148
+ "video_id"
149
+ ],
150
+ "title": "YouTubeDownloadInput",
151
+ "type": "object"
152
+ }
@@ -1,29 +1,29 @@
1
- [build-system]
2
- requires = ["hatchling>=1.27,<2"]
3
- build-backend = "hatchling.build"
4
-
5
- [project]
6
- name = "flashdata-youtube-cloud-storage"
7
- version = "0.2.0"
8
- description = "Deliver authorized YouTube media to your cloud storage with the FlashData JSON CLI"
9
- readme = "README.md"
10
- requires-python = ">=3.10"
11
- license = "MIT"
12
- license-files = ["LICENSE"]
13
- authors = [{name = "FlashData", email = "support@flashdata.dev"}]
14
- keywords = ["youtube-download", "cli", "json", "uvx", "flashdata"]
15
- classifiers = ["Intended Audience :: Developers", "Programming Language :: Python :: 3", "Environment :: Console"]
16
- dependencies = ["httpx>=0.28.1,<1", "pydantic>=2.7.4,<3", "jsonschema>=4.23,<5"]
17
-
18
- [project.scripts]
19
- flashdata-youtube-cloud-storage = "flashdata_youtube_cloud_storage_cli.cli:main"
20
-
21
- [project.urls]
22
- Homepage = "https://flashdata.dev/docs/sources/youtube_download"
23
- Documentation = "https://flashdata.dev/docs/sources/youtube_download"
24
- Pricing = "https://flashdata.dev/pricing"
25
- Support = "https://flashdata.dev"
26
- Source = "https://github.com/flashdatadev/flashdata-mcp/tree/main/packages/python-cli"
27
-
28
- [tool.hatch.build.targets.wheel]
29
- packages = ["flashdata_youtube_cloud_storage_cli"]
1
+ [build-system]
2
+ requires = ["hatchling>=1.27,<2"]
3
+ build-backend = "hatchling.build"
4
+
5
+ [project]
6
+ name = "flashdata-youtube-cloud-storage"
7
+ version = "0.2.1"
8
+ description = "Deliver authorized YouTube media to your cloud storage with the FlashData JSON CLI"
9
+ readme = "README.md"
10
+ requires-python = ">=3.10"
11
+ license = "MIT"
12
+ license-files = ["LICENSE"]
13
+ authors = [{name = "FlashData", email = "support@flashdata.dev"}]
14
+ keywords = ["youtube-download", "cli", "json", "uvx", "flashdata"]
15
+ classifiers = ["Intended Audience :: Developers", "Programming Language :: Python :: 3", "Environment :: Console"]
16
+ dependencies = ["httpx>=0.28.1,<1", "pydantic>=2.7.4,<3", "jsonschema>=4.23,<5"]
17
+
18
+ [project.scripts]
19
+ flashdata-youtube-cloud-storage = "flashdata_youtube_cloud_storage_cli.cli:main"
20
+
21
+ [project.urls]
22
+ Homepage = "https://flashdata.dev/docs/sources/youtube_download?utm_source=pypi&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task"
23
+ Documentation = "https://flashdata.dev/docs/sources/youtube_download?utm_source=pypi&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task"
24
+ Pricing = "https://flashdata.dev/pricing?utm_source=pypi&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task"
25
+ Support = "https://flashdata.dev?utm_source=pypi&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_download-task"
26
+ Source = "https://github.com/flashdatadev/flashdata-mcp/tree/main/packages/python-cli"
27
+
28
+ [tool.hatch.build.targets.wheel]
29
+ packages = ["flashdata_youtube_cloud_storage_cli"]