מדריך שלב‑אחר‑שלב להמרת VSD ל‑SVG ב‑Python

pip install asposehtmlcloud

from asposehtmlcloud import Configuration

config = Configuration()
config.api_key['client_id'] = os.getenv('ASPOSE_CLIENT_ID')
config.api_key['client_secret'] = os.getenv('ASPOSE_CLIENT_SECRET')
config.host = 'https://api.aspose.cloud'

from asposehtmlcloud import HtmlApi, StorageApi

html_api = HtmlApi(configuration=config)
storage_api = StorageApi(configuration=config)

def upload_to_storage(local_path: str, remote_path: str) -> None:
    with open(local_path, "rb") as f:
        file_bytes = f.read()
    upload_req = UploadFileRequest(path=remote_path, file=file_bytes)
    storage_api.upload_file(upload_req)

convert_req = ConvertDocumentRequest(
    name=remote_input_path,
    format="svg",
    out_path=remote_output_path,
    storage=None,
    folder=None
)
html_api.convert_document(convert_req)

def download_from_storage(remote_path: str, local_path: str) -> None:
    download_req = DownloadFileRequest(path=remote_path)
    response = storage_api.download_file(download_req)
    with open(local_path, "wb") as out_file:
        for chunk in response.iter_content(chunk_size=8192):
            if chunk:
                out_file.write(chunk)

def validate_svg(svg_path: str) -> bool:
    try:
        tree = ET.parse(svg_path)
        root = tree.getroot()
        return root.tag.endswith('svg')
    except ET.ParseError:
        return False

storage_api.delete_file(UploadFileRequest(path=remote_input_path))
storage_api.delete_file(UploadFileRequest(path=remote_output_path))

import os
import io
import sys
import xml.etree.ElementTree as ET
from asposehtmlcloud import (
    HtmlApi,
    StorageApi,
    Configuration,
    ApiException,
    UploadFileRequest,
    DownloadFileRequest,
    ConvertDocumentRequest,
)

# ----------------------------------------------------------------------
# Configuration – use environment variables for credentials (security)
# ----------------------------------------------------------------------
config = Configuration()
config.api_key['client_id'] = os.getenv('ASPOSE_CLIENT_ID')
config.api_key['client_secret'] = os.getenv('ASPOSE_CLIENT_SECRET')
# Default Aspose Cloud base URL; change if using a different region
config.host = 'https://api.aspose.cloud'

# ----------------------------------------------------------------------
# API instances
# ----------------------------------------------------------------------
html_api = HtmlApi(configuration=config)
storage_api = StorageApi(configuration=config)

# ----------------------------------------------------------------------
# File paths (generic, adjust as needed)
# ----------------------------------------------------------------------
local_input_path = "sample.vsd"          # VSD file on local disk
remote_input_path = "temp/sample.vsd"    # Path in Aspose Cloud storage
remote_output_path = "temp/sample.svg"   # Desired SVG location in storage
local_output_path = "sample.svg"         # Final SVG on local disk

# ----------------------------------------------------------------------
# Helper: upload a file to Aspose Cloud storage
# ----------------------------------------------------------------------
def upload_to_storage(local_path: str, remote_path: str) -> None:
    with open(local_path, "rb") as f:
        file_bytes = f.read()
    upload_req = UploadFileRequest(path=remote_path, file=file_bytes)
    storage_api.upload_file(upload_req)

# ----------------------------------------------------------------------
# Helper: download a file from Aspose Cloud storage (streamed)
# ----------------------------------------------------------------------
def download_from_storage(remote_path: str, local_path: str) -> None:
    download_req = DownloadFileRequest(path=remote_path)
    # The SDK returns a file stream; we write it in chunks to avoid high memory usage
    response = storage_api.download_file(download_req)
    with open(local_path, "wb") as out_file:
        for chunk in response.iter_content(chunk_size=8192):
            if chunk:
                out_file.write(chunk)

# ----------------------------------------------------------------------
# Helper: validate that the resulting SVG is well‑formed XML
# ----------------------------------------------------------------------
def validate_svg(svg_path: str) -> bool:
    try:
        tree = ET.parse(svg_path)
        root = tree.getroot()
        return root.tag.endswith('svg')
    except ET.ParseError:
        return False

# ----------------------------------------------------------------------
# Main conversion workflow with robust error handling
# ----------------------------------------------------------------------
def convert_vsd_to_svg():
    try:
        # 1. Upload source VSD
        upload_to_storage(local_input_path, remote_input_path)

# 2. Convert VSD → SVG using Aspose.HTML Cloud
        convert_req = ConvertDocumentRequest(
            name=remote_input_path,
            format="svg",
            out_path=remote_output_path,
            storage=None,          # default storage
            folder=None            # root folder
        )
        html_api.convert_document(convert_req)

# 3. Download the generated SVG
        download_from_storage(remote_output_path, local_output_path)

# 4. Validate SVG integrity
        if not validate_svg(local_output_path):
            raise ValueError("The generated SVG is not a valid SVG document.")

# 5. (Optional) Clean up remote files to keep storage tidy
        storage_api.delete_file(UploadFileRequest(path=remote_input_path))
        storage_api.delete_file(UploadFileRequest(path=remote_output_path))

print(f"Conversion successful. SVG saved to '{local_output_path}'.")
    except ApiException as api_err:
        # Aspose‑specific errors (e.g., authentication, quota, unsupported format)
        sys.stderr.write(f"Aspose API error [{api_err.status}]: {api_err.reason}\n")
        sys.exit(1)
    except (OSError, IOError) as io_err:
        # Local file system errors
        sys.stderr.write(f"I/O error: {io_err}\n")
        sys.exit(1)
    except Exception as ex:
        # Catch‑all for unexpected issues
        sys.stderr.write(f"Unexpected error: {ex}\n")
        sys.exit(1)

# ----------------------------------------------------------------------
# Entry point
# ----------------------------------------------------------------------
if __name__ == "__main__":
    # Performance tip: for very large VSD files, consider increasing the timeout
    # on the underlying HTTP client (not shown here) or processing in batches.
    convert_vsd_to_svg()

# 1. Get an access token
curl -X POST "https://api.aspose.cloud/connect/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
# The response contains "access_token"

# 2. Upload the VSD file
curl -X PUT "https://api.aspose.cloud/v4.0/html/storage/file/temp/sample.vsd" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary "@sample.vsd"

# 3. Convert VSD to SVG
curl -X POST "https://api.aspose.cloud/v4.0/html/convert?format=svg&outPath=temp/sample.svg&fileName=temp/sample.vsd" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# 4. Download the SVG result
curl -X GET "https://api.aspose.cloud/v4.0/html/storage/file/temp/sample.svg" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o sample.svg

convert_req = ConvertDocumentRequest(
    name=remote_input_path,
    format="svg",
    out_path=remote_output_path,
    storage=None,
    folder=None
)

response = storage_api.download_file(download_req)
with open(local_path, "wb") as out_file:
    for chunk in response.iter_content(chunk_size=8192):
        if chunk:
            out_file.write(chunk)