CVS log for net-qmtp/Net/QMTP/QMTP.pm

Up to [Local Repository] / net-qmtp / Net / QMTP

Request diff between arbitrary revisions

Keyword substitution: kv
Default branch: MAIN

Take advantage of the latest ExtUtils::MakeMaker/META.yml stuff to fix
  some CPANTS/Kwalitee "problems".

Bump version number for new release.

Read from network socket and message file in "binary" mode otherwise
  automatic CRLF<->LF translation stuffs up the module on Win/Dos. Patch
  supplied by Paul G. Weiss. Thanks!

Release version 0.05.

Use netstring_read() from Text::Netstring 0.04 thereby trimming
   _read_netstring() significantly and dumping _getlen() and _getcomma()

Dump &_list_as_netstring(). It's no longer needed, having been
  superceeded by Text::Netstring.
Note requirement for Text::Netstring.
Avoid multiple calls to netstring_encode() for the same value.

Use the Text::Netstring module and use its encoding function for
  scalar encoding.
Remove &_as_netstring()

POD improvements.

Rename Timeout constructor option to ConnectTimeout.
Fix read() handling to work with IO::Socket errors and catch an
  eof properly.
Don't need a newline for confess.

Note message() vs. message_from_file() restriction.

Protocol imposes a one hour limit on a QMTP session. Add support for this
  but it's not enabled yet; _session_notexpired().
Print the length of time our socket was connected for in debugging
  output.
Don't check for existence of file in message_from_file() - user can
  delay creating the file if desired. Only need exist when send() is called.
Only get file size in _send_file if open succeeded. Use stat on the file
  handle. Count bytes as we read to check that file size hasn't changed
  while reading.
Fix bug in _send_file() which caused it to print the IO::Socket reference
  instead of printing _to_ the IO::Socket reference.
Update documentation, noting need to disconnect if send() fails. Other
  fixes and text improvements.
Check for 'defined' vs. FALSE in read() in _read_netstring().

Reponse doesn't begin with D, K or Z; die with a protocol violation.

host() method renamed to server()
New constructor option; Port, to connect to non-standard port.
Extra debugging output.
timeout() from IO::Socket doesn't seem to work. Hmm. Use a
  conditional with different IO::Socket constructors.
reconnect() will disconnect if necessary before connecting again.
Empty message bodies are OK - fixed test in _ready_to_send().
PODify changed reconnect() and renamed host() and minor clean-ups.

Implement user-configureable socket timeout through constructor
  Timeout option.
Rename ManualConnect to DeferConnect.
PODify the above.
Blank (i.e. defined, but empty) message bodies should be OK'd by
  _ready_to_send.
Amend some debug output.
Clean-up some inappropriate use of C<> in POD.

Copious amounts of debugging output added.
ManualConnect option to new() was interpreted in reverse.
Destructor shouldn't call disconnect() if we're not connected.

Update VERSION to 0.02.

Write BUGS in sentances.
Remove some trailing whitespace in comments and POD.
Scrub no-auto-connect from the TODO - it's done.

Have a once over to check usage of die vs. croak vs. carp vs. confess.
  Change many. Replace die's with 'return undef'.
Have new() accept options in hash key pairs.
Option to new(): ManualConnect - delay connection until explicit
  call to reconnect().
Option to new(): Debug - enable debugging. NOOP at present.
Don't waste time calling new_{envelope,message} in new().
Replace most || with 'or'.
Warn if asked to _send_file an empty file, and fail if size is seemingly
  negative.
Rename connect() to reconnect() to avoid mixup with perl's connect().
_ready_to_send() to check we have enough to attempt sending the
   message.
_read_netstring() to read a netstring at a time.
Fail on protocol errors -- bad netstrings.
Fail on huge netstring sizes -- 200000000 bytes.
Add destructor to ensure we call disconnect().
Reword, fix typos in POD. Document new user methods. Add EXAMPLES.
Move TODO comments in BUGS POD section.

&new_message() and &new_envelope() to trash the message/message-file and
  envelope info respectively.
&connect() and &disconnect() to make socket creation/destruction not
  hooked to object creation/destruction.
Add a DESTROY sub to make sure we &disconnect().

Gah - hate that RCS Revision parsing.

Add CAVEATS to draw attention to the importance of encodings.
Tidy up some of the POD.

Write out POD for the module.
Add &message_from_file() and &_send_file() to allow files to be used
  as complete message bodies.
Add &encoding() to manipulate line-ending encoding.
Add &host() to manipulate the QMTP server we use.
Prevent &message() and &message_from_file() from trampliing on each other.

Initial commit.