Release share v0.51.0 (2023-12-06)v0.51.0

=== New features

* lib/http: implement Server-Sent Events (SSE)
* lib/net: add method Read
* lib/crypto: add support for reading passphrase using SSH_ASKPASS
* lib/memfs: add method JSON to Node

=== Enhancements

* lib/ini: create the file if its not exist on Open
* lib/net: use [time.Ticker] to loop in WaitAlive
* lib/memfs: add sub file system
* lib/memfs: improve the refresh method
* lib/ini: append variable into section before any empty lines
* lib/memfs: stop all Watcher spawn by DirWatcher
* lib/memfs: remove embedding os.FileInfo and http.File
* lib/memfs: refactoring, simplify DirWatcher logic
* email/dkim: set ExpiredAt to MaxInt64 if value is greater than 12 digits

2 files changed, 173 insertions, 1 deletions

diff --git a/CHANGELOG.adoc b/CHANGELOG.adoc
index 77856b30..92dae827 100644
--- a/CHANGELOG.adoc
+++ b/CHANGELOG.adoc
@@ -19,6 +19,178 @@ link:CHANGELOG_2018-2019.html[Changelog from 2018 to 2019^].
 This is changelog for share module since v0.1.0 until v0.11.0.
 
 
+[#v0_51_0]
+== share v0.51.0 (2023-12-06)
+
+[#v0_51_0__new_features]
+=== New features
+
+lib/http: implement Server-Sent Events (SSE)::
++
+--
+For server SSE, we add new type SSEEndpoint, for registering endpoint
+that can handle SSE.
+
+For client SSE, we add it in new sub package "sseclient".
+--
+
+lib/net: add method Read::
++
+--
+The Read method read packet from raw connection.
+
+If the conn parameter is nil it will return [net.ErrClosed].
+
+The bufsize parameter set the size of buffer for each read operation,
+default to 1024 if not set or invalid (less than 0 or greater than
+65535).
+
+The timeout parameter set how long to wait for data before considering
+it as failed.
+If its not set, less or equal to 0, it will wait forever.
+If no data received and timeout is set, it will return [ErrReadTimeout].
+
+If there is data received and connection closed at the same time, it will
+return the data first without error.
+The subsequent Read will return empty packet with [ErrClosed].
+--
+
+lib/crypto: add support for reading passphrase using SSH_ASKPASS::
++
+--
+If the library failed to changes os.Stdin to raw, it will try to use
+a program defined in SSH_ASKPASS environment variable.
+
+The SSH_ASKPASS is controlled by environment SSH_ASKPASS_REQUIRE.
+
+- If SSH_ASKPASS_REQUIRE is empty the passphrase will read from
+  terminal first, if not possible then using SSH_ASKPASS program.
+
+- If SSH_ASKPASS_REQUIRE is set to "never" the passphrase will read
+  from terminal only.
+
+- If SSH_ASKPASS_REQUIRE is set to "prefer", the passphrase will read
+  using SSH_ASKPASS program not from terminal, but require
+  DISPLAY environment to be set.
+
+- If SSH_ASKPASS_REQUIRE is set to "force", the passphrase will read
+  using SSH_ASKPASS program not from terminal, without checking DISPLAY
+  environment.
+--
+
+This changes affect the [ssh.NewClientInteractive] indirectly.
+
+lib/memfs: add method JSON to Node::
++
+--
+The JSON method encode the Node into JSON.
+This method provides an alternative to MarshalJSON with granular options,
+depth and withoutModTime.
+
+The depth set the level of childs to be encoded.
+The depth=0 only encode the Root Node itself (with its childs), depth=1
+encode the Root node and its subdirectories, and so on.
+
+If withoutModTime is set to true, all of the node ModTime will not be
+included in output.
+--
+
+
+[#v0_51_0__enhancements]
+=== Enhancements
+
+lib/ini: create the file if its not exist on Open::
++
+Previously, Open will return an error if file not exist.
+This changes create the file if not exist.
+
+lib/net: use [time.Ticker] to loop in WaitAlive::
++
+--
+The Timeout field in net.Dialer sometimes does not have any effect.
+In the for-loop, we expect that each Dial at least consume 100 ms
+before returning an error.
+
+Turns out, on several occasion, the loop run too quickly, less than the
+passed timeout.
+This is probably because the listening address has not been
+active yet and we run it in the same machine, the OS (or Go?) return
+immediately without waiting for timeout.
+--
+
+lib/memfs: add sub file system::
++
+--
+This implemented simplified version of merging multiple MemFS instances.
+The sub file system (subfs) can be added to the parent MemFS instance
+by calling new method "Merge".
+
+  parent.Merge(other *MemfS)
+
+When Get method called, each subfs will be evaluated in order of Merge
+called.
+
+This deprecated the function Merge.
+--
+
+lib/memfs: improve the refresh method::
++
+--
+Instead of refreshing from the Root, find the directory that closes
+to the requested path.
+
+While at it, simplify the returned error.
+--
+
+lib/ini: append variable into section before any empty lines::
++
+--
+Previously, appending a new variable into section always create an empty
+line before after the variable.
+This changes fix this by appending variable only after non-empty lines.
+While at it, add empty space before variable value.
+--
+
+lib/memfs: stop all Watcher spawn by DirWatcher::
++
+--
+Previously, the Watcher goroutine will stopped only if the file is
+being deleted.
+If the DirWatcher stopped manually, by calling Stop method, the
+Watcher goroutine will still running in the background.
+
+This changes record all spawned Watcher and stop it when files inside
+a deleted directory or when Stop called.
+--
+
+lib/memfs: remove embedding os.FileInfo and http.File::
++
+The original idea of embedding those interface is to guard the Node
+implementation to always follow all methods in the os.FileInfo and
+http.File, in case there is additional methods in the future.
+But, embedding interfaces make the struct store it as field "FileInfo"
+and File with "<nil>" values, which add storage cost to Node.
+
+lib/memfs: refactoring, simplify DirWatcher logic::
++
+In this changes, we simplify re-scanning the directory content.
+Instead of looping on node Child to detect new or delete files, use map
+to store previous Child first.
+If node path exist in map then add it again as child, otherwise delete it.
+
+email/dkim: set ExpiredAt to MaxInt64 if value is greater than 12 digits::
++
+--
+According to RFC 6376,
+
+  To avoid denial-of-service attacks, implementations MAY consider any
+  value longer than 12 digits to be infinite.
+
+Since ExpiredAt type is uint64, we cannot set it to infinite, so set it
+to maximum value int64 (not maximum of uint64).
+--
+
+
 [#v0_50_1]
 == share v0.50.1 (2023-11-05)
 
diff --git a/share.go b/share.go
index d94b8a4f..3d9efdc7 100644
--- a/share.go
+++ b/share.go
@@ -8,5 +8,5 @@ package share
 
 var (
 	// Version of this module.
-	Version = `0.50.1`
+	Version = `0.51.0`
 )