ما می توانیم یک یا چند فایل یا پوشه فشرده را در یک فایل ZIP ذخیره کنیم تا به عنوان یک فایل واحد عمل کند. بایگانی Zip فضای ذخیره سازی را ذخیره می کند و عملکرد رایانه ها را افزایش می دهد. همچنین به ما امکان می دهد فایل ها و پوشه های خود را در یک آرشیو ZIP از یک مکان به مکان دیگر به طور موثر انتقال دهیم. در این مقاله یاد می گیریم که چگونه محتوای فایل های ZIP را با استفاده از REST API در پایتون مشاهده کنیم.
موضوعات زیر باید در این مقاله پوشش داده شود:
- ZIP File Viewer REST API و Python SDK
- مشاهده فایل های ZIP در HTML با استفاده از REST API در پایتون
- مشاهده پوشه خاص از آرشیو ZIP در HTML
- رندر محتوای فایل های ZIP در PDF
- رندر آرشیو ZIP به JPG
- فهرستی از فایل ها و پوشه ها را از آرشیو ZIP دریافت کنید
ZIP File Viewer REST API و Python SDK
برای ارائه آرشیوهای ZIP، از Python SDK of GroupDocs.Viewer Cloud API استفاده خواهیم کرد. این ما را قادر میسازد تا انواع [فرمتهای سند محبوب3 را به صورت برنامهنویسی ارائه کنیم. لطفا با استفاده از دستور زیر در کنسول آن را نصب کنید:
pip install groupdocs-viewer-cloud
لطفاً قبل از انجام مراحل ذکر شده [شناسه مشتری و راز خود را از داشبورد 4 دریافت کنید. هنگامی که شناسه و راز خود را دریافت کردید، کد را مطابق شکل زیر اضافه کنید:
# این مثال کد نحوه اضافه کردن Client Id و Secret را در کد نشان می دهد.
client_id = "659fe7da-715b-4744-a0f7-cf469a392b73"
client_secret = "b377c36cfa28fa69960ebac6b6e36421"
configuration = groupdocs_viewer_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"
my_storage = ""
مشاهده فایل های ZIP در HTML با استفاده از REST API در پایتون
با دنبال کردن مراحل ساده زیر میتوانیم آرشیوهای ZIP را در HTML ارائه کنیم:
- آپلود فایل ZIP در ابر
- رندر ZIP به HTML
- دانلود فایل HTML ارائه شده
فایل ZIP را آپلود کنید
ابتدا فایل ZIP را با استفاده از نمونه کد زیر در فضای ابری آپلود می کنیم:
# این مثال کد نحوه آپلود فایل ZIP در فضای ابری را نشان می دهد.
# یک نمونه از API ایجاد کنید
file_api = groupdocs_viewer_cloud.FileApi.from_config(configuration)
# درخواست آپلود فایل
request = groupdocs_viewer_cloud.UploadFileRequest("sample.zip", "C:\\Files\\Viewer\\sample.zip", my_storage)
# آپلود فایل
response = file_api.upload_file(request)
در نتیجه، فایل آپلود شده در بخش فایل ها داشبورد در فضای ابری در دسترس خواهد بود.
ZIP به HTML در پایتون رندر کنید
اکنون، با دنبال کردن مراحل زیر، محتوای آرشیو ZIP آپلود شده را در مرورگر مشاهده خواهیم کرد:
- ابتدا یک نمونه از ViewAPI ایجاد کنید.
- در مرحله بعد، گزینه های view را تعریف کرده و مسیر فایل ZIP آپلود شده را ارائه دهید.
- سپس، view\format را به عنوان “HTML” تنظیم کنید.
- در صورت تمایل، render\to\single\page را روی True تنظیم کنید.
- پس از آن، CreateViewRequest را با گزینه های view به عنوان آرگومان ایجاد کنید.
- در نهایت، ZIP را با استفاده از روش create\view() به HTML رندر کنید.
نمونه کد زیر نحوه ارائه فایل ZIP در HTML با استفاده از REST API در پایتون را نشان می دهد.
# این مثال کد نحوه رندر فایل ZIP به HTML را نشان می دهد.
# مقداردهی اولیه API
apiInstance = groupdocs_viewer_cloud.ViewApi.from_keys(client_id, client_secret)
# گزینه های مشاهده را تعریف کنید
view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "sample.zip"
view_options.view_format = "HTML"
# گزینه های HTML را تعریف کنید
view_options.render_options = groupdocs_viewer_cloud.HtmlOptions()
view_options.render_options.render_to_single_page = True
# ایجاد درخواست مشاهده
request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = apiInstance.create_view(request)
# نمایش نتایج
for page in response.pages:
print("Document path: " + page.path)
فایل رندر شده را دانلود کنید
نمونه کد بالا فایل HTML ارائه شده را در فضای ابری ذخیره می کند. با استفاده از نمونه کد زیر قابل دانلود است:
# این مثال کد نحوه دانلود فایل رندر شده از ابر را نشان می دهد.
# مقداردهی اولیه API
file_api = groupdocs_viewer_cloud.FileApi.from_config(configuration)
# درخواست فایل دانلود را ایجاد کنید
request = groupdocs_viewer_cloud.DownloadFileRequest("viewer\\sample_zip\\sample_page_1.html", my_storage)
# دریافت فایل
response = file_api.download_file(request)
# فایل دانلود شده را به دایرکتوری کاری خود منتقل کنید
shutil.move(response, "C:\\Files\\Viewer\\")
مشاهده پوشه خاص از آرشیو ZIP در HTML
همچنین با دنبال کردن مراحل زیر میتوانیم فقط یک پوشه خاص را از فایل ZIP در مرورگر مشاهده کنیم:
- ابتدا یک نمونه از ViewAPI ایجاد کنید.
- در مرحله بعد، viewoption ها را تعریف کرده و مسیر فایل ZIP آپلود شده را ارائه دهید.
- سپس، view\format را به عنوان “HTML” تنظیم کنید.
- سپس، ArchiveOptions را تعریف کنید و نام پوشه را برای رندر ارائه دهید.
- پس از آن، CreateViewRequest را با گزینه های view به عنوان آرگومان ایجاد کنید.
- در نهایت، با استفاده از متد ()create\view یک پوشه خاص را از ZIP به HTML رندر کنید.
نمونه کد زیر نحوه رندر کردن یک پوشه خاص از فایل ZIP در HTML را با استفاده از پایتون نشان می دهد.
# این مثال کد نشان می دهد که چگونه یک پوشه خاص را از فایل ZIP به HTML رندر کنید.
# مقداردهی اولیه API
apiInstance = groupdocs_viewer_cloud.ViewApi.from_keys(client_id, client_secret)
# گزینه های مشاهده را تعریف کنید
view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "sample.zip"
view_options.view_format = "HTML"
view_options.render_options = groupdocs_viewer_cloud.HtmlOptions()
# گزینه های آرشیو را تعریف کنید
view_options.render_options.archive_options = groupdocs_viewer_cloud.ArchiveOptions()
# نام پوشه را تنظیم کنید
view_options.render_options.archive_options.folder = "ThirdFolderWithItems"
# ایجاد درخواست مشاهده
request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = apiInstance.create_view(request)
# انجام شده
for page in response.pages:
print("Document path: " + page.path)
رندر محتوای فایل های ZIP در PDF
با دنبال کردن مراحل ساده زیر میتوانیم محتوای یک فایل ZIP را در یک سند PDF ارائه کنیم:
- ابتدا یک نمونه از ViewAPI ایجاد کنید.
- در مرحله بعد، viewoption ها را تعریف کرده و مسیر فایل ZIP آپلود شده را ارائه دهید.
- سپس، view\format را به عنوان “PDF” تنظیم کنید.
- پس از آن، CreateViewRequest را با گزینه های view به عنوان آرگومان ایجاد کنید.
- در نهایت، با استفاده از روش create\view() محتوا را از ZIP به PDF رندر کنید.
نمونه کد زیر نحوه ارائه محتوای یک فایل ZIP در PDF را با استفاده از REST API در پایتون نشان می دهد.
# این مثال کد نشان می دهد که چگونه یک فایل ZIP را به PDF تبدیل کنید.
# مقداردهی اولیه API
apiInstance = groupdocs_viewer_cloud.ViewApi.from_keys(client_id, client_secret)
# گزینه های مشاهده را تعریف کنید
view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "sample.zip"
view_options.view_format = "PDF"
# ایجاد درخواست مشاهده
request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = apiInstance.create_view(request)
# نمایش مسیر فایل
print("Document path: " + response.file.path)
رندر آرشیو ZIP به JPG
همچنین می توانیم با دنبال کردن مراحل زیر، محتوای یک فایل ZIP را به صورت تصویر JPG ارائه کنیم:
- ابتدا یک نمونه از ViewAPI ایجاد کنید.
- در مرحله بعد، viewoption ها را تعریف کرده و مسیر فایل ZIP آپلود شده را ارائه دهید.
- سپس، فرمت نمای را به عنوان “JPG” تنظیم کنید.
- پس از آن، CreateViewRequest را با گزینه های view به عنوان آرگومان ایجاد کنید.
- در نهایت، ZIP را با استفاده از روش create\view() به JPG تبدیل کنید.
نمونه کد زیر نحوه رندر فایل ZIP در یک تصویر JPG را با استفاده از REST API در پایتون نشان می دهد.
# این مثال کد نحوه رندر کردن یک فایل ZIP به JPG را نشان می دهد.
# مقداردهی اولیه API
apiInstance = groupdocs_viewer_cloud.ViewApi.from_keys(client_id, client_secret)
# گزینه های مشاهده را تعریف کنید
view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "sample.zip"
view_options.view_format = "JPG"
# ایجاد درخواست مشاهده
request = groupdocs_viewer_cloud.CreateViewRequest(view_options)
response = apiInstance.create_view(request)
# نمایش مسیر فایل
print("Document path: " + response.file.path)
فهرستی از فایل ها و پوشه ها را از آرشیو ZIP دریافت کنید
با دنبال کردن مراحل زیر میتوانیم فهرستی از تمام فایلها و پوشهها را از آرشیو ZIP دریافت کنیم:
- ابتدا یک نمونه از InfoAPI ایجاد کنید.
- در مرحله بعد، viewoption ها را تعریف کرده و مسیر فایل ZIP آپلود شده را ارائه دهید.
- پس از آن، GetInfoRequest را با گزینه های view به عنوان آرگومان ایجاد کنید.
- در نهایت، محتوای یک فایل ZIP را با استفاده از روش get\info() فهرست کنید.
نمونه کد زیر نحوه دریافت لیستی از فایل ها و پوشه ها را از فایل ZIP در پایتون نشان می دهد.
# این مثال کد نحوه فهرست کردن فایلها و پوشهها را در یک فایل ZIP نشان میدهد.
# مقداردهی اولیه API
apiInstance = groupdocs_viewer_cloud.InfoApi.from_keys(client_id, client_secret)
# گزینه های مشاهده را تعریف کنید
view_options = groupdocs_viewer_cloud.ViewOptions()
view_options.file_info = groupdocs_viewer_cloud.FileInfo()
view_options.file_info.file_path = "sample.zip"
# درخواست دریافت اطلاعات را ایجاد کنید
request = groupdocs_viewer_cloud.GetInfoRequest(view_options)
# گرفتن اطلاعات
response = apiInstance.get_info(request)
# لیست پوشه ها
folders = response.archive_view_info.folders
for folder in folders:
print(folder)
# لیست فایل ها
for attachment in response.attachments:
print(attachment.name)
آنلاین را امتحان کنید
لطفاً ابزار رندر ZIP آنلاین رایگان زیر را که با استفاده از API بالا ایجاد شده است، امتحان کنید. https://products.groupdocs.app/viewer/zip
نتیجه
در این مقاله یاد گرفتیم که چگونه:
- رندر آرشیو ZIP یا یک پوشه خاص از ZIP به HTML در پایتون.
- مشاهده محتوای یک فایل ZIP در PDF.
- رندر آرشیو ZIP به JPG.
- لیست فایل ها و پوشه های یک آرشیو ZIP.
- به صورت برنامه نویسی فایل ZIP را در ابر آپلود کنید.
- فایل HTML ارائه شده را از ابر دانلود کنید.
علاوه بر این، میتوانید با استفاده از مستندات درباره GroupDocs.Viewer Cloud API اطلاعات بیشتری کسب کنید. ما همچنین یک بخش API Reference ارائه میکنیم که به شما امکان میدهد APIهای ما را مستقیماً از طریق مرورگر تجسم کرده و با آنها تعامل داشته باشید. در صورت وجود هرگونه ابهام، لطفاً با ما در [تالار] تماس حاصل فرمایید24.