Μετάβαση στη Νέα Μηχανή Python-προς-.NET στην Έκδοση 26.8

Σχετικά με αυτήν τη σελίδα

Μετακινήστε τον κώδικά σας Python στη νέα μηχανή Aspose.Slides στην έκδοση 26.8: μεταφέρετε τα primitives σχεδίασης στο aspose.slides και διορθώστε αυτόματα τις εισαγωγές.

Εισαγωγή

Η έκδοση 26.8 αντικαθιστά τη μηχανή που συνδέει την Python με το .NET. Τα primitive σχεδίασης μετακινήθηκαν στο module aspose.slides.

Jump straight to Έχω Σφάλμα if you have an issues after upgrade.

Primitive Σχεδίασης Μεταφέρθηκαν στο aspose.slides

Μεταφέρθηκαν επτά τύποι. Διατηρούν τα ονόματά τους, τα ορίσματα και τη συμπεριφορά τους:

Τύπος	Πριν 26.8	26.8 και Μετά
Point	`aspose.pydrawing.Point`	aspose.slides.Point
PointF	`aspose.pydrawing.PointF`	aspose.slides.PointF
Size	`aspose.pydrawing.Size`	aspose.slides.Size
SizeF	`aspose.pydrawing.SizeF`	aspose.slides.SizeF
Rectangle	`aspose.pydrawing.Rectangle`	aspose.slides.Rectangle
RectangleF	`aspose.pydrawing.RectangleF`	aspose.slides.RectangleF
Color	`aspose.pydrawing.Color`	aspose.slides.Color

Αυτοί οι επτά τύποι ήταν το μοναδικό υπόλοιπο περιεχόμενο του aspose.pydrawing. Μόλις τα επαναπροσανατολίσετε, δεν χρειάζεται να αναφερθείτε καθόλου στο aspose.pydrawing στον κώδικά σας, και κάθε εισαγωγή του μπορεί να αφαιρεθεί. Αυτό επίσης καθιστά το αποτέλεσμα εύκολο στον έλεγχο – δείτε Επαλήθευση της Μετανάστευσης.

Παραδοσιακός κώδικας:

import aspose.slides as slides
import aspose.pydrawing as drawing

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 200, 100)

    shape.fill_format.fill_type = slides.FillType.SOLID
    shape.fill_format.solid_fill_color.color = drawing.Color.red

    with slide.get_image(drawing.Size(1920, 1080)) as slide_image:
        slide_image.save("slide1.jpeg", slides.ImageFormat.JPEG)

Έκδοση 26.8:

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 200, 100)

    shape.fill_format.fill_type = slides.FillType.SOLID
    shape.fill_format.solid_fill_color.color = slides.Color.red

    with slide.get_image(slides.Size(1920, 1080)) as slide_image:
        slide_image.save("slide1.jpeg", slides.ImageFormat.JPEG)

Η μορφή εισαγωγής from αλλάζει με τον ίδιο τρόπο:

# Κώδικας κληρονομίας
from aspose.pydrawing import Color, Point

# Έκδοση 26.8
from aspose.slides import Color, Point

Διόρθωση Σφάλματος Εισαγωγής

Βρείτε το traceback σας στην πρώτη στήλη.

Σφάλμα	Αιτία	Διόρθωση
`AttributeError: module 'aspose.pydrawing' has no attribute 'Color'` (or `Point`, `Rectangle`, and so on)	Το πακέτο είναι 26.8, ο κώδικας εξακολουθεί να δείχνει στο παλιό module	Ενημέρωση του κώδικά σας
`ImportError: cannot import name 'Color' from 'aspose.pydrawing'`	Ίδια αιτία, μορφή εισαγωγής `from`	Ενημέρωση του κώδικά σας
`ModuleNotFoundError: No module named 'aspose.pydrawing'`	Το module και όλοι οι επτά τύποι του μετακινήθηκαν στο `aspose.slides`	Ενημέρωση του κώδικά σας, μετά διαγράψτε την εισαγωγή `aspose.pydrawing`
`ImportError: cannot import name 'Color' from 'aspose.slides'`	Ο κώδικας είχε μεταφερθεί, αλλά το εγκατεστημένο πακέτο είναι 26.7 ή παλαιότερο	`pip install --upgrade aspose.slides`
`TypeError` on a color, point, or size argument	Μια τιμή που δημιουργήθηκε από `aspose.pydrawing` περνά στο νέο API	Δημιουργήστε την τιμή επίσης από `aspose.slides`

Ενημέρωση του Κώδικά σας

Επειδή το aspose.pydrawing δεν έχει περιεχόμενο εκτός από τους επτά μεταφερμένους τύπους, η μετανάστευση είναι μια μετονομασία του module. Κάθε μορφή εισαγωγής καλύπτεται από αυτή τη μονή μετονομασία, συμπεριλαμβανομένων των ψευδωνύμων:

