dancroak-twitter-search 0.4 → 0.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- data/README.markdown +5 -71
- data/twitter-search.gemspec +2 -2
- metadata +2 -2
data/README.markdown
CHANGED
|
@@ -1,82 +1,29 @@
|
|
|
1
|
-
<<<<<<< HEAD:README.markdown
|
|
2
|
-
# A simple Summize client for Ruby.
|
|
3
|
-
=======
|
|
4
1
|
# A Twitter Search client for Ruby.
|
|
5
|
-
>>>>>>> ef8ef7aaafceb04d69cdfb3963f229ec1ab666db:README.markdown
|
|
6
2
|
|
|
7
|
-
<<<<<<< HEAD:README.markdown
|
|
8
|
-
Access the Summize API from your Ruby code.
|
|
9
|
-
=======
|
|
10
3
|
Access the Twitter Search API from your Ruby code.
|
|
11
|
-
>>>>>>> ef8ef7aaafceb04d69cdfb3963f229ec1ab666db:README.markdown
|
|
12
4
|
|
|
13
5
|
## Usage
|
|
14
6
|
|
|
15
|
-
<<<<<<< HEAD:README.markdown
|
|
16
|
-
=======
|
|
17
7
|
Install the gem.
|
|
18
8
|
|
|
19
9
|
sudo gem install dancroak-twitter-search -s http://gems.github.com
|
|
20
10
|
|
|
21
|
-
>>>>>>> ef8ef7aaafceb04d69cdfb3963f229ec1ab666db:README.markdown
|
|
22
11
|
Require the gem.
|
|
23
12
|
|
|
24
|
-
<<<<<<< HEAD:README.markdown
|
|
25
|
-
require 'summize'
|
|
26
|
-
=======
|
|
27
13
|
require 'twitter-search'
|
|
28
|
-
>>>>>>> ef8ef7aaafceb04d69cdfb3963f229ec1ab666db:README.markdown
|
|
29
14
|
|
|
30
|
-
<<<<<<< HEAD:README.markdown
|
|
31
|
-
Set up a Summize::Client. Name your client (a.k.a. 'user agent') to something meaningful, such as your app's name. This helps Summize answer any questions about your use of the API.
|
|
32
|
-
=======
|
|
33
15
|
Set up a TwitterSearch::Client. Name your client (a.k.a. 'user agent') to something meaningful, such as your app's name. This helps Twitter Search answer any questions about your use of the API.
|
|
34
|
-
>>>>>>> ef8ef7aaafceb04d69cdfb3963f229ec1ab666db:README.markdown
|
|
35
16
|
|
|
36
|
-
<<<<<<< HEAD:README.markdown
|
|
37
|
-
@client = Summize::Client.new 'politweets'
|
|
38
|
-
=======
|
|
39
17
|
@client = TwitterSearch::Client.new 'politweets'
|
|
40
|
-
>>>>>>> ef8ef7aaafceb04d69cdfb3963f229ec1ab666db:README.markdown
|
|
41
18
|
|
|
42
19
|
Request tweets by calling the query method of your client. It takes either a String or a Hash of arguments.
|
|
43
20
|
|
|
44
21
|
@tweets = @client.query 'twitter search'
|
|
45
22
|
|
|
46
|
-
<<<<<<< HEAD:README.markdown
|
|
47
|
-
The String form uses the default Summize behavior, which in this example finds tweets containing both "twitter" and "search". It is identical to the more verbose, explicit version:
|
|
48
|
-
=======
|
|
49
23
|
The String form uses the default Twitter Search behavior, which in this example finds tweets containing both "twitter" and "search". It is identical to the more verbose, explicit version:
|
|
50
|
-
>>>>>>> ef8ef7aaafceb04d69cdfb3963f229ec1ab666db:README.markdown
|
|
51
24
|
|
|
52
25
|
@tweets = @client.query :q => 'twitter search'
|
|
53
|
-
|
|
54
|
-
<<<<<<< HEAD:README.markdown
|
|
55
|
-
Use Summize's query operators with the :q key to access the following behavior:
|
|
56
|
-
|
|
57
|
-
<table>
|
|
58
|
-
<tr><th>Operator</th><th>Finds tweets...</th></tr>
|
|
59
|
-
|
|
60
|
-
<tr><td><a href="http://summize.com/search?q=twitter+search">:q => 'twitter search'</a></td><td>containing both "twitter" and "search". This is the default operator.</td></tr>
|
|
61
|
-
<tr><td><a href="http://summize.com/search?q=%22happy+hour%22">:q => '<b>"</b>happy hour<b>"</b>'</a></td><td>containing the exact phrase "happy hour".</td></tr>
|
|
62
|
-
<tr><td><a href="http://summize.com/search?q=obama+OR+hillary">:q => 'obama <b>OR</b> hillary'</a></td><td>containing either "obama" or "hillary" (or both).</td></tr>
|
|
63
|
-
|
|
64
|
-
<tr><td><a href="http://summize.com/search?q=beer+-root">:q => 'beer <b>-</b>root'</a></td><td>containing "beer" but not "root".</td></tr>
|
|
65
|
-
<tr><td><a href="http://summize.com/search?q=%23haiku">:q => '<b>#</b>haiku</a>'</td><td>containing the hashtag "haiku".</td></tr>
|
|
66
|
-
<tr><td><a href="http://summize.com/search?q=from%3Aalexiskold">:q => '<b>from:</b>alexiskold'</a></td><td>sent from person "alexiskold".</td></tr>
|
|
67
|
-
<tr><td><a href="http://summize.com/search?q=to%3Atechcrunch">:q => '<b>to:</b>techcrunch</a>'</td><td>sent to person "techcrunch".</td></tr>
|
|
68
|
-
<tr><td><a href="http://summize.com/search?q=%40mashable">:q => '<b>@</b>mashable</a>'</td><td>referencing person "mashable".</td></tr>
|
|
69
|
-
|
|
70
|
-
<tr><td><a href="http://summize.com/search?q=superhero+since%3A2008-05-01">:q => 'superhero <b>since:</b>2008-05-01'</a></td><td>containing "superhero" and sent since date "2008-05-01" (year-month-day).</td></tr>
|
|
71
|
-
|
|
72
|
-
<tr><td><a href="http://summize.com/search?q=ftw+until%3A2008-05-03">:q => 'ftw <b>until:</b>2008-05-03'</a></td><td>containing "ftw" and sent up to date "2008-05-03".</td></tr>
|
|
73
|
-
<tr><td><a href="http://summize.com/search?q=movie+-scary+%3A%29">:q => 'movie -scary <b>:)</b>'</a></td><td>containing "movie", but not "scary", and with a positive attitude.</td></tr>
|
|
74
|
-
<tr><td><a href="http://summize.com/search?q=flight+%3A%28">:q => 'flight <b>:(</b>'</a></td><td>containing "flight" and with a negative attitude.</td></tr>
|
|
75
|
-
<tr><td><a href="http://summize.com/search?q=traffic+%3F">:q => 'traffic <b>?</b>'</a></td><td>containing "traffic" and asking a question.</td></tr>
|
|
76
|
-
|
|
77
|
-
<tr><td><a href="http://summize.com/search?q=hilarious+filter%3Alinks">:q => 'hilarious <b>filter:links</b>'</a></td><td>containing "hilarious" and linking to URLs.</td></tr>
|
|
78
|
-
</table>
|
|
79
|
-
=======
|
|
26
|
+
|
|
80
27
|
Use the Twitter Search API's query operators with the :q key to access a variety of behavior.
|
|
81
28
|
|
|
82
29
|
## Search Operators
|
|
@@ -97,35 +44,26 @@ The following operator examples find tweets...
|
|
|
97
44
|
* <a href="http://search.twitter.com/search?q=flight+%3A%28">:q => 'flight <b>:(</b>'</a> - containing "flight" and with a negative attitude.
|
|
98
45
|
* <a href="http://search.twitter.com/search?q=traffic+%3F">:q => 'traffic <b>?</b>'</a> - containing "traffic" and asking a question.
|
|
99
46
|
* <a href="http://search.twitter.com/search?q=hilarious+filter%3Alinks">:q => 'hilarious <b>filter:links</b>'</a> - containing "hilarious" and linking to URLs.
|
|
100
|
-
>>>>>>> ef8ef7aaafceb04d69cdfb3963f229ec1ab666db:README.markdown
|
|
101
47
|
|
|
102
48
|
### Foreign Languages
|
|
103
49
|
|
|
104
|
-
<<<<<<< HEAD:README.markdown
|
|
105
|
-
The Summize API supports foreign languages, accessible via the :lang key. Use the [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) codes as the value:
|
|
106
|
-
=======
|
|
107
50
|
The Twitter Search API supports foreign languages, accessible via the :lang key. Use the [ISO 639-1](http://en.wikipedia.org/wiki/ISO_639-1) codes as the value:
|
|
108
|
-
>>>>>>> ef8ef7aaafceb04d69cdfb3963f229ec1ab666db:README.markdown
|
|
109
51
|
|
|
110
52
|
@tweets = @client.query :q => 'programmé', :lang => 'fr'
|
|
111
53
|
|
|
112
|
-
<<<<<<< HEAD:README.markdown
|
|
113
|
-
=======
|
|
114
54
|
### Pagination
|
|
115
55
|
|
|
116
56
|
Alter the number of Tweets returned per page with the :rpp key. Stick with 10, 15, 20, 25, 30, or 50.
|
|
117
57
|
|
|
118
58
|
@tweets = @client.query :q => 'Boston Celtics', :rpp => '30'
|
|
119
59
|
|
|
120
|
-
>>>>>>> ef8ef7aaafceb04d69cdfb3963f229ec1ab666db:README.markdown
|
|
121
60
|
## Gotchas
|
|
122
61
|
|
|
123
62
|
* Searches are case-insenstive.
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
>>>>>>> ef8ef7aaafceb04d69cdfb3963f229ec1ab666db:README.markdown
|
|
63
|
+
* The "near" operator available in the Twitter Search web interface is not available via the API. You must geocode before making your Twitter Search API call, and use the :geocode key in your request using the pattern lat,lngmi or lat,lngkm:
|
|
64
|
+
|
|
65
|
+
@tweets = @client.query :q => 'Pearl Jam', :geocode => '43.4411,-70.9846mi'
|
|
66
|
+
|
|
129
67
|
* Searching for a positive attitude :) returns tweets containing the text :), =), :D, and :-)
|
|
130
68
|
|
|
131
69
|
## Authors
|
|
@@ -134,11 +72,7 @@ Written by Dustin Sallings (dustin@spy.net), forked by Dan Croak (dcroak@thought
|
|
|
134
72
|
|
|
135
73
|
## Resources
|
|
136
74
|
|
|
137
|
-
<<<<<<< HEAD:README.markdown
|
|
138
|
-
* [Official Summize API](http://summize.com/api)
|
|
139
|
-
=======
|
|
140
75
|
* [Official Twitter Search API](http://search.twitter.com/api)
|
|
141
|
-
>>>>>>> ef8ef7aaafceb04d69cdfb3963f229ec1ab666db:README.markdown
|
|
142
76
|
|
|
143
77
|
## License
|
|
144
78
|
|
data/twitter-search.gemspec
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
Gem::Specification.new do |s|
|
|
2
2
|
s.name = "twitter-search"
|
|
3
|
-
s.version = "0.
|
|
4
|
-
s.date = "2008-
|
|
3
|
+
s.version = "0.5"
|
|
4
|
+
s.date = "2008-08-04"
|
|
5
5
|
s.summary = "Ruby client for Twitter Search."
|
|
6
6
|
s.email = "dcroak@thoughtbot.com"
|
|
7
7
|
s.homepage = "http://github.com/dancroak/twitter-search"
|
metadata
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: dancroak-twitter-search
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: "0.
|
|
4
|
+
version: "0.5"
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Dustin Sallings
|
|
@@ -10,7 +10,7 @@ autorequire:
|
|
|
10
10
|
bindir: bin
|
|
11
11
|
cert_chain: []
|
|
12
12
|
|
|
13
|
-
date: 2008-
|
|
13
|
+
date: 2008-08-04 00:00:00 -07:00
|
|
14
14
|
default_executable:
|
|
15
15
|
dependencies:
|
|
16
16
|
- !ruby/object:Gem::Dependency
|