feedbag 0.9.1 → 0.9.2

Sign up to get free protection for your applications and to get access to all the features.
Files changed (2) hide show
  1. data/README.markdown +16 -72
  2. metadata +36 -52
data/README.markdown CHANGED
@@ -1,92 +1,40 @@
1
1
  Feedbag
2
2
  =======
3
- > Do you want me to drag my sack across your face?
4
- > - Glenn Quagmire
5
3
 
6
- Feedbag is a feed auto-discovery Ruby library. You don't need to know more about it. It is said to be:
7
-
8
- > Ruby's favorite auto-discovery tool/library!
4
+ Feedbag is Ruby's favorite auto-discovery tool/library!
9
5
 
10
6
  ### Quick synopsis
11
7
 
12
- >> require "rubygems"
13
- => true
14
8
  >> require "feedbag"
15
9
  => true
16
- >> Feedbag.find "log.damog.net"
17
- => ["http://feeds.feedburner.com/TeoremaDelCerdoInfinito", "http://log.damog.net/comments/feed/"]
18
- >> Feedbag.feed?("google.com")
19
- => false
20
- >> Feedbag.feed?("http://planet.debian.org/rss20.xml")
21
- => true
22
-
23
- ### Installation
24
-
25
- $ sudo gem install damog-feedbag -s http://gems.github.com/
26
-
27
- Or just grab feedbag.rb and use it on your own project:
28
-
29
- $ wget http://github.com/damog/feedbag/raw/master/lib/feedbag.rb
30
-
31
- ## Tutorial
32
-
33
- So you want to know more about it.
34
-
35
- OK, if the URL passed to the find method is a feed itself, that only feed URL will be returned.
36
-
37
- >> Feedbag.find "github.com/damog.atom"
38
- => ["http://github.com/damog.atom"]
39
- >>
40
-
41
- Otherwise, it will always return LINK feeds first, A (anchor tags) feeds later. Between A feeds, the ones hosted on the same URL's host, will have larger priority:
10
+ >> Feedbag.find "damog.net/blog"
11
+ => ["http://damog.net/blog/index.rss", "http://damog.net/blog/tags/feed", "http://damog.net/blog/tags/rfeed"]
12
+ >> Feedbag.feed? "perl.org"
13
+ => false
14
+ >> Feedbag.feed?("http://jobs.perl.org/rss/standard.rss")
15
+ => true
42
16
 
43
- >> Feedbag.find "http://ve.planetalinux.org"
44
- => ["http://feedproxy.google.com/PlanetaLinuxVenezuela", "http://rendergraf.wordpress.com/feed/", "http://rootweiller.wordpress.com/feed/", "http://skatox.com/blog/feed/", "http://kodegeek.com/atom.xml", "http://blog.0x29.com.ve/?feed=rss2&cat=8"]
45
- >>
17
+ You can also use an installed command line tool for quick queries, if you install the gem:
46
18
 
47
- On your application you should only take the very first element of the array, most of the times:
19
+ $ feedbag http://rubygems.org/profiles/damog
20
+ == http://rubygems.org/profiles/damog:
21
+ - http://feeds.feedburner.com/gemcutter-latest
48
22
 
49
- >> Feedbag.find("planet.debian.org").first(3)
50
- => ["http://planet.debian.org/rss10.xml", "http://planet.debian.org/rss20.xml", "http://planet.debian.org/atom.xml"]
51
- >>
52
23
 