# Κώδικας κληρονομίας
import aspose.pydrawing as drawing
color = drawing.Color.red

# Έκδοση 26.8 - το ψευδώνυμο παραμένει ενεργό
import aspose.slides as drawing
color = drawing.Color.red

Αυτό είναι έγκυρο σε οποιοδήποτε scope, συμπεριλαμβανομένου του σώματος μιας συνάρτησης, επειδή το ψευδώνυμο παραμένει δεσμευμένο ακριβώς όπου ήταν δεσμευμένο πριν. Το μόνο μειονέκτημα είναι ένα παραπλανητικό όνομα, οπότε σκεφτείτε να κάνετε το σκοπό σαφές:

import aspose.slides as slides
color = slides.Color.red

Επιλέξτε την προσέγγιση που ταιριάζει στο μέγεθος του κώδικά σας.

Αντικατάσταση Χειροκίνητα

Για μερικά αρχεία, ψάξτε για aspose.pydrawing και αντικαταστήστε το με aspose.slides, τότε αφαιρέστε οποιαδήποτε εισαγωγή δεν χρειάζεται πλέον.

Αντικατάσταση με Εντολή Shell

Αυτή είναι μια αντικατάσταση κειμένου, επομένως επηρεάζει επίσης εμφανίσεις μέσα σε strings και σχόλια. Και οι δύο εντολές γράφουν ένα αντίγραφο .bak κάθε αρχείου που αλλάζουν.

Linux:

grep -rlZ --include='*.py' 'aspose\.pydrawing' . \
  | xargs -0 -r sed -i.bak 's/aspose\.pydrawing/aspose.slides/g'

Σε macOS, χρησιμοποιήστε sed -i '' αντί για sed -i.bak, ή εγκαταστήστε GNU sed ως gsed.

Windows PowerShell:

Get-ChildItem -Recurse -Filter *.py | ForEach-Object {
  $t = Get-Content $_ -Raw
  $new = $t -replace 'aspose\.pydrawing', 'aspose.slides'
  if ($new -ne $t) {
    Copy-Item $_.FullName "$($_.FullName).bak"
    Set-Content $_.FullName $new -NoNewline
    $_.FullName
  }
}

Για επαναφορά σε Linux ή macOS:

find . -name '*.py.bak' -exec sh -c 'mv "$1" "${1%.bak}"' _ {} \;

Για επαναφορά σε Windows:

Get-ChildItem -Recurse -Filter *.py.bak | ForEach-Object {
  Move-Item $_.FullName ($_.FullName -replace '\.bak$', '') -Force
}

Αντικατάσταση με Python Script

Η ίδια μετονομασία, φορητή σε Linux, macOS και Windows. Το script παίρνει τη διαδρομή ως όρισμα και προεπισκοπεί τις αλλαγές εκτός αν δοθεί --write. Προσθέστε --backup για να κρατήσετε ένα αντίγραφο .bak κάθε τροποποιημένου αρχείου. Αποθηκεύστε το με οποιοδήποτε όνομα – το μήνυμα χρήσης παίρνει το όνομα κατά την εκτέλεση.

"""Rename aspose.pydrawing to aspose.slides. Plain text replacement.

    python <this script> src/                     # preview
    python <this script> src/ --write             # apply
    python <this script> src/ --write --backup    # apply, keeping .bak copies
"""

import sys
from pathlib import Path

W = "--write" in sys.argv
B = "--backup" in sys.argv
ROOT = next((a for a in sys.argv[1:] if not a.startswith("-")), None)

if ROOT is None:
    sys.exit(f"usage: python {Path(sys.argv[0]).name} <path> [--write] [--backup]")

root = Path(ROOT)
if not root.exists():
    sys.exit(f"no such path: {root}")

files = [root] if root.is_file() else root.rglob("*.py")
changed = 0

for p in files:
    if {".venv", "venv", "__pycache__", ".git"} & set(p.parts):
        continue
    s = p.read_text(encoding="utf-8")
    n = s.replace("aspose.pydrawing", "aspose.slides")
    if n == s:
        continue
    changed += 1
    print(("wrote " if W else "would change ") + str(p))
    if W:
        if B:
            p.with_suffix(p.suffix + ".bak").write_text(s, encoding="utf-8")
        p.write_text(n, encoding="utf-8")

print(f"{changed} file(s) {'changed' if W else 'to change'}"
      + ("" if W or not changed else "; rerun with --write to apply"))

Μια τυπική εκτέλεση φαίνεται έτσι:

$ python migrate.py src/
would change src/render.py
would change src/export/slides.py
2 file(s) to change; rerun with --write to apply

$ python migrate.py src/ --write --backup
wrote src/render.py
wrote src/export/slides.py
2 file(s) changed

