From 85dffe4cb596ba8d5131c07f8993c6158184d988 Mon Sep 17 00:00:00 2001 From: Shulhan Date: Sat, 4 May 2024 15:05:07 +0700 Subject: Release pakakeh.go v0.55.0 (2024-05-04) === Breaking changes * lib/http: refactoring "multipart/form-data" parameters in ClientRequest Previously, ClientRequest with type RequestTypeMultipartForm pass the type "map[string][]byte" in Params. This type hold the file upload, where key is the file name and []byte is content of file. Unfortunately, this model does not correct because a "multipart/form-data" can contains different field name and file name, for example --boundary Content-Disposition: form-data; name="field0"; filename="file0" Content-Type: application/octet-stream This changes fix this by changing the parameter type for RequestTypeMultipartForm to [*multipart.Form], which affect several functions including [Client.PutFormData] and [GenerateFormData]. === Bug fixes * lib/dns: fix packing and unpacking OPT record The RDATA in OPT records can contains zero or more options. Previously, we only handle unpacking and packing one option, now we handle multiple options. * telegram/bot: fix Webhook URL registration Using [path.Join] cause "https://domain" become "https:/domain" which is not a valid URL. This bug caused by refactoring in b89afa24f. === Enhancements * lib/memfs: set embed file mode to print as octal Using octal in mode make the embedded code more readable, for example mode with permission "0o644" much more readable than 420". * telegram/bot: register GET endpoint to test webhook The call to get "GET /" will return HTTP status 200 with JSON body '{"code":200,"message":"OK"}'. This endpoint is to check if the bot server is really running. * lib/http: allow all HTTP method to generate HTTP request with body Although the RFC 7231 says that no special defined meaning for a payload in GET, some implementation of HTTP API sometimes use GET with content type "application/x-www-form-urlencoded". * lib/http: add new function [CreateMultipartFileHeader] The CreateMultipartFileHeader help creating [multipart.FileHeader] from raw bytes, that can be assigned to [*multipart.Form]. --- CHANGELOG.adoc | 75 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ pakakeh.go | 2 +- 2 files changed, 76 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.adoc b/CHANGELOG.adoc index 3b95cbdb..e5ba6acb 100644 --- a/CHANGELOG.adoc +++ b/CHANGELOG.adoc @@ -20,6 +20,81 @@ link:CHANGELOG_2018-2019.html[Changelog from 2018 to 2019^]. This is changelog for `pakakeh.go` module since v0.1.0 until v0.11.0. +[#v0_55_0] +== pakakeh.go v0.55.0 (2024-05-04) + +[#v_55_0__breaking_changes] +=== Breaking changes + +lib/http: refactoring "multipart/form-data" parameters in ClientRequest:: ++ +-- +Previously, ClientRequest with type RequestTypeMultipartForm pass the +type "map[string][]byte" in Params. +This type hold the file upload, where key is the file name and []byte is +content of file. +Unfortunately, this model does not correct because a +"multipart/form-data" can contains different field name and file name, +for example + +---- +--boundary +Content-Disposition: form-data; name="field0"; filename="file0" +Content-Type: application/octet-stream + + +---- + +This changes fix this by changing the parameter type for +RequestTypeMultipartForm to [*multipart.Form], which affect several +functions including [Client.PutFormData] and [GenerateFormData]. +-- + +[#v0_55_0__bug_fixes] +=== Bug fixes + +lib/dns: fix packing and unpacking OPT record:: ++ +The RDATA in OPT records can contains zero or _more_ options. +Previously, we only handle unpacking and packing one option, now we +handle multiple options. + +telegram/bot: fix Webhook URL registration:: ++ +Using [path.Join] cause "https://domain" become "https:/domain" which +is not a valid URL. +This bug caused by refactoring in b89afa24f. + + +[#v0_55_0__enhancements] +=== Enhancements + +lib/memfs: set embed file mode to print as octal:: ++ +Using octal in mode make the embedded code more readable, for example mode +with permission "0o644" much more readable than 420". + +telegram/bot: register GET endpoint to test webhook:: ++ +-- +The call to get "GET /" will return HTTP status +200 with JSON body '{"code":200,"message":"OK"}'. + +This endpoint is to check if the bot server is really running. +-- + +lib/http: allow all HTTP method to generate HTTP request with body:: ++ +Although the RFC 7231 says that no special defined meaning for a +payload in GET, some implementation of HTTP API sometimes use GET with +content type "application/x-www-form-urlencoded". + +lib/http: add new function [CreateMultipartFileHeader]:: ++ +The CreateMultipartFileHeader help creating [multipart.FileHeader] +from raw bytes, that can be assigned to [*multipart.Form]. + + [#v0_54_0] == pakakeh.go v0.54.0 (2024-04-04) diff --git a/pakakeh.go b/pakakeh.go index d79dda25..42e702b7 100644 --- a/pakakeh.go +++ b/pakakeh.go @@ -8,5 +8,5 @@ package pakakeh var ( // Version of this module. - Version = `0.54.0` + Version = `0.55.0` ) -- cgit v1.3