53
- (Try running that same example without the "first" method. That example's host is a blog aggregator, so it has hundreds of feed URLs:)
24
+ ### Installation
54
25
 
55
- >> Feedbag.find("planet.debian.org").size
56
- => 104
57
- >>
26
+ $ sudo gem install feedbag
58
27
 
59
- Feedbag will find them all, but it will return the most important ones on the first elements on the array returned.
28
+ Or just grab feedbag.rb and use it on your own project:
60
29
 
61
- >> Feedbag.find("cnn.com")
62
- => ["http://rss.cnn.com/rss/cnn_topstories.rss", "http://rss.cnn.com/rss/cnn_latest.rss", "http://rss.cnn.com/services/podcasting/robinmeade/rss.xml"]
63
- >>
30
+ $ wget http://github.com/damog/feedbag/raw/master/lib/feedbag.rb
64
31
 
65
32
  ### Why should you use it?
66
33
 
67
- - Because it's cool.
68
34
  - Because it only uses [Hpricot](https://code.whytheluckystiff.net/hpricot/) as dependency.
69
35
  - Because it follows modern feed filename conventions (like those ones used by WordPress blogs, or Blogger, etc).
70
36
  - Because it's a single file you can embed easily in your application.
71
- - Because it passes most of the Mark Pilgrim's [Atom auto-discovery test suite](http://diveintomark.org/tests/client/autodiscovery/). It doesn't pass them all because some of those tests are broken (citation needed).
72
-
73
- ### Why did I build it?
74
-
75
- - Because I liked Benjamin Trott's [Feed::Find](http://search.cpan.org/~btrott/Feed-Find-0.06/lib/Feed/Find.pm).
76
- - Because I thought it would be good to have Feed::Find's functionality in Ruby.
77
- - Because I thought it was going to be easy to maintain.
78
- - Because I was going to use it on [rFeed](http://github.com/damog/rfeed).
79
- - And finally, because I didn't know [rfeedfinder](http://rfeedfinder.rubyforge.org/) existed :-)
80
-
81
- ### Bugs
82
-
83
- Please, report bugs to [rt@support.axiombox.com](rt@support.axiombox.com) or directly to the author.
84
-
85
- ### Contribute
86
-
87
- > git clone git://github.com/damog/feedbag.git
88
-
89
- ...patch, build, hack and make pull requests. I'll be glad.
37
+ - Because it's faster than rfeedfinder.
90
38
 
91
39
  ### Author
92
40
 
@@ -96,7 +44,3 @@ Please, report bugs to [rt@support.axiombox.com](rt@support.axiombox.com) or dir
96
44
 
97
45
  This is free software. See [COPYING](http://github.com/damog/feedbag/master/COPYING) for more information.
98
46
 
99
- ### Thanks
100
-
101
- [Raquel](http://maggit.net), for making [Axiombox](http://axiombox.com) and most of my dreams possible. Also, [GitHub](http://github.com) for making a nice code sharing service that doesn't suck.
102
-
metadata CHANGED
@@ -1,86 +1,70 @@
1
- --- !ruby/object:Gem::Specification
1
+ --- !ruby/object:Gem::Specification
2
2
  name: feedbag
3
- version: !ruby/object:Gem::Version
4
- hash: 57
3
+ version: !ruby/object:Gem::Version
4
+ version: 0.9.2
5
5
  prerelease:
6
- segments:
7
- - 0
8
- - 9
9
- - 1
10
- version: 0.9.1
11
6
  platform: ruby
12
- authors:
13
- - Axiombox
7
+ authors:
14
8
  - David Moreno
15
9
  autorequire:
16
10
  bindir: bin
17
11
  cert_chain: []
18
-
19
- date: 2012-03-16 00:00:00 Z
20
- dependencies:
21
- - !ruby/object:Gem::Dependency
12
+ date: 2013-12-07 00:00:00.000000000 Z
13
+ dependencies:
14
+ - !ruby/object:Gem::Dependency
22
15
  name: hpricot
23
- prerelease: false
24
- requirement: &id001 !ruby/object:Gem::Requirement
16
+ requirement: !ruby/object:Gem::Requirement
25
17
  none: false
26
- requirements:
27
- - - ">="
28
- - !ruby/object:Gem::Version
29
- hash: 7
30
- segments:
31
- - 0
32
- - 6
33
- version: "0.6"
18
+ requirements:
19
+ - - ! '>='
20
+ - !ruby/object:Gem::Version
21
+ version: '0.6'
34
22
  type: :runtime
35
- version_requirements: *id001
23
+ prerelease: false
24
+ version_requirements: !ruby/object:Gem::Requirement
25
+ none: false
26
+ requirements:
27
+ - - ! '>='
28
+ - !ruby/object:Gem::Version
29
+ version: '0.6'
36
30
  description: Ruby's favorite feed auto-discoverty tool
37
31
  email: david@axiombox.com
38
- executables:
32
+ executables:
39
33
  - feedbag
40
34
  extensions: []
41
-
42
- extra_rdoc_files:
35
+ extra_rdoc_files:
43
36
  - README.markdown
44
37
  - COPYING
45
- files:
38
+ files:
46
39
  - lib/feedbag.rb
47
40
  - benchmark/rfeedfinder_benchmark.rb
48
41
  - bin/feedbag
49
42
  - README.markdown
50
43
  - COPYING
51
- homepage: http://axiombox.com/feedbag
44
+ homepage: http://github.com/damog/feedbag
52
45
  licenses: []
53
-
54
46
  post_install_message:
55
- rdoc_options:
47
+ rdoc_options:
56
48
  - --main
57
49
  - README.markdown
58
- require_paths:
50
+ require_paths:
59
51
  - lib
60
- required_ruby_version: !ruby/object:Gem::Requirement
52
+ required_ruby_version: !ruby/object:Gem::Requirement
61
53
  none: false
62
- requirements:
63
- - - ">="
64
- - !ruby/object:Gem::Version
65
- hash: 3
66
- segments:
67
- - 0
68
- version: "0"
69
- required_rubygems_version: !ruby/object:Gem::Requirement
54
+ requirements:
55
+ - - ! '>='
56
+ - !ruby/object:Gem::Version
57
+ version: '0'
58
+ required_rubygems_version: !ruby/object:Gem::Requirement
70
59
  none: false
71
- requirements:
72
- - - ">="
73
- - !ruby/object:Gem::Version
74
- hash: 3
75
- segments:
76
- - 0
77
- version: "0"
60
+ requirements:
61
+ - - ! '>='
62
+ - !ruby/object:Gem::Version
63
+ version: '0'
78
64
  requirements: []
79
-
80
65
  rubyforge_project: feedbag
81
- rubygems_version: 1.8.10
66
+ rubygems_version: 1.8.23
82
67
  signing_key:
83
68
  specification_version: 3
84
69
  summary: Ruby's favorite feed auto-discovery tool
85
70
  test_files: []
86
-