{ "info": { "author": "The seats.io dev team", "author_email": "hello@seats.io", "bugtrack_url": null, "classifiers": [], "description": "# seatsio-python, the official Seats.io Python client library\n\n[![Build Status](https://travis-ci.org/seatsio/seatsio-python.svg?branch=master)](https://travis-ci.org/seatsio/seatsio-python)\n\nThis is the official Python client library for the [Seats.io V2 REST API](https://docs.seats.io/docs/api-overview), supporting python 2.7, and python 3.3 - 3.7. \n\n## Installing\n\n```\npip install seatsio\n```\n\n## Versioning\n\nseatsio-python only uses major version numbers: v5, v6, v7 etc. Each release - backwards compatible or not - receives a new major version number.\n\nThe reason: we want to play safe and assume that each release _might_ break backwards compatibility.\n\n## Examples\n\n### Creating a chart and an event\n\n```python\nimport seatsio\nclient = seatsio.Client(secret_key=\"my-secret-key\") # can be found on https://app.seats.io/settings\nchart = client.charts.create()\nevent = client.events.create(chart.key)\n```\n\n### Booking objects\n\n```python\nimport seatsio\nclient = seatsio.Client(secret_key=\"my-secret-key\")\nclient.events.book(event.key, [\"A-1\", \"A-2\"])\n```\n\n### Releasing objects\n\n```python\nimport seatsio\nclient = seatsio.Client(secret_key=\"my-secret-key\")\nclient.events.release(event.key, [\"A-1\", \"A-2\"])\n```\n\n### Booking objects that have been held\n\n```python\nimport seatsio\nclient = seatsio.Client(secret_key=\"my-secret-key\")\nclient.events.book(event.key, [\"A-1\", \"A-2\"], hold_token=\"a-hold-token\")\n```\n\n### Changing object status\n\n```python\nimport seatsio\nclient = seatsio.Client(secret_key=\"my-secret-key\")\nclient.events.change_object_status(\"\", [\"A-1\", \"A-2\"], \"my-custom-status\")\n```\n\n### Listing all charts\n\n```python\nimport seatsio\nclient = seatsio.Client(secret_key=\"my-secret-key\")\ncharts = client.charts.list()\nfor chart in charts:\n print(\"Chart: \" + chart.key)\n```\n\nNote: `list()` returns a `PagedIterator`, which under the hood calls the seats.io API to fetch charts page by page. So multiple API calls may be done underneath to fetch all charts.\n\n### Listing charts page by page\n\nE.g. to show charts in a paginated list on a dashboard.\n\nEach page contains an `items` array of charts, and `next_page_starts_after` and `previous_page_ends_before` properties. Those properties are the chart IDs after which the next page starts or the previous page ends.\n\n```python\n# ... user initially opens the screen ...\n\nfirstPage = client.charts.list_first_page()\nfor chart in firstPage.items:\n print(\"Chart: \" + chart.key)\n```\n\n```python\n# ... user clicks on 'next page' button ...\n\nnextPage = client.charts.list_page_after(firstPage.next_page_starts_after)\nfor chart in nextPage.items:\n print(\"Chart: \" + chart.key)\n```\n\n```python\n# ... user clicks on 'previous page' button ...\n\npreviousPage = client.charts.list_page_before(nextPage.previous_page_ends_before)\nfor chart in previousPage.items:\n print(\"Chart: \" + chart.key)\n```\n\n## Error handling\n\nWhen an API call results in a 4xx or 5xx error (e.g. when a chart could not be found), a SeatsioException is raised.\n\nThis exception contains a message string describing what went wrong, and also two other properties:\n\n- `Errors`: a list of errors (containing a code and a message) that the server returned. In most cases, this list will contain only one element.\n- `RequestId`: the identifier of the request you made. Please mention this to us when you have questions, as it will make debugging easier.", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/seatsio/seatsio-python", "keywords": "", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "seatsio", "package_url": "https://pypi.org/project/seatsio/", "platform": "", "project_url": "https://pypi.org/project/seatsio/", "project_urls": { "Homepage": "https://github.com/seatsio/seatsio-python" }, "release_url": "https://pypi.org/project/seatsio/46/", "requires_dist": null, "requires_python": "", "summary": "The official Seats.io Python client library", "version": "46" }, "last_serial": 5720734, "releases": { "1": [ { "comment_text": "", "digests": { "md5": "2fd2823bb6c6b1eef5309a3281a8015f", "sha256": "6448b21f34cface2d7269b93116133b8a1aaa6a910e48c596746099597d5b88a" }, "downloads": -1, "filename": "seatsio-1.tar.gz", "has_sig": false, "md5_digest": "2fd2823bb6c6b1eef5309a3281a8015f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4348, "upload_time": "2018-03-23T12:25:33", "url": "https://files.pythonhosted.org/packages/bb/89/fbfede455ef254501493f9373d149a33dc66a2c2f1e30e1b7fac3e9ddd06/seatsio-1.tar.gz" } ], "19": [ { "comment_text": "", "digests": { "md5": "79a9ad4b8623a121c15307403977e469", "sha256": "d239247f5a0cbcbbaefaf5cc6d358aaa44bb247bff947b5cb5de0d5db413bd45" }, "downloads": -1, "filename": "seatsio-19.tar.gz", "has_sig": false, "md5_digest": "79a9ad4b8623a121c15307403977e469", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4402, "upload_time": "2018-09-05T11:17:30", "url": "https://files.pythonhosted.org/packages/4f/0b/3c3c51df389b5cd9a1dfcd80250c4fec3c6c97c0cb4702d935f9b36d61d6/seatsio-19.tar.gz" } ], "2": [ { "comment_text": "", "digests": { "md5": "1cc6a290dc5b5f4a711a4c4a9250000f", "sha256": "f1850030f4f405a9dcc8ac3f345e46c69fffb9227ad9dc721e139e1cbfbc958b" }, "downloads": -1, "filename": "seatsio-2.tar.gz", "has_sig": false, "md5_digest": "1cc6a290dc5b5f4a711a4c4a9250000f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4350, "upload_time": "2018-03-23T12:48:49", "url": "https://files.pythonhosted.org/packages/46/6c/b80fc0c5820e9798cd5cff791b5d9e478021b79c2f0f4c358b7d82ac6af0/seatsio-2.tar.gz" } ], "20": [ { "comment_text": "", "digests": { "md5": "3f00615b37825bb26c960b608628f1c0", "sha256": "95fc0add677350d0d97ba510d5e591a9d7d0a7fc1440f04f7adbb7620ddd45da" }, "downloads": -1, "filename": "seatsio-20.tar.gz", "has_sig": false, "md5_digest": "3f00615b37825bb26c960b608628f1c0", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 4410, "upload_time": "2018-09-05T12:11:45", "url": "https://files.pythonhosted.org/packages/72/78/cfd366222189abc5e0918639a507e47a8528781e9e5d537caff27e64e86a/seatsio-20.tar.gz" } ], "21": [ { "comment_text": "", "digests": { "md5": "04b6387c2562628328784f9e05b014f6", "sha256": "b596f37c1433e6bbde5635ac801120cc24941bb90fc43f56a9fbb7017fe232bb" }, "downloads": -1, "filename": "seatsio-21.tar.gz", "has_sig": false, "md5_digest": "04b6387c2562628328784f9e05b014f6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8933, "upload_time": "2018-09-06T10:37:20", "url": "https://files.pythonhosted.org/packages/6f/0f/d46d44817acdf176f2b8def96ee5da937b4dab8138bdf626145827aaca58/seatsio-21.tar.gz" } ], "22": [ { "comment_text": "", "digests": { "md5": "e3ec6b6cab77ab7780977a482efa50ce", "sha256": "e3295616ddc1839b94f51c2945aea24ce9cb27acc61e2257f126633e3c5feefa" }, "downloads": -1, "filename": "seatsio-22.tar.gz", "has_sig": false, "md5_digest": "e3ec6b6cab77ab7780977a482efa50ce", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 8946, "upload_time": "2018-09-07T11:02:21", "url": "https://files.pythonhosted.org/packages/d6/31/dc342dc6b51805fd6a8a76ba273afc1d1cf2ab627c6553c59ed50141d598/seatsio-22.tar.gz" } ], "25": [ { "comment_text": "", "digests": { "md5": "427e166a2a691a0c105c3557b05e6616", "sha256": "6624bf431e3ee228985e2fb5602ff357fd760796eb405bf685f72b41fe313e5c" }, "downloads": -1, "filename": "seatsio-25.tar.gz", "has_sig": false, "md5_digest": "427e166a2a691a0c105c3557b05e6616", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 9335, "upload_time": "2018-09-28T07:24:59", "url": "https://files.pythonhosted.org/packages/01/bc/3a4fa2f45b45c6d719819107aa8f5a5a36329944dae39fb41dfffeb5d19e/seatsio-25.tar.gz" } ], "26": [ { "comment_text": "", "digests": { "md5": "18a6e2e5047eee8c6c0e6f6f591f29ca", "sha256": "2aab2fd57fcf914594367421ee946ae7f59c3918eb814c6142c2861d6a4904f2" }, "downloads": -1, "filename": "seatsio-26.tar.gz", "has_sig": false, "md5_digest": "18a6e2e5047eee8c6c0e6f6f591f29ca", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10593, "upload_time": "2018-10-04T09:09:54", "url": "https://files.pythonhosted.org/packages/aa/c0/5eeae6b99f0fae87ee8d1b8f750cee18551cf6b659211d041bf925cf8bc5/seatsio-26.tar.gz" } ], "27": [ { "comment_text": "", "digests": { "md5": "6390a1e316bc5ba5cd75da57e5863ed6", "sha256": "92bbab14ca39f8cbffa33e97f53df89d9f2a5d749722e5c349f6c24f1bf20e38" }, "downloads": -1, "filename": "seatsio-27.tar.gz", "has_sig": false, "md5_digest": "6390a1e316bc5ba5cd75da57e5863ed6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10672, "upload_time": "2018-10-09T11:58:18", "url": "https://files.pythonhosted.org/packages/1b/dc/acb2a4f5d6368df037a40214705eaaaa64831f072777ab62342465b93763/seatsio-27.tar.gz" } ], "28": [ { "comment_text": "", "digests": { "md5": "096aa3fe34e02404d329dc0f3a066d01", "sha256": "40110f99148ff644ab1806b4efca7656cd96134452875e5eb80c8dcf3560a234" }, "downloads": -1, "filename": "seatsio-28.tar.gz", "has_sig": false, "md5_digest": "096aa3fe34e02404d329dc0f3a066d01", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10693, "upload_time": "2018-10-16T09:18:40", "url": "https://files.pythonhosted.org/packages/8b/18/a6814fead5e48dc8d38f03d73f7a539ad362019dfab03963bb432fc0f2cd/seatsio-28.tar.gz" } ], "29": [ { "comment_text": "", "digests": { "md5": "6af534378e1e514054b9d93217d3fe6f", "sha256": "c73615058c3f062de49871765557b18d23a636bdc8a14bf0abc0c4c339fbc81b" }, "downloads": -1, "filename": "seatsio-29.tar.gz", "has_sig": false, "md5_digest": "6af534378e1e514054b9d93217d3fe6f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10728, "upload_time": "2018-10-24T13:29:34", "url": "https://files.pythonhosted.org/packages/ea/0c/7b6f3b3bddfb724b9251116df56c635a2c3af60d6c190dc565908c4575e3/seatsio-29.tar.gz" } ], "30": [ { "comment_text": "", "digests": { "md5": "81b7b1ed846474daefef4008b3980c2c", "sha256": "1913a84265256bca433a1ed84655e736810d225b757a0c2d088aac1411d2f5cc" }, "downloads": -1, "filename": "seatsio-30.tar.gz", "has_sig": false, "md5_digest": "81b7b1ed846474daefef4008b3980c2c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10738, "upload_time": "2018-11-20T08:34:42", "url": "https://files.pythonhosted.org/packages/06/fb/19a1ddf14c205c033d71e386a88c50a8e63d3171bb9e08185bfa7c158881/seatsio-30.tar.gz" } ], "31": [ { "comment_text": "", "digests": { "md5": "76d1f27c435b87d86fc0708ecaa89c11", "sha256": "d79a4f70f54519db6a2f21c50e8217ee54683a06a9614fd3ab6339ff94090ee2" }, "downloads": -1, "filename": "seatsio-31.tar.gz", "has_sig": false, "md5_digest": "76d1f27c435b87d86fc0708ecaa89c11", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10738, "upload_time": "2018-11-21T08:41:35", "url": "https://files.pythonhosted.org/packages/06/21/c96a102afa715daea20196abfd973486e6c98d10abc217dc6503811ca331/seatsio-31.tar.gz" } ], "32": [ { "comment_text": "", "digests": { "md5": "a13e648f6bc656acdce7b2df877a52a2", "sha256": "a499c6ecd427bce7a2a6647293b12f1dc0c9ad3db40efafba501fe2de2377e65" }, "downloads": -1, "filename": "seatsio-32.tar.gz", "has_sig": false, "md5_digest": "a13e648f6bc656acdce7b2df877a52a2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10753, "upload_time": "2018-11-23T08:54:55", "url": "https://files.pythonhosted.org/packages/02/72/6eb5ab544c83ad53cc0c20ee190f8b3318144bc6c2e672fb857fdb0a1e7f/seatsio-32.tar.gz" } ], "33": [ { "comment_text": "", "digests": { "md5": "92285c2a8be12c235e787b92e3090681", "sha256": "62fb47ece5a48ac36e57373d91ee879110eb79eb9541ac4adf2f0b3f986cb672" }, "downloads": -1, "filename": "seatsio-33.tar.gz", "has_sig": false, "md5_digest": "92285c2a8be12c235e787b92e3090681", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10768, "upload_time": "2019-01-22T13:43:13", "url": "https://files.pythonhosted.org/packages/74/72/591b478f33a74506d4ed0cf043787d0543e8e88b7aaec1b0c5fb846e8dfc/seatsio-33.tar.gz" } ], "34": [ { "comment_text": "", "digests": { "md5": "8e100d8bf3df4109c5ee6d65d6763ad6", "sha256": "1ad983919d7568878ffcd739104594fa0b0763861800cb91df82d66efd80503f" }, "downloads": -1, "filename": "seatsio-34.tar.gz", "has_sig": false, "md5_digest": "8e100d8bf3df4109c5ee6d65d6763ad6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10916, "upload_time": "2019-01-23T10:38:14", "url": "https://files.pythonhosted.org/packages/22/17/691cd9bc9028d1e7293d0cc1d50db04da4d3405be3f1e16f8012b1d40a43/seatsio-34.tar.gz" } ], "35": [ { "comment_text": "", "digests": { "md5": "9714ec703060ae8985951965d41b7c7d", "sha256": "aac21bb2e8a9d1fe768c69170420814ef30a1ba3d8f416e7e4a2312d165898a2" }, "downloads": -1, "filename": "seatsio-35.tar.gz", "has_sig": false, "md5_digest": "9714ec703060ae8985951965d41b7c7d", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10971, "upload_time": "2019-02-05T12:37:18", "url": "https://files.pythonhosted.org/packages/df/da/618e7dd2d7ba4cfa09ee06b14f776f31097dea41e75698b9c247016c2050/seatsio-35.tar.gz" } ], "36": [ { "comment_text": "", "digests": { "md5": "19d6e13995cdfe8be250518a863fc429", "sha256": "e87038edb3e88db84f8e41b68f56fdfb2dc38ebe745b2e56ef5e87f4a2f7b737" }, "downloads": -1, "filename": "seatsio-36.tar.gz", "has_sig": false, "md5_digest": "19d6e13995cdfe8be250518a863fc429", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11678, "upload_time": "2019-03-20T17:04:03", "url": "https://files.pythonhosted.org/packages/7a/f6/eae390ec67bfd8412063c787f2ff0fed857daee075cd6bf6d31f26592991/seatsio-36.tar.gz" } ], "37": [ { "comment_text": "", "digests": { "md5": "915bc8f843d8a0e98bb4c60edaf8347a", "sha256": "ca6fdc589025708e1bec4ba2b9c22d0791ca87c434a09d66473a1e533158ca5e" }, "downloads": -1, "filename": "seatsio-37.tar.gz", "has_sig": false, "md5_digest": "915bc8f843d8a0e98bb4c60edaf8347a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11701, "upload_time": "2019-03-28T13:36:22", "url": "https://files.pythonhosted.org/packages/62/69/e454561ebcd741d67c413a26ade7ba5641d77e778297ace67ff9d3013bda/seatsio-37.tar.gz" } ], "38": [ { "comment_text": "", "digests": { "md5": "cd3919af1b5fee5f0147c69a099b7786", "sha256": "039721c3745e139260332f0f248137dfe123148361ce2050c7f16944e15d2774" }, "downloads": -1, "filename": "seatsio-38.tar.gz", "has_sig": false, "md5_digest": "cd3919af1b5fee5f0147c69a099b7786", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11718, "upload_time": "2019-04-02T09:58:10", "url": "https://files.pythonhosted.org/packages/f7/17/ce8f81da2d18e8546108d1efdb3d25a39bd7b74fd4918ff3773a67ff5d8d/seatsio-38.tar.gz" } ], "39": [ { "comment_text": "", "digests": { "md5": "cbfe306f21e3313264202783d7a6119e", "sha256": "814469a3e9333662b167a3d320e4b3de0abadd7b4e0b14d27316914091f50f2c" }, "downloads": -1, "filename": "seatsio-39.tar.gz", "has_sig": false, "md5_digest": "cbfe306f21e3313264202783d7a6119e", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11872, "upload_time": "2019-04-17T12:50:01", "url": "https://files.pythonhosted.org/packages/08/b0/686a89394455e819e24a14d6b1b482d5c91a5a740449232a90b81df82fad/seatsio-39.tar.gz" } ], "40": [ { "comment_text": "", "digests": { "md5": "edbb0a3a309193b528b8f5f2d21f7047", "sha256": "e12d5dec265ac9c9bb4ffdca0fae083abccf2bf279028b0b6ae1fe929d7e7281" }, "downloads": -1, "filename": "seatsio-40.tar.gz", "has_sig": false, "md5_digest": "edbb0a3a309193b528b8f5f2d21f7047", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 11884, "upload_time": "2019-04-29T12:13:13", "url": "https://files.pythonhosted.org/packages/af/99/9ea9b23bdf1daf4dba078e0ac83c53008b7fcdc604efb38be1e79f814ccf/seatsio-40.tar.gz" } ], "42": [ { "comment_text": "", "digests": { "md5": "8d62a6775db7298667acc1c5caf6d8e8", "sha256": "af3824fdcaedfe5f0bb75482f62578be0dc9104c467208d23909efffd23d079e" }, "downloads": -1, "filename": "seatsio-42.tar.gz", "has_sig": false, "md5_digest": "8d62a6775db7298667acc1c5caf6d8e8", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12630, "upload_time": "2019-06-08T21:36:33", "url": "https://files.pythonhosted.org/packages/a4/be/942dee4c800d020098841d27160185f291e495259bf628eb3bd2f63205c5/seatsio-42.tar.gz" } ], "43": [ { "comment_text": "", "digests": { "md5": "5f748e2a4e7120b8b3c6c0736e196d3a", "sha256": "52b812691ef03242f93f8a1c6d1ce26de8b37fa55a1820165ce46c6bb1588537" }, "downloads": -1, "filename": "seatsio-43.tar.gz", "has_sig": false, "md5_digest": "5f748e2a4e7120b8b3c6c0736e196d3a", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12653, "upload_time": "2019-06-12T14:17:50", "url": "https://files.pythonhosted.org/packages/23/bd/7d9b5c47433acda5c442e75fc03857e5fb22de5ab51bf6cfdba306d634db/seatsio-43.tar.gz" } ], "44": [ { "comment_text": "", "digests": { "md5": "0fb3b20da73bb253bd3cbd803bda1317", "sha256": "082557c606dcb9b14c8ec65df2eab682cefcbe73ad2ceb2d7bcdccd0d393bde3" }, "downloads": -1, "filename": "seatsio-44.tar.gz", "has_sig": false, "md5_digest": "0fb3b20da73bb253bd3cbd803bda1317", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12698, "upload_time": "2019-06-25T11:23:42", "url": "https://files.pythonhosted.org/packages/b9/2b/4ddb46264012c863333b677abfd4a68ad21525c6069bf073ede5d98a26a7/seatsio-44.tar.gz" } ], "45": [ { "comment_text": "", "digests": { "md5": "50e7195bfa3723d883f35e5fff3d988b", "sha256": "3eb297bc79bbe8bd710d23861a214d75aa23ee503ed6cd15401034a8b50eb38a" }, "downloads": -1, "filename": "seatsio-45.tar.gz", "has_sig": false, "md5_digest": "50e7195bfa3723d883f35e5fff3d988b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12748, "upload_time": "2019-06-25T19:42:46", "url": "https://files.pythonhosted.org/packages/5a/7f/406adc74d68c63cf3a0d7eec0160d4a865ded243495a2a9df515c4fb3584/seatsio-45.tar.gz" } ], "46": [ { "comment_text": "", "digests": { "md5": "05c185354fc24c928e82314202e5ebf4", "sha256": "7c820a9ba811897d90f83e6757f7d0c13e3285570abcb114297e8cc0ec9c2f86" }, "downloads": -1, "filename": "seatsio-46.tar.gz", "has_sig": false, "md5_digest": "05c185354fc24c928e82314202e5ebf4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12750, "upload_time": "2019-08-23T13:17:00", "url": "https://files.pythonhosted.org/packages/e9/38/3e12d24482ee33cd355580c9e0d254e0fecba3a148c7f64c3e2750835567/seatsio-46.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "05c185354fc24c928e82314202e5ebf4", "sha256": "7c820a9ba811897d90f83e6757f7d0c13e3285570abcb114297e8cc0ec9c2f86" }, "downloads": -1, "filename": "seatsio-46.tar.gz", "has_sig": false, "md5_digest": "05c185354fc24c928e82314202e5ebf4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 12750, "upload_time": "2019-08-23T13:17:00", "url": "https://files.pythonhosted.org/packages/e9/38/3e12d24482ee33cd355580c9e0d254e0fecba3a148c7f64c3e2750835567/seatsio-46.tar.gz" } ] }