FilesExpand file tree

 master

/

sendgrid.py

Copy path

Blame

More file actions

Blame

More file actions

Latest commit

 

History

History

History

99 lines (81 loc) · 3.57 KB

 master

/

sendgrid.py

Copy path

Top

File metadata and controls

• Code
• Blame

99 lines (81 loc) · 3.57 KB

Raw

Copy raw file

Download raw file

Open symbols panel

Edit and raw actions

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

77

78

79

80

81

82

83

84

85

86

87

88

89

90

91

92

93

94

95

96

97

98

99

"""

This library allows you to quickly and easily use the Twilio SendGrid Web API v3 via

Python.

For more information on this library, see the README on GitHub.

http://github.com/sendgrid/sendgrid-python

For more information on the Twilio SendGrid v3 API, see the v3 docs:

http://sendgrid.com/docs/API_Reference/api_v3.html

For the user guide, code examples, and more, visit the main docs page:

http://sendgrid.com/docs/index.html

This file provides the Twilio SendGrid API Client.

"""

import os

import warnings

import python_http_client

class SendGridAPIClient(object):

"""The Twilio SendGrid API Client.

Use this object to interact with the v3 API. For example:

sg = sendgrid.SendGridAPIClient(os.environ.get('SENDGRID_API_KEY'))

...

mail = Mail(from_email, subject, to_email, content)

response = sg.client.mail.send.post(request_body=mail.get())

For examples and detailed use instructions, see

https://github.com/sendgrid/sendgrid-python

"""

def __init__(

self,

api_key=None,

host='https://api.sendgrid.com',

impersonate_subuser=None):

"""

Construct the Twilio SendGrid v3 API object.

Note that the underlying client is being set up during initialization,

therefore changing attributes in runtime will not affect HTTP client

behaviour.

:param api_key: Twilio SendGrid API key to use. If not provided, key will be

read from environment variable "SENDGRID_API_KEY"

:type api_key: string

:param impersonate_subuser: the subuser to impersonate. Will be passed

by "On-Behalf-Of" header by underlying

client. See

https://sendgrid.com/docs/User_Guide/Settings/subusers.html

for more details

:type impersonate_subuser: string

:param host: base URL for API calls

:type host: string

"""

from . import __version__

self.api_key = api_key or os.environ.get('SENDGRID_API_KEY')

self.impersonate_subuser = impersonate_subuser

self.host = host

self.version = __version__

self.useragent = 'sendgrid/{};python'.format(self.version)

self.client = python_http_client.Client(

host=self.host,

request_headers=self._default_headers,

version=3)

@property

def _default_headers(self):

"""Set the default header for a Twilio SendGrid v3 API call"""

headers = {

"Authorization": 'Bearer {}'.format(self.api_key),

"User-agent": self.useragent,

"Accept": 'application/json'

}

if self.impersonate_subuser:

headers['On-Behalf-Of'] = self.impersonate_subuser

return headers

def reset_request_headers(self):

self.client.request_headers = self._default_headers

def send(self, message):

"""Make a Twilio SendGrid v3 API request with the request body generated by

the Mail object

:param message: The Twilio SendGrid v3 API request body generated by the Mail

object

:type message: Mail

"""

if isinstance(message, dict):

response = self.client.mail.send.post(request_body=message)

else:

response = self.client.mail.send.post(request_body=message.get())

return response