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
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
|
## Contact support@pubnub.com for all questions
#### [PubNub](http://www.pubnub.com) Real-time Data Network
##### Clients for Python, including Twisted and Tornado
## Installation
```
pip install pubnub==3.5.0
```
If you prefer to use the previous version of PubNub, run this pip commandline to revert
```
pip install pubnub==3.3.5
```
Examples and instructions for migrating from older versions of sdk are available in
README.md, migration.md and examples directories under specific platforms.
[Base Python - Everyday python for your scripts and apps](python)
[Tornado - For use with the Python Tornado Framework](tornado)
[Twisted - For use with the Python Twisted Framework](twisted)
## Pubnub Console
Pubnub console is a command line app which allows you to do various
pubnub operations like publish, subscribe, getting history, here now,
presence etc from command line
```
pip install pubnub-console
```
## Contact support@pubnub.com for all questions
=======
## PubNub 3.3 Web Data Push Cloud-hosted API - PYTHON
#### www.pubnub.com - PubNub Web Data Push Service in the Cloud.
#### http://github.com/pubnub/python
## Major Upgrade to 3.6 underway! In the meantime, we've provided Python 3 beta support in the python3 branch.
Contact us at support@pubnub.com if you have any questions in the meantime.
#### Init
```
pubnub = Pubnub(
"demo", ## PUBLISH_KEY
"demo", ## SUBSCRIBE_KEY
None, ## SECRET_KEY
False ## SSL_ON?
)
```
#### PUBLISH
```
info = pubnub.publish({
'channel' : 'hello_world',
'message' : {
'some_text' : 'Hello my World'
}
})
print(info)
```
#### SUBSCRIBE
```
# Listen for Messages *BLOCKING*
def receive(message) :
print(message)
return True
pubnub.subscribe({
'channel' : 'hello_world',
'callback' : receive
})
```
#### PRESENCE
```
# Listen for Presence Event Messages *BLOCKING*
def pres_event(message) :
print(message)
return True
pubnub.presence({
'channel' : 'hello_world',
'callback' : receive
})
```
#### HERE_NOW
```
# Get info on who is here right now!
here_now = pubnub.here_now({
'channel' : 'hello_world',
})
print(here_now['occupancy'])
print(here_now['uuids'])
```
#### Channel Analytics
```
analytics = pubnub.analytics({
'channel' : 'channel-name-here', ## Leave blank for all channels
'limit' : 100, ## aggregation range
'ago' : 0, ## minutes ago to look backward
'duration' : 100 ## minutes offset
})
print(analytics)
```
#### HISTORY
```
# Load Previously Published Messages
history = pubnub.detailedHistory({
'channel' : 'my_channel',
'end' : my_end_time_token, # Optional
'start' : my_start_time_token, # Optional
'count' : num_of_msgs_to_return # Optional, default is 100
})
print(history)
```
|
