thoughtafter-nntp 1.0.0.2 → 1.0.0.3

Sign up to get free protection for your applications and to get access to all the features.
Files changed (25) hide show
  1. data/Authors.txt +18 -0
  2. data/History.txt +42 -0
  3. data/License.txt +32 -0
  4. data/Manifest.txt +24 -0
  5. data/README.txt +9 -0
  6. data/Rakefile +4 -0
  7. data/config/hoe.rb +71 -0
  8. data/config/requirements.rb +17 -0
  9. data/lib/nntp.rb +883 -0
  10. data/lib/nntp/version.rb +34 -0
  11. data/script/destroy +14 -0
  12. data/script/generate +14 -0
  13. data/script/txt2html +74 -0
  14. data/setup.rb +1585 -0
  15. data/tasks/deployment.rake +34 -0
  16. data/tasks/environment.rake +7 -0
  17. data/tasks/website.rake +17 -0
  18. data/test/test_helper.rb +2 -0
  19. data/test/test_nntp.rb +11 -0
  20. data/website/index.html +254 -0
  21. data/website/index.txt +163 -0
  22. data/website/javascripts/rounded_corners_lite.inc.js +285 -0
  23. data/website/stylesheets/screen.css +138 -0
  24. data/website/template.rhtml +48 -0
  25. metadata +26 -2
