Este documento explica como emitir CSV (valores separados por vírgulas) dinamicamente usando “views” do Django. Para fazer isso, você pode usar a biblioteca CSV do Python ou o sistema de templates do Django.
\nPython vem com uma biblioteca CSV, csv. A chave para usá-lo com Django é que a capacidade CSV-creation do módulo csv age como um objeto “file-like”, e aos objetos da class:~django.http.HttpResponse do Django são objetos “file-like”.
Aqui está um exemplo
\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\nO código e comentário devem ser auto-explanaveis, mas algumas coisas merecem uma menção.
\nA resposta recebe um tipo MIME especial text/csv. Isso diz ao browser que o documento é um arquivo CSV, ao invés de um arquivo HTML. Se deixar isso desligado, os browsers vão provavelmente interpretar a resposta como HTML, o qual irá resultar em uma feia e assustadora gobbledygook na janela do seu browser.
A resposta recebe um cabeçalho adicional Content-Dispoition, o qual contém o nome do arquivo CSV. Este nome de arquivo e arbitrário; chame isso do que você quiser. Ele será usado pelo browser no diálogo “Salvar como…”, etc.
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.
Para cada linha no seu arquivo CSV, chamar o método writer.writerow, passando um iterable.
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.
Quando lida com “views” que geram respostas muito grandes, talvez queira considerar usar o StreamingHttpResponse do Django no lugar. Por exemplo, por trasmitir em fluxo contínuo ou “streaming” um arquivo que leva muito tempo para ser gerado você pode evitar que a conexão seja perdida tentando balancear a carga que talvez expire enquanto o servidor estava gerando a resposta.
Neste exemplo, fazemos uso total de geradores Python para manipular eficientemente a montagem e transmissão de um grande arquivo 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 )\nUma alternatica, você pode usar o sistema de tempaltes do Django para gerar CSV. Isso é mais baixo nível que usar o conveniente módulo Python csv, mas a solução é apresentada aqui para para abrangência.
A idéia aqui é passar uma lista de itens para seu template, e ter a saida do template as vírgulas em um loop for.
Aqui um exemplo, o qual gera o mesmo arquivo CSV que acima:
\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\nA única diferença entre este exemplo e o exemplo anterior é que este usa carga de template ao invés do módulo CSV. O resto do código – tal como content_type='text/csv' – é o mesmo.
Então, crie o template my_template_name.txt, com este código no 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.
Note que não tem muita coisa específica sobre CSV aqui – apenas o formato de saída. Você pode usar qualquer uma destas técnicas para qualquer formato texto que você imagine. Você também pode usar essa técnica para gerar dados binários arbitrários; veja How to create PDF files por exemplo.
\n