[prev in list] [next in list] [prev in thread] [next in thread]
List: python-list
Subject: Most "pythonic" syntax to use for an API client library
From: Jonathan Leroy - Inikup via Python-list <python-list () python ! org>
Date: 2019-04-28 18:58:40
Message-ID: CAC88fzF+7awajKcu0_=05BOVLvV2Q7Vjo+JJFdH2rLkXnjgxng () mail ! gmail ! com
[Download RAW message or body]
Hi all,
I'm writing a client library for a REST API. The API endpoints looks like this:
/customers
/customers/1
/customers/1/update
/customers/1/delete
Which of the following syntax do you expect an API client library to
use, and why?
1/
api.customers_list()
api.customers_info(1)
api.customers_update(1, name='Bob')
api.customers_delete(1)
2/
api.customers.list()
api.customers.info(1)
api.customers.update(1, name='Bob')
api.customers.delete(1)
3/
api.customers.list()
api.customers(1).info()
api.customers(1).update(name='Bob')
api.customers(1).delete()
...any other?
#3 seems to be more "pretty" to me, but I did not find any "official"
recommendation online.
Thanks.
--
Jonathan.
--
https://mail.python.org/mailman/listinfo/python-list
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic