ruby-net-nntp 0.2.2 → 1.0.0

data/CHANGELOG

@@ -1,177 +1,194 @@
-2008-01-17 15:01 +0100  Anton 'tony' Bangratz  <tony@twincode.net>  (e2a61a62dc59 [tip])
+2008-06-04  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>
 
-	* .autotest, README, lib/net/nntp.rb, lib/net/nntp/version.rb, tags,
-	test/functional/test_nntp.rb, test/mock/mock_socket.rb:
-	doc fix, connected? method, code coverage
+	* fixed packaging tasks
 
-	 * added some documentation, fixed doc error for 'raw'
-	response
-		* added acknowledgments to documentation
-		* added connected? method
-		* added more tests for better coverage
+2008-06-02  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>
 
-2007-11-19 12:12 +0100  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>  (75b6c0f1fefa)
+	* branch merges
 
-	* lib/net/nntp/article.rb, lib/net/nntp/version.rb, tags,
-	test/unit/test_nntp_article.rb:
-	Bugfix release
+	* streamlined process request - asks responses more, no more case
+	based on classes
 
-	 - fixed header parsing, closing #2
-		- fixed body parsing bug, closing #4
+	* merged stuff in
 
-2007-08-22 17:00 +0200  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>  (1eb71d8b00b4)
+2008-06-02  Jürgen Strobel  <strobel@inqnet.at>
 
-	* lib/net/nntp.rb, lib/net/nntp/version.rb,
-	test/functional/test_nntp.rb:
-	added newnews command, response_timeout (used only in xover at the
-	moment)
+	* Ensure close after block given to ctor.
 
-	 * added newnews command
-		* added response_timeout variable
-		* patched xover to use response_timeout variable instead of static
-	value
+2008-06-02  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>
 
-2007-08-03 17:56 +0200  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>  (e54f52f53711)
+	* streamlinging processing requests: Authinfo, Post, Ihave
 
-	* lib/net/nntp.rb, lib/net/nntp/article.rb, lib/net/nntp/version.rb:
-	fixed encoding and header parsing bugs
-		* lib/net/nntp.rb: fixed encoding ('..') of lines on
-	fetching
-		* lib/net/nntp/article.rb: fixed header parsing regexp
+	* removed gtk and notify stuff from .autotest
 
-2007-07-14 12:22 +0200  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>  (5de9968582e9)
+	* added connection closing, Quit and reconnect behaviour
 
-	* README, lib/net/nntp.rb, lib/net/nntp/article.rb,
-	lib/net/nntp/group.rb, lib/net/nntp/version.rb,
-	test/mock/mock_socket.rb, test/unit/test_nntp_article.rb,
-	test/unit/test_nntp_group.rb:
-	NNTP can QUIT, Article redesign: parse HEAD, BODY and ARTICLE,
-	renamed 'id' to 'number', headers and body along with proxies added
-		- added QUIT to Net::NNTP
-		- added parse from HEAD, BODY and ARTICLE to Net::NNTP::Article
-	(factory)
-		- redesigned Net::NNTP::Article: + separate headers
-	and body attributes + including proxies to mimick
-	old attributes, deprecated + renamed the conflicting
-	'id' attribute to 'number'
-		- improved documentation
+	* small bug fixes, posting processing redone
 
-2007-07-09 14:34 +0200  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>  (d97d95ec735b)
+2008-05-31  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>
 
-	* lib/net/nntp.rb, lib/net/nntp/article.rb, lib/net/nntp/group.rb,
-	lib/net/nntp/version.rb, lib/net/nntp_article.rb,
-	lib/net/nntp_group.rb, test/functional/test_nntp.rb,
-	test/mock/mock_socket.rb:
-	fixed overview.fmt, fixed logging
-		- fixed overview.fmt bug
-		- fixed logging for autotest/test
+	* fixed major bug (CRLF instead of LF (system-dependant)
 
-2007-07-02 21:35 +0200  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>  (5ba29ac12969)
+2008-05-28  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>
 
-	* lib/net/nntp/version.rb:
-	new release;version fix
+	* removed unused code
 
-2007-07-02 21:34 +0200  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>  (8441de3d244d)
+	* added post and ihave specs and proxies
 
-	* lib/net/nntp.rb:
-	bugfix read_response multiline read - introduced with last release
+2008-05-27  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>
 
-2007-07-02 20:51 +0200  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>  (4399451e92c0)
+	* more documentation
 
-	* lib/net/nntp/version.rb:
-	Release 0.0.8, fixed version
+	* added more proxies for old functionality - will still break old
+	code.
 
-2007-07-02 20:50 +0200  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>  (c65d5217aa31)
+2008-05-24  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>
 
-	* lib/net/nntp.rb, lib/net/nntp_article.rb, lib/net/nntp_group.rb,
-	test/functional/test_nntp.rb, test/mock/mock_socket.rb,
-	test/unit/test_nntp_group.rb:
-	fixed tests, fixed tabs, fixed xhdr bug and api, fixed chomping of
-	results
+	* added command proxies for list, next, last, group; fixed
+	documentation; fixed ListInformationFollows and GroupListResponse
 
-2007-07-02 17:15 +0200  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>  (6fe65b246b19)
+2008-05-21  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>
 
-	* lib/net/nntp/version.rb:
-	new version; new release
+	* more documentation added
 
-2007-07-02 17:14 +0200  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>  (0ec007283eb8)
+	* fixed more documentation, fixed DateResponse
 
-	* lib/net/nntp.rb:
-	bugfixes: read_response response detection only on first line,
-	listgroup accepting no group (error if none selected)
+	* fixed some documentation, got rid of body_proc, using body now.
 
-2007-07-02 16:25 +0200  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>  (a75e65c0e31c)
+2008-05-20  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>
 
-	* lib/net/nntp.rb, lib/net/nntp/version.rb:
-	xover and log bugfix
+	* code and doc cleanup, new NNTP#help method
 
-2007-07-02 15:57 +0200  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>  (d6c2c8c99d26)
+	* changelog changes
 
-	* .autotest, .hgignore, Rakefile, lib/net/nntp.rb,
-	lib/net/nntp/version.rb, lib/net/nntp_article.rb, script/console,
-	test/functional/test_nntp.rb:
-	added logging (log4r), fixed article, refactored read_response and
-	depending methods
-		- added Log4r dependency and logging stub, added dependency to
-	Rakefile gem build process
-		- fixed article: added 'from' attribute reader
-		- refactored read_response: changed methods to use read_response and
-	added intelligent one- and multi-line sensing (including
-	force parameter, thanks to NNTP response 211)
+2008-05-19  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>
+
+	* handling changes
+
+2008-05-18  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>
+
+	* all responses implemented, removed deprecated requests
+
+2008-05-17  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>
+
+	* some more responses added
+
+2008-05-15  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>
+
+	* added code 224
+
+	* added codes 220-223 (article responses)
+
+2008-05-13  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>
+
+	* changed spec directory layout for autotest
+
+	* more options, added libnotify stuff to .autotest
+
+	* renamed NNTP::Request class, added first responses, bumped version
+	up
+
+	* changed specs, fleshed out specs, changed behaviour of request
+	classes
+
+2008-05-12  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>
+
+	* added changelog for rake satisfaction
+
+2008-05-11  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>
+
+	* added documentation and completed requests
+
+	* first steps towards oop interface
+
+2008-05-10  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>
+
+	* more small changes
+
+	* small changes for specs
+
+2008-05-05  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>
 
-2007-06-28 17:11 +0200  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>  (43d551bd69a3)
+	* introducing rspec and bones layout
 
-	* Rakefile, lib/net/nntp.rb, lib/net/nntp/version.rb:
-	moved version to separate file
+	* Added tag release-0.2.2 for changeset e2a61a62dc59
 
-2007-06-28 17:02 +0200  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>  (650cf04a9829)
+	* Added tag release-0.2.1 for changeset 75b6c0f1fefa
 
-	* lib/net/nntp.rb, lib/net/nntp_article.rb:
-	fixed bug in article overview parser
+	* Added tag release-0.2.0 for changeset 1eb71d8b00b4
 
-2007-06-28 14:58 +0200  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>  (8e4738703032)
+	* Added tag release-0.1.1 for changeset e54f52f53711
 
-	* .hgtags:
-	Added tag release-0.0.3 for changeset 215be61f9524
+	* Added tag release-0.1.0 for changeset 5de9968582e9
+
+2008-01-17  Anton 'tony' Bangratz  <tony@twincode.net>
+
+	* doc fix, connected? method, code coverage
+
+2007-11-19  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>
+
+	* Bugfix release
+
+2007-08-22  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>
+
+	* added newnews command, response_timeout (used only in xover at the
+	moment)
+
+2007-08-03  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>
+
+	* fixed encoding and header parsing bugs
+
+2007-07-14  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>
+
+	* NNTP can QUIT, Article redesign: parse HEAD, BODY and ARTICLE,
+	renamed 'id' to 'number', headers and body along with
+
+2007-07-09  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>
+
+	* fixed overview.fmt, fixed logging
+
+2007-07-02  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>
+
+	* new release;version fix
+
+	* bugfix read_response multiline read - introduced with last release
+
+	* Release 0.0.8, fixed version
+
+	* fixed tests, fixed tabs, fixed xhdr bug and api, fixed chomping of
+	results
+
+	* new version; new release
+
+	* bugfixes: read_response response detection only on first line,
+	listgroup accepting no group (error if none selected)
+
+	* xover and log bugfix
+
+	* added logging (log4r), fixed article, refactored read_response and
+	depending methods
 
-2007-06-28 14:57 +0200  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>  (215be61f9524 [release-0.0.3])
+2007-06-28  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>
 
-	* Rakefile:
-	fixed version usage for Pallet task
+	* moved version to separate file
 
-2007-06-28 14:52 +0200  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>  (96257e85a815)
+	* fixed bug in article overview parser
 
-	* lib/net/nntp.rb, tags:
-	branch merge from tests, added documentation, added nntp.close
+	* Added tag release-0.0.3 for changeset 215be61f9524
 
-2007-06-28 14:34 +0200  Anton 'tony' Bangratz  <anton.bangratz@gmail.com>  (1ca49077563a)
+	* fixed version usage for Pallet task
 
-	* lib/net/nntp.rb, script/console, tags:
-	bugfix for last, next, xover, grouplist
-		- last and next commands don't hang anymore
-		- xover doesn't hang and can be called without parameters, or with
-	groupname only
-		- grouplist actually returns data
+	* branch merge from tests, added documentation, added nntp.close
 
-2007-05-21 11:16 +0200  Anton 'tony' Bangratz  <tony@twincode.net>  (168baa3c37eb)
+	* bugfix for last, next, xover, grouplist
 
-	* lib/net/nntp.rb, tags, test/functional/test_nntp.rb,
-	test/mock/mock_socket.rb:
-	- added more tests for over/xover
-	- completed help (mock)
-	- added dummy functions for over/xover selections
+2007-05-21  Anton 'tony' Bangratz  <tony@twincode.net>
 
-2007-05-17 08:09 +0200  Anton 'tony' Bangratz  <tony@twincode.net>  (702e55388bb4)
+	* - added more tests for over/xover
 
-	* .hgtags:
-	tags fix
+2007-05-17  Anton 'tony' Bangratz  <tony@twincode.net>
 
-2007-05-17 08:00 +0200  Anton 'tony' Bangratz  <tony@twincode.net>  (63ed2815f13f)
+	* tags fix
 
-	* .autotest, .hgignore, .hgtags, .in.vim, MIT-LICENSE, README,
-	Rakefile, lib/net/nntp.rb, lib/net/nntp_article.rb,
-	lib/net/nntp_group.rb, tags, test/functional/test_nntp.rb,
-	test/mock/mock_socket.rb, test/unit/test_nntp_article.rb,
-	test/unit/test_nntp_group.rb:
-	Safe commit
+	* Safe commit
 

data/CHANGELOG.debian

@@ -0,0 +1,5 @@
+libruby-nntp (1.0.0) unstable; urgency=low
+
+  * Update release. Replaces ruby-net-nntp.
+
+ -- Anton Bangratz <anton.bangratz@gmail.com>  Tue, 03 Jun 2008 14:23:56 +0200

data/Manifest.txt

@@ -0,0 +1,37 @@
+CHANGELOG
+CHANGELOG.debian
+MIT-LICENSE
+Manifest.txt
+README.txt
+Rakefile
+build-stamp
+lib/net/nntp.rb
+lib/net/nntp/request.rb
+lib/net/nntp/response.rb
+lib/net/nntp/version.rb
+script/console
+spec/net/nntp/request_spec.rb
+spec/net/nntp/response_spec.rb
+spec/net/nntp_spec.rb
+spec/spec.opts
+spec/spec_helper.rb
+spec/stories/all.rb
+spec/stories/helper.rb
+spec/stories/net/nntp.rb
+spec/stories/net/nntp.story
+spec/stories/steps/nntp.rb
+tasks/ann.rake
+tasks/bones.rake
+tasks/gem.rake
+tasks/git.rake
+tasks/manifest.rake
+tasks/mercurial.rake
+tasks/notes.rake
+tasks/pallet.rake
+tasks/post_load.rake
+tasks/rdoc.rake
+tasks/rubyforge.rake
+tasks/setup.rb
+tasks/spec.rake
+tasks/svn.rake
+tasks/test.rake

data/README.txt

@@ -0,0 +1,69 @@
+ruby-net-nntp
+	by Anton Bangratz <anton.bangratz@gmail.com>
+
+== DESCRIPTION
+
+The Net::NNTP library provides a simple communication layer for the NNTP (Network News Transfer Protocol).
+
+== FEATURES
+
+The Net::NNTP library provides a communication layer in Net::HTTP style for NNTP.
+
+
+== SYNOPSIS
+
+Net::NNTP uses a simple interface to wrap commands to communicate with an NNTP server.
+
+=== Example
+
+  nntp = Net::NNTP.new
+  nntp.server = 'localhost' # also default
+  nntp.port = 119           # default port
+  welcome = nntp.connect
+  if OKResponse === welcome
+    # set mode reader
+    request = Net::NNTP::Modereader
+    response = nntp.process(request)
+    if PostingAllowed === response
+      File.open('message', r) {|f|
+        request = Net::NNTP::Post
+        request.body = f
+        response = nntp.process(request)
+        case response
+        when ArticleReceived
+          #everything ok, go on ..
+        when PostingNotPermitted
+          # inform user
+        when PostingFailed
+          # delay and retry?
+          ...
+          response = nntp.process(nntp.last_response.request)
+        end
+      }
+    end
+  end
+
+
+
+== INSTALL
+
+* sudo gem install ruby-net-nntp or
+* sudo dpkg -r libruby-nntp_1.0.0_all.deb
+
+= CHANGES
+
+
+Version 0.2.x introduces a more complete API and bugfixes.
+
+Version 0.1.0 introduces the Net::NNTP::Article#headers and #body attributes. 
+Due to this, the attribute Net::NNTP::Article#id has been changed to Net::NNTP::Article#number 
+to avoid conflicts with Object#id.
+
+Additionally, on request, Net::NNTP::Article has been changed from being a mere proxy for Net::NNTP#xover
+result lines to being able to parse HEAD, BODY and ARTICLE results and return a corresponding instance.
+
+== Acknowledgments
+
+Thanks to Ward Bekker and Geff Hanoian for finding and fixing bugs and providing me with useful hints and enhancements.
+Thanks to Jürgen Strobel for providing support and hosting of the code libraries and bug tracking system. Thanks to Tom
+Copeland and Rich Kilmer for rubyforge, and big thanks to Matz and everyone of the core team for Ruby.

data/Rakefile

@@ -0,0 +1,28 @@
+# Look in the tasks/setup.rb file for the various options that can be
+# configured in this Rakefile. The .rake files in the tasks directory
+# are where the options are used.
+
+load 'tasks/setup.rb'
+
+ensure_in_path 'lib'
+require 'net/nntp'
+
+task :default => 'spec:run'
+
+PROJ.name = 'ruby-net-nntp'
+PROJ.authors = "Anton 'tony' Bangratz"
+PROJ.email = 'anton.bangratz@gmail.com'
+PROJ.url = 'http://rubyforge.org/projects/ruby-net-nntp'
+PROJ.rubyforge.name = 'ruby-net-nntp'
+PROJ.history_file = 'CHANGELOG'
+PROJ.readme_file = 'README.txt'
+PROJ.version = Net::NNTP::VERSION
+PROJ.exclude += %w(^\. ^tags ^debian/ ^logs/ ^coverage.info )
+PROJ.gem.dependencies = %w(tmail log4r)
+
+PROJ.spec.opts << '--color'
+PROJ.rdoc.include = %w(^lib/ ^bin/ ^ext/ .txt$ ^CHANGELOG$)
+PROJ.rdoc.opts = %w(-S -M -N)
+PROJ.ruby_opts = []
+
+# EOF