Η διαδρομή μπορεί να είναι φάκελος, που περιπλανιέται αναδρομικά, ή ένα μόνο αρχείο .py.

Αντικατάσταση με Script Βασισμένο σε AST

Συνιστάται για μεγαλύτερα code bases. Αυτό το script εκτελεί την ίδια μετονομασία, αλλά αναλύει πρώτα το κάθε αρχείο, ώστε να μην αγγίζει εμφανίσεις μέσα σε strings, σχόλια ή docstrings.

Επειδή μετονομάζει το module επί τόπου και αφήνει τα ψευδώνυμα, κάθε μορφή εισαγωγής αντιμετωπίζεται χωρίς ειδικές περιπτώσεις: import aspose.pydrawing, import aspose.pydrawing as X, from aspose.pydrawing import Color, from aspose.pydrawing import Color as C, εισαγωγές πολλαπλών γραμμών με παρενθέσεις, εισαγωγές μέσα σε συναρτήσεις, και το module που περνιέται ως τιμή. Αποδέχεται τις ίδιες σημαίες --write και --backup.

"""Rename aspose.pydrawing to aspose.slides, skipping strings and comments.

    python <this script> src/                     # preview
    python <this script> src/ --write             # apply
    python <this script> src/ --write --backup    # apply, keeping .bak copies
"""

import ast, sys
from pathlib import Path

MOD, DST = "aspose.pydrawing", "aspose.slides"
W = "--write" in sys.argv
B = "--backup" in sys.argv
ROOT = next((a for a in sys.argv[1:] if not a.startswith("-")), None)

if ROOT is None:
    sys.exit(f"usage: python {Path(sys.argv[0]).name} <path> [--write] [--backup]")

root = Path(ROOT)
if not root.exists():
    sys.exit(f"no such path: {root}")

files = [root] if root.is_file() else root.rglob("*.py")
changed = 0


def chain(n):
    p = []
    while isinstance(n, ast.Attribute):
        p.append(n.attr)
        n = n.value
    return ".".join(reversed(p + [n.id])) if isinstance(n, ast.Name) else None


def fix(src):
    tree = ast.parse(src)
    off, o = [], 0
    for l in src.encode().splitlines(keepends=True):
        off.append(o)
        o += len(l)
    off.append(o)
    edits = []

    for n in ast.walk(tree):
        # εισαγωγή aspose.pydrawing [ως X]  /  από aspose.pydrawing import ...
        # Το όνομα του module μετονομάζεται επί τόπου, έτσι οποιοδήποτε ψευδώνυμο παραμένει δεσμευμένο όπως πριν.
        if (isinstance(n, ast.Import) and any(a.name == MOD for a in n.names)) or \
           (isinstance(n, ast.ImportFrom) and n.module == MOD):
            s, e = off[n.lineno - 1], off[n.end_lineno - 1] + n.end_col_offset
            edits.append((s, e, src.encode()[s:e].decode().replace(MOD, DST)))
        # Οποιαδήποτε έκφραση που αναφέρεται στο module, συμπεριλαμβανομένου του ακατέργαστου `fn(aspose.pydrawing)`.
        elif isinstance(n, ast.Attribute) and chain(n) == MOD:
            edits.append((off[n.lineno - 1] + n.col_offset,
                          off[n.end_lineno - 1] + n.end_col_offset, DST))

    b = src.encode()
    for s, e, r in sorted(edits, reverse=True):  # η επεξεργασία από το τέλος προς την αρχή διατηρεί τις μετατοπίσεις έγκυρες
        b = b[:s] + r.encode() + b[e:]
    return b.decode()


for p in files:
    if {".venv", "venv", "__pycache__", ".git"} & set(p.parts):
        continue
    s = p.read_text(encoding="utf-8")
    try:
        n = fix(s)
    except SyntaxError as e:
        print(f"skipped {p}: {e}")
        continue
    if n != s:
        print(("wrote " if W else "would change ") + str(p))
        if W:
            if B:
                p.with_suffix(p.suffix + ".bak").write_text(s, encoding="utf-8")
            p.write_text(n, encoding="utf-8")

Και τα δύο scripts είναι idempotent: η επανεκτέλεσή τους σε κώδικα που έχει ήδη μεταφερθεί δεν κάνει καμία αλλαγή.

Επαλήθευση της Μετανάστευσης

Μια αναζήτηση κειμένου δείχνει αν κάτι απομένει:

grep -rn 'aspose\.pydrawing' --include='*.py' --exclude-dir=.venv .

Αυτό είναι γρήγορο, αλλά επίσης ταιριάζει μέσα σε strings και σχόλια, οπότε καθαρός κώδικας μπορεί ακόμα να παράγει αποτελέσματα. Για οριστική απάντηση, χρησιμοποιήστε τον παρακάτω έλεγχο. Αναφέρει μόνο πραγματικές αναφορές κώδικα και εξέρχεται με μη μηδενική κατάσταση αν κάτι απομείνει, πράγμα που το κάνει χρήσιμο ως φάκελο κατασκευής.