data/tasks/deployment.rake ADDED
@@ -0,0 +1,34 @@
1
+ desc 'Release the website and new gem version'
2
+ task :deploy => [:check_version, :website, :release] do
3
+ puts "Remember to create SVN tag:"
4
+ puts "svn copy svn+ssh://#{rubyforge_username}@rubyforge.org/var/svn/#{PATH}/trunk " +
5
+ "svn+ssh://#{rubyforge_username}@rubyforge.org/var/svn/#{PATH}/tags/REL-#{VERS} "
6
+ puts "Suggested comment:"
7
+ puts "Tagging release #{CHANGES}"
8
+ end
9
+
10
+ desc 'Runs tasks website_generate and install_gem as a local deployment of the gem'
11
+ task :local_deploy => [:website_generate, :install_gem]
12
+
13
+ task :check_version do
14
+ unless ENV['VERSION']
15
+ puts 'Must pass a VERSION=x.y.z release version'
16
+ exit
17
+ end
18
+ unless ENV['VERSION'] == VERS
19
+ puts "Please update your version.rb to match the release version, currently #{VERS}"
20
+ exit
21
+ end
22
+ end
23
+
24
+ desc 'Install the package as a gem, without generating documentation(ri/rdoc)'
25
+ task :install_gem_no_doc => [:clean, :package] do
26
+ sh "#{'sudo ' unless Hoe::WINDOZE }gem install pkg/*.gem --no-rdoc --no-ri"
27
+ end
28
+
29
+ namespace :manifest do
30
+ desc 'Recreate Manifest.txt to include ALL files'
31
+ task :refresh do
32
+ `rake check_manifest | patch -p0 > Manifest.txt`
33
+ end
34
+ end
data/tasks/environment.rake ADDED
@@ -0,0 +1,7 @@
1
+ task :ruby_env do
2
+ RUBY_APP = if RUBY_PLATFORM =~ /java/
3
+ "jruby"
4
+ else
5
+ "ruby"
6
+ end unless defined? RUBY_APP
7
+ end
data/tasks/website.rake ADDED
@@ -0,0 +1,17 @@
1
+ desc 'Generate website files'
2
+ task :website_generate => :ruby_env do
3
+ (Dir['website/**/*.txt'] - Dir['website/version*.txt']).each do |txt|
4
+ sh %{ #{RUBY_APP} script/txt2html #{txt} > #{txt.gsub(/txt$/,'html')} }
5
+ end
6
+ end
7
+
8
+ desc 'Upload website files to rubyforge'
9
+ task :website_upload do
10
+ host = "#{rubyforge_username}@rubyforge.org"
11
+ remote_dir = "/var/www/gforge-projects/#{PATH}/"
12
+ local_dir = 'website'
13
+ sh %{rsync -rlgoDCv #{local_dir}/ #{host}:#{remote_dir}}
14
+ end
15
+
16
+ desc 'Generate and upload website files'
17
+ task :website => [:website_generate, :website_upload, :publish_docs]
data/test/test_helper.rb ADDED
@@ -0,0 +1,2 @@
1
+ require 'test/unit'
2
+ require File.dirname(__FILE__) + '/../lib/nntp'
data/test/test_nntp.rb ADDED
@@ -0,0 +1,11 @@
1
+ require File.dirname(__FILE__) + '/test_helper.rb'
2
+
3
+ class TestNntp < Test::Unit::TestCase
4
+
5
+ def setup
6
+ end
7
+
8
+ def test_truth
9
+ assert true
10
+ end
11
+ end
data/website/index.html ADDED
@@ -0,0 +1,254 @@
1
+ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
2
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3
+ <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4
+ <head>
5
+ <link rel="stylesheet" href="stylesheets/screen.css" type="text/css" media="screen" />
6
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
7
+ <title>
8
+ Net::NNTP Client Library
9
+ </title>
10
+ <script src="javascripts/rounded_corners_lite.inc.js" type="text/javascript"></script>
11
+ <style>
12
+
13
+ </style>
14
+ <script type="text/javascript">
15
+ window.onload = function() {
16
+ settings = {
17
+ tl: { radius: 10 },
18
+ tr: { radius: 10 },
19
+ bl: { radius: 10 },
20
+ br: { radius: 10 },
21
+ antiAlias: true,
22
+ autoPad: true,
23
+ validTags: ["div"]
24
+ }
25
+ var versionBox = new curvyCorners(settings, document.getElementById("version"));
26
+ versionBox.applyCornersToAll();
27
+ }
28
+ </script>
29
+ </head>
30
+ <body>
31
+ <div id="main">
32
+
33
+ <h1>Net::NNTP Client Library</h1>
34
+ <div id="version" class="clickable" onclick='document.location = "http://rubyforge.org/projects/nntp"; return false'>
35
+ <p>Get Version</p>
36
+ <a href="http://rubyforge.org/projects/nntp" class="numbers">1.0.0</a>
37
+ </div>
38
+ <h1>&#x2192; &#8216;nntp&#8217;</h1>
39
+
40
+
41
+ <h2>What</h2>
42
+
43
+
44
+ <p>This gem allows you to to retrieve and post Usenet news articles via <span class="caps">NNTP</span>, the Network News Transfer Protocol. For details of <span class="caps">NNTP</span> itself, see <a href="http://www.ietf.org/rfc/rfc977.txt"><span class="caps">RFC977</span></a>.</p>
45
+
46
+
47
+ <p>This library does <span class="caps">NOT</span> provide functions to compose Usenet news articles. You must create and format them yourself per Standard for Interchange of Usenet Messages. See <a href="http://www.ietf.org/rfc/rfc850.txt"><span class="caps">RFC850</span></a>, <a href="http://www.ietf.org/rfc/rfc2047.txt"><span class="caps">RFC2047</span></a>.</p>
48
+
49
+
50
+ <h2>Installing</h2>
51
+
52
+
53
+ <p><pre class='syntax'><span class="ident">sudo</span> <span class="ident">gem</span> <span class="ident">install</span> <span class="ident">nntp</span></pre></p>
54
+
55
+
56
+ <p>Alternatively, you may download the gem from the <a href="http://rubyforge.org/projects/nntp">project info page</a> and install manually.</p>
57
+
58
+
59
+ <h2>The basics</h2>
60
+
61
+
62
+ <h3>Posting Messages</h3>
63
+
64
+
65
+ <p>You must open a connection to a <span class="caps">NNTP</span> server before posting messages. The first argument is the address of your <span class="caps">NNTP</span> server, and the second argument is the port number. Using <span class="caps">NNTP</span>.start with a block is the simplest way to do this because the <span class="caps">NNTP</span> connection closes automatically after the block executes.</p>
66
+
67
+
68
+ <p><pre class='syntax'>
69
+ <span class="ident">require</span> <span class="punct">'</span><span class="string">rubygems</span><span class="punct">'</span>
70
+ <span class="ident">require</span> <span class="punct">'</span><span class="string">nntp</span><span class="punct">'</span>
71
+ <span class="constant">Net</span><span class="punct">::</span><span class="constant">NNTP</span><span class="punct">.</span><span class="ident">start</span><span class="punct">('</span><span class="string">your.nntp.server</span><span class="punct">',</span> <span class="number">119</span><span class="punct">)</span> <span class="keyword">do</span> <span class="punct">|</span><span class="ident">nntp</span><span class="punct">|</span>
72
+ <span class="comment"># Use the NNTP object nntp only in this block.</span>
73
+ <span class="keyword">end</span>
74
+ </pre></p>
75
+
76
+
77
+ <p>Replace ‘your.nntp.server’ with your <span class="caps">NNTP</span> server. Normally your systems administrator or internet service provider supplies a server for you.</p>
78
+
79
+
80
+ <p>Then you can post messages.</p>
81
+
82
+
83
+ <p><pre class='syntax'>
84
+ <span class="ident">require</span> <span class="punct">'</span><span class="string">date</span><span class="punct">'</span>
85
+ <span class="ident">date</span> <span class="punct">=</span> <span class="constant">DateTime</span><span class="punct">.</span><span class="ident">now</span><span class="punct">().</span><span class="ident">strftime</span><span class="punct">(</span><span class="ident">fmt</span><span class="punct">='</span><span class="string">%a, %d %b %Y %T %z</span><span class="punct">')</span>
86
+
87
+ <span class="ident">msgstr</span> <span class="punct">=</span> <span class="punct">&lt;&lt;</span><span class="constant">END_OF_MESSAGE</span><span class="string">
88
+ From: Your Name &lt;your@mail.address&gt;
89
+ Newsgroups: news.group.one, news.group.two ...
90
+ Subject: test message
91
+ Date: <span class="expr">#{date}</span>
92
+
93
+ This is a test message.
94
+ END_OF_MESSAGE
95
+
96
+ require 'rubygems'
97
+ require 'nntp'
98
+ Net::NNTP.start('your.nntp.server', 119) do |nntp|
99
+ nntp.post msgstr
100
+ end<span class="normal">
101
+ </span></span></pre></p>
102
+
103
+
104
+ <p><span class="caps">NOTE</span>: The <span class="caps">NNTP</span> message headers such as <code>Date:</code>, <code>Message-ID:</code>, and <code>Path:</code>, if ommited, may automatically be added by your Usenet news server; however, it is best not to rely on this behavior.</p>
105
+
106
+
107
+ <h3>Reading Messages</h3>
108
+
109
+
110
+ <p>This snippet will display all subject lines within a particular news group.</p>
111
+
112
+
113
+ <p><pre class='syntax'>
114
+ <span class="ident">require</span> <span class="punct">'</span><span class="string">rubygems</span><span class="punct">'</span>
115
+ <span class="ident">require</span> <span class="punct">'</span><span class="string">nntp</span><span class="punct">'</span>
116
+
117
+ <span class="ident">newsgroup</span> <span class="punct">=</span> <span class="punct">'</span><span class="string">comp.lang.ruby</span><span class="punct">'</span>
118
+
119
+ <span class="constant">Net</span><span class="punct">::</span><span class="constant">NNTP</span><span class="punct">.</span><span class="ident">start</span><span class="punct">('</span><span class="string">your.nntp.server</span><span class="punct">',</span> <span class="number">119</span><span class="punct">)</span> <span class="keyword">do</span> <span class="punct">|</span><span class="ident">nntp</span><span class="punct">|</span>
120
+ <span class="ident">message_ids</span> <span class="punct">=</span> <span class="ident">nntp</span><span class="punct">.</span><span class="ident">listgroup</span><span class="punct">(</span><span class="ident">newsgroup</span><span class="punct">)</span>
121
+ <span class="ident">message_ids</span><span class="punct">[</span><span class="number">1</span><span class="punct">].</span><span class="ident">each</span> <span class="keyword">do</span> <span class="punct">|</span><span class="ident">id</span><span class="punct">|</span>
122
+ <span class="ident">nntp</span><span class="punct">.</span><span class="ident">head</span><span class="punct">(</span><span class="ident">id</span><span class="punct">).</span><span class="ident">each</span> <span class="keyword">do</span> <span class="punct">|</span><span class="ident">header</span><span class="punct">|</span>
123
+ <span class="ident">header</span><span class="punct">.</span><span class="ident">each</span> <span class="punct">{</span> <span class="punct">|</span><span class="ident">line</span><span class="punct">|</span> <span class="ident">puts</span><span class="punct">(</span><span class="ident">line</span><span class="punct">)</span> <span class="keyword">if</span> <span class="ident">line</span><span class="punct">.</span><span class="ident">index</span><span class="punct">('</span><span class="string">Subject:</span><span class="punct">')</span> <span class="punct">}</span>
124
+ <span class="keyword">end</span>
125
+ <span class="keyword">end</span>
126
+ <span class="keyword">end</span>
127
+ </pre></p>
128
+
129
+
130
+ <h3>Closing the Session</h3>
131
+
132
+
133
+ <p>You <span class="caps">MUST</span> close the <span class="caps">NNTP</span> session after posting messages by calling the Net::NNTP#finish method:</p>
134
+
135
+
136
+ <p><pre class='syntax'>
137
+ <span class="comment"># using NNTP#finish</span>
138
+ <span class="ident">nntp</span> <span class="punct">=</span> <span class="constant">Net</span><span class="punct">::</span><span class="constant">NNTP</span><span class="punct">.</span><span class="ident">start</span><span class="punct">('</span><span class="string">your.nntp.server</span><span class="punct">',</span> <span class="number">119</span><span class="punct">)</span>
139
+ <span class="ident">nntp</span><span class="punct">.</span><span class="ident">post</span> <span class="ident">msgstr</span>
140
+ <span class="ident">nntp</span><span class="punct">.</span><span class="ident">finish</span>
141
+ </pre></p>
142
+
143
+
144
+ <p>You can also use the block form of <span class="caps">NNTP</span>.start/NNTP#start. This closes the <span class="caps">NNTP</span> session automatically:</p>
145
+
146
+
147
+ <p><pre class='syntax'>
148
+ <span class="comment"># using block form of NNTP.start</span>
149
+ <span class="constant">Net</span><span class="punct">::</span><span class="constant">NNTP</span><span class="punct">.</span><span class="ident">start</span><span class="punct">('</span><span class="string">your.nntp.server</span><span class="punct">',</span> <span class="number">119</span><span class="punct">)</span> <span class="keyword">do</span> <span class="punct">|</span><span class="ident">nntp</span><span class="punct">|</span>
150
+ <span class="ident">nntp</span><span class="punct">.</span><span class="ident">post</span> <span class="ident">msgstr</span>
151
+ <span class="keyword">end</span>
152
+ </pre></p>
153
+
154
+
155
+ <p>We strongly recommend the latter scheme since it is simpler and more robust.</p>
156
+
157
+
158
+ <h3><span class="caps">NNTP</span> Authentication</h3>
159
+
160
+
161
+ <p>The Net::NNTP class may support various authentication schemes depending on your news server‘s reponse to <span class="caps">CAPABILITIES</span> command. To use <span class="caps">NNTP</span> authentication, pass extra arguments to <span class="caps">NNTP</span>.start/NNTP#start.</p>
162
+
163
+
164
+ <p>See <a href="http://www.ietf.org/internet-drafts/draft-ietf-nntpext-authinfo-07.txt"><span class="caps">NNTP</span> Extension for Authentication</a>.</p>
165
+
166
+
167
+ <p><pre class='syntax'>
168
+ <span class="constant">Net</span><span class="punct">::</span><span class="constant">NNTP</span><span class="punct">.</span><span class="ident">start</span><span class="punct">('</span><span class="string">your.nntp.server</span><span class="punct">',</span> <span class="number">119</span><span class="punct">,</span>
169
+ <span class="punct">'</span><span class="string">YourAccountName</span><span class="punct">',</span> <span class="punct">'</span><span class="string">YourPassword</span><span class="punct">',</span> <span class="symbol">:method</span><span class="punct">)</span>
170
+ </pre></p>
171
+
172
+
173
+ <p>Where <code>:method</code> can be one of ‘gassapi’, ‘digest_md5’, ‘cram_md5’, ‘starttls’, ‘external’, ‘plain’, ‘generic’, ‘simple’ or ‘original’.</p>
174
+
175
+
176
+ <p>In the case of method <code>:generic</code>, arguments should be passed to a format string as follows:</p>
177
+
178
+
179
+ <p><pre class='syntax'>
180
+ <span class="constant">Net</span><span class="punct">::</span><span class="constant">NNTP</span><span class="punct">.</span><span class="ident">start</span><span class="punct">('</span><span class="string">your.nntp.server</span><span class="punct">',</span> <span class="number">119</span><span class="punct">,</span>
181
+ <span class="punct">&quot;</span><span class="string">format</span><span class="punct">&quot;,</span> <span class="punct">*</span><span class="ident">arguments</span><span class="punct">,</span> <span class="symbol">:generic</span><span class="punct">)</span>
182
+ </pre></p>
183
+
184
+
185
+ <p><span class="caps">NOTE</span>: With the exception of <code>:generic</code>, the authentication mechanism will fallback to a less secure scheme if your Usenet server does not support the method you selected.</p>
186
+
187
+
188
+ <h2>How to Submit Patches</h2>
189
+
190
+
191
+ <ul>
192
+ <li>Read the <a href="http://drnicwilliams.com/2007/06/01/8-steps-for-fixing-other-peoples-code/">8 steps for fixing other people&#8217;s code</a>.</li>
193
+ <li>The trunk repository is <code>svn://rubyforge.org/var/svn/nntp/trunk</code> for anonymous access.</li>
194
+ <li>You can upload your patch to the &#8220;Patches&#8221; section of the <a href="http://rubyforge.org/projects/nntp">project info page</a>.</li>
195
+ </ul>
196
+
197
+
198
+ <h2>License</h2>
199
+
200
+
201
+ <p>This code is free to use under the terms of version 2.1 of the <span class="caps">GNU</span> Lesser General Public License.</p>
202
+
203
+
204
+ <h2>Donate</h2>
205
+
206
+
207
+ Any contribution of yours, however small it may be, will highly be appreciated and used for further development of this and other F/LOSS (Free/Libre Open Source Software) Projects.
208
+ <form action="https://www.paypal.com/cgi-bin/webscr" method="post">
209
+ <input type="hidden" name="cmd" value="_xclick" />
210
+ <input type="hidden" name="business" value="bsd@rubyforge.org" />
211
+ <input type="image" src="https://www.paypal.com/en_US/i/logo/PayPal_mark_37x23.gif" style="border:0" name="submit" alt="[ Make payments with PayPal -it's fast, free and secure! ]" title="Please do donate to keep this project alive!" />
212
+ </form>
213
+
214
+ <h2>Documentation</h2>
215
+
216
+
217
+ <p>In addition to this page, you can also view the automatically generated RDocs in the &#8220;DocManager: Project Documentation&#8221;
218
+ section of the <a href="http://rubyforge.org/projects/nntp">project info page</a>. If you elect to install the RI documentation
219
+ when you install the gem, you can afterwards issue the following command for the <span class="caps">API</span> reference:</p>
220
+
221
+
222
+ <code>
223
+ ri Net::NNTP
224
+ </code>
225
+
226
+ <h2>Similar Gems</h2>
227
+
228
+
229
+ <p>Anton Bangratz&#8217;s <a href="http://rubyforge.org/projects/ruby-net-nntp/">ruby-net-nntp</a></p>
230
+
231
+
232
+ <h2>Credits</h2>
233
+
234
+
235
+ <ul>
236
+ <li><a href="http://rubyforge.org/">RubyForge</a> – hosting and project management</li>
237
+ <li><a href="http://newgem.rubyforge.org/">newgem</a> &#8211; new gem generator</li>
238
+ </ul>
239
+
240
+
241
+ <h2>Where to get help</h2>
242
+
243
+
244
+ <p>If you need assistance with this gem, visit the <a href="http://rubyforge.org/projects/nntp">project info page</a> to file a bug, make a support request, or suggest a new feature.</p>
245
+ <p class="coda">
246
+ Albert Vernon, 2nd January 2008<br>
247
+ Theme extended from <a href="http://rb2js.rubyforge.org/">Paul Battley</a>
248
+ </p>
249
+ </div>
250
+
251
+ <!-- insert site tracking codes here, like Google Urchin -->
252
+
253
+ </body>
254
+ </html>
data/website/index.txt ADDED
@@ -0,0 +1,163 @@
1
+ h1. Net::NNTP Client Library
2
+
3
+ h1. &#x2192; 'nntp'
4
+
5
+
6
+ h2. What
7
+
8
+ This gem allows you to to retrieve and post Usenet news articles via NNTP, the Network News Transfer Protocol. For details of NNTP itself, see "RFC977":http://www.ietf.org/rfc/rfc977.txt.
9
+
10
+ This library does NOT provide functions to compose Usenet news articles. You must create and format them yourself per Standard for Interchange of Usenet Messages. See "RFC850":http://www.ietf.org/rfc/rfc850.txt, "RFC2047":http://www.ietf.org/rfc/rfc2047.txt.
11
+
12
+ h2. Installing
13
+
14
+ <pre syntax="ruby">sudo gem install nntp</pre>
15
+
16
+ Alternatively, you may download the gem from the "project info page":http://rubyforge.org/projects/nntp and install manually.
17
+
18
+ h2. The basics
19
+
20
+ h3. Posting Messages
21
+
22
+ You must open a connection to a NNTP server before posting messages. The first argument is the address of your NNTP server, and the second argument is the port number. Using NNTP.start with a block is the simplest way to do this because the NNTP connection closes automatically after the block executes.
23
+
24
+ <pre syntax="ruby">
25
+ require 'rubygems'
26
+ require 'nntp'
27
+ Net::NNTP.start('your.nntp.server', 119) do |nntp|
28
+ # Use the NNTP object nntp only in this block.
29
+ end
30
+ </pre>
31
+
32
+ Replace ‘your.nntp.server’ with your NNTP server. Normally your systems administrator or internet service provider supplies a server for you.
33
+
34
+ Then you can post messages.
35
+
36
+ <pre syntax="ruby">
37
+ require 'date'
38
+ date = DateTime.now().strftime(fmt='%a, %d %b %Y %T %z')
39
+
40
+ msgstr = <<END_OF_MESSAGE
41
+ From: Your Name <your@mail.address>
42
+ Newsgroups: news.group.one, news.group.two ...
43
+ Subject: test message
44
+ Date: #{date}
45
+
46
+ This is a test message.
47
+ END_OF_MESSAGE
48
+
49
+ require 'rubygems'
50
+ require 'nntp'
51
+ Net::NNTP.start('your.nntp.server', 119) do |nntp|
52
+ nntp.post msgstr
53
+ end
54
+ </pre>
55
+
56
+ NOTE: The NNTP message headers such as @Date:@, @Message-ID:@, and @Path:@, if ommited, may automatically be added by your Usenet news server; however, it is best not to rely on this behavior.
57
+
58
+ h3. Reading Messages
59
+
60
+ This snippet will display all subject lines within a particular news group.
61
+
62
+ <pre syntax="ruby">
63
+ require 'rubygems'
64
+ require 'nntp'
65
+
66
+ newsgroup = 'comp.lang.ruby'
67
+
68
+ Net::NNTP.start('your.nntp.server', 119) do |nntp|
69
+ message_ids = nntp.listgroup(newsgroup)
70
+ message_ids[1].each do |id|
71
+ nntp.head(id).each do |header|
72
+ header.each { |line| puts(line) if line.index('Subject:') }
73
+ end
74
+ end
75
+ end
76
+ </pre>
77
+
78
+ h3. Closing the Session
79
+
80
+ You MUST close the NNTP session after posting messages by calling the Net::NNTP#finish method:
81
+
82
+ <pre syntax="ruby">
83
+ # using NNTP#finish
84
+ nntp = Net::NNTP.start('your.nntp.server', 119)
85
+ nntp.post msgstr
86
+ nntp.finish
87
+ </pre>
88
+
89
+ You can also use the block form of NNTP.start/NNTP#start. This closes the NNTP session automatically:
90
+
91
+ <pre syntax="ruby">
92
+ # using block form of NNTP.start
93
+ Net::NNTP.start('your.nntp.server', 119) do |nntp|
94
+ nntp.post msgstr
95
+ end
96
+ </pre>
97
+
98
+ We strongly recommend the latter scheme since it is simpler and more robust.
99
+
100
+ h3. NNTP Authentication
101
+
102
+ The Net::NNTP class may support various authentication schemes depending on your news server‘s reponse to CAPABILITIES command. To use NNTP authentication, pass extra arguments to NNTP.start/NNTP#start.
103
+
104
+ See "NNTP Extension for Authentication":http://www.ietf.org/internet-drafts/draft-ietf-nntpext-authinfo-07.txt.
105
+
106
+ <pre syntax="ruby">
107
+ Net::NNTP.start('your.nntp.server', 119,
108
+ 'YourAccountName', 'YourPassword', :method)
109
+ </pre>
110
+
111
+ Where @:method@ can be one of ‘gassapi’, ‘digest_md5’, ‘cram_md5’, ‘starttls’, ‘external’, ‘plain’, ‘generic’, ‘simple’ or ‘original’.
112
+
113
+ In the case of method @:generic@, arguments should be passed to a format string as follows:
114
+
115
+ <pre syntax="ruby">
116
+ Net::NNTP.start('your.nntp.server', 119,
117
+ "format", *arguments, :generic)
118
+ </pre>
119
+
120
+ NOTE: With the exception of @:generic@, the authentication mechanism will fallback to a less secure scheme if your Usenet server does not support the method you selected.
121
+
122
+
123
+ h2. How to Submit Patches
124
+
125
+ * Read the "8 steps for fixing other people's code":http://drnicwilliams.com/2007/06/01/8-steps-for-fixing-other-peoples-code/.
126
+ * The trunk repository is <code>svn://rubyforge.org/var/svn/nntp/trunk</code> for anonymous access.
127
+ * You can upload your patch to the "Patches" section of the "project info page":http://rubyforge.org/projects/nntp.
128
+
129
+ h2. License
130
+
131
+ This code is free to use under the terms of version 2.1 of the GNU Lesser General Public License.
132
+
133
+ h2. Donate
134
+
135
+ Any contribution of yours, however small it may be, will highly be appreciated and used for further development of this and other F/LOSS (Free/Libre Open Source Software) Projects.
136
+ <form action="https://www.paypal.com/cgi-bin/webscr" method="post">
137
+ <input type="hidden" name="cmd" value="_xclick" />
138
+ <input type="hidden" name="business" value="bsd@rubyforge.org" />
139
+ <input type="image" src="https://www.paypal.com/en_US/i/logo/PayPal_mark_37x23.gif" style="border:0" name="submit" alt="[ Make payments with PayPal -it's fast, free and secure! ]" title="Please do donate to keep this project alive!" />
140
+ </form>
141
+
142
+ h2. Documentation
143
+
144
+ In addition to this page, you can also view the automatically generated RDocs in the "DocManager: Project Documentation"
145
+ section of the "project info page":http://rubyforge.org/projects/nntp. If you elect to install the RI documentation
146
+ when you install the gem, you can afterwards issue the following command for the API reference:
147
+
148
+ <code>
149
+ ri Net::NNTP
150
+ </code>
151
+
152
+ h2. Similar Gems
153
+
154
+ Anton Bangratz's "ruby-net-nntp":http://rubyforge.org/projects/ruby-net-nntp/
155
+
156
+ h2. Credits
157
+
158
+ * "RubyForge":http://rubyforge.org/ – hosting and project management
159
+ * "newgem":http://newgem.rubyforge.org/ - new gem generator
160
+
161
+ h2. Where to get help
162
+
163
+ If you need assistance with this gem, visit the "project info page":http://rubyforge.org/projects/nntp to file a bug, make a support request, or suggest a new feature.