|
1 | | -# Aspose.Cells Cloud SDK for Python |
| 1 | +Python Cloud SDK wraps Aspose.Cells REST API so you could seamlessly integrate Microsoft Excel® spreadsheet generation, manipulation, conversion & inspection features into your own Python applications. |
2 | 2 |
|
3 | | -- API version: 3.0 |
4 | | -- SDK version: 20.1 |
| 3 | +[Aspose.Cells Cloud SDK for Python](https://products.aspose.cloud/cells/python) offers Excel® file creation, manipulation, conversion, & rendering. Developers can format worksheets, rows, columns or cells to the most granular level, create & manipulate chart & pivot tables, render worksheets, charts and specific data ranges to PDF & images, add & calculate Excel's built-in and custom formulas and much more. Feel free to explore the [Developer's Guide](https://docs.aspose.cloud/display/cellscloud/Developer+Guide) for all usage scenarios. |
5 | 4 |
|
6 | | -This repository contains Aspose.Cells Cloud SDK for Python source code. This SDK allows you to work with Aspose.Cells Cloud REST APIs in your Python applications quickly and easily, with zero initial cost. |
| 5 | +## Manipulate Excel Files in the Cloud with Python |
7 | 6 |
|
| 7 | +- Create Excel files via API. |
| 8 | +- Create & refresh Pivot Tables & charts. |
| 9 | +- Create & manipulate spark-lines & conditional formatting. |
| 10 | +- Convert charts, worksheets or data ranges to images or PDF. |
| 11 | +- Manage comments & hyperlinks. |
| 12 | +- Set complex formulas & calculate results via API. |
| 13 | +- Set protection on workbook, worksheet, cell, column or row. |
| 14 | +- Create & manipulate named ranges. |
| 15 | +- Populate worksheets through Smart Markers. |
| 16 | +- Convert worksheets to PDF, XPS & SVG formats. |
| 17 | +- Inter-convert files to popular Excel formats. |
8 | 18 |
|
| 19 | +## Feature & Enhancements in Version 20.4 |
9 | 20 |
|
10 | | -# Key Features |
| 21 | +- Support to export area or page of sheet to JPEG. |
| 22 | +- Support to add background for workbook. |
| 23 | +- Enhancement for splitting workbook. |
| 24 | +- Enhancement for create workbook. |
11 | 25 |
|
12 | | -- Conversion between various document-related formats (20+ formats supported), including PDF<->Excel conversion |
| 26 | +## Read & Write Spreadsheet Formats |
13 | 27 |
|
14 | | -- Splitting Excel documents |
| 28 | +**Microsoft Excel:** XLS, XLSX, XLSB, XLSM, XLT, XLTX, XLTM |
| 29 | +**OpenOffice:** ODS |
| 30 | +**SpreadsheetML:** XML |
| 31 | +**Text:** CSV, TSV, TXT (TabDelimited) |
| 32 | +**Web:** HTML, MHTML |
| 33 | +**PDF** |
15 | 34 |
|
16 | | -- Accessing Excel document metadata and statistics |
| 35 | +## Save Spreadsheet As |
17 | 36 |
|
18 | | -- Find and replace |
| 37 | +DIF, HTML, MHTML,PNG,JPG, TIFF, XPS, SVG, MD (Markdown), ODS ,xlsx,xls,xlsb, PDF,XML,TXT,CSV |
19 | 38 |
|
20 | | -- Watermarks and protection |
| 39 | +## Read Spreadsheet Formats |
21 | 40 |
|
22 | | -- Full read & write access to Cells Object Model, including workbook, worksheet, cell, shapes, tables, list object ,ole Object,headers/footers and many others |
| 41 | +SXC, FODS |
23 | 42 |
|
24 | | - |
| 43 | +## Storage API Support |
25 | 44 |
|
26 | | -See [API Reference](https://apireference.aspose.cloud/cells/) for full API specification. |
27 | | - |
28 | | - |
29 | | - |
30 | | -# Storage API support |
31 | | - |
32 | | -#### Since version 19.9 SDK includes support of storage operations for better user experience and unification, so now there's no need to use 2 different SDKs! |
| 45 | +Since version 19.9, SDK includes support of storage operations for better user experience and unification, so now there's no need to use 2 different SDKs! |
33 | 46 |
|
34 | 47 | It gives you an ability to: |
35 | 48 |
|
36 | | -- Upload, download, copy, move and delete files, including versions handling (if you are using Cloud storage that supports this feature - true by default) |
37 | | -- Create, copy, move and delete folders |
38 | | -- Copy and move files and folders accross separate storages in scope of a single operation |
39 | | -- Check if certain file, folder or storage exists |
40 | | - |
41 | | -# Licensing |
42 | | - |
43 | | -All Aspose.Cells Cloud SDKs are licensed under [MIT License](https://github.com/aspose-cells-cloud/aspose-cells-cloud-python/blob/master/LICENSE). |
44 | | - |
45 | | - |
46 | | - |
47 | | -# How to use the SDK? |
| 49 | +- Upload, download, copy, move and delete files, including versions handling (if you are using Cloud storage that supports this feature - true by default). |
| 50 | +- Create, copy, move and delete folders. |
| 51 | +- Copy and move files and folders across separate storages in scope of a single operation. |
| 52 | +- Check if certain file, folder or storage exists. |
48 | 53 |
|
49 | | -The complete source code is available in this repository folder. You can either directly use it in your project via source code or get [PyPi](https://pypi.org/project/asposecellscloud) (recommended). For more details, please visit our [documentation website](https://docs.aspose.cloud/display/cellscloud/Available+SDKs). |
| 54 | +## Getting Started with Aspose.Cells Cloud SDK for Python |
50 | 55 |
|
| 56 | +Firstly, create an account at [Aspose for Cloud](https://dashboard.aspose.cloud/#/apps) to get your application information and free quota to use the API. Now execute `pip install asposecellscloud` from the command line to get the get the SDK from PIP. The complete source code is available at [GitHub Repository](https://github.com/aspose-cells-cloud/aspose-cells-cloud-python). |
51 | 57 |
|
52 | | -### Prerequisites |
| 58 | +## Create Spreadsheet from a Template in the Cloud via Python |
53 | 59 |
|
54 | | - |
| 60 | +```python |
55 | 61 |
|
56 | | -To use Aspose Cells Cloud SDK for Python you need to register an account with [Aspose Cloud](https://www.aspose.cloud/) and lookup/create App Key and SID at [Cloud Dashboard](https://dashboard.aspose.cloud/#/apps). There is free quota available. For more details, see [Aspose Cloud Pricing](https://purchase.aspose.cloud/pricing). |
| 62 | + #Instantiate Aspose Cells API SDK |
| 63 | + cellsApi = asposecellscloud.apis.cells_api.CellsApi(GetAPPSID(),GetAPPKey(),"v3.0") |
57 | 64 |
|
58 | | - |
59 | | -## Installation & Usage |
60 | | - |
61 | | -### pip install |
62 | | - |
63 | | -If the python package is hosted on Github, you can install directly from Github |
64 | | - |
65 | | -``` |
66 | | -pip install asposecellscloud |
| 65 | + templateFile ='Book1.xlsx' |
| 66 | + folder = "Temp" |
| 67 | + name = "NewBook" + datetime.now().strftime("%Y%m%d%H%M%S") + ".xlsx" |
| 68 | + dataFile = "ReportData.xml" |
| 69 | + template_file = folder + "/" + templateFile |
| 70 | + data_file = folder + "/" + dataFile |
| 71 | + fullfilename = os.path.dirname(os.path.realpath(__file__)) + "/" + templateFile |
| 72 | + api.upload_file(template_file, fullfilename) |
| 73 | + fullfilename = os.path.dirname(os.path.realpath(__file__)) + "/" + data_file |
| 74 | + api.upload_file(data_file, fullfilename) |
| 75 | + result = cellsApi.cells_workbook_put_workbook_create(name, template_file=template_file, data_file=data_file, folder=folder) |
| 76 | + self.assertEqual(result.code,200) |
67 | 77 | ``` |
68 | 78 |
|
69 | | -(you may need to run `pip` with root permission: `sudo pip install asposecellscloud) |
| 79 | +## Convert Excel to PDF via Python |
70 | 80 |
|
71 | | -Then import the package: |
| 81 | +```python |
| 82 | + #Instantiate Aspose Cells API SDK |
| 83 | + cellsApi = asposecellscloud.apis.cells_api.CellsApi(GetAPPSID(),GetAPPKey(),"v3.0") |
72 | 84 |
|
| 85 | + fullfilename = os.path.dirname(os.path.realpath(__file__)) + "/../TestData/" + "Book1.xlsx" |
| 86 | + format ='pdf' |
| 87 | + password = None |
| 88 | + outPath = None |
| 89 | + result = cellsApi.cells_workbook_put_convert_workbook(fullfilename,format=format) |
| 90 | + # self.assertEqual(result.code,200) |
73 | 91 | ``` |
74 | | -import asposecellscloud |
75 | | -``` |
76 | | - |
77 | | -### Setuptools |
78 | | - |
79 | | -Install via [Setuptools](http://pypi.python.org/pypi/setuptools). |
80 | | - |
81 | | -``` |
82 | | -python setup.py install --user |
83 | | -``` |
84 | | - |
85 | | -(or `sudo python setup.py install` to install the package for all users) |
86 | | - |
87 | | -Then import the package: |
88 | | - |
89 | | -``` |
90 | | -require asposecellscloud |
91 | | -``` |
92 | | - |
93 | | -### Sample usage |
94 | | - |
95 | | - |
96 | | - |
97 | | -# Tests |
98 | | - |
99 | | -[Tests](https://github.com/aspose-cells-cloud/aspose-cells-cloud-python/tree/master/test) contain various examples of using the SDK. |
100 | | - |
101 | | - |
102 | | -# Contact Us |
103 | | - |
104 | | -Your feedback is very important to us. Please feel free to contact via |
105 | | - |
106 | | -- [**Free Support Forum**](https://forum.aspose.cloud/c/cells) |
107 | | -- [**Paid Support Helpdesk**](https://helpdesk.aspose.cloud/) |
108 | | - |
109 | | -# Resources |
110 | 92 |
|
111 | | -- [**Web API reference**](https://apireference.aspose.cloud/cells/) |
112 | | -- [**Website**](https://www.aspose.cloud) |
113 | | -- [**Product Home**](https://products.aspose.cloud/cells) |
114 | | -- [**Documentation**](https://docs.aspose.cloud/display/cellscloud/Home) |
115 | | -- [**Blog**](https://blog.aspose.cloud/category/cells/) |
| 93 | +[Product Page](https://products.aspose.cloud/cells/python) | [Documentation](https://docs.aspose.cloud/display/cellscloud/Home) | [Live Demo](https://products.aspose.app/cells/family) | [API Reference](https://apireference.aspose.cloud/cells/) | [Code Samples](https://github.com/aspose-cells-cloud/aspose-cells-cloud-python) | [Blog](https://blog.aspose.cloud/category/cells/) | [Free Support](https://forum.aspose.cloud/c/cells) | [Free Trial](https://dashboard.aspose.cloud/#/apps) |
0 commit comments