Αυτό το άρθρο εξηγεί πως να εξάγετε αρχεία CSV (Comma Separated Values), δυναμικά, χρησιμοποιώντας τα Django views. Για να το κάνετε αυτό, μπορείτε είτε να χρησιμοποιήσετε την βιβλιοθήκη CSV της Python ή το σύστημα template του Django.
\nΗ Python έρχεται με μια βιβλιοθήκη, csv. Το κλειδί για να την χρησιμοποιήσετε με το Django είναι ότι η δυνατότητα της δημιουργίας CSV του module csv ενεργεί πάνω σε objects που μοιάζουν με αρχεία και τα objects της κλάσης HttpResponse του Django είναι objects που μοιάζουν με αρχεία.
Ορίστε ένα παράδειγμα:
\nimport csv\nfrom django.http import HttpResponse\n\n\ndef some_view(request):\n # Create the HttpResponse object with the appropriate CSV header.\n response = HttpResponse(\n content_type="text/csv",\n headers={"Content-Disposition": 'attachment; filename="somefilename.csv"'},\n )\n\n writer = csv.writer(response)\n writer.writerow(["First row", "Foo", "Bar", "Baz"])\n writer.writerow(["Second row", "A", "B", "C", '"Testing"', "Here's a quote"])\n\n return response\nΠαρόλο που ο κώδικας και τα σχόλια είναι αρκετά επεξηγηματικά, θα πρέπει να αναφέρουμε μερικά πράγματα:
\nΤο response παίρνει έναν ειδικό τύπο MIME, text/csv. Αυτό λέει στους browsers ότι το έγγραφο είναι ένα αρχείο CSV, παρά ένα αρχείο HTML. Αν δεν το προσδιορίσετε, οι browsers, πιθανόν, να ερμηνεύσουν το reponse ως ένα αρχείο HTML, που σημαίνει ότι το αποτέλεσμα θα είναι όχι μόνο άσχημο αλλά δεν θα καταλαβαίνετε τίποτα!
Το response παίρνει έναν επιπλέον header με το όνομα Content-Disposition, ο οποίος περιέχει το όνομα του αρχείου CSV. Αυτό το όνομα είναι αυθαίρετο. Μπορείτε να το ονομάσετε όπως εσείς θέλετε. Θα χρησιμοποιηθεί από τους browsers στο παράθυρο διαλόγου «Αποθήκευση ως…» κλπ.
You can hook into the CSV-generation API by passing response as the first\nargument to csv.writer. The csv.writer function expects a file-like\nobject, and HttpResponse objects fit the bill.
For each row in your CSV file, call writer.writerow, passing it an\niterable.
The CSV module takes care of quoting for you, so you don’t have to worry\nabout escaping strings with quotes or commas in them. Pass writerow()\nyour raw strings, and it’ll do the right thing.
Όταν έχουμε views τα οποία παράγουν πολύ μεγάλα responses, ίσως θα θέλατε να χρησιμοποιήσετε το StreamingHttpResponse του Django. Για παράδειγμα, όταν κάνετε streaming ένα αρχείο το οποίο παίρνει αρκετή ώρα για να παραχθεί, μπορείτε να αποφύγετε την διακοπή σύνδεσης του load balancer (Error 522: Connection timed out) που θα προέκυπτε όσο ο server σας παράγει το response.
Σε αυτό το παράδειγμα, χρησιμοποιούμε αμιγώς τους Python generators για να χειριστούμε αποδοτικά την συναρμολόγηση και εκπομπή ενός μεγάλου, σε μέγεθος, αρχείου CSV:
\nimport csv\n\nfrom django.http import StreamingHttpResponse\n\n\nclass Echo:\n """An object that implements just the write method of the file-like\n interface.\n """\n\n def write(self, value):\n """Write the value by returning it, instead of storing in a buffer."""\n return value\n\n\ndef some_streaming_csv_view(request):\n """A view that streams a large CSV file."""\n # Generate a sequence of rows. The range is based on the maximum number of\n # rows that can be handled by a single sheet in most spreadsheet\n # applications.\n rows = (["Row {}".format(idx), str(idx)] for idx in range(65536))\n pseudo_buffer = Echo()\n writer = csv.writer(pseudo_buffer)\n return StreamingHttpResponse(\n (writer.writerow(row) for row in rows),\n content_type="text/csv",\n headers={"Content-Disposition": 'attachment; filename="somefilename.csv"'},\n )\nΕναλλακτικά, μπορείτε να χρησιμοποιήσετε το σύστημα template του Django για να δημιουργήσετε CSV αρχεία. Αυτή η μέθοδος είναι χαμηλού επιπέδου (low-level) εν συγκρίσει με τη χρήση του, βολικού, module csv της Python, αλλά παρουσιάζεται εδώ για λόγους πληρότητας.
Η ιδέα εδώ είναι να περάσετε μια λίστα από items στο template σας και να βάλετε το template να εισάγει τα κόμματα μέσα σε ένα βρόγχο επανάληψης, for.
Εδώ φαίνεται ένα παράδειγμα, στο οποίο παράγεται το ίδιο αρχείο CSV όπως παραπάνω:
\nfrom django.http import HttpResponse\nfrom django.template import loader\n\n\ndef some_view(request):\n # Create the HttpResponse object with the appropriate CSV header.\n response = HttpResponse(\n content_type="text/csv",\n headers={"Content-Disposition": 'attachment; filename="somefilename.csv"'},\n )\n\n # The data is hard-coded here, but you could load it from a database or\n # some other source.\n csv_data = (\n ("First row", "Foo", "Bar", "Baz"),\n ("Second row", "A", "B", "C", '"Testing"', "Here's a quote"),\n )\n\n t = loader.get_template("my_template_name.txt")\n c = {"data": csv_data}\n response.write(t.render(c))\n return response\nΗ μόνη διαφορά αυτού του παραδείγματος με το προηγούμενο είναι ότι αυτό χρησιμοποιεί το template loading αντί του CSV module. Ο υπόλοιπος κώδικας – όπως το content_type='text/csv' – παραμένει ο ίδιος.
Έπειτα, δημιουργήστε ένα template my_template_name.txt, με τον template κώδικα, ως εξής:
{% for row in data %}"{{ row.0|addslashes }}", "{{ row.1|addslashes }}", "{{ row.2|addslashes }}", "{{ row.3|addslashes }}", "{{ row.4|addslashes }}"\n{% endfor %}\nThis short template iterates over the given data and displays a line of CSV for\neach row. It uses the addslashes template filter to ensure there\naren’t any problems with quotes.
Όπως είδατε, δεν υπάρχει κάτι συγκεκριμένο με το CSV εδώ – απλώς μια συγκεκριμένη μορφή εξόδου. Μπορείτε να χρησιμοποιήσετε τις ανωτέρω τεχνικές για να εξάγετε οποιαδήποτε μορφή τύπου κειμένου εσείς θέλετε. Μπορείτε, επίσης, να χρησιμοποιήσετε μια παρόμοια τεχνική για να παράγετε αυθαίρετα δυαδικά δεδομένα. Δείτε στο άρθρο εξάγοντας αρχεία PDF με το Django για ένα παράδειγμα.
\n