import ast, sys
from pathlib import Path

MOD = "aspose.pydrawing"
ROOT = next((a for a in sys.argv[1:] if not a.startswith("-")), ".")


def chain(n):
    p = []
    while isinstance(n, ast.Attribute):
        p.append(n.attr)
        n = n.value
    return ".".join(reversed(p + [n.id])) if isinstance(n, ast.Name) else None


def scan(tree):
    for n in ast.walk(tree):
        if isinstance(n, ast.Import) and any(a.name == MOD for a in n.names):
            yield n.lineno, f"import {MOD}"
        elif isinstance(n, ast.ImportFrom) and n.module == MOD:
            names = ", ".join(a.name for a in n.names)
            yield n.lineno, f"from {MOD} import {names}"
        elif isinstance(n, ast.Attribute) and chain(n) == MOD:
            yield n.lineno, f"reference to {MOD}"


hits = 0
for p in sorted(Path(ROOT).rglob("*.py")):
    if {".venv", "venv", "__pycache__", ".git"} & set(p.parts):
        continue
    try:
        tree = ast.parse(p.read_text(encoding="utf-8"))
    except SyntaxError as e:
        print(f"skipped {p}: {e}")
        continue
    for lineno, what in sorted(scan(tree)):
        print(f"{p}:{lineno}: {what}")
        hits += 1

print("migration complete" if not hits else f"{hits} reference(s) left")
sys.exit(1 if hits else 0)

Τρέξτε το πριν και μετά τη μετανάστευση:

$ python verify.py src/
src/render.py:4: from aspose.pydrawing import Color, Point
src/render.py:11: import aspose.pydrawing
src/render.py:12: reference to aspose.pydrawing
3 reference(s) left

$ python migrate.py src/ --write
wrote src/render.py

$ python verify.py src/
migration complete

Τέλος, τρέξτε ένα smoke test που δοκιμάζει τους μεταφερμένους τύπους:

import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]
    shape = slide.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 50, 50, 200, 100)

    shape.fill_format.fill_type = slides.FillType.SOLID
    shape.fill_format.solid_fill_color.color = slides.Color.red

    presentation.save("smoke.pptx", slides.export.SaveFormat.PPTX)
    print("OK")

Συνιστώμενη Σειρά Μεταναστεύσεων

Αποθήκευση βασικής γραμμής. Εκτελέστε τις δοκιμές σας στην τρέχουσα έκδοση και κρατήστε αναφορικά renders. Αυτό σας επιτρέπει να διαχωρίσετε σφάλματα μετανάστευσης από διαφορές rendering αργότερα.
Προεπισκόπηση της μετανάστευσης. Εκτελέστε ένα από τα scripts χωρίς --write και ελέγξτε τη λίστα αρχείων που θα αλλάξει.
Εφαρμογή και επαλήθευση. Εκτελέστε με --write --backup, έπειτα το script επαλήθευσης και το smoke test.
Σύγκριση renders με ανοχή. Η μετάβαση στο .NET 6 build μπορεί να δημιουργήσει μικρές διαφορές σε κείμενο και εφέ. Χρησιμοποιήστε σύγκριση βάσει κατωφλίου αντί για byte‑by‑byte έλεγχο.
Διαγραφή των αντιγράφων ασφαλείας. Μόλις επιβεβαιώσετε το αποτέλεσμα, διαγράψτε τα αρχεία .bak: find . -name '*.py.bak' -delete σε Linux και macOS, ή Get-ChildItem -Recurse -Filter *.py.bak | Remove-Item σε Windows.

Υποστήριξη Και των Δύο Εκδόσεων σε Ένα Code Base

Εάν χρειάζεται να τρέξετε εναντίον 26.7 και 26.8 από την ίδια πηγή:

try:
    from aspose.slides import Color, Point, Rectangle      # 26.8 και αργότερα
except ImportError:
    from aspose.pydrawing import Color, Point, Rectangle   # 26.7 και παλαιότερα

Τι Δεν Άλλαξε

Ονόματα, ορίσματα και συμπεριφορά των μεταφερόμενων primitive.
Το υπόλοιπο του API aspose.slides.
Η άδεια χρήσης και ο τρόπος εφαρμογής του αρχείου άδειας.
Οι μορφές αρχείων και η συμπεριφορά αποθήκευσης/φόρτωσης.
Απαιτήσεις συστήματος σε Windows και macOS.
Η απουσία ξεχωριστής εγκατάστασης .NET – το runtime εξακολουθεί να είναι ενσωματωμένο.

Βελτιώστε την Επεξεργασία Εικόνας με το Σύγχρονο API Γνωστά Ζητήματα