mirror of
https://github.com/akyaiy/GoSally-mvp.git
synced 2026-01-08 23:12:25 +00:00
Compare commits
50 Commits
4a9719cdfb
...
auth-serve
| Author | SHA1 | Date | |
|---|---|---|---|
| 625e5daf71 | |||
| cc27843bb3 | |||
| 20fec82159 | |||
| 055b299ecb | |||
| 17bf207087 | |||
| 7ae8e12dc8 | |||
| 6e36db428a | |||
| 06103a3264 | |||
| c6da55ad65 | |||
| 20a1e3e7bb | |||
| e594d519a7 | |||
| 2ceb236a53 | |||
| 811403a0a2 | |||
| b451f2d3fc | |||
| 5c01eaad6f | |||
| 2b38e179db | |||
| 2889092821 | |||
| 3df3a7b4b5 | |||
| c63f1bd123 | |||
| 095b8559f4 | |||
| 39532f22ea | |||
| 35cebee819 | |||
| 84dfdd6b35 | |||
| e693efe8e7 | |||
| c3dcf24e50 | |||
| 9e7d99e854 | |||
| 7f2783b39a | |||
| c08135309f | |||
| cd9e3ab6c4 | |||
| adaedf195f | |||
| 87694f6654 | |||
| fe628e0f7f | |||
| 3898e2833b | |||
| e4db8505a0 | |||
| 0c25d00171 | |||
| b5a6de0b62 | |||
| 1d3d74846e | |||
| 0141427bfe | |||
| 866946646b | |||
| 251e580e8a | |||
| c734779b69 | |||
| 0923f32b46 | |||
| 1c2c4c1356 | |||
| d3eb483461 | |||
| 5b32698ec5 | |||
| 0ed734b2b1 | |||
| 396352ba15 | |||
| 7b9bdcf768 | |||
| 47058f0ddd | |||
| a72627d87c |
1
.gitignore
vendored
1
.gitignore
vendored
@@ -6,6 +6,7 @@ tmp/
|
|||||||
db/
|
db/
|
||||||
|
|
||||||
com/test.lua
|
com/test.lua
|
||||||
|
com/_config.lua
|
||||||
|
|
||||||
.vscode
|
.vscode
|
||||||
Taskfile.yml
|
Taskfile.yml
|
||||||
|
|||||||
@@ -1,3 +1,5 @@
|
|||||||
|
// The cmd package is the main package where all the main hooks and methods are called.
|
||||||
|
// GoSally uses spf13/cobra to organize all the calls.
|
||||||
package cmd
|
package cmd
|
||||||
|
|
||||||
import (
|
import (
|
||||||
@@ -22,6 +24,8 @@ scripts in a given directory. For more information, visit: https://gosally.oblat
|
|||||||
},
|
},
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Execute prepares global log, loads cmdline args
|
||||||
|
// and executes rootCmd.Execute()
|
||||||
func Execute() {
|
func Execute() {
|
||||||
log.SetOutput(os.Stdout)
|
log.SetOutput(os.Stdout)
|
||||||
log.SetPrefix(colors.SetBrightBlack(fmt.Sprintf("(%s) ", corestate.StageNotReady)))
|
log.SetPrefix(colors.SetBrightBlack(fmt.Sprintf("(%s) ", corestate.StageNotReady)))
|
||||||
|
|||||||
@@ -11,6 +11,7 @@ var runCmd = &cobra.Command{
|
|||||||
Short: "Run node normally",
|
Short: "Run node normally",
|
||||||
Long: `
|
Long: `
|
||||||
"run" starts the node with settings depending on the configuration file`,
|
"run" starts the node with settings depending on the configuration file`,
|
||||||
|
// hooks.Run essentially the heart of the program
|
||||||
Run: hooks.Run,
|
Run: hooks.Run,
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
77
com/Access/GetMasterAccess.lua
Normal file
77
com/Access/GetMasterAccess.lua
Normal file
@@ -0,0 +1,77 @@
|
|||||||
|
local session = require("internal.session")
|
||||||
|
local log = require("internal.log")
|
||||||
|
local jwt = require("internal.crypt.jwt")
|
||||||
|
local bc = require("internal.crypt.bcrypt")
|
||||||
|
local db = require("internal.database.sqlite").connect("db/root.db", {log = true})
|
||||||
|
local sha256 = require("internal.crypt.sha256")
|
||||||
|
|
||||||
|
log.info("Someone at "..session.request.address.." trying to get master access")
|
||||||
|
|
||||||
|
local function close_db()
|
||||||
|
if db then
|
||||||
|
db:close()
|
||||||
|
db = nil
|
||||||
|
end
|
||||||
|
end
|
||||||
|
|
||||||
|
local params = session.request.params.get()
|
||||||
|
|
||||||
|
local function check_missing(arr, p)
|
||||||
|
local is_missing = {}
|
||||||
|
local ok = true
|
||||||
|
for _, key in ipairs(arr) do
|
||||||
|
if p[key] == nil then
|
||||||
|
table.insert(is_missing, key)
|
||||||
|
ok = false
|
||||||
|
end
|
||||||
|
end
|
||||||
|
return ok, is_missing
|
||||||
|
end
|
||||||
|
|
||||||
|
local ok, mp = check_missing({"master_secret", "master_name", "my_key"}, params)
|
||||||
|
if not ok then
|
||||||
|
close_db()
|
||||||
|
session.response.send_error(-32602, "Missing params", mp)
|
||||||
|
end
|
||||||
|
|
||||||
|
if type(params.master_secret) ~= "string" then
|
||||||
|
close_db()
|
||||||
|
session.response.send_error(-32050, "Access denied")
|
||||||
|
end
|
||||||
|
|
||||||
|
if type(params.master_name) ~= "string" then
|
||||||
|
close_db()
|
||||||
|
session.response.send_error(-32050, "Access denied")
|
||||||
|
end
|
||||||
|
|
||||||
|
local master, err = db:query_row("SELECT * FROM master_units WHERE master_name = ?", {params.master_name})
|
||||||
|
|
||||||
|
if not master then
|
||||||
|
log.event("DB query failed:", err)
|
||||||
|
close_db()
|
||||||
|
session.response.send_error(-32050, "Access denied")
|
||||||
|
end
|
||||||
|
|
||||||
|
local ok = bc.compare(master.master_secret, params.master_secret)
|
||||||
|
if not ok then
|
||||||
|
log.warn("Login failed: wrong password")
|
||||||
|
close_db()
|
||||||
|
session.response.send_error(-32050, "Access denied")
|
||||||
|
end
|
||||||
|
|
||||||
|
local token = jwt.encode({
|
||||||
|
secret = require("_config").token(),
|
||||||
|
payload = {
|
||||||
|
session_uuid = session.id,
|
||||||
|
master_id = master.id,
|
||||||
|
key = sha256.sum(params.my_key)
|
||||||
|
},
|
||||||
|
expires_in = 3600
|
||||||
|
})
|
||||||
|
|
||||||
|
close_db()
|
||||||
|
session.response.send({
|
||||||
|
token = token
|
||||||
|
})
|
||||||
|
|
||||||
|
-- G7HgOgl72o7t7u7r
|
||||||
11
com/Echo.lua
Normal file
11
com/Echo.lua
Normal file
@@ -0,0 +1,11 @@
|
|||||||
|
local s = require("internal.session")
|
||||||
|
|
||||||
|
if not s.request.params.__fetched.data then
|
||||||
|
s.response.error = {
|
||||||
|
code = 123,
|
||||||
|
message = "params.data is missing"
|
||||||
|
}
|
||||||
|
return
|
||||||
|
end
|
||||||
|
|
||||||
|
s.response.send(s.request.params.__fetched)
|
||||||
10
com/List.lua
10
com/List.lua
@@ -2,7 +2,9 @@
|
|||||||
|
|
||||||
local session = require("internal.session")
|
local session = require("internal.session")
|
||||||
|
|
||||||
if session.request and session.request.params and session.request.params.about then
|
local params = session.request.params.get()
|
||||||
|
|
||||||
|
if params.about then
|
||||||
session.response.result = {
|
session.response.result = {
|
||||||
description = "Returns a list of available methods",
|
description = "Returns a list of available methods",
|
||||||
params = {
|
params = {
|
||||||
@@ -48,8 +50,8 @@ local function scanDirectory(basePath, targetPath)
|
|||||||
end
|
end
|
||||||
|
|
||||||
local basePath = "com"
|
local basePath = "com"
|
||||||
local layer = session.request and session.request.params.layer and session.request.params.layer:gsub(">", "/") or nil
|
local layer = params.layer and params.layer:gsub(">", "/") or nil
|
||||||
|
|
||||||
session.response.result = {
|
session.response.send({
|
||||||
answer = layer and scanDirectory(basePath, layer) or scanDirectory(basePath, "")
|
answer = layer and scanDirectory(basePath, layer) or scanDirectory(basePath, "")
|
||||||
}
|
})
|
||||||
@@ -1,22 +0,0 @@
|
|||||||
if In.Params and In.Params.about then
|
|
||||||
Out.Result = {
|
|
||||||
description = "Echo of the message",
|
|
||||||
params = {
|
|
||||||
msg = "just message"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return
|
|
||||||
end
|
|
||||||
|
|
||||||
local function validate()
|
|
||||||
if not In.Params.msg or In.Params.msg == "" then
|
|
||||||
Out.Error = {
|
|
||||||
message = "there must be a msg parameter"
|
|
||||||
}
|
|
||||||
return
|
|
||||||
end
|
|
||||||
end
|
|
||||||
|
|
||||||
|
|
||||||
validate()
|
|
||||||
Out.Result.answer = In.Params.msg
|
|
||||||
@@ -1,8 +0,0 @@
|
|||||||
if In.Params and In.Params.about then
|
|
||||||
Out.Result = {
|
|
||||||
description = "Just ping"
|
|
||||||
}
|
|
||||||
return
|
|
||||||
end
|
|
||||||
|
|
||||||
Out.Result.answer = "pong"
|
|
||||||
69
com/Zones/GetZoneInfo.lua
Normal file
69
com/Zones/GetZoneInfo.lua
Normal file
@@ -0,0 +1,69 @@
|
|||||||
|
local session = require("internal.session")
|
||||||
|
local log = require("internal.log")
|
||||||
|
local jwt = require("internal.crypt.jwt")
|
||||||
|
local bc = require("internal.crypt.bcrypt")
|
||||||
|
local sha256 = require("internal.crypt.sha256")
|
||||||
|
local dbdriver = require("internal.database.sqlite")
|
||||||
|
|
||||||
|
local db_root = dbdriver.connect("db/root.db", {log = true})
|
||||||
|
local db_zone = nil
|
||||||
|
|
||||||
|
local function close_db()
|
||||||
|
if db_root then
|
||||||
|
db_root:close()
|
||||||
|
db_root = nil
|
||||||
|
end
|
||||||
|
if db_zone then
|
||||||
|
db_zone:close()
|
||||||
|
db_zone = nil
|
||||||
|
end
|
||||||
|
end
|
||||||
|
|
||||||
|
local token = session.request.headers.get("authorization")
|
||||||
|
|
||||||
|
if not token or type(token) ~= "string" then
|
||||||
|
close_db()
|
||||||
|
session.response.send_error(-32050, "Access denied")
|
||||||
|
end
|
||||||
|
|
||||||
|
local prefix = "Bearer "
|
||||||
|
if token:sub(1, #prefix) ~= prefix then
|
||||||
|
close_db()
|
||||||
|
session.response.send_error(-32052, "Invalid Authorization scheme")
|
||||||
|
end
|
||||||
|
|
||||||
|
local access_token = token:sub(#prefix + 1)
|
||||||
|
|
||||||
|
local err, data = jwt.decode(access_token, { secret = require("_config").token() })
|
||||||
|
|
||||||
|
if err or not data then
|
||||||
|
close_db()
|
||||||
|
session.response.send_error(-32053, "Cannod parse JWT", {err})
|
||||||
|
end
|
||||||
|
|
||||||
|
if data.master_id then
|
||||||
|
|
||||||
|
|
||||||
|
end
|
||||||
|
|
||||||
|
local params = session.request.params.get()
|
||||||
|
|
||||||
|
local function check_missing(arr, p)
|
||||||
|
local is_missing = {}
|
||||||
|
local ok = true
|
||||||
|
for _, key in ipairs(arr) do
|
||||||
|
if p[key] == nil then
|
||||||
|
table.insert(is_missing, key)
|
||||||
|
ok = false
|
||||||
|
end
|
||||||
|
end
|
||||||
|
return ok, is_missing
|
||||||
|
end
|
||||||
|
|
||||||
|
local ok, mp = check_missing({"zone_name"}, params)
|
||||||
|
if not ok then
|
||||||
|
close_db()
|
||||||
|
session.response.send_error(-32602, "Missing params", mp)
|
||||||
|
end
|
||||||
|
|
||||||
|
close_db()
|
||||||
119
com/_Auth/DeleteUnit.lua
Normal file
119
com/_Auth/DeleteUnit.lua
Normal file
@@ -0,0 +1,119 @@
|
|||||||
|
-- com/DeleteUnit.lua
|
||||||
|
|
||||||
|
---@diagnostic disable: redefined-local
|
||||||
|
local db = require("internal.database.sqlite").connect("db/user-database.db", {log = true})
|
||||||
|
local log = require("internal.log")
|
||||||
|
local session = require("internal.session")
|
||||||
|
local crypt = require("internal.crypt.bcrypt")
|
||||||
|
local jwt = require("internal.crypt.jwt")
|
||||||
|
local sha256 = require("internal.crypt.sha256")
|
||||||
|
|
||||||
|
local params = session.request.params.get()
|
||||||
|
local token = session.request.headers.get("authorization")
|
||||||
|
|
||||||
|
local function close_db()
|
||||||
|
if db then
|
||||||
|
db:close()
|
||||||
|
db = nil
|
||||||
|
end
|
||||||
|
end
|
||||||
|
|
||||||
|
local function error_response(message, code, data)
|
||||||
|
session.response.error = {
|
||||||
|
code = code or nil,
|
||||||
|
message = message,
|
||||||
|
data = data or nil
|
||||||
|
}
|
||||||
|
close_db()
|
||||||
|
end
|
||||||
|
|
||||||
|
if not token or type(token) ~= "string" then
|
||||||
|
return error_response("Access denied")
|
||||||
|
end
|
||||||
|
|
||||||
|
local prefix = "Bearer "
|
||||||
|
if token:sub(1, #prefix) ~= prefix then
|
||||||
|
return error_response("Invalid Authorization scheme")
|
||||||
|
end
|
||||||
|
|
||||||
|
local access_token = token:sub(#prefix + 1)
|
||||||
|
|
||||||
|
local err, data = jwt.decode(access_token, { secret = require("_config").token() })
|
||||||
|
|
||||||
|
if err or not data then
|
||||||
|
session.response.error = {
|
||||||
|
message = err
|
||||||
|
}
|
||||||
|
return
|
||||||
|
end
|
||||||
|
|
||||||
|
-- if data.session_uuid ~= session.id then
|
||||||
|
-- return error_response("Access denied")
|
||||||
|
-- end
|
||||||
|
|
||||||
|
-- if data.key ~= sha256.sum(session.request.address .. session.id .. session.request.headers.get("user-agent", "noagent")) then
|
||||||
|
-- return error_response("Access denied")
|
||||||
|
-- end
|
||||||
|
|
||||||
|
if not params then
|
||||||
|
return error_response("no params provided")
|
||||||
|
end
|
||||||
|
|
||||||
|
if not (params.username and params.email and params.password) then
|
||||||
|
return error_response("no username/email/password provided")
|
||||||
|
end
|
||||||
|
|
||||||
|
local existing, err = db:query(
|
||||||
|
"SELECT password FROM users WHERE email = ? AND username = ? AND deleted = 0 LIMIT 1",
|
||||||
|
{
|
||||||
|
params.email,
|
||||||
|
params.username
|
||||||
|
}
|
||||||
|
)
|
||||||
|
|
||||||
|
if err ~= nil then
|
||||||
|
log.error("Password fetch failed: " .. tostring(err))
|
||||||
|
return error_response("Database query failed: " .. tostring(err))
|
||||||
|
end
|
||||||
|
|
||||||
|
if not existing or #existing == 0 then
|
||||||
|
return error_response("Unit not found")
|
||||||
|
end
|
||||||
|
|
||||||
|
local hashed_password = existing[1].password
|
||||||
|
|
||||||
|
local ok = crypt.compare(hashed_password, params.password)
|
||||||
|
if not ok then
|
||||||
|
log.warn("Wrong password attempt for: " .. params.username)
|
||||||
|
return error_response("Invalid password")
|
||||||
|
end
|
||||||
|
|
||||||
|
local ctx, err = db:exec(
|
||||||
|
[[
|
||||||
|
UPDATE users
|
||||||
|
SET deleted = 1,
|
||||||
|
deleted_at = CURRENT_TIMESTAMP
|
||||||
|
WHERE email = ? AND username = ? AND deleted = 0
|
||||||
|
]],
|
||||||
|
{ params.email, params.username }
|
||||||
|
)
|
||||||
|
|
||||||
|
if err ~= nil then
|
||||||
|
log.error("Soft delete failed: " .. tostring(err))
|
||||||
|
return error_response("Soft delete failed: " .. tostring(err))
|
||||||
|
end
|
||||||
|
|
||||||
|
local res, err = ctx:wait()
|
||||||
|
if err ~= nil then
|
||||||
|
log.error("Soft delete confirmation failed: " .. tostring(err))
|
||||||
|
return error_response("Soft delete confirmation failed: " .. tostring(err))
|
||||||
|
end
|
||||||
|
|
||||||
|
session.response.result = {
|
||||||
|
rows_affected = res,
|
||||||
|
message = "Unit soft-deleted successfully"
|
||||||
|
}
|
||||||
|
|
||||||
|
log.info("user " .. params.username .. " soft-deleted successfully")
|
||||||
|
|
||||||
|
close_db()
|
||||||
76
com/_Auth/GetAccess.lua
Normal file
76
com/_Auth/GetAccess.lua
Normal file
@@ -0,0 +1,76 @@
|
|||||||
|
-- com/GetAccess
|
||||||
|
|
||||||
|
---@diagnostic disable: redefined-local
|
||||||
|
local db = require("internal.database.sqlite").connect("db/user-database.db", {log = true})
|
||||||
|
local log = require("internal.log")
|
||||||
|
local session = require("internal.session")
|
||||||
|
local crypt = require("internal.crypt.bcrypt")
|
||||||
|
local jwt = require("internal.crypt.jwt")
|
||||||
|
local sha256 = require("internal.crypt.sha256")
|
||||||
|
|
||||||
|
local params = session.request.params.get()
|
||||||
|
local secret = require("_config").token()
|
||||||
|
|
||||||
|
local function close_db()
|
||||||
|
if db then
|
||||||
|
db:close()
|
||||||
|
db = nil
|
||||||
|
end
|
||||||
|
end
|
||||||
|
|
||||||
|
local function error_response(message, code, data)
|
||||||
|
session.response.error = {
|
||||||
|
code = code or nil,
|
||||||
|
message = message,
|
||||||
|
data = data or nil
|
||||||
|
}
|
||||||
|
close_db()
|
||||||
|
end
|
||||||
|
|
||||||
|
if not params then
|
||||||
|
return error_response("No params provided")
|
||||||
|
end
|
||||||
|
|
||||||
|
if not (params.username and params.email and params.password) then
|
||||||
|
return error_response("Missing username, email or password")
|
||||||
|
end
|
||||||
|
|
||||||
|
local unit, err = db:query(
|
||||||
|
"SELECT id, username, email, password, created_at FROM users WHERE email = ? AND username = ? AND deleted = 0 LIMIT 1",
|
||||||
|
{
|
||||||
|
params.email,
|
||||||
|
params.username
|
||||||
|
}
|
||||||
|
)
|
||||||
|
|
||||||
|
if err then
|
||||||
|
log.error("DB query error: " .. tostring(err))
|
||||||
|
return error_response("Database query failed")
|
||||||
|
end
|
||||||
|
|
||||||
|
if not unit or #unit == 0 then
|
||||||
|
return error_response("Unit not found")
|
||||||
|
end
|
||||||
|
|
||||||
|
unit = unit[1]
|
||||||
|
|
||||||
|
local ok = crypt.compare(unit.password, params.password)
|
||||||
|
if not ok then
|
||||||
|
log.warn("Login failed: wrong password for " .. params.username)
|
||||||
|
return error_response("Invalid password")
|
||||||
|
end
|
||||||
|
|
||||||
|
local token = jwt.encode({
|
||||||
|
secret = secret,
|
||||||
|
payload = { session_uuid = session.id,
|
||||||
|
admin_user = params.username,
|
||||||
|
key = sha256.sum(session.request.address .. session.id .. session.request.headers.get("user-agent", "noagent"))
|
||||||
|
},
|
||||||
|
expires_in = 3600
|
||||||
|
})
|
||||||
|
|
||||||
|
session.response.result = {
|
||||||
|
access_token = token
|
||||||
|
}
|
||||||
|
|
||||||
|
close_db()
|
||||||
109
com/_Auth/PutNewUnit.lua
Normal file
109
com/_Auth/PutNewUnit.lua
Normal file
@@ -0,0 +1,109 @@
|
|||||||
|
-- com/PutNewUnit.lua
|
||||||
|
|
||||||
|
---@diagnostic disable: redefined-local
|
||||||
|
local db = require("internal.database.sqlite").connect("db/user-database.db", {log = true})
|
||||||
|
local log = require("internal.log")
|
||||||
|
local session = require("internal.session")
|
||||||
|
local crypt = require("internal.crypt.bcrypt")
|
||||||
|
local jwt = require("internal.crypt.jwt")
|
||||||
|
local sha256 = require("internal.crypt.sha256")
|
||||||
|
|
||||||
|
local params = session.request.params.get()
|
||||||
|
local token = session.request.headers.get("authorization")
|
||||||
|
|
||||||
|
local function close_db()
|
||||||
|
if db then
|
||||||
|
db:close()
|
||||||
|
db = nil
|
||||||
|
end
|
||||||
|
end
|
||||||
|
|
||||||
|
local function error_response(message, code, data)
|
||||||
|
session.response.error = {
|
||||||
|
code = code or nil,
|
||||||
|
message = message,
|
||||||
|
data = data or nil
|
||||||
|
}
|
||||||
|
close_db()
|
||||||
|
end
|
||||||
|
|
||||||
|
if not token or type(token) ~= "string" then
|
||||||
|
return error_response("Access denied")
|
||||||
|
end
|
||||||
|
|
||||||
|
local prefix = "Bearer "
|
||||||
|
if token:sub(1, #prefix) ~= prefix then
|
||||||
|
return error_response("Invalid Authorization scheme")
|
||||||
|
end
|
||||||
|
|
||||||
|
local access_token = token:sub(#prefix + 1)
|
||||||
|
|
||||||
|
local err, data = jwt.decode(access_token, { secret = require("_config").token() })
|
||||||
|
|
||||||
|
if err or not data then
|
||||||
|
session.response.error = {
|
||||||
|
message = err
|
||||||
|
}
|
||||||
|
return
|
||||||
|
end
|
||||||
|
|
||||||
|
if data.session_uuid ~= session.id then
|
||||||
|
return error_response("Access denied")
|
||||||
|
end
|
||||||
|
|
||||||
|
if data.key ~= sha256.sum(session.request.address .. session.id .. session.request.headers.get("user-agent", "noagent")) then
|
||||||
|
return error_response("Access denied")
|
||||||
|
end
|
||||||
|
|
||||||
|
if not params then
|
||||||
|
return error_response("no params provided")
|
||||||
|
end
|
||||||
|
|
||||||
|
if not (params.username and params.email and params.password) then
|
||||||
|
return error_response("no username/email/password provided")
|
||||||
|
end
|
||||||
|
|
||||||
|
local hashPass = crypt.generate(params.password, crypt.DefaultCost)
|
||||||
|
|
||||||
|
local existing, err = db:query("SELECT 1 FROM users WHERE deleted = 0 AND (email = ? OR username = ?) LIMIT 1", {
|
||||||
|
params.email,
|
||||||
|
params.username
|
||||||
|
})
|
||||||
|
|
||||||
|
if err ~= nil then
|
||||||
|
log.error("Email check failed: "..tostring(err))
|
||||||
|
return error_response("Database check failed: "..tostring(err))
|
||||||
|
end
|
||||||
|
|
||||||
|
if existing and #existing > 0 then
|
||||||
|
return error_response("Unit already exists")
|
||||||
|
end
|
||||||
|
|
||||||
|
local ctx, err = db:exec(
|
||||||
|
"INSERT INTO users (username, email, password, first_name, last_name, phone_number) VALUES (?, ?, ?, ?, ?, ?)",
|
||||||
|
{
|
||||||
|
params.username,
|
||||||
|
params.email,
|
||||||
|
hashPass,
|
||||||
|
params.first_name or "",
|
||||||
|
params.last_name or "",
|
||||||
|
params.phone_number or ""
|
||||||
|
}
|
||||||
|
)
|
||||||
|
if err ~= nil then
|
||||||
|
log.error("Insert failed: "..tostring(err))
|
||||||
|
return error_response("Insert failed: "..tostring(err))
|
||||||
|
end
|
||||||
|
|
||||||
|
local res, err = ctx:wait()
|
||||||
|
if err ~= nil then
|
||||||
|
log.error("Insert confirmation failed: "..tostring(err))
|
||||||
|
return error_response("Insert confirmation failed: "..tostring(err))
|
||||||
|
end
|
||||||
|
|
||||||
|
session.response.result = {
|
||||||
|
rows_affected = res,
|
||||||
|
message = "Unit created successfully"
|
||||||
|
}
|
||||||
|
|
||||||
|
close_db()
|
||||||
@@ -3,25 +3,6 @@ local db = require("internal.database-sqlite").connect("db/test.db", {log = true
|
|||||||
local log = require("internal.log")
|
local log = require("internal.log")
|
||||||
local session = require("internal.session")
|
local session = require("internal.session")
|
||||||
|
|
||||||
local ctx, err = db:exec([[
|
|
||||||
CREATE TABLE IF NOT EXISTS users (
|
|
||||||
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
||||||
name TEXT NOT NULL,
|
|
||||||
email TEXT UNIQUE,
|
|
||||||
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
|
|
||||||
)
|
|
||||||
]])
|
|
||||||
if err ~= nil then
|
|
||||||
log.event_error("Failed to create table: "..tostring(err))
|
|
||||||
return
|
|
||||||
end
|
|
||||||
|
|
||||||
_, err = ctx:wait()
|
|
||||||
if err ~= nil then
|
|
||||||
log.event_error("Table creation failed: "..tostring(err))
|
|
||||||
return
|
|
||||||
end
|
|
||||||
|
|
||||||
if not (session.request.params.name and session.request.params.email) then
|
if not (session.request.params.name and session.request.params.email) then
|
||||||
session.response.error = {
|
session.response.error = {
|
||||||
code = -32602,
|
code = -32602,
|
||||||
@@ -2,15 +2,3 @@
|
|||||||
package.path = package.path .. ";/usr/lib64/lua/5.1/?.lua;/usr/local/share/lua/5.1/?.lua" .. ";./com/?.lua;"
|
package.path = package.path .. ";/usr/lib64/lua/5.1/?.lua;/usr/local/share/lua/5.1/?.lua" .. ";./com/?.lua;"
|
||||||
package.cpath = package.cpath .. ";/usr/lib64/lua/5.1/?.so;/usr/local/lib/lua/5.1/?.so"
|
package.cpath = package.cpath .. ";/usr/lib64/lua/5.1/?.so;/usr/local/lib/lua/5.1/?.so"
|
||||||
|
|
||||||
print = function() end
|
|
||||||
io.write = function(...) end
|
|
||||||
io.stdout = function() return nil end
|
|
||||||
io.stderr = function() return nil end
|
|
||||||
io.read = function(...) return nil end
|
|
||||||
|
|
||||||
---@type table<string, any>
|
|
||||||
Status = {
|
|
||||||
ok = "ok",
|
|
||||||
error = "error",
|
|
||||||
invalid = "invalid",
|
|
||||||
}
|
|
||||||
|
|||||||
2
go.mod
2
go.mod
@@ -8,6 +8,7 @@ require (
|
|||||||
github.com/spf13/cobra v1.9.1
|
github.com/spf13/cobra v1.9.1
|
||||||
github.com/spf13/viper v1.20.1
|
github.com/spf13/viper v1.20.1
|
||||||
github.com/yuin/gopher-lua v1.1.1
|
github.com/yuin/gopher-lua v1.1.1
|
||||||
|
golang.org/x/crypto v0.40.0
|
||||||
golang.org/x/net v0.42.0
|
golang.org/x/net v0.42.0
|
||||||
gopkg.in/ini.v1 v1.67.0
|
gopkg.in/ini.v1 v1.67.0
|
||||||
gopkg.in/natefinch/lumberjack.v2 v2.2.1
|
gopkg.in/natefinch/lumberjack.v2 v2.2.1
|
||||||
@@ -18,6 +19,7 @@ require (
|
|||||||
github.com/dustin/go-humanize v1.0.1 // indirect
|
github.com/dustin/go-humanize v1.0.1 // indirect
|
||||||
github.com/fsnotify/fsnotify v1.9.0 // indirect
|
github.com/fsnotify/fsnotify v1.9.0 // indirect
|
||||||
github.com/go-viper/mapstructure/v2 v2.4.0 // indirect
|
github.com/go-viper/mapstructure/v2 v2.4.0 // indirect
|
||||||
|
github.com/golang-jwt/jwt/v5 v5.3.0
|
||||||
github.com/inconshreveable/mousetrap v1.1.0 // indirect
|
github.com/inconshreveable/mousetrap v1.1.0 // indirect
|
||||||
github.com/mattn/go-isatty v0.0.20 // indirect
|
github.com/mattn/go-isatty v0.0.20 // indirect
|
||||||
github.com/ncruces/go-strftime v0.1.9 // indirect
|
github.com/ncruces/go-strftime v0.1.9 // indirect
|
||||||
|
|||||||
6
go.sum
6
go.sum
@@ -13,6 +13,10 @@ github.com/go-chi/cors v1.2.2 h1:Jmey33TE+b+rB7fT8MUy1u0I4L+NARQlK6LhzKPSyQE=
|
|||||||
github.com/go-chi/cors v1.2.2/go.mod h1:sSbTewc+6wYHBBCW7ytsFSn836hqM7JxpglAy2Vzc58=
|
github.com/go-chi/cors v1.2.2/go.mod h1:sSbTewc+6wYHBBCW7ytsFSn836hqM7JxpglAy2Vzc58=
|
||||||
github.com/go-viper/mapstructure/v2 v2.4.0 h1:EBsztssimR/CONLSZZ04E8qAkxNYq4Qp9LvH92wZUgs=
|
github.com/go-viper/mapstructure/v2 v2.4.0 h1:EBsztssimR/CONLSZZ04E8qAkxNYq4Qp9LvH92wZUgs=
|
||||||
github.com/go-viper/mapstructure/v2 v2.4.0/go.mod h1:oJDH3BJKyqBA2TXFhDsKDGDTlndYOZ6rGS0BRZIxGhM=
|
github.com/go-viper/mapstructure/v2 v2.4.0/go.mod h1:oJDH3BJKyqBA2TXFhDsKDGDTlndYOZ6rGS0BRZIxGhM=
|
||||||
|
github.com/golang-jwt/jwt v3.2.2+incompatible h1:IfV12K8xAKAnZqdXVzCZ+TOjboZ2keLg81eXfW3O+oY=
|
||||||
|
github.com/golang-jwt/jwt v3.2.2+incompatible/go.mod h1:8pz2t5EyA70fFQQSrl6XZXzqecmYZeUEB8OUGHkxJ+I=
|
||||||
|
github.com/golang-jwt/jwt/v5 v5.3.0 h1:pv4AsKCKKZuqlgs5sUmn4x8UlGa0kEVt/puTpKx9vvo=
|
||||||
|
github.com/golang-jwt/jwt/v5 v5.3.0/go.mod h1:fxCRLWMO43lRc8nhHWY6LGqRcf+1gQWArsqaEUEa5bE=
|
||||||
github.com/google/go-cmp v0.6.0 h1:ofyhxvXcZhMsU5ulbFiLKl/XBFqE1GSq7atu8tAmTRI=
|
github.com/google/go-cmp v0.6.0 h1:ofyhxvXcZhMsU5ulbFiLKl/XBFqE1GSq7atu8tAmTRI=
|
||||||
github.com/google/go-cmp v0.6.0/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY=
|
github.com/google/go-cmp v0.6.0/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY=
|
||||||
github.com/google/pprof v0.0.0-20250317173921-a4b03ec1a45e h1:ijClszYn+mADRFY17kjQEVQ1XRhq2/JR1M3sGqeJoxs=
|
github.com/google/pprof v0.0.0-20250317173921-a4b03ec1a45e h1:ijClszYn+mADRFY17kjQEVQ1XRhq2/JR1M3sGqeJoxs=
|
||||||
@@ -59,6 +63,8 @@ github.com/subosito/gotenv v1.6.0 h1:9NlTDc1FTs4qu0DDq7AEtTPNw6SVm7uBMsUCUjABIf8
|
|||||||
github.com/subosito/gotenv v1.6.0/go.mod h1:Dk4QP5c2W3ibzajGcXpNraDfq2IrhjMIvMSWPKKo0FU=
|
github.com/subosito/gotenv v1.6.0/go.mod h1:Dk4QP5c2W3ibzajGcXpNraDfq2IrhjMIvMSWPKKo0FU=
|
||||||
github.com/yuin/gopher-lua v1.1.1 h1:kYKnWBjvbNP4XLT3+bPEwAXJx262OhaHDWDVOPjL46M=
|
github.com/yuin/gopher-lua v1.1.1 h1:kYKnWBjvbNP4XLT3+bPEwAXJx262OhaHDWDVOPjL46M=
|
||||||
github.com/yuin/gopher-lua v1.1.1/go.mod h1:GBR0iDaNXjAgGg9zfCvksxSRnQx76gclCIb7kdAd1Pw=
|
github.com/yuin/gopher-lua v1.1.1/go.mod h1:GBR0iDaNXjAgGg9zfCvksxSRnQx76gclCIb7kdAd1Pw=
|
||||||
|
golang.org/x/crypto v0.40.0 h1:r4x+VvoG5Fm+eJcxMaY8CQM7Lb0l1lsmjGBQ6s8BfKM=
|
||||||
|
golang.org/x/crypto v0.40.0/go.mod h1:Qr1vMER5WyS2dfPHAlsOj01wgLbsyWtFn/aY+5+ZdxY=
|
||||||
golang.org/x/exp v0.0.0-20250718183923-645b1fa84792 h1:R9PFI6EUdfVKgwKjZef7QIwGcBKu86OEFpJ9nUEP2l4=
|
golang.org/x/exp v0.0.0-20250718183923-645b1fa84792 h1:R9PFI6EUdfVKgwKjZef7QIwGcBKu86OEFpJ9nUEP2l4=
|
||||||
golang.org/x/exp v0.0.0-20250718183923-645b1fa84792/go.mod h1:A+z0yzpGtvnG90cToK5n2tu8UJVP2XUATh+r+sfOOOc=
|
golang.org/x/exp v0.0.0-20250718183923-645b1fa84792/go.mod h1:A+z0yzpGtvnG90cToK5n2tu8UJVP2XUATh+r+sfOOOc=
|
||||||
golang.org/x/mod v0.26.0 h1:EGMPT//Ezu+ylkCijjPc+f4Aih7sZvaAr+O3EHBxvZg=
|
golang.org/x/mod v0.26.0 h1:EGMPT//Ezu+ylkCijjPc+f4Aih7sZvaAr+O3EHBxvZg=
|
||||||
|
|||||||
@@ -28,6 +28,7 @@ import (
|
|||||||
"gopkg.in/ini.v1"
|
"gopkg.in/ini.v1"
|
||||||
)
|
)
|
||||||
|
|
||||||
|
// The config composer needs to be in the global scope
|
||||||
var Compositor *config.Compositor = config.NewCompositor()
|
var Compositor *config.Compositor = config.NewCompositor()
|
||||||
|
|
||||||
func InitGlobalLoggerHook(_ context.Context, cs *corestate.CoreState, x *app.AppX) {
|
func InitGlobalLoggerHook(_ context.Context, cs *corestate.CoreState, x *app.AppX) {
|
||||||
@@ -65,7 +66,8 @@ func InitConfigLoadHook(_ context.Context, cs *corestate.CoreState, x *app.AppX)
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
func InitUUUDHook(_ context.Context, cs *corestate.CoreState, x *app.AppX) {
|
// The hook reads or prepares a persistent uuid for the node
|
||||||
|
func InitUUIDHook(_ context.Context, cs *corestate.CoreState, x *app.AppX) {
|
||||||
uuid32, err := corestate.GetNodeUUID(filepath.Join(cs.MetaDir, "uuid"))
|
uuid32, err := corestate.GetNodeUUID(filepath.Join(cs.MetaDir, "uuid"))
|
||||||
if errors.Is(err, fs.ErrNotExist) {
|
if errors.Is(err, fs.ErrNotExist) {
|
||||||
if err := corestate.SetNodeUUID(filepath.Join(cs.NodePath, cs.MetaDir, cs.UUID32DirName)); err != nil {
|
if err := corestate.SetNodeUUID(filepath.Join(cs.NodePath, cs.MetaDir, cs.UUID32DirName)); err != nil {
|
||||||
@@ -80,8 +82,11 @@ func InitUUUDHook(_ context.Context, cs *corestate.CoreState, x *app.AppX) {
|
|||||||
x.Log.Fatalf("uuid load error: %s", err)
|
x.Log.Fatalf("uuid load error: %s", err)
|
||||||
}
|
}
|
||||||
cs.UUID32 = uuid32
|
cs.UUID32 = uuid32
|
||||||
|
corestate.NODE_UUID = uuid32
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// The hook is responsible for checking the initialization stage
|
||||||
|
// and restarting in some cases
|
||||||
func InitRuntimeHook(_ context.Context, cs *corestate.CoreState, x *app.AppX) {
|
func InitRuntimeHook(_ context.Context, cs *corestate.CoreState, x *app.AppX) {
|
||||||
if *x.Config.Env.ParentStagePID != os.Getpid() {
|
if *x.Config.Env.ParentStagePID != os.Getpid() {
|
||||||
// still pre-init stage
|
// still pre-init stage
|
||||||
@@ -133,6 +138,8 @@ func InitRuntimeHook(_ context.Context, cs *corestate.CoreState, x *app.AppX) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
// post-init stage
|
// post-init stage
|
||||||
|
// The hook creates a run.lock file, which contains information
|
||||||
|
// about the process and the node, in the runtime directory.
|
||||||
func InitRunlockHook(_ context.Context, cs *corestate.CoreState, x *app.AppX) {
|
func InitRunlockHook(_ context.Context, cs *corestate.CoreState, x *app.AppX) {
|
||||||
NodeApp.Fallback(func(ctx context.Context, cs *corestate.CoreState, x *app.AppX) {
|
NodeApp.Fallback(func(ctx context.Context, cs *corestate.CoreState, x *app.AppX) {
|
||||||
x.Log.Println("Cleaning up...")
|
x.Log.Println("Cleaning up...")
|
||||||
@@ -185,6 +192,8 @@ func InitRunlockHook(_ context.Context, cs *corestate.CoreState, x *app.AppX) {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// The hook reads the configuration and replaces special expressions
|
||||||
|
// (%tmp% and so on) in string fields with the required data.
|
||||||
func InitConfigReplHook(_ context.Context, cs *corestate.CoreState, x *app.AppX) {
|
func InitConfigReplHook(_ context.Context, cs *corestate.CoreState, x *app.AppX) {
|
||||||
if !slices.Contains(*x.Config.Conf.DisableWarnings, "--WNonStdTmpDir") && os.TempDir() != "/tmp" {
|
if !slices.Contains(*x.Config.Conf.DisableWarnings, "--WNonStdTmpDir") && os.TempDir() != "/tmp" {
|
||||||
x.Log.Printf("%s: %s", colors.PrintWarn(), "Non-standard value specified for temporary directory")
|
x.Log.Printf("%s: %s", colors.PrintWarn(), "Non-standard value specified for temporary directory")
|
||||||
@@ -209,6 +218,8 @@ func InitConfigReplHook(_ context.Context, cs *corestate.CoreState, x *app.AppX)
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// The hook is responsible for outputting the
|
||||||
|
// final config and asking for confirmation.
|
||||||
func InitConfigPrintHook(ctx context.Context, cs *corestate.CoreState, x *app.AppX) {
|
func InitConfigPrintHook(ctx context.Context, cs *corestate.CoreState, x *app.AppX) {
|
||||||
if *x.Config.Conf.Node.ShowConfig {
|
if *x.Config.Conf.Node.ShowConfig {
|
||||||
fmt.Printf("Configuration from %s:\n", x.Config.CMDLine.Run.ConfigPath)
|
fmt.Printf("Configuration from %s:\n", x.Config.CMDLine.Run.ConfigPath)
|
||||||
@@ -239,6 +250,8 @@ func InitSLogHook(_ context.Context, cs *corestate.CoreState, x *app.AppX) {
|
|||||||
*x.SLog = *newSlog
|
*x.SLog = *newSlog
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// The method goes through the entire config structure through
|
||||||
|
// reflection and replaces string fields with the required ones.
|
||||||
func processConfig(conf any, replacements map[string]any) error {
|
func processConfig(conf any, replacements map[string]any) error {
|
||||||
val := reflect.ValueOf(conf)
|
val := reflect.ValueOf(conf)
|
||||||
if val.Kind() == reflect.Ptr {
|
if val.Kind() == reflect.Ptr {
|
||||||
|
|||||||
@@ -33,7 +33,7 @@ var NodeApp = app.New()
|
|||||||
func Run(cmd *cobra.Command, args []string) {
|
func Run(cmd *cobra.Command, args []string) {
|
||||||
NodeApp.InitialHooks(
|
NodeApp.InitialHooks(
|
||||||
InitGlobalLoggerHook, InitCorestateHook, InitConfigLoadHook,
|
InitGlobalLoggerHook, InitCorestateHook, InitConfigLoadHook,
|
||||||
InitUUUDHook, InitRuntimeHook, InitRunlockHook,
|
InitUUIDHook, InitRuntimeHook, InitRunlockHook,
|
||||||
InitConfigReplHook, InitConfigPrintHook, InitSLogHook,
|
InitConfigReplHook, InitConfigPrintHook, InitSLogHook,
|
||||||
)
|
)
|
||||||
|
|
||||||
|
|||||||
@@ -1,5 +1,7 @@
|
|||||||
package corestate
|
package corestate
|
||||||
|
|
||||||
|
var NODE_UUID string
|
||||||
|
|
||||||
type Stage string
|
type Stage string
|
||||||
|
|
||||||
const (
|
const (
|
||||||
|
|||||||
1
internal/engine/lua/handler.go
Normal file
1
internal/engine/lua/handler.go
Normal file
@@ -0,0 +1 @@
|
|||||||
|
package lua
|
||||||
35
internal/engine/lua/pool.go
Normal file
35
internal/engine/lua/pool.go
Normal file
@@ -0,0 +1,35 @@
|
|||||||
|
package lua
|
||||||
|
|
||||||
|
import (
|
||||||
|
"sync"
|
||||||
|
|
||||||
|
lua "github.com/yuin/gopher-lua"
|
||||||
|
)
|
||||||
|
|
||||||
|
type LuaPool struct {
|
||||||
|
pool sync.Pool
|
||||||
|
}
|
||||||
|
|
||||||
|
func NewLuaPool() *LuaPool {
|
||||||
|
return &LuaPool{
|
||||||
|
pool: sync.Pool{
|
||||||
|
New: func() any {
|
||||||
|
L := lua.NewState()
|
||||||
|
|
||||||
|
return L
|
||||||
|
},
|
||||||
|
},
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func (lp *LuaPool) Get() *lua.LState {
|
||||||
|
return lp.pool.Get().(*lua.LState)
|
||||||
|
}
|
||||||
|
|
||||||
|
func (lp *LuaPool) Put(L *lua.LState) {
|
||||||
|
L.Close()
|
||||||
|
|
||||||
|
newL := lua.NewState()
|
||||||
|
|
||||||
|
lp.pool.Put(newL)
|
||||||
|
}
|
||||||
26
internal/engine/lua/types.go
Normal file
26
internal/engine/lua/types.go
Normal file
@@ -0,0 +1,26 @@
|
|||||||
|
package lua
|
||||||
|
|
||||||
|
import (
|
||||||
|
"net/http"
|
||||||
|
|
||||||
|
"github.com/akyaiy/GoSally-mvp/internal/core/corestate"
|
||||||
|
"github.com/akyaiy/GoSally-mvp/internal/engine/app"
|
||||||
|
"github.com/akyaiy/GoSally-mvp/internal/server/rpc"
|
||||||
|
)
|
||||||
|
|
||||||
|
type LuaEngineDeps struct {
|
||||||
|
HttpRequest *http.Request
|
||||||
|
JSONRPCRequest *rpc.RPCRequest
|
||||||
|
SessionUUID string
|
||||||
|
ScriptPath string
|
||||||
|
}
|
||||||
|
|
||||||
|
type LuaEngineContract interface {
|
||||||
|
Handle(deps *LuaEngineDeps) *rpc.RPCResponse
|
||||||
|
|
||||||
|
}
|
||||||
|
|
||||||
|
type LuaEngine struct {
|
||||||
|
x *app.AppX
|
||||||
|
cs *corestate.CoreState
|
||||||
|
}
|
||||||
@@ -20,18 +20,14 @@ func (gs *GatewayServer) Handle(w http.ResponseWriter, r *http.Request) {
|
|||||||
sessionUUID := r.Header.Get("X-Session-UUID")
|
sessionUUID := r.Header.Get("X-Session-UUID")
|
||||||
if sessionUUID == "" {
|
if sessionUUID == "" {
|
||||||
sessionUUID = uuid.New().String()
|
sessionUUID = uuid.New().String()
|
||||||
|
|
||||||
}
|
}
|
||||||
gs.x.SLog.Debug("new request", slog.String("session-uuid", sessionUUID), slog.Group("connection", slog.String("ip", r.RemoteAddr)))
|
gs.x.SLog.Debug("new request", slog.String("session-uuid", sessionUUID), slog.Group("connection", slog.String("ip", r.RemoteAddr)))
|
||||||
|
|
||||||
w.Header().Set("X-Session-UUID", sessionUUID)
|
w.Header().Set("X-Session-UUID", sessionUUID)
|
||||||
if !gs.sm.Add(sessionUUID) {
|
if !gs.sm.Add(sessionUUID) {
|
||||||
gs.x.SLog.Debug("session is busy", slog.String("session-uuid", sessionUUID))
|
gs.x.SLog.Debug("session is busy", slog.String("session-uuid", sessionUUID))
|
||||||
rpc.WriteError(w, &rpc.RPCResponse{
|
rpc.WriteError(w, rpc.NewError(rpc.ErrSessionIsBusy, rpc.ErrSessionIsBusyS, nil, nil))
|
||||||
Error: map[string]any{
|
|
||||||
"code": rpc.ErrSessionIsBusy,
|
|
||||||
"message": rpc.ErrSessionIsBusyS,
|
|
||||||
},
|
|
||||||
})
|
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
defer gs.sm.Delete(sessionUUID)
|
defer gs.sm.Delete(sessionUUID)
|
||||||
@@ -40,14 +36,7 @@ func (gs *GatewayServer) Handle(w http.ResponseWriter, r *http.Request) {
|
|||||||
if err != nil {
|
if err != nil {
|
||||||
gs.x.SLog.Debug("failed to read body", slog.String("err", err.Error()))
|
gs.x.SLog.Debug("failed to read body", slog.String("err", err.Error()))
|
||||||
w.WriteHeader(http.StatusBadRequest)
|
w.WriteHeader(http.StatusBadRequest)
|
||||||
rpc.WriteError(w, &rpc.RPCResponse{
|
rpc.WriteError(w, rpc.NewError(rpc.ErrInternalError, rpc.ErrInternalErrorS, nil, nil))
|
||||||
JSONRPC: rpc.JSONRPCVersion,
|
|
||||||
ID: nil,
|
|
||||||
Error: map[string]any{
|
|
||||||
"code": rpc.ErrInternalError,
|
|
||||||
"message": rpc.ErrInternalErrorS,
|
|
||||||
},
|
|
||||||
})
|
|
||||||
gs.x.SLog.Info("invalid request received", slog.String("issue", rpc.ErrInternalErrorS))
|
gs.x.SLog.Info("invalid request received", slog.String("issue", rpc.ErrInternalErrorS))
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
@@ -60,14 +49,7 @@ func (gs *GatewayServer) Handle(w http.ResponseWriter, r *http.Request) {
|
|||||||
if err := json.Unmarshal(body, &single); err != nil {
|
if err := json.Unmarshal(body, &single); err != nil {
|
||||||
gs.x.SLog.Debug("failed to parse json", slog.String("err", err.Error()))
|
gs.x.SLog.Debug("failed to parse json", slog.String("err", err.Error()))
|
||||||
w.WriteHeader(http.StatusBadRequest)
|
w.WriteHeader(http.StatusBadRequest)
|
||||||
rpc.WriteError(w, &rpc.RPCResponse{
|
rpc.WriteError(w, rpc.NewError(rpc.ErrParseError, rpc.ErrParseErrorS, nil, nil))
|
||||||
JSONRPC: rpc.JSONRPCVersion,
|
|
||||||
ID: nil,
|
|
||||||
Error: map[string]any{
|
|
||||||
"code": rpc.ErrParseError,
|
|
||||||
"message": rpc.ErrParseErrorS,
|
|
||||||
},
|
|
||||||
})
|
|
||||||
gs.x.SLog.Info("invalid request received", slog.String("issue", rpc.ErrParseErrorS))
|
gs.x.SLog.Info("invalid request received", slog.String("issue", rpc.ErrParseErrorS))
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -13,8 +13,16 @@ type RPCRequest struct {
|
|||||||
type RPCResponse struct {
|
type RPCResponse struct {
|
||||||
JSONRPC string `json:"jsonrpc"`
|
JSONRPC string `json:"jsonrpc"`
|
||||||
ID *json.RawMessage `json:"id"`
|
ID *json.RawMessage `json:"id"`
|
||||||
Result any `json:"result,omitempty"`
|
Result any `json:"result,omitzero"`
|
||||||
Error any `json:"error,omitempty"`
|
Error any `json:"error,omitzero"`
|
||||||
|
Data *RPCData `json:"data,omitzero"`
|
||||||
|
}
|
||||||
|
|
||||||
|
type RPCData struct {
|
||||||
|
ResponsibleNode string `json:"responsible-node,omitempty"`
|
||||||
|
Salt string `json:"salt,omitempty"`
|
||||||
|
Checksum string `json:"checksum-md5,omitempty"`
|
||||||
|
NewSessionUUID string `json:"new-session-uuid,omitempty"`
|
||||||
}
|
}
|
||||||
|
|
||||||
const (
|
const (
|
||||||
|
|||||||
@@ -1,26 +1,50 @@
|
|||||||
package rpc
|
package rpc
|
||||||
|
|
||||||
import "encoding/json"
|
import (
|
||||||
|
"crypto/md5"
|
||||||
|
"encoding/json"
|
||||||
|
"fmt"
|
||||||
|
|
||||||
|
"github.com/akyaiy/GoSally-mvp/internal/core/corestate"
|
||||||
|
"github.com/google/uuid"
|
||||||
|
)
|
||||||
|
|
||||||
|
func generateChecksum(result any) string {
|
||||||
|
if result == nil {
|
||||||
|
return ""
|
||||||
|
}
|
||||||
|
data, err := json.Marshal(result)
|
||||||
|
if err != nil {
|
||||||
|
return ""
|
||||||
|
}
|
||||||
|
return fmt.Sprintf("%x", md5.Sum(data))
|
||||||
|
}
|
||||||
|
|
||||||
|
func generateSalt() string {
|
||||||
|
return uuid.NewString()
|
||||||
|
}
|
||||||
|
|
||||||
|
func GetData(data any) *RPCData {
|
||||||
|
return &RPCData{
|
||||||
|
Salt: generateSalt(),
|
||||||
|
ResponsibleNode: corestate.NODE_UUID,
|
||||||
|
Checksum: generateChecksum(data),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
func NewError(code int, message string, data any, id *json.RawMessage) *RPCResponse {
|
func NewError(code int, message string, data any, id *json.RawMessage) *RPCResponse {
|
||||||
if data != nil {
|
Error := make(map[string]any)
|
||||||
return &RPCResponse{
|
Error = map[string]any{
|
||||||
JSONRPC: JSONRPCVersion,
|
"code": code,
|
||||||
ID: id,
|
"message": message,
|
||||||
Error: map[string]any{
|
"data": data,
|
||||||
"code": code,
|
|
||||||
"message": message,
|
|
||||||
"data": data,
|
|
||||||
},
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|
||||||
return &RPCResponse{
|
return &RPCResponse{
|
||||||
JSONRPC: JSONRPCVersion,
|
JSONRPC: JSONRPCVersion,
|
||||||
ID: id,
|
ID: id,
|
||||||
Error: map[string]any{
|
Error: Error,
|
||||||
"code": code,
|
Data: GetData(Error),
|
||||||
"message": message,
|
|
||||||
},
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -29,5 +53,6 @@ func NewResponse(result any, id *json.RawMessage) *RPCResponse {
|
|||||||
JSONRPC: JSONRPCVersion,
|
JSONRPC: JSONRPCVersion,
|
||||||
ID: id,
|
ID: id,
|
||||||
Result: result,
|
Result: result,
|
||||||
|
Data: GetData(result),
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
415
internal/server/sv1/db_sqlite.go
Normal file
415
internal/server/sv1/db_sqlite.go
Normal file
@@ -0,0 +1,415 @@
|
|||||||
|
package sv1
|
||||||
|
|
||||||
|
import (
|
||||||
|
"database/sql"
|
||||||
|
"fmt"
|
||||||
|
"log/slog"
|
||||||
|
"sync"
|
||||||
|
|
||||||
|
lua "github.com/yuin/gopher-lua"
|
||||||
|
)
|
||||||
|
|
||||||
|
type DBConnection struct {
|
||||||
|
dbPath string
|
||||||
|
log bool
|
||||||
|
logger *slog.Logger
|
||||||
|
writeChan chan *dbWriteRequest
|
||||||
|
closeChan chan struct{}
|
||||||
|
}
|
||||||
|
|
||||||
|
type dbWriteRequest struct {
|
||||||
|
query string
|
||||||
|
args []interface{}
|
||||||
|
resCh chan *dbWriteResult
|
||||||
|
}
|
||||||
|
|
||||||
|
type dbWriteResult struct {
|
||||||
|
rowsAffected int64
|
||||||
|
err error
|
||||||
|
}
|
||||||
|
|
||||||
|
var dbMutexMap = make(map[string]*sync.RWMutex)
|
||||||
|
var dbGlobalMutex sync.Mutex
|
||||||
|
|
||||||
|
func getDBMutex(dbPath string) *sync.RWMutex {
|
||||||
|
dbGlobalMutex.Lock()
|
||||||
|
defer dbGlobalMutex.Unlock()
|
||||||
|
|
||||||
|
if mtx, ok := dbMutexMap[dbPath]; ok {
|
||||||
|
return mtx
|
||||||
|
}
|
||||||
|
|
||||||
|
mtx := &sync.RWMutex{}
|
||||||
|
dbMutexMap[dbPath] = mtx
|
||||||
|
return mtx
|
||||||
|
}
|
||||||
|
|
||||||
|
func loadDBMod(llog *slog.Logger, sid string) func(*lua.LState) int {
|
||||||
|
return func(L *lua.LState) int {
|
||||||
|
llog.Debug("import module db-sqlite")
|
||||||
|
dbMod := L.NewTable()
|
||||||
|
|
||||||
|
L.SetField(dbMod, "connect", L.NewFunction(func(L *lua.LState) int {
|
||||||
|
dbPath := L.CheckString(1)
|
||||||
|
|
||||||
|
logQueries := false
|
||||||
|
if L.GetTop() >= 2 {
|
||||||
|
opts := L.CheckTable(2)
|
||||||
|
if val := opts.RawGetString("log"); val != lua.LNil {
|
||||||
|
logQueries = lua.LVAsBool(val)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
conn := &DBConnection{
|
||||||
|
dbPath: dbPath,
|
||||||
|
log: logQueries,
|
||||||
|
logger: llog,
|
||||||
|
writeChan: make(chan *dbWriteRequest, 100),
|
||||||
|
closeChan: make(chan struct{}),
|
||||||
|
}
|
||||||
|
|
||||||
|
go conn.processWrites()
|
||||||
|
|
||||||
|
ud := L.NewUserData()
|
||||||
|
ud.Value = conn
|
||||||
|
L.SetMetatable(ud, L.GetTypeMetatable("gosally_db"))
|
||||||
|
|
||||||
|
L.Push(ud)
|
||||||
|
return 1
|
||||||
|
}))
|
||||||
|
|
||||||
|
mt := L.NewTypeMetatable("gosally_db")
|
||||||
|
L.SetField(mt, "__index", L.SetFuncs(L.NewTable(), map[string]lua.LGFunction{
|
||||||
|
"exec": dbExec,
|
||||||
|
"query": dbQuery,
|
||||||
|
"query_row": dbQueryRow,
|
||||||
|
"close": dbClose,
|
||||||
|
}))
|
||||||
|
|
||||||
|
L.SetField(dbMod, "__seed", lua.LString(sid))
|
||||||
|
L.Push(dbMod)
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func (conn *DBConnection) processWrites() {
|
||||||
|
for {
|
||||||
|
select {
|
||||||
|
case req := <-conn.writeChan:
|
||||||
|
mtx := getDBMutex(conn.dbPath)
|
||||||
|
mtx.Lock()
|
||||||
|
|
||||||
|
db, err := sql.Open("sqlite", conn.dbPath+"?_busy_timeout=5000&_journal_mode=WAL&_sync=NORMAL&_cache_size=-10000")
|
||||||
|
if err == nil {
|
||||||
|
_, err = db.Exec("PRAGMA journal_mode=WAL;")
|
||||||
|
if err == nil {
|
||||||
|
res, execErr := db.Exec(req.query, req.args...)
|
||||||
|
if execErr == nil {
|
||||||
|
rows, _ := res.RowsAffected()
|
||||||
|
req.resCh <- &dbWriteResult{rowsAffected: rows}
|
||||||
|
} else {
|
||||||
|
req.resCh <- &dbWriteResult{err: execErr}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
db.Close()
|
||||||
|
}
|
||||||
|
|
||||||
|
if err != nil {
|
||||||
|
req.resCh <- &dbWriteResult{err: err}
|
||||||
|
}
|
||||||
|
|
||||||
|
mtx.Unlock()
|
||||||
|
case <-conn.closeChan:
|
||||||
|
return
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func dbExec(L *lua.LState) int {
|
||||||
|
ud := L.CheckUserData(1)
|
||||||
|
conn, ok := ud.Value.(*DBConnection)
|
||||||
|
if !ok {
|
||||||
|
L.Push(lua.LNil)
|
||||||
|
L.Push(lua.LString("invalid database connection"))
|
||||||
|
return 2
|
||||||
|
}
|
||||||
|
|
||||||
|
query := L.CheckString(2)
|
||||||
|
|
||||||
|
var args []any
|
||||||
|
if L.GetTop() >= 3 {
|
||||||
|
params := L.CheckTable(3)
|
||||||
|
params.ForEach(func(k lua.LValue, v lua.LValue) {
|
||||||
|
args = append(args, ConvertLuaTypesToGolang(v))
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
if conn.log {
|
||||||
|
conn.logger.Info("DB Exec",
|
||||||
|
slog.String("query", query),
|
||||||
|
slog.Any("params", args))
|
||||||
|
}
|
||||||
|
|
||||||
|
resCh := make(chan *dbWriteResult, 1)
|
||||||
|
conn.writeChan <- &dbWriteRequest{
|
||||||
|
query: query,
|
||||||
|
args: args,
|
||||||
|
resCh: resCh,
|
||||||
|
}
|
||||||
|
|
||||||
|
ctx := L.NewTable()
|
||||||
|
L.SetField(ctx, "done", lua.LBool(false))
|
||||||
|
|
||||||
|
var result lua.LValue = lua.LNil
|
||||||
|
var errorMsg lua.LValue = lua.LNil
|
||||||
|
|
||||||
|
L.SetField(ctx, "wait", L.NewFunction(func(L *lua.LState) int {
|
||||||
|
res := <-resCh
|
||||||
|
L.SetField(ctx, "done", lua.LBool(true))
|
||||||
|
|
||||||
|
if res.err != nil {
|
||||||
|
errorMsg = lua.LString(res.err.Error())
|
||||||
|
result = lua.LNil
|
||||||
|
} else {
|
||||||
|
result = lua.LNumber(res.rowsAffected)
|
||||||
|
errorMsg = lua.LNil
|
||||||
|
}
|
||||||
|
|
||||||
|
if res.err != nil {
|
||||||
|
L.Push(lua.LNil)
|
||||||
|
L.Push(lua.LString(res.err.Error()))
|
||||||
|
return 2
|
||||||
|
}
|
||||||
|
L.Push(lua.LNumber(res.rowsAffected))
|
||||||
|
L.Push(lua.LNil)
|
||||||
|
return 2
|
||||||
|
}))
|
||||||
|
|
||||||
|
L.SetField(ctx, "check", L.NewFunction(func(L *lua.LState) int {
|
||||||
|
select {
|
||||||
|
case res := <-resCh:
|
||||||
|
L.SetField(ctx, "done", lua.LBool(true))
|
||||||
|
if res.err != nil {
|
||||||
|
errorMsg = lua.LString(res.err.Error())
|
||||||
|
result = lua.LNil
|
||||||
|
L.Push(lua.LNil)
|
||||||
|
L.Push(lua.LString(res.err.Error()))
|
||||||
|
return 2
|
||||||
|
} else {
|
||||||
|
result = lua.LNumber(res.rowsAffected)
|
||||||
|
errorMsg = lua.LNil
|
||||||
|
L.Push(lua.LNumber(res.rowsAffected))
|
||||||
|
L.Push(lua.LNil)
|
||||||
|
return 2
|
||||||
|
}
|
||||||
|
default:
|
||||||
|
L.Push(result)
|
||||||
|
L.Push(errorMsg)
|
||||||
|
return 2
|
||||||
|
}
|
||||||
|
}))
|
||||||
|
|
||||||
|
L.Push(ctx)
|
||||||
|
L.Push(lua.LNil)
|
||||||
|
return 2
|
||||||
|
}
|
||||||
|
|
||||||
|
func dbQueryRow(L *lua.LState) int {
|
||||||
|
ud := L.CheckUserData(1)
|
||||||
|
conn, ok := ud.Value.(*DBConnection)
|
||||||
|
if !ok {
|
||||||
|
L.Push(lua.LNil)
|
||||||
|
L.Push(lua.LString("invalid database connection"))
|
||||||
|
return 2
|
||||||
|
}
|
||||||
|
|
||||||
|
query := L.CheckString(2)
|
||||||
|
|
||||||
|
var args []any
|
||||||
|
if L.GetTop() >= 3 {
|
||||||
|
params := L.CheckTable(3)
|
||||||
|
params.ForEach(func(k lua.LValue, v lua.LValue) {
|
||||||
|
args = append(args, ConvertLuaTypesToGolang(v))
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
if conn.log {
|
||||||
|
conn.logger.Info("DB QueryRow",
|
||||||
|
slog.String("query", query),
|
||||||
|
slog.Any("params", args))
|
||||||
|
}
|
||||||
|
|
||||||
|
mtx := getDBMutex(conn.dbPath)
|
||||||
|
mtx.RLock()
|
||||||
|
defer mtx.RUnlock()
|
||||||
|
|
||||||
|
db, err := sql.Open("sqlite", conn.dbPath+"?_busy_timeout=5000&_journal_mode=WAL&_sync=NORMAL&_cache_size=-10000")
|
||||||
|
if err != nil {
|
||||||
|
L.Push(lua.LNil)
|
||||||
|
L.Push(lua.LString(err.Error()))
|
||||||
|
return 2
|
||||||
|
}
|
||||||
|
defer db.Close()
|
||||||
|
|
||||||
|
row := db.QueryRow(query, args...)
|
||||||
|
|
||||||
|
columns := []string{}
|
||||||
|
stmt, err := db.Prepare(query)
|
||||||
|
if err != nil {
|
||||||
|
L.Push(lua.LNil)
|
||||||
|
L.Push(lua.LString(fmt.Sprintf("prepare failed: %v", err)))
|
||||||
|
return 2
|
||||||
|
}
|
||||||
|
defer stmt.Close()
|
||||||
|
rows, err := stmt.Query(args...)
|
||||||
|
if err != nil {
|
||||||
|
L.Push(lua.LNil)
|
||||||
|
L.Push(lua.LString(fmt.Sprintf("query failed: %v", err)))
|
||||||
|
return 2
|
||||||
|
}
|
||||||
|
defer rows.Close()
|
||||||
|
cols, err := rows.Columns()
|
||||||
|
if err != nil {
|
||||||
|
L.Push(lua.LNil)
|
||||||
|
L.Push(lua.LString(fmt.Sprintf("get columns failed: %v", err)))
|
||||||
|
return 2
|
||||||
|
}
|
||||||
|
for _, c := range cols {
|
||||||
|
columns = append(columns, c)
|
||||||
|
}
|
||||||
|
|
||||||
|
colCount := len(columns)
|
||||||
|
values := make([]any, colCount)
|
||||||
|
valuePtrs := make([]any, colCount)
|
||||||
|
for i := range columns {
|
||||||
|
valuePtrs[i] = &values[i]
|
||||||
|
}
|
||||||
|
|
||||||
|
err = row.Scan(valuePtrs...)
|
||||||
|
if err != nil {
|
||||||
|
if err == sql.ErrNoRows {
|
||||||
|
L.Push(lua.LNil)
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
L.Push(lua.LNil)
|
||||||
|
L.Push(lua.LString(fmt.Sprintf("scan failed: %v", err)))
|
||||||
|
return 2
|
||||||
|
}
|
||||||
|
|
||||||
|
rowTable := L.NewTable()
|
||||||
|
for i, col := range columns {
|
||||||
|
val := values[i]
|
||||||
|
if val == nil {
|
||||||
|
L.SetField(rowTable, col, lua.LNil)
|
||||||
|
} else {
|
||||||
|
L.SetField(rowTable, col, ConvertGolangTypesToLua(L, val))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
L.Push(rowTable)
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
|
||||||
|
func dbQuery(L *lua.LState) int {
|
||||||
|
ud := L.CheckUserData(1)
|
||||||
|
conn, ok := ud.Value.(*DBConnection)
|
||||||
|
if !ok {
|
||||||
|
L.Push(lua.LNil)
|
||||||
|
L.Push(lua.LString("invalid database connection"))
|
||||||
|
return 2
|
||||||
|
}
|
||||||
|
|
||||||
|
query := L.CheckString(2)
|
||||||
|
|
||||||
|
var args []any
|
||||||
|
if L.GetTop() >= 3 {
|
||||||
|
params := L.CheckTable(3)
|
||||||
|
params.ForEach(func(k lua.LValue, v lua.LValue) {
|
||||||
|
args = append(args, ConvertLuaTypesToGolang(v))
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
if conn.log {
|
||||||
|
conn.logger.Info("DB Query",
|
||||||
|
slog.String("query", query),
|
||||||
|
slog.Any("params", args))
|
||||||
|
}
|
||||||
|
|
||||||
|
mtx := getDBMutex(conn.dbPath)
|
||||||
|
mtx.RLock()
|
||||||
|
defer mtx.RUnlock()
|
||||||
|
|
||||||
|
db, err := sql.Open("sqlite", conn.dbPath+"?_busy_timeout=5000&_journal_mode=WAL&_sync=NORMAL&_cache_size=-10000")
|
||||||
|
if err != nil {
|
||||||
|
L.Push(lua.LNil)
|
||||||
|
L.Push(lua.LString(err.Error()))
|
||||||
|
return 2
|
||||||
|
}
|
||||||
|
defer db.Close()
|
||||||
|
|
||||||
|
rows, err := db.Query(query, args...)
|
||||||
|
if err != nil {
|
||||||
|
L.Push(lua.LNil)
|
||||||
|
L.Push(lua.LString(fmt.Sprintf("query failed: %v", err)))
|
||||||
|
return 2
|
||||||
|
}
|
||||||
|
defer rows.Close()
|
||||||
|
|
||||||
|
columns, err := rows.Columns()
|
||||||
|
if err != nil {
|
||||||
|
L.Push(lua.LNil)
|
||||||
|
L.Push(lua.LString(fmt.Sprintf("get columns failed: %v", err)))
|
||||||
|
return 2
|
||||||
|
}
|
||||||
|
|
||||||
|
result := L.NewTable()
|
||||||
|
colCount := len(columns)
|
||||||
|
values := make([]any, colCount)
|
||||||
|
valuePtrs := make([]any, colCount)
|
||||||
|
|
||||||
|
for rows.Next() {
|
||||||
|
for i := range columns {
|
||||||
|
valuePtrs[i] = &values[i]
|
||||||
|
}
|
||||||
|
|
||||||
|
if err := rows.Scan(valuePtrs...); err != nil {
|
||||||
|
L.Push(lua.LNil)
|
||||||
|
L.Push(lua.LString(fmt.Sprintf("scan failed: %v", err)))
|
||||||
|
return 2
|
||||||
|
}
|
||||||
|
|
||||||
|
rowTable := L.NewTable()
|
||||||
|
for i, col := range columns {
|
||||||
|
val := values[i]
|
||||||
|
if val == nil {
|
||||||
|
L.SetField(rowTable, col, lua.LNil)
|
||||||
|
} else {
|
||||||
|
L.SetField(rowTable, col, ConvertGolangTypesToLua(L, val))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
result.Append(rowTable)
|
||||||
|
}
|
||||||
|
|
||||||
|
if err := rows.Err(); err != nil {
|
||||||
|
L.Push(lua.LNil)
|
||||||
|
L.Push(lua.LString(fmt.Sprintf("rows iteration failed: %v", err)))
|
||||||
|
return 2
|
||||||
|
}
|
||||||
|
|
||||||
|
L.Push(result)
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
|
||||||
|
func dbClose(L *lua.LState) int {
|
||||||
|
ud := L.CheckUserData(1)
|
||||||
|
conn, ok := ud.Value.(*DBConnection)
|
||||||
|
if !ok {
|
||||||
|
L.Push(lua.LFalse)
|
||||||
|
L.Push(lua.LString("invalid database connection"))
|
||||||
|
return 2
|
||||||
|
}
|
||||||
|
|
||||||
|
close(conn.closeChan)
|
||||||
|
L.Push(lua.LTrue)
|
||||||
|
return 1
|
||||||
|
}
|
||||||
@@ -24,6 +24,16 @@ func (h *HandlerV1) Handle(_ context.Context, sid string, r *http.Request, req *
|
|||||||
return rpc.NewError(rpc.ErrMethodNotFound, rpc.ErrMethodNotFoundS, nil, req.ID)
|
return rpc.NewError(rpc.ErrMethodNotFound, rpc.ErrMethodNotFoundS, nil, req.ID)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
switch req.Params.(type) {
|
||||||
return h.handleLUA(sid, r, req, method)
|
case map[string]any, []any, nil:
|
||||||
|
return h.handleLUA(sid, r, req, method)
|
||||||
|
default:
|
||||||
|
// JSON-RPC 2.0 Specification:
|
||||||
|
// https://www.jsonrpc.org/specification#parameter_structures
|
||||||
|
//
|
||||||
|
// "params" MUST be either an *array* or an *object* if included.
|
||||||
|
// Any other type (e.g., a number, string, or boolean) is INVALID.
|
||||||
|
h.x.SLog.Info("invalid request received", slog.String("issue", rpc.ErrInvalidParamsS))
|
||||||
|
return rpc.NewError(rpc.ErrInvalidParams, rpc.ErrInvalidParamsS, nil, req.ID)
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
86
internal/server/sv1/jwt.go
Normal file
86
internal/server/sv1/jwt.go
Normal file
@@ -0,0 +1,86 @@
|
|||||||
|
package sv1
|
||||||
|
|
||||||
|
import (
|
||||||
|
"log/slog"
|
||||||
|
"time"
|
||||||
|
|
||||||
|
"github.com/golang-jwt/jwt/v5"
|
||||||
|
lua "github.com/yuin/gopher-lua"
|
||||||
|
)
|
||||||
|
|
||||||
|
func loadJWTMod(llog *slog.Logger, sid string) func(*lua.LState) int {
|
||||||
|
return func(L *lua.LState) int {
|
||||||
|
llog.Debug("import module jwt")
|
||||||
|
jwtMod := L.NewTable()
|
||||||
|
|
||||||
|
L.SetField(jwtMod, "encode", L.NewFunction(jwtEncode))
|
||||||
|
L.SetField(jwtMod, "decode", L.NewFunction(jwtDecode))
|
||||||
|
|
||||||
|
L.SetField(jwtMod, "__seed", lua.LString(sid))
|
||||||
|
L.Push(jwtMod)
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func jwtEncode(L *lua.LState) int {
|
||||||
|
payloadTbl := L.CheckTable(1)
|
||||||
|
secret := L.GetField(payloadTbl, "secret").String()
|
||||||
|
payload := L.GetField(payloadTbl, "payload").(*lua.LTable)
|
||||||
|
expiresIn := L.GetField(payloadTbl, "expires_in")
|
||||||
|
expDuration := time.Hour
|
||||||
|
|
||||||
|
if expiresIn.Type() == lua.LTNumber {
|
||||||
|
floatVal := ConvertLuaTypesToGolang(expiresIn).(float64)
|
||||||
|
expDuration = time.Duration(floatVal) * time.Second
|
||||||
|
}
|
||||||
|
|
||||||
|
claims := jwt.MapClaims{}
|
||||||
|
payload.ForEach(func(key, value lua.LValue) {
|
||||||
|
claims[key.String()] = ConvertLuaTypesToGolang(value)
|
||||||
|
})
|
||||||
|
claims["iat"] = time.Now().Unix()
|
||||||
|
claims["exp"] = time.Now().Add(expDuration).Unix()
|
||||||
|
|
||||||
|
token := jwt.NewWithClaims(jwt.SigningMethodHS256, claims)
|
||||||
|
signedToken, err := token.SignedString([]byte(secret))
|
||||||
|
if err != nil {
|
||||||
|
L.Push(lua.LNil)
|
||||||
|
L.Push(lua.LString(err.Error()))
|
||||||
|
return 2
|
||||||
|
}
|
||||||
|
|
||||||
|
L.Push(lua.LString(signedToken))
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
|
||||||
|
func jwtDecode(L *lua.LState) int {
|
||||||
|
tokenString := L.CheckString(1)
|
||||||
|
optsTbl := L.OptTable(2, L.NewTable())
|
||||||
|
secret := L.GetField(optsTbl, "secret").String()
|
||||||
|
|
||||||
|
token, err := jwt.Parse(tokenString, func(t *jwt.Token) (any, error) {
|
||||||
|
return []byte(secret), nil
|
||||||
|
})
|
||||||
|
|
||||||
|
if err != nil || !token.Valid {
|
||||||
|
L.Push(lua.LString("Invalid token: " + err.Error()))
|
||||||
|
L.Push(lua.LNil)
|
||||||
|
return 2
|
||||||
|
}
|
||||||
|
|
||||||
|
claims, ok := token.Claims.(jwt.MapClaims)
|
||||||
|
if !ok {
|
||||||
|
L.Push(lua.LString("Invalid claims"))
|
||||||
|
L.Push(lua.LNil)
|
||||||
|
return 2
|
||||||
|
}
|
||||||
|
|
||||||
|
luaTable := L.NewTable()
|
||||||
|
for k, v := range claims {
|
||||||
|
luaTable.RawSetString(k, ConvertGolangTypesToLua(L, v))
|
||||||
|
}
|
||||||
|
|
||||||
|
L.Push(lua.LNil)
|
||||||
|
L.Push(luaTable)
|
||||||
|
return 2
|
||||||
|
}
|
||||||
@@ -3,7 +3,8 @@ package sv1
|
|||||||
// TODO: make a lua state pool using sync.Pool
|
// TODO: make a lua state pool using sync.Pool
|
||||||
|
|
||||||
import (
|
import (
|
||||||
"database/sql"
|
"crypto/sha256"
|
||||||
|
"encoding/hex"
|
||||||
"fmt"
|
"fmt"
|
||||||
"io"
|
"io"
|
||||||
"log/slog"
|
"log/slog"
|
||||||
@@ -13,7 +14,8 @@ import (
|
|||||||
"path/filepath"
|
"path/filepath"
|
||||||
"strconv"
|
"strconv"
|
||||||
"strings"
|
"strings"
|
||||||
"sync"
|
|
||||||
|
"golang.org/x/crypto/bcrypt"
|
||||||
|
|
||||||
"github.com/akyaiy/GoSally-mvp/internal/colors"
|
"github.com/akyaiy/GoSally-mvp/internal/colors"
|
||||||
"github.com/akyaiy/GoSally-mvp/internal/server/rpc"
|
"github.com/akyaiy/GoSally-mvp/internal/server/rpc"
|
||||||
@@ -21,314 +23,6 @@ import (
|
|||||||
_ "modernc.org/sqlite"
|
_ "modernc.org/sqlite"
|
||||||
)
|
)
|
||||||
|
|
||||||
type DBConnection struct {
|
|
||||||
dbPath string
|
|
||||||
log bool
|
|
||||||
logger *slog.Logger
|
|
||||||
writeChan chan *dbWriteRequest
|
|
||||||
closeChan chan struct{}
|
|
||||||
}
|
|
||||||
|
|
||||||
type dbWriteRequest struct {
|
|
||||||
query string
|
|
||||||
args []interface{}
|
|
||||||
resCh chan *dbWriteResult
|
|
||||||
}
|
|
||||||
|
|
||||||
type dbWriteResult struct {
|
|
||||||
rowsAffected int64
|
|
||||||
err error
|
|
||||||
}
|
|
||||||
|
|
||||||
var dbMutexMap = make(map[string]*sync.RWMutex)
|
|
||||||
var dbGlobalMutex sync.Mutex
|
|
||||||
|
|
||||||
func getDBMutex(dbPath string) *sync.RWMutex {
|
|
||||||
dbGlobalMutex.Lock()
|
|
||||||
defer dbGlobalMutex.Unlock()
|
|
||||||
|
|
||||||
if mtx, ok := dbMutexMap[dbPath]; ok {
|
|
||||||
return mtx
|
|
||||||
}
|
|
||||||
|
|
||||||
mtx := &sync.RWMutex{}
|
|
||||||
dbMutexMap[dbPath] = mtx
|
|
||||||
return mtx
|
|
||||||
}
|
|
||||||
|
|
||||||
func loadDBMod(llog *slog.Logger) func(*lua.LState) int {
|
|
||||||
llog.Debug("import module db-sqlite")
|
|
||||||
return func(L *lua.LState) int {
|
|
||||||
dbMod := L.NewTable()
|
|
||||||
|
|
||||||
L.SetField(dbMod, "connect", L.NewFunction(func(L *lua.LState) int {
|
|
||||||
dbPath := L.CheckString(1)
|
|
||||||
|
|
||||||
logQueries := false
|
|
||||||
if L.GetTop() >= 2 {
|
|
||||||
opts := L.CheckTable(2)
|
|
||||||
if val := opts.RawGetString("log"); val != lua.LNil {
|
|
||||||
logQueries = lua.LVAsBool(val)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
conn := &DBConnection{
|
|
||||||
dbPath: dbPath,
|
|
||||||
log: logQueries,
|
|
||||||
logger: llog,
|
|
||||||
writeChan: make(chan *dbWriteRequest, 100),
|
|
||||||
closeChan: make(chan struct{}),
|
|
||||||
}
|
|
||||||
|
|
||||||
go conn.processWrites()
|
|
||||||
|
|
||||||
ud := L.NewUserData()
|
|
||||||
ud.Value = conn
|
|
||||||
L.SetMetatable(ud, L.GetTypeMetatable("gosally_db"))
|
|
||||||
|
|
||||||
L.Push(ud)
|
|
||||||
return 1
|
|
||||||
}))
|
|
||||||
|
|
||||||
mt := L.NewTypeMetatable("gosally_db")
|
|
||||||
L.SetField(mt, "__index", L.SetFuncs(L.NewTable(), map[string]lua.LGFunction{
|
|
||||||
"exec": dbExec,
|
|
||||||
"query": dbQuery,
|
|
||||||
"close": dbClose,
|
|
||||||
}))
|
|
||||||
|
|
||||||
L.SetField(dbMod, "__gosally_internal", lua.LString("0"))
|
|
||||||
L.Push(dbMod)
|
|
||||||
return 1
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (conn *DBConnection) processWrites() {
|
|
||||||
for {
|
|
||||||
select {
|
|
||||||
case req := <-conn.writeChan:
|
|
||||||
mtx := getDBMutex(conn.dbPath)
|
|
||||||
mtx.Lock()
|
|
||||||
|
|
||||||
db, err := sql.Open("sqlite", conn.dbPath+"?_busy_timeout=5000&_journal_mode=WAL&_sync=NORMAL&_cache_size=-10000")
|
|
||||||
if err == nil {
|
|
||||||
_, err = db.Exec("PRAGMA journal_mode=WAL;")
|
|
||||||
if err == nil {
|
|
||||||
res, execErr := db.Exec(req.query, req.args...)
|
|
||||||
if execErr == nil {
|
|
||||||
rows, _ := res.RowsAffected()
|
|
||||||
req.resCh <- &dbWriteResult{rowsAffected: rows}
|
|
||||||
} else {
|
|
||||||
req.resCh <- &dbWriteResult{err: execErr}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
db.Close()
|
|
||||||
}
|
|
||||||
|
|
||||||
if err != nil {
|
|
||||||
req.resCh <- &dbWriteResult{err: err}
|
|
||||||
}
|
|
||||||
|
|
||||||
mtx.Unlock()
|
|
||||||
case <-conn.closeChan:
|
|
||||||
return
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func dbExec(L *lua.LState) int {
|
|
||||||
ud := L.CheckUserData(1)
|
|
||||||
conn, ok := ud.Value.(*DBConnection)
|
|
||||||
if !ok {
|
|
||||||
L.Push(lua.LNil)
|
|
||||||
L.Push(lua.LString("invalid database connection"))
|
|
||||||
return 2
|
|
||||||
}
|
|
||||||
|
|
||||||
query := L.CheckString(2)
|
|
||||||
|
|
||||||
var args []any
|
|
||||||
if L.GetTop() >= 3 {
|
|
||||||
params := L.CheckTable(3)
|
|
||||||
params.ForEach(func(k lua.LValue, v lua.LValue) {
|
|
||||||
args = append(args, ConvertLuaTypesToGolang(v))
|
|
||||||
})
|
|
||||||
}
|
|
||||||
|
|
||||||
if conn.log {
|
|
||||||
conn.logger.Info("DB Exec",
|
|
||||||
slog.String("query", query),
|
|
||||||
slog.Any("params", args))
|
|
||||||
}
|
|
||||||
|
|
||||||
resCh := make(chan *dbWriteResult, 1)
|
|
||||||
conn.writeChan <- &dbWriteRequest{
|
|
||||||
query: query,
|
|
||||||
args: args,
|
|
||||||
resCh: resCh,
|
|
||||||
}
|
|
||||||
|
|
||||||
ctx := L.NewTable()
|
|
||||||
L.SetField(ctx, "done", lua.LBool(false))
|
|
||||||
|
|
||||||
var result lua.LValue = lua.LNil
|
|
||||||
var errorMsg lua.LValue = lua.LNil
|
|
||||||
|
|
||||||
L.SetField(ctx, "wait", L.NewFunction(func(lL *lua.LState) int {
|
|
||||||
res := <-resCh
|
|
||||||
L.SetField(ctx, "done", lua.LBool(true))
|
|
||||||
|
|
||||||
if res.err != nil {
|
|
||||||
errorMsg = lua.LString(res.err.Error())
|
|
||||||
result = lua.LNil
|
|
||||||
} else {
|
|
||||||
result = lua.LNumber(res.rowsAffected)
|
|
||||||
errorMsg = lua.LNil
|
|
||||||
}
|
|
||||||
|
|
||||||
if res.err != nil {
|
|
||||||
lL.Push(lua.LNil)
|
|
||||||
lL.Push(lua.LString(res.err.Error()))
|
|
||||||
return 2
|
|
||||||
}
|
|
||||||
lL.Push(lua.LNumber(res.rowsAffected))
|
|
||||||
lL.Push(lua.LNil)
|
|
||||||
return 2
|
|
||||||
}))
|
|
||||||
|
|
||||||
L.SetField(ctx, "check", L.NewFunction(func(lL *lua.LState) int {
|
|
||||||
select {
|
|
||||||
case res := <-resCh:
|
|
||||||
lL.SetField(ctx, "done", lua.LBool(true))
|
|
||||||
if res.err != nil {
|
|
||||||
errorMsg = lua.LString(res.err.Error())
|
|
||||||
result = lua.LNil
|
|
||||||
lL.Push(lua.LNil)
|
|
||||||
lL.Push(lua.LString(res.err.Error()))
|
|
||||||
return 2
|
|
||||||
} else {
|
|
||||||
result = lua.LNumber(res.rowsAffected)
|
|
||||||
errorMsg = lua.LNil
|
|
||||||
lL.Push(lua.LNumber(res.rowsAffected))
|
|
||||||
lL.Push(lua.LNil)
|
|
||||||
return 2
|
|
||||||
}
|
|
||||||
default:
|
|
||||||
lL.Push(result)
|
|
||||||
lL.Push(errorMsg)
|
|
||||||
return 2
|
|
||||||
}
|
|
||||||
}))
|
|
||||||
|
|
||||||
L.Push(ctx)
|
|
||||||
L.Push(lua.LNil)
|
|
||||||
return 2
|
|
||||||
}
|
|
||||||
|
|
||||||
func dbQuery(L *lua.LState) int {
|
|
||||||
ud := L.CheckUserData(1)
|
|
||||||
conn, ok := ud.Value.(*DBConnection)
|
|
||||||
if !ok {
|
|
||||||
L.Push(lua.LNil)
|
|
||||||
L.Push(lua.LString("invalid database connection"))
|
|
||||||
return 2
|
|
||||||
}
|
|
||||||
|
|
||||||
query := L.CheckString(2)
|
|
||||||
|
|
||||||
var args []any
|
|
||||||
if L.GetTop() >= 3 {
|
|
||||||
params := L.CheckTable(3)
|
|
||||||
params.ForEach(func(k lua.LValue, v lua.LValue) {
|
|
||||||
args = append(args, ConvertLuaTypesToGolang(v))
|
|
||||||
})
|
|
||||||
}
|
|
||||||
|
|
||||||
if conn.log {
|
|
||||||
conn.logger.Info("DB Query",
|
|
||||||
slog.String("query", query),
|
|
||||||
slog.Any("params", args))
|
|
||||||
}
|
|
||||||
|
|
||||||
mtx := getDBMutex(conn.dbPath)
|
|
||||||
mtx.RLock()
|
|
||||||
defer mtx.RUnlock()
|
|
||||||
|
|
||||||
db, err := sql.Open("sqlite", conn.dbPath+"?_busy_timeout=5000&_journal_mode=WAL&_sync=NORMAL&_cache_size=-10000")
|
|
||||||
if err != nil {
|
|
||||||
L.Push(lua.LNil)
|
|
||||||
L.Push(lua.LString(err.Error()))
|
|
||||||
return 2
|
|
||||||
}
|
|
||||||
defer db.Close()
|
|
||||||
|
|
||||||
rows, err := db.Query(query, args...)
|
|
||||||
if err != nil {
|
|
||||||
L.Push(lua.LNil)
|
|
||||||
L.Push(lua.LString(fmt.Sprintf("query failed: %v", err)))
|
|
||||||
return 2
|
|
||||||
}
|
|
||||||
defer rows.Close()
|
|
||||||
|
|
||||||
columns, err := rows.Columns()
|
|
||||||
if err != nil {
|
|
||||||
L.Push(lua.LNil)
|
|
||||||
L.Push(lua.LString(fmt.Sprintf("get columns failed: %v", err)))
|
|
||||||
return 2
|
|
||||||
}
|
|
||||||
|
|
||||||
result := L.NewTable()
|
|
||||||
colCount := len(columns)
|
|
||||||
values := make([]any, colCount)
|
|
||||||
valuePtrs := make([]any, colCount)
|
|
||||||
|
|
||||||
for rows.Next() {
|
|
||||||
for i := range columns {
|
|
||||||
valuePtrs[i] = &values[i]
|
|
||||||
}
|
|
||||||
|
|
||||||
if err := rows.Scan(valuePtrs...); err != nil {
|
|
||||||
L.Push(lua.LNil)
|
|
||||||
L.Push(lua.LString(fmt.Sprintf("scan failed: %v", err)))
|
|
||||||
return 2
|
|
||||||
}
|
|
||||||
|
|
||||||
rowTable := L.NewTable()
|
|
||||||
for i, col := range columns {
|
|
||||||
val := values[i]
|
|
||||||
if val == nil {
|
|
||||||
L.SetField(rowTable, col, lua.LNil)
|
|
||||||
} else {
|
|
||||||
L.SetField(rowTable, col, ConvertGolangTypesToLua(L, val))
|
|
||||||
}
|
|
||||||
}
|
|
||||||
result.Append(rowTable)
|
|
||||||
}
|
|
||||||
|
|
||||||
if err := rows.Err(); err != nil {
|
|
||||||
L.Push(lua.LNil)
|
|
||||||
L.Push(lua.LString(fmt.Sprintf("rows iteration failed: %v", err)))
|
|
||||||
return 2
|
|
||||||
}
|
|
||||||
|
|
||||||
L.Push(result)
|
|
||||||
return 1
|
|
||||||
}
|
|
||||||
|
|
||||||
func dbClose(L *lua.LState) int {
|
|
||||||
ud := L.CheckUserData(1)
|
|
||||||
conn, ok := ud.Value.(*DBConnection)
|
|
||||||
if !ok {
|
|
||||||
L.Push(lua.LFalse)
|
|
||||||
L.Push(lua.LString("invalid database connection"))
|
|
||||||
return 2
|
|
||||||
}
|
|
||||||
|
|
||||||
close(conn.closeChan)
|
|
||||||
L.Push(lua.LTrue)
|
|
||||||
return 1
|
|
||||||
}
|
|
||||||
|
|
||||||
func addInitiatorHeaders(sid string, req *http.Request, headers http.Header) {
|
func addInitiatorHeaders(sid string, req *http.Request, headers http.Header) {
|
||||||
clientIP := req.RemoteAddr
|
clientIP := req.RemoteAddr
|
||||||
if forwardedFor := req.Header.Get("X-Forwarded-For"); forwardedFor != "" {
|
if forwardedFor := req.Header.Get("X-Forwarded-For"); forwardedFor != "" {
|
||||||
@@ -349,43 +43,256 @@ func addInitiatorHeaders(sid string, req *http.Request, headers http.Header) {
|
|||||||
// I will be only glad.
|
// I will be only glad.
|
||||||
// TODO: make this huge function more harmonious by dividing responsibilities
|
// TODO: make this huge function more harmonious by dividing responsibilities
|
||||||
func (h *HandlerV1) handleLUA(sid string, r *http.Request, req *rpc.RPCRequest, path string) *rpc.RPCResponse {
|
func (h *HandlerV1) handleLUA(sid string, r *http.Request, req *rpc.RPCRequest, path string) *rpc.RPCResponse {
|
||||||
|
var __exit = -1
|
||||||
|
|
||||||
llog := h.x.SLog.With(slog.String("session-id", sid))
|
llog := h.x.SLog.With(slog.String("session-id", sid))
|
||||||
llog.Debug("handling LUA")
|
llog.Debug("handling LUA")
|
||||||
L := lua.NewState()
|
L := lua.NewState()
|
||||||
defer L.Close()
|
defer L.Close()
|
||||||
|
|
||||||
|
osMod := L.GetGlobal("os").(*lua.LTable)
|
||||||
|
L.SetField(osMod, "exit", lua.LNil)
|
||||||
|
|
||||||
|
ioMod := L.GetGlobal("io").(*lua.LTable)
|
||||||
|
for _, k := range []string{"write", "output", "flush", "read", "input"} {
|
||||||
|
ioMod.RawSetString(k, lua.LNil)
|
||||||
|
}
|
||||||
|
L.Env.RawSetString("print", lua.LNil)
|
||||||
|
|
||||||
|
for _, name := range []string{"stdout", "stderr", "stdin"} {
|
||||||
|
stream := ioMod.RawGetString(name)
|
||||||
|
if t, ok := stream.(*lua.LUserData); ok {
|
||||||
|
t.Metatable = lua.LNil
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
seed := rand.Int()
|
seed := rand.Int()
|
||||||
|
|
||||||
loadSessionMod := func(lL *lua.LState) int {
|
loadSessionMod := func(L *lua.LState) int {
|
||||||
llog.Debug("import module session", slog.String("script", path))
|
llog.Debug("import module session", slog.String("script", path))
|
||||||
sessionMod := lL.NewTable()
|
sessionMod := L.NewTable()
|
||||||
inTable := lL.NewTable()
|
inTable := L.NewTable()
|
||||||
paramsTable := lL.NewTable()
|
paramsTable := L.NewTable()
|
||||||
if fetchedParams, ok := req.Params.(map[string]any); ok {
|
headersTable := L.NewTable()
|
||||||
for k, v := range fetchedParams {
|
|
||||||
lL.SetField(paramsTable, k, ConvertGolangTypesToLua(lL, v))
|
fetchedHeadersTable := L.NewTable()
|
||||||
|
for k, v := range r.Header {
|
||||||
|
L.SetField(fetchedHeadersTable, k, ConvertGolangTypesToLua(L, v))
|
||||||
|
}
|
||||||
|
|
||||||
|
headersGetter := L.NewFunction(func(L *lua.LState) int {
|
||||||
|
path := L.OptString(1, "")
|
||||||
|
def := L.Get(2)
|
||||||
|
|
||||||
|
get := func(path string) lua.LValue {
|
||||||
|
if path == "" {
|
||||||
|
return fetchedHeadersTable
|
||||||
|
}
|
||||||
|
fetched := r.Header.Get(path)
|
||||||
|
if fetched == "" {
|
||||||
|
return lua.LNil
|
||||||
|
}
|
||||||
|
return lua.LString(fetched)
|
||||||
|
}
|
||||||
|
val := get(path)
|
||||||
|
if val == lua.LNil && def != lua.LNil {
|
||||||
|
L.Push(def)
|
||||||
|
} else {
|
||||||
|
L.Push(val)
|
||||||
|
}
|
||||||
|
return 1
|
||||||
|
})
|
||||||
|
|
||||||
|
L.SetField(headersTable, "__fetched", fetchedHeadersTable)
|
||||||
|
|
||||||
|
L.SetField(headersTable, "get", headersGetter)
|
||||||
|
L.SetField(inTable, "headers", headersTable)
|
||||||
|
|
||||||
|
fetchedParamsTable := L.NewTable()
|
||||||
|
switch params := req.Params.(type) {
|
||||||
|
case map[string]any:
|
||||||
|
for k, v := range params {
|
||||||
|
L.SetField(fetchedParamsTable, k, ConvertGolangTypesToLua(L, v))
|
||||||
|
}
|
||||||
|
case []any:
|
||||||
|
for i, v := range params {
|
||||||
|
fetchedParamsTable.RawSetInt(i+1, ConvertGolangTypesToLua(L, v))
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
lL.SetField(inTable, "params", paramsTable)
|
|
||||||
|
|
||||||
outTable := lL.NewTable()
|
paramsGetter := L.NewFunction(func(L *lua.LState) int {
|
||||||
resultTable := lL.NewTable()
|
path := L.OptString(1, "")
|
||||||
lL.SetField(outTable, "result", resultTable)
|
def := L.Get(2)
|
||||||
|
|
||||||
lL.SetField(inTable, "address", lua.LString(r.RemoteAddr))
|
get := func(tbl *lua.LTable, path string) lua.LValue {
|
||||||
lL.SetField(sessionMod, "request", inTable)
|
if path == "" {
|
||||||
lL.SetField(sessionMod, "response", outTable)
|
return tbl
|
||||||
|
}
|
||||||
|
current := tbl
|
||||||
|
parts := strings.Split(path, ".")
|
||||||
|
size := len(parts)
|
||||||
|
for index, key := range parts {
|
||||||
|
val := current.RawGetString(key)
|
||||||
|
if tblVal, ok := val.(*lua.LTable); ok {
|
||||||
|
current = tblVal
|
||||||
|
} else {
|
||||||
|
if index == size-1 {
|
||||||
|
return val
|
||||||
|
}
|
||||||
|
return lua.LNil
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return current
|
||||||
|
}
|
||||||
|
|
||||||
lL.SetField(sessionMod, "id", lua.LString(sid))
|
paramsTbl := L.GetField(paramsTable, "__fetched") //
|
||||||
|
val := get(paramsTbl.(*lua.LTable), path) //
|
||||||
|
if val == lua.LNil && def != lua.LNil {
|
||||||
|
L.Push(def)
|
||||||
|
} else {
|
||||||
|
L.Push(val)
|
||||||
|
}
|
||||||
|
return 1
|
||||||
|
})
|
||||||
|
L.SetField(paramsTable, "__fetched", fetchedParamsTable)
|
||||||
|
|
||||||
lL.SetField(sessionMod, "__gosally_internal", lua.LString(fmt.Sprint(seed)))
|
L.SetField(paramsTable, "get", paramsGetter)
|
||||||
lL.Push(sessionMod)
|
L.SetField(inTable, "params", paramsTable)
|
||||||
|
|
||||||
|
outTable := L.NewTable()
|
||||||
|
scriptDataTable := L.NewTable()
|
||||||
|
L.SetField(outTable, "__script_data", scriptDataTable)
|
||||||
|
|
||||||
|
L.SetField(inTable, "address", lua.LString(r.RemoteAddr))
|
||||||
|
|
||||||
|
L.SetField(sessionMod, "throw_error", L.NewFunction(func(L *lua.LState) int {
|
||||||
|
arg := L.Get(1)
|
||||||
|
var msg string
|
||||||
|
switch arg.Type() {
|
||||||
|
case lua.LTString:
|
||||||
|
msg = arg.String()
|
||||||
|
case lua.LTNumber:
|
||||||
|
msg = strconv.FormatFloat(float64(arg.(lua.LNumber)), 'f', -1, 64)
|
||||||
|
default:
|
||||||
|
L.ArgError(1, "expected string or number")
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
L.RaiseError("%s", msg)
|
||||||
|
return 0
|
||||||
|
}))
|
||||||
|
|
||||||
|
resTable := L.NewTable()
|
||||||
|
L.SetField(scriptDataTable, "result", resTable)
|
||||||
|
L.SetField(outTable, "send", L.NewFunction(func(L *lua.LState) int {
|
||||||
|
res := L.Get(1)
|
||||||
|
if res == lua.LNil {
|
||||||
|
__exit = 0
|
||||||
|
L.RaiseError("__successfull")
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
resFTable := scriptDataTable.RawGetString("result")
|
||||||
|
if resPTable, ok := res.(*lua.LTable); ok {
|
||||||
|
resPTable.ForEach(func(key, value lua.LValue) {
|
||||||
|
L.SetField(resFTable, key.String(), value)
|
||||||
|
})
|
||||||
|
} else {
|
||||||
|
L.SetField(scriptDataTable, "result", res)
|
||||||
|
}
|
||||||
|
|
||||||
|
__exit = 0
|
||||||
|
L.RaiseError("__successfull")
|
||||||
|
return 0
|
||||||
|
}))
|
||||||
|
|
||||||
|
L.SetField(outTable, "set", L.NewFunction(func(L *lua.LState) int {
|
||||||
|
res := L.Get(1)
|
||||||
|
if res == lua.LNil {
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
|
||||||
|
resFTable := scriptDataTable.RawGetString("result")
|
||||||
|
if resPTable, ok := res.(*lua.LTable); ok {
|
||||||
|
resPTable.ForEach(func(key, value lua.LValue) {
|
||||||
|
L.SetField(resFTable, key.String(), value)
|
||||||
|
})
|
||||||
|
} else {
|
||||||
|
L.SetField(scriptDataTable, "result", res)
|
||||||
|
}
|
||||||
|
return 0
|
||||||
|
}))
|
||||||
|
|
||||||
|
errTable := L.NewTable()
|
||||||
|
L.SetField(scriptDataTable, "error", errTable)
|
||||||
|
L.SetField(outTable, "send_error", L.NewFunction(func(L *lua.LState) int {
|
||||||
|
var params [3]lua.LValue
|
||||||
|
for i := range 3 {
|
||||||
|
params[i] = L.Get(i + 1)
|
||||||
|
}
|
||||||
|
if errTable, ok := scriptDataTable.RawGetString("error").(*lua.LTable); ok {
|
||||||
|
for _, v := range params {
|
||||||
|
switch v.Type() {
|
||||||
|
case lua.LTNumber:
|
||||||
|
if n, ok := v.(lua.LNumber); ok {
|
||||||
|
L.SetField(errTable, "code", n)
|
||||||
|
}
|
||||||
|
case lua.LTString:
|
||||||
|
if s, ok := v.(lua.LString); ok {
|
||||||
|
L.SetField(errTable, "message", s)
|
||||||
|
}
|
||||||
|
case lua.LTTable:
|
||||||
|
if tbl, ok := v.(*lua.LTable); ok {
|
||||||
|
L.SetField(errTable, "data", tbl)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
__exit = 1
|
||||||
|
L.RaiseError("__unsuccessfull")
|
||||||
|
return 0
|
||||||
|
}))
|
||||||
|
|
||||||
|
L.SetField(outTable, "set_error", L.NewFunction(func(L *lua.LState) int {
|
||||||
|
var params [3]lua.LValue
|
||||||
|
for i := range 3 {
|
||||||
|
params[i] = L.Get(i + 1)
|
||||||
|
}
|
||||||
|
if errTable, ok := scriptDataTable.RawGetString("error").(*lua.LTable); ok {
|
||||||
|
for _, v := range params {
|
||||||
|
switch v.Type() {
|
||||||
|
case lua.LTNumber:
|
||||||
|
if n, ok := v.(lua.LNumber); ok {
|
||||||
|
L.SetField(errTable, "code", n)
|
||||||
|
}
|
||||||
|
case lua.LTString:
|
||||||
|
if s, ok := v.(lua.LString); ok {
|
||||||
|
L.SetField(errTable, "message", s)
|
||||||
|
}
|
||||||
|
case lua.LTTable:
|
||||||
|
if tbl, ok := v.(*lua.LTable); ok {
|
||||||
|
L.SetField(errTable, "data", tbl)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return 0
|
||||||
|
}))
|
||||||
|
|
||||||
|
L.SetField(sessionMod, "request", inTable)
|
||||||
|
L.SetField(sessionMod, "response", outTable)
|
||||||
|
|
||||||
|
L.SetField(sessionMod, "id", lua.LString(sid))
|
||||||
|
|
||||||
|
L.SetField(sessionMod, "__seed", lua.LString(fmt.Sprint(seed)))
|
||||||
|
L.Push(sessionMod)
|
||||||
return 1
|
return 1
|
||||||
}
|
}
|
||||||
|
|
||||||
loadLogMod := func(lL *lua.LState) int {
|
loadLogMod := func(L *lua.LState) int {
|
||||||
llog.Debug("import module log", slog.String("script", path))
|
llog.Debug("import module log", slog.String("script", path))
|
||||||
logMod := lL.NewTable()
|
logMod := L.NewTable()
|
||||||
|
|
||||||
logFuncs := map[string]func(string, ...any){
|
logFuncs := map[string]func(string, ...any){
|
||||||
"info": llog.Info,
|
"info": llog.Info,
|
||||||
@@ -396,8 +303,8 @@ func (h *HandlerV1) handleLUA(sid string, r *http.Request, req *rpc.RPCRequest,
|
|||||||
|
|
||||||
for name, logFunc := range logFuncs {
|
for name, logFunc := range logFuncs {
|
||||||
fun := logFunc
|
fun := logFunc
|
||||||
lL.SetField(logMod, name, lL.NewFunction(func(lL *lua.LState) int {
|
L.SetField(logMod, name, L.NewFunction(func(L *lua.LState) int {
|
||||||
msg := lL.Get(1)
|
msg := L.Get(1)
|
||||||
converted := ConvertLuaTypesToGolang(msg)
|
converted := ConvertLuaTypesToGolang(msg)
|
||||||
fun(fmt.Sprintf("the script says: %s", converted), slog.String("script", path))
|
fun(fmt.Sprintf("the script says: %s", converted), slog.String("script", path))
|
||||||
return 0
|
return 0
|
||||||
@@ -413,8 +320,8 @@ func (h *HandlerV1) handleLUA(sid string, r *http.Request, req *rpc.RPCRequest,
|
|||||||
{"event_error", h.x.Log.Printf, colors.PrintError},
|
{"event_error", h.x.Log.Printf, colors.PrintError},
|
||||||
{"event_warn", h.x.Log.Printf, colors.PrintWarn},
|
{"event_warn", h.x.Log.Printf, colors.PrintWarn},
|
||||||
} {
|
} {
|
||||||
lL.SetField(logMod, fn.field, lL.NewFunction(func(lL *lua.LState) int {
|
L.SetField(logMod, fn.field, L.NewFunction(func(L *lua.LState) int {
|
||||||
msg := lL.Get(1)
|
msg := L.Get(1)
|
||||||
converted := ConvertLuaTypesToGolang(msg)
|
converted := ConvertLuaTypesToGolang(msg)
|
||||||
if fn.color != nil {
|
if fn.color != nil {
|
||||||
h.x.Log.Printf("%s: %s: %s", fn.color(), path, converted)
|
h.x.Log.Printf("%s: %s: %s", fn.color(), path, converted)
|
||||||
@@ -425,24 +332,24 @@ func (h *HandlerV1) handleLUA(sid string, r *http.Request, req *rpc.RPCRequest,
|
|||||||
}))
|
}))
|
||||||
}
|
}
|
||||||
|
|
||||||
lL.SetField(logMod, "__gosally_internal", lua.LString(fmt.Sprint(seed)))
|
L.SetField(logMod, "__seed", lua.LString(fmt.Sprint(seed)))
|
||||||
lL.Push(logMod)
|
L.Push(logMod)
|
||||||
return 1
|
return 1
|
||||||
}
|
}
|
||||||
|
|
||||||
loadNetMod := func(lL *lua.LState) int {
|
loadNetMod := func(L *lua.LState) int {
|
||||||
llog.Debug("import module net", slog.String("script", path))
|
llog.Debug("import module net", slog.String("script", path))
|
||||||
netMod := lL.NewTable()
|
netMod := L.NewTable()
|
||||||
netModhttp := lL.NewTable()
|
netModhttp := L.NewTable()
|
||||||
|
|
||||||
lL.SetField(netModhttp, "get_request", lL.NewFunction(func(lL *lua.LState) int {
|
L.SetField(netModhttp, "get_request", L.NewFunction(func(L *lua.LState) int {
|
||||||
logRequest := lL.ToBool(1)
|
logRequest := L.ToBool(1)
|
||||||
url := lL.ToString(2)
|
url := L.ToString(2)
|
||||||
|
|
||||||
req, err := http.NewRequest("GET", url, nil)
|
req, err := http.NewRequest("GET", url, nil)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
lL.Push(lua.LNil)
|
L.Push(lua.LNil)
|
||||||
lL.Push(lua.LString(err.Error()))
|
L.Push(lua.LString(err.Error()))
|
||||||
return 2
|
return 2
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -451,16 +358,16 @@ func (h *HandlerV1) handleLUA(sid string, r *http.Request, req *rpc.RPCRequest,
|
|||||||
client := &http.Client{}
|
client := &http.Client{}
|
||||||
resp, err := client.Do(req)
|
resp, err := client.Do(req)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
lL.Push(lua.LNil)
|
L.Push(lua.LNil)
|
||||||
lL.Push(lua.LString(err.Error()))
|
L.Push(lua.LString(err.Error()))
|
||||||
return 2
|
return 2
|
||||||
}
|
}
|
||||||
defer resp.Body.Close()
|
defer resp.Body.Close()
|
||||||
|
|
||||||
body, err := io.ReadAll(resp.Body)
|
body, err := io.ReadAll(resp.Body)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
lL.Push(lua.LNil)
|
L.Push(lua.LNil)
|
||||||
lL.Push(lua.LString(err.Error()))
|
L.Push(lua.LString(err.Error()))
|
||||||
return 2
|
return 2
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -474,34 +381,34 @@ func (h *HandlerV1) handleLUA(sid string, r *http.Request, req *rpc.RPCRequest,
|
|||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
result := lL.NewTable()
|
result := L.NewTable()
|
||||||
lL.SetField(result, "status", lua.LNumber(resp.StatusCode))
|
L.SetField(result, "status", lua.LNumber(resp.StatusCode))
|
||||||
lL.SetField(result, "status_text", lua.LString(resp.Status))
|
L.SetField(result, "status_text", lua.LString(resp.Status))
|
||||||
lL.SetField(result, "body", lua.LString(body))
|
L.SetField(result, "body", lua.LString(body))
|
||||||
lL.SetField(result, "content_length", lua.LNumber(resp.ContentLength))
|
L.SetField(result, "content_length", lua.LNumber(resp.ContentLength))
|
||||||
|
|
||||||
headers := lL.NewTable()
|
headers := L.NewTable()
|
||||||
for k, v := range resp.Header {
|
for k, v := range resp.Header {
|
||||||
lL.SetField(headers, k, ConvertGolangTypesToLua(lL, v))
|
L.SetField(headers, k, ConvertGolangTypesToLua(L, v))
|
||||||
}
|
}
|
||||||
lL.SetField(result, "headers", headers)
|
L.SetField(result, "headers", headers)
|
||||||
|
|
||||||
lL.Push(result)
|
L.Push(result)
|
||||||
return 1
|
return 1
|
||||||
}))
|
}))
|
||||||
|
|
||||||
lL.SetField(netModhttp, "post_request", lL.NewFunction(func(lL *lua.LState) int {
|
L.SetField(netModhttp, "post_request", L.NewFunction(func(L *lua.LState) int {
|
||||||
logRequest := lL.ToBool(1)
|
logRequest := L.ToBool(1)
|
||||||
url := lL.ToString(2)
|
url := L.ToString(2)
|
||||||
contentType := lL.ToString(3)
|
contentType := L.ToString(3)
|
||||||
payload := lL.ToString(4)
|
payload := L.ToString(4)
|
||||||
|
|
||||||
body := strings.NewReader(payload)
|
body := strings.NewReader(payload)
|
||||||
|
|
||||||
req, err := http.NewRequest("POST", url, body)
|
req, err := http.NewRequest("POST", url, body)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
lL.Push(lua.LNil)
|
L.Push(lua.LNil)
|
||||||
lL.Push(lua.LString(err.Error()))
|
L.Push(lua.LString(err.Error()))
|
||||||
return 2
|
return 2
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -512,16 +419,16 @@ func (h *HandlerV1) handleLUA(sid string, r *http.Request, req *rpc.RPCRequest,
|
|||||||
client := &http.Client{}
|
client := &http.Client{}
|
||||||
resp, err := client.Do(req)
|
resp, err := client.Do(req)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
lL.Push(lua.LNil)
|
L.Push(lua.LNil)
|
||||||
lL.Push(lua.LString(err.Error()))
|
L.Push(lua.LString(err.Error()))
|
||||||
return 2
|
return 2
|
||||||
}
|
}
|
||||||
defer resp.Body.Close()
|
defer resp.Body.Close()
|
||||||
|
|
||||||
respBody, err := io.ReadAll(resp.Body)
|
respBody, err := io.ReadAll(resp.Body)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
lL.Push(lua.LNil)
|
L.Push(lua.LNil)
|
||||||
lL.Push(lua.LString(err.Error()))
|
L.Push(lua.LString(err.Error()))
|
||||||
return 2
|
return 2
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -536,33 +443,128 @@ func (h *HandlerV1) handleLUA(sid string, r *http.Request, req *rpc.RPCRequest,
|
|||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
result := lL.NewTable()
|
result := L.NewTable()
|
||||||
lL.SetField(result, "status", lua.LNumber(resp.StatusCode))
|
L.SetField(result, "status", lua.LNumber(resp.StatusCode))
|
||||||
lL.SetField(result, "status_text", lua.LString(resp.Status))
|
L.SetField(result, "status_text", lua.LString(resp.Status))
|
||||||
lL.SetField(result, "body", lua.LString(respBody))
|
L.SetField(result, "body", lua.LString(respBody))
|
||||||
lL.SetField(result, "content_length", lua.LNumber(resp.ContentLength))
|
L.SetField(result, "content_length", lua.LNumber(resp.ContentLength))
|
||||||
|
|
||||||
headers := lL.NewTable()
|
headers := L.NewTable()
|
||||||
for k, v := range resp.Header {
|
for k, v := range resp.Header {
|
||||||
lL.SetField(headers, k, ConvertGolangTypesToLua(lL, v))
|
L.SetField(headers, k, ConvertGolangTypesToLua(L, v))
|
||||||
}
|
}
|
||||||
lL.SetField(result, "headers", headers)
|
L.SetField(result, "headers", headers)
|
||||||
|
|
||||||
lL.Push(result)
|
L.Push(result)
|
||||||
return 1
|
return 1
|
||||||
}))
|
}))
|
||||||
|
|
||||||
lL.SetField(netMod, "http", netModhttp)
|
L.SetField(netMod, "http", netModhttp)
|
||||||
|
|
||||||
lL.SetField(netMod, "__gosally_internal", lua.LString(fmt.Sprint(seed)))
|
L.SetField(netMod, "__seed", lua.LString(fmt.Sprint(seed)))
|
||||||
lL.Push(netMod)
|
L.Push(netMod)
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
|
||||||
|
loadCryptbcryptMod := func(L *lua.LState) int {
|
||||||
|
llog.Debug("import module crypt.bcrypt", slog.String("script", path))
|
||||||
|
bcryptMod := L.NewTable()
|
||||||
|
|
||||||
|
L.SetField(bcryptMod, "MinCost", lua.LNumber(bcrypt.MinCost))
|
||||||
|
L.SetField(bcryptMod, "MaxCost", lua.LNumber(bcrypt.MaxCost))
|
||||||
|
L.SetField(bcryptMod, "DefaultCost", lua.LNumber(bcrypt.DefaultCost))
|
||||||
|
|
||||||
|
L.SetField(bcryptMod, "generate", L.NewFunction(func(l *lua.LState) int {
|
||||||
|
password := ConvertLuaTypesToGolang(L.Get(1))
|
||||||
|
passwordStr, ok := password.(string)
|
||||||
|
if !ok {
|
||||||
|
L.Push(lua.LNil)
|
||||||
|
L.Push(lua.LString("error: password must be a string"))
|
||||||
|
return 2
|
||||||
|
}
|
||||||
|
|
||||||
|
cost := ConvertLuaTypesToGolang(L.Get(2))
|
||||||
|
costInt := bcrypt.DefaultCost
|
||||||
|
switch v := cost.(type) {
|
||||||
|
case int:
|
||||||
|
costInt = v
|
||||||
|
case float64:
|
||||||
|
costInt = int(v)
|
||||||
|
case nil:
|
||||||
|
// ok, use DefaultCost
|
||||||
|
default:
|
||||||
|
L.Push(lua.LNil)
|
||||||
|
L.Push(lua.LString("error: cost must be an integer"))
|
||||||
|
return 2
|
||||||
|
}
|
||||||
|
|
||||||
|
hashBytes, err := bcrypt.GenerateFromPassword([]byte(passwordStr), costInt)
|
||||||
|
if err != nil {
|
||||||
|
L.Push(lua.LNil)
|
||||||
|
L.Push(lua.LString("error: " + err.Error()))
|
||||||
|
return 2
|
||||||
|
}
|
||||||
|
|
||||||
|
L.Push(lua.LString(string(hashBytes)))
|
||||||
|
L.Push(lua.LNil)
|
||||||
|
return 2
|
||||||
|
}))
|
||||||
|
|
||||||
|
L.SetField(bcryptMod, "compare", L.NewFunction(func(l *lua.LState) int {
|
||||||
|
hash := ConvertLuaTypesToGolang(L.Get(1))
|
||||||
|
hashStr, ok := hash.(string)
|
||||||
|
if !ok {
|
||||||
|
L.Push(lua.LString("error: hash must be a string"))
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
password := ConvertLuaTypesToGolang(L.Get(2))
|
||||||
|
passwordStr, ok := password.(string)
|
||||||
|
if !ok {
|
||||||
|
L.Push(lua.LString("error: password must be a string"))
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
|
||||||
|
err := bcrypt.CompareHashAndPassword([]byte(hashStr), []byte(passwordStr))
|
||||||
|
if err != nil {
|
||||||
|
L.Push(lua.LFalse)
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
L.Push(lua.LTrue)
|
||||||
|
return 1
|
||||||
|
}))
|
||||||
|
|
||||||
|
L.SetField(bcryptMod, "__seed", lua.LString(fmt.Sprint(seed)))
|
||||||
|
L.Push(bcryptMod)
|
||||||
|
return 1
|
||||||
|
}
|
||||||
|
|
||||||
|
loadCryptbsha256Mod := func(L *lua.LState) int {
|
||||||
|
llog.Debug("import module crypt.sha256", slog.String("script", path))
|
||||||
|
sha265mod := L.NewTable()
|
||||||
|
|
||||||
|
L.SetField(sha265mod, "sum", L.NewFunction(func(l *lua.LState) int {
|
||||||
|
data := ConvertLuaTypesToGolang(L.Get(1))
|
||||||
|
var dataStr = fmt.Sprint(data)
|
||||||
|
|
||||||
|
hash := sha256.Sum256([]byte(dataStr))
|
||||||
|
|
||||||
|
L.Push(lua.LString(hex.EncodeToString(hash[:])))
|
||||||
|
L.Push(lua.LNil)
|
||||||
|
return 2
|
||||||
|
}))
|
||||||
|
|
||||||
|
L.SetField(sha265mod, "__seed", lua.LString(fmt.Sprint(seed)))
|
||||||
|
L.Push(sha265mod)
|
||||||
return 1
|
return 1
|
||||||
}
|
}
|
||||||
|
|
||||||
L.PreloadModule("internal.session", loadSessionMod)
|
L.PreloadModule("internal.session", loadSessionMod)
|
||||||
L.PreloadModule("internal.log", loadLogMod)
|
L.PreloadModule("internal.log", loadLogMod)
|
||||||
L.PreloadModule("internal.net", loadNetMod)
|
L.PreloadModule("internal.net", loadNetMod)
|
||||||
L.PreloadModule("internal.database-sqlite", loadDBMod(llog))
|
L.PreloadModule("internal.database.sqlite", loadDBMod(llog, fmt.Sprint(seed)))
|
||||||
|
L.PreloadModule("internal.crypt.bcrypt", loadCryptbcryptMod)
|
||||||
|
L.PreloadModule("internal.crypt.sha256", loadCryptbsha256Mod)
|
||||||
|
L.PreloadModule("internal.crypt.jwt", loadJWTMod(llog, fmt.Sprint(seed)))
|
||||||
|
|
||||||
llog.Debug("preparing environment")
|
llog.Debug("preparing environment")
|
||||||
prep := filepath.Join(*h.x.Config.Conf.Node.ComDir, "_prepare.lua")
|
prep := filepath.Join(*h.x.Config.Conf.Node.ComDir, "_prepare.lua")
|
||||||
@@ -573,7 +575,8 @@ func (h *HandlerV1) handleLUA(sid string, r *http.Request, req *rpc.RPCRequest,
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
llog.Debug("executing script", slog.String("script", path))
|
llog.Debug("executing script", slog.String("script", path))
|
||||||
if err := L.DoFile(path); err != nil {
|
err := L.DoFile(path)
|
||||||
|
if err != nil && __exit != 0 && __exit != 1 {
|
||||||
llog.Error("script error", slog.String("script", path), slog.String("error", err.Error()))
|
llog.Error("script error", slog.String("script", path), slog.String("error", err.Error()))
|
||||||
return rpc.NewError(rpc.ErrInternalError, rpc.ErrInternalErrorS, nil, req.ID)
|
return rpc.NewError(rpc.ErrInternalError, rpc.ErrInternalErrorS, nil, req.ID)
|
||||||
}
|
}
|
||||||
@@ -595,17 +598,13 @@ func (h *HandlerV1) handleLUA(sid string, r *http.Request, req *rpc.RPCRequest,
|
|||||||
sessionVal := loadedTbl.RawGetString("internal.session")
|
sessionVal := loadedTbl.RawGetString("internal.session")
|
||||||
sessionTbl, ok := sessionVal.(*lua.LTable)
|
sessionTbl, ok := sessionVal.(*lua.LTable)
|
||||||
if !ok {
|
if !ok {
|
||||||
return rpc.NewResponse(map[string]any{
|
return rpc.NewResponse(nil, req.ID)
|
||||||
"responsible-node": h.cs.UUID32,
|
|
||||||
}, req.ID)
|
|
||||||
}
|
}
|
||||||
|
|
||||||
tag := sessionTbl.RawGetString("__gosally_internal")
|
tag := sessionTbl.RawGetString("__seed")
|
||||||
if tag.Type() != lua.LTString || tag.String() != fmt.Sprint(seed) {
|
if tag.Type() != lua.LTString || tag.String() != fmt.Sprint(seed) {
|
||||||
llog.Debug("stock session module is not imported: wrong seed", slog.String("script", path))
|
llog.Debug("stock session module is not imported: wrong seed", slog.String("script", path))
|
||||||
return rpc.NewResponse(map[string]any{
|
return rpc.NewResponse(nil, req.ID)
|
||||||
"responsible-node": h.cs.UUID32,
|
|
||||||
}, req.ID)
|
|
||||||
}
|
}
|
||||||
|
|
||||||
outVal := sessionTbl.RawGetString("response")
|
outVal := sessionTbl.RawGetString("response")
|
||||||
@@ -615,39 +614,28 @@ func (h *HandlerV1) handleLUA(sid string, r *http.Request, req *rpc.RPCRequest,
|
|||||||
return rpc.NewError(rpc.ErrInternalError, rpc.ErrInternalErrorS, nil, req.ID)
|
return rpc.NewError(rpc.ErrInternalError, rpc.ErrInternalErrorS, nil, req.ID)
|
||||||
}
|
}
|
||||||
|
|
||||||
if errVal := outTbl.RawGetString("error"); errVal != lua.LNil {
|
if scriptDataTable, ok := outTbl.RawGetString("__script_data").(*lua.LTable); ok {
|
||||||
llog.Debug("catch error table", slog.String("script", path))
|
switch __exit {
|
||||||
if errTbl, ok := errVal.(*lua.LTable); ok {
|
case 1:
|
||||||
code := rpc.ErrInternalError
|
if errTbl, ok := scriptDataTable.RawGetString("error").(*lua.LTable); ok {
|
||||||
message := rpc.ErrInternalErrorS
|
llog.Debug("catch error table", slog.String("script", path))
|
||||||
data := make(map[string]any)
|
code := rpc.ErrInternalError
|
||||||
if c := errTbl.RawGetString("code"); c.Type() == lua.LTNumber {
|
message := rpc.ErrInternalErrorS
|
||||||
code = int(c.(lua.LNumber))
|
if c := errTbl.RawGetString("code"); c.Type() == lua.LTNumber {
|
||||||
|
code = int(c.(lua.LNumber))
|
||||||
|
}
|
||||||
|
if msg := errTbl.RawGetString("message"); msg.Type() == lua.LTString {
|
||||||
|
message = msg.String()
|
||||||
|
}
|
||||||
|
data := ConvertLuaTypesToGolang(errTbl.RawGetString("data"))
|
||||||
|
llog.Error("the script terminated with an error", slog.Int("code", code), slog.String("message", message), slog.Any("data", data))
|
||||||
|
return rpc.NewError(code, message, data, req.ID)
|
||||||
}
|
}
|
||||||
if msg := errTbl.RawGetString("message"); msg.Type() == lua.LTString {
|
return rpc.NewError(rpc.ErrInternalError, rpc.ErrInternalErrorS, nil, req.ID)
|
||||||
message = msg.String()
|
case 0:
|
||||||
}
|
resVal := ConvertLuaTypesToGolang(scriptDataTable.RawGetString("result"))
|
||||||
rawData := errTbl.RawGetString("data")
|
return rpc.NewResponse(resVal, req.ID)
|
||||||
|
|
||||||
if tbl, ok := rawData.(*lua.LTable); ok {
|
|
||||||
tbl.ForEach(func(k, v lua.LValue) { data[k.String()] = ConvertLuaTypesToGolang(v) })
|
|
||||||
} else {
|
|
||||||
llog.Error("the script terminated with an error", slog.String("code", strconv.Itoa(code)), slog.String("message", message))
|
|
||||||
return rpc.NewError(code, message, ConvertLuaTypesToGolang(rawData), req.ID)
|
|
||||||
}
|
|
||||||
llog.Error("the script terminated with an error", slog.String("code", strconv.Itoa(code)), slog.String("message", message))
|
|
||||||
return rpc.NewError(code, message, data, req.ID)
|
|
||||||
}
|
}
|
||||||
return rpc.NewError(rpc.ErrInternalError, rpc.ErrInternalErrorS, nil, req.ID)
|
|
||||||
}
|
}
|
||||||
|
return rpc.NewResponse(nil, req.ID)
|
||||||
resultVal := outTbl.RawGetString("result")
|
|
||||||
payload := make(map[string]any)
|
|
||||||
if tbl, ok := resultVal.(*lua.LTable); ok {
|
|
||||||
tbl.ForEach(func(k, v lua.LValue) { payload[k.String()] = ConvertLuaTypesToGolang(v) })
|
|
||||||
} else {
|
|
||||||
payload["message"] = ConvertLuaTypesToGolang(resultVal)
|
|
||||||
}
|
|
||||||
payload["responsible-node"] = h.cs.UUID32
|
|
||||||
return rpc.NewResponse(payload, req.ID)
|
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -2,6 +2,8 @@ package sv1
|
|||||||
|
|
||||||
import (
|
import (
|
||||||
"fmt"
|
"fmt"
|
||||||
|
"reflect"
|
||||||
|
"strconv"
|
||||||
|
|
||||||
lua "github.com/yuin/gopher-lua"
|
lua "github.com/yuin/gopher-lua"
|
||||||
)
|
)
|
||||||
@@ -17,19 +19,56 @@ func ConvertLuaTypesToGolang(value lua.LValue) any {
|
|||||||
case lua.LTTable:
|
case lua.LTTable:
|
||||||
tbl := value.(*lua.LTable)
|
tbl := value.(*lua.LTable)
|
||||||
|
|
||||||
var arr []any
|
maxIdx := 0
|
||||||
isArray := true
|
isArray := true
|
||||||
tbl.ForEach(func(key, val lua.LValue) {
|
|
||||||
if key.Type() != lua.LTNumber {
|
var isNumeric = false
|
||||||
isArray = false
|
tbl.ForEach(func(key, _ lua.LValue) {
|
||||||
|
var numKey lua.LValue
|
||||||
|
var ok bool
|
||||||
|
switch key.Type() {
|
||||||
|
case lua.LTString:
|
||||||
|
numKey, ok = key.(lua.LString)
|
||||||
|
if !ok {
|
||||||
|
isArray = false
|
||||||
|
return
|
||||||
|
}
|
||||||
|
case lua.LTNumber:
|
||||||
|
numKey, ok = key.(lua.LNumber)
|
||||||
|
if !ok {
|
||||||
|
isArray = false
|
||||||
|
return
|
||||||
|
}
|
||||||
|
isNumeric = true
|
||||||
|
}
|
||||||
|
|
||||||
|
num, err := strconv.Atoi(numKey.String())
|
||||||
|
if err != nil {
|
||||||
|
isArray = false
|
||||||
|
return
|
||||||
|
}
|
||||||
|
if num < 1 {
|
||||||
|
isArray = false
|
||||||
|
return
|
||||||
|
}
|
||||||
|
if num > maxIdx {
|
||||||
|
maxIdx = num
|
||||||
}
|
}
|
||||||
arr = append(arr, ConvertLuaTypesToGolang(val))
|
|
||||||
})
|
})
|
||||||
|
|
||||||
if isArray {
|
if isArray {
|
||||||
|
arr := make([]any, maxIdx)
|
||||||
|
if isNumeric {
|
||||||
|
for i := 1; i <= maxIdx; i++ {
|
||||||
|
arr[i-1] = ConvertLuaTypesToGolang(tbl.RawGetInt(i))
|
||||||
|
}
|
||||||
|
} else {
|
||||||
|
for i := 1; i <= maxIdx; i++ {
|
||||||
|
arr[i-1] = ConvertLuaTypesToGolang(tbl.RawGetString(strconv.Itoa(i)))
|
||||||
|
}
|
||||||
|
}
|
||||||
return arr
|
return arr
|
||||||
}
|
}
|
||||||
|
|
||||||
result := make(map[string]any)
|
result := make(map[string]any)
|
||||||
tbl.ForEach(func(key, val lua.LValue) {
|
tbl.ForEach(func(key, val lua.LValue) {
|
||||||
result[key.String()] = ConvertLuaTypesToGolang(val)
|
result[key.String()] = ConvertLuaTypesToGolang(val)
|
||||||
@@ -44,34 +83,44 @@ func ConvertLuaTypesToGolang(value lua.LValue) any {
|
|||||||
}
|
}
|
||||||
|
|
||||||
func ConvertGolangTypesToLua(L *lua.LState, val any) lua.LValue {
|
func ConvertGolangTypesToLua(L *lua.LState, val any) lua.LValue {
|
||||||
switch v := val.(type) {
|
if val == nil {
|
||||||
case string:
|
|
||||||
return lua.LString(v)
|
|
||||||
case bool:
|
|
||||||
return lua.LBool(v)
|
|
||||||
case int:
|
|
||||||
return lua.LNumber(float64(v))
|
|
||||||
case int64:
|
|
||||||
return lua.LNumber(float64(v))
|
|
||||||
case float32:
|
|
||||||
return lua.LNumber(float64(v))
|
|
||||||
case float64:
|
|
||||||
return lua.LNumber(v)
|
|
||||||
case []any:
|
|
||||||
tbl := L.NewTable()
|
|
||||||
for i, item := range v {
|
|
||||||
tbl.RawSetInt(i+1, ConvertGolangTypesToLua(L, item))
|
|
||||||
}
|
|
||||||
return tbl
|
|
||||||
case map[string]any:
|
|
||||||
tbl := L.NewTable()
|
|
||||||
for key, value := range v {
|
|
||||||
tbl.RawSetString(key, ConvertGolangTypesToLua(L, value))
|
|
||||||
}
|
|
||||||
return tbl
|
|
||||||
case nil:
|
|
||||||
return lua.LNil
|
return lua.LNil
|
||||||
default:
|
|
||||||
return lua.LString(fmt.Sprintf("%v", v))
|
|
||||||
}
|
}
|
||||||
|
|
||||||
|
rv := reflect.ValueOf(val)
|
||||||
|
rt := rv.Type()
|
||||||
|
|
||||||
|
switch rt.Kind() {
|
||||||
|
case reflect.String:
|
||||||
|
return lua.LString(rv.String())
|
||||||
|
case reflect.Bool:
|
||||||
|
return lua.LBool(rv.Bool())
|
||||||
|
case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64:
|
||||||
|
return lua.LNumber(rv.Int())
|
||||||
|
case reflect.Uint, reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uint64, reflect.Uintptr:
|
||||||
|
return lua.LNumber(rv.Uint())
|
||||||
|
case reflect.Float32, reflect.Float64:
|
||||||
|
return lua.LNumber(rv.Float())
|
||||||
|
|
||||||
|
case reflect.Slice, reflect.Array:
|
||||||
|
tbl := L.NewTable()
|
||||||
|
for i := 0; i < rv.Len(); i++ {
|
||||||
|
tbl.RawSetInt(i+1, ConvertGolangTypesToLua(L, rv.Index(i).Interface()))
|
||||||
|
}
|
||||||
|
return tbl
|
||||||
|
|
||||||
|
case reflect.Map:
|
||||||
|
if rt.Key().Kind() == reflect.String {
|
||||||
|
tbl := L.NewTable()
|
||||||
|
for _, key := range rv.MapKeys() {
|
||||||
|
val := rv.MapIndex(key)
|
||||||
|
tbl.RawSetString(key.String(), ConvertGolangTypesToLua(L, val.Interface()))
|
||||||
|
}
|
||||||
|
return tbl
|
||||||
|
}
|
||||||
|
|
||||||
|
default:
|
||||||
|
return lua.LString(fmt.Sprintf("%v", val))
|
||||||
|
}
|
||||||
|
return lua.LString(fmt.Sprintf("%v", val))
|
||||||
}
|
}
|
||||||
|
|||||||
1
main.go
1
main.go
@@ -1,3 +1,4 @@
|
|||||||
|
// Package main used only for calling cmd.Execute()
|
||||||
package main
|
package main
|
||||||
|
|
||||||
import (
|
import (
|
||||||
|
|||||||
21
vendor/github.com/dustin/go-humanize/.travis.yml
generated
vendored
21
vendor/github.com/dustin/go-humanize/.travis.yml
generated
vendored
@@ -1,21 +0,0 @@
|
|||||||
sudo: false
|
|
||||||
language: go
|
|
||||||
go_import_path: github.com/dustin/go-humanize
|
|
||||||
go:
|
|
||||||
- 1.13.x
|
|
||||||
- 1.14.x
|
|
||||||
- 1.15.x
|
|
||||||
- 1.16.x
|
|
||||||
- stable
|
|
||||||
- master
|
|
||||||
matrix:
|
|
||||||
allow_failures:
|
|
||||||
- go: master
|
|
||||||
fast_finish: true
|
|
||||||
install:
|
|
||||||
- # Do nothing. This is needed to prevent default install action "go get -t -v ./..." from happening here (we want it to happen inside script step).
|
|
||||||
script:
|
|
||||||
- diff -u <(echo -n) <(gofmt -d -s .)
|
|
||||||
- go vet .
|
|
||||||
- go install -v -race ./...
|
|
||||||
- go test -v -race ./...
|
|
||||||
21
vendor/github.com/dustin/go-humanize/LICENSE
generated
vendored
21
vendor/github.com/dustin/go-humanize/LICENSE
generated
vendored
@@ -1,21 +0,0 @@
|
|||||||
Copyright (c) 2005-2008 Dustin Sallings <dustin@spy.net>
|
|
||||||
|
|
||||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
||||||
of this software and associated documentation files (the "Software"), to deal
|
|
||||||
in the Software without restriction, including without limitation the rights
|
|
||||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
||||||
copies of the Software, and to permit persons to whom the Software is
|
|
||||||
furnished to do so, subject to the following conditions:
|
|
||||||
|
|
||||||
The above copyright notice and this permission notice shall be included in
|
|
||||||
all copies or substantial portions of the Software.
|
|
||||||
|
|
||||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
||||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
||||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
||||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
||||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
||||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
||||||
SOFTWARE.
|
|
||||||
|
|
||||||
<http://www.opensource.org/licenses/mit-license.php>
|
|
||||||
124
vendor/github.com/dustin/go-humanize/README.markdown
generated
vendored
124
vendor/github.com/dustin/go-humanize/README.markdown
generated
vendored
@@ -1,124 +0,0 @@
|
|||||||
# Humane Units [](https://travis-ci.org/dustin/go-humanize) [](https://godoc.org/github.com/dustin/go-humanize)
|
|
||||||
|
|
||||||
Just a few functions for helping humanize times and sizes.
|
|
||||||
|
|
||||||
`go get` it as `github.com/dustin/go-humanize`, import it as
|
|
||||||
`"github.com/dustin/go-humanize"`, use it as `humanize`.
|
|
||||||
|
|
||||||
See [godoc](https://pkg.go.dev/github.com/dustin/go-humanize) for
|
|
||||||
complete documentation.
|
|
||||||
|
|
||||||
## Sizes
|
|
||||||
|
|
||||||
This lets you take numbers like `82854982` and convert them to useful
|
|
||||||
strings like, `83 MB` or `79 MiB` (whichever you prefer).
|
|
||||||
|
|
||||||
Example:
|
|
||||||
|
|
||||||
```go
|
|
||||||
fmt.Printf("That file is %s.", humanize.Bytes(82854982)) // That file is 83 MB.
|
|
||||||
```
|
|
||||||
|
|
||||||
## Times
|
|
||||||
|
|
||||||
This lets you take a `time.Time` and spit it out in relative terms.
|
|
||||||
For example, `12 seconds ago` or `3 days from now`.
|
|
||||||
|
|
||||||
Example:
|
|
||||||
|
|
||||||
```go
|
|
||||||
fmt.Printf("This was touched %s.", humanize.Time(someTimeInstance)) // This was touched 7 hours ago.
|
|
||||||
```
|
|
||||||
|
|
||||||
Thanks to Kyle Lemons for the time implementation from an IRC
|
|
||||||
conversation one day. It's pretty neat.
|
|
||||||
|
|
||||||
## Ordinals
|
|
||||||
|
|
||||||
From a [mailing list discussion][odisc] where a user wanted to be able
|
|
||||||
to label ordinals.
|
|
||||||
|
|
||||||
0 -> 0th
|
|
||||||
1 -> 1st
|
|
||||||
2 -> 2nd
|
|
||||||
3 -> 3rd
|
|
||||||
4 -> 4th
|
|
||||||
[...]
|
|
||||||
|
|
||||||
Example:
|
|
||||||
|
|
||||||
```go
|
|
||||||
fmt.Printf("You're my %s best friend.", humanize.Ordinal(193)) // You are my 193rd best friend.
|
|
||||||
```
|
|
||||||
|
|
||||||
## Commas
|
|
||||||
|
|
||||||
Want to shove commas into numbers? Be my guest.
|
|
||||||
|
|
||||||
0 -> 0
|
|
||||||
100 -> 100
|
|
||||||
1000 -> 1,000
|
|
||||||
1000000000 -> 1,000,000,000
|
|
||||||
-100000 -> -100,000
|
|
||||||
|
|
||||||
Example:
|
|
||||||
|
|
||||||
```go
|
|
||||||
fmt.Printf("You owe $%s.\n", humanize.Comma(6582491)) // You owe $6,582,491.
|
|
||||||
```
|
|
||||||
|
|
||||||
## Ftoa
|
|
||||||
|
|
||||||
Nicer float64 formatter that removes trailing zeros.
|
|
||||||
|
|
||||||
```go
|
|
||||||
fmt.Printf("%f", 2.24) // 2.240000
|
|
||||||
fmt.Printf("%s", humanize.Ftoa(2.24)) // 2.24
|
|
||||||
fmt.Printf("%f", 2.0) // 2.000000
|
|
||||||
fmt.Printf("%s", humanize.Ftoa(2.0)) // 2
|
|
||||||
```
|
|
||||||
|
|
||||||
## SI notation
|
|
||||||
|
|
||||||
Format numbers with [SI notation][sinotation].
|
|
||||||
|
|
||||||
Example:
|
|
||||||
|
|
||||||
```go
|
|
||||||
humanize.SI(0.00000000223, "M") // 2.23 nM
|
|
||||||
```
|
|
||||||
|
|
||||||
## English-specific functions
|
|
||||||
|
|
||||||
The following functions are in the `humanize/english` subpackage.
|
|
||||||
|
|
||||||
### Plurals
|
|
||||||
|
|
||||||
Simple English pluralization
|
|
||||||
|
|
||||||
```go
|
|
||||||
english.PluralWord(1, "object", "") // object
|
|
||||||
english.PluralWord(42, "object", "") // objects
|
|
||||||
english.PluralWord(2, "bus", "") // buses
|
|
||||||
english.PluralWord(99, "locus", "loci") // loci
|
|
||||||
|
|
||||||
english.Plural(1, "object", "") // 1 object
|
|
||||||
english.Plural(42, "object", "") // 42 objects
|
|
||||||
english.Plural(2, "bus", "") // 2 buses
|
|
||||||
english.Plural(99, "locus", "loci") // 99 loci
|
|
||||||
```
|
|
||||||
|
|
||||||
### Word series
|
|
||||||
|
|
||||||
Format comma-separated words lists with conjuctions:
|
|
||||||
|
|
||||||
```go
|
|
||||||
english.WordSeries([]string{"foo"}, "and") // foo
|
|
||||||
english.WordSeries([]string{"foo", "bar"}, "and") // foo and bar
|
|
||||||
english.WordSeries([]string{"foo", "bar", "baz"}, "and") // foo, bar and baz
|
|
||||||
|
|
||||||
english.OxfordWordSeries([]string{"foo", "bar", "baz"}, "and") // foo, bar, and baz
|
|
||||||
```
|
|
||||||
|
|
||||||
[odisc]: https://groups.google.com/d/topic/golang-nuts/l8NhI74jl-4/discussion
|
|
||||||
[sinotation]: http://en.wikipedia.org/wiki/Metric_prefix
|
|
||||||
31
vendor/github.com/dustin/go-humanize/big.go
generated
vendored
31
vendor/github.com/dustin/go-humanize/big.go
generated
vendored
@@ -1,31 +0,0 @@
|
|||||||
package humanize
|
|
||||||
|
|
||||||
import (
|
|
||||||
"math/big"
|
|
||||||
)
|
|
||||||
|
|
||||||
// order of magnitude (to a max order)
|
|
||||||
func oomm(n, b *big.Int, maxmag int) (float64, int) {
|
|
||||||
mag := 0
|
|
||||||
m := &big.Int{}
|
|
||||||
for n.Cmp(b) >= 0 {
|
|
||||||
n.DivMod(n, b, m)
|
|
||||||
mag++
|
|
||||||
if mag == maxmag && maxmag >= 0 {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return float64(n.Int64()) + (float64(m.Int64()) / float64(b.Int64())), mag
|
|
||||||
}
|
|
||||||
|
|
||||||
// total order of magnitude
|
|
||||||
// (same as above, but with no upper limit)
|
|
||||||
func oom(n, b *big.Int) (float64, int) {
|
|
||||||
mag := 0
|
|
||||||
m := &big.Int{}
|
|
||||||
for n.Cmp(b) >= 0 {
|
|
||||||
n.DivMod(n, b, m)
|
|
||||||
mag++
|
|
||||||
}
|
|
||||||
return float64(n.Int64()) + (float64(m.Int64()) / float64(b.Int64())), mag
|
|
||||||
}
|
|
||||||
189
vendor/github.com/dustin/go-humanize/bigbytes.go
generated
vendored
189
vendor/github.com/dustin/go-humanize/bigbytes.go
generated
vendored
@@ -1,189 +0,0 @@
|
|||||||
package humanize
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
"math/big"
|
|
||||||
"strings"
|
|
||||||
"unicode"
|
|
||||||
)
|
|
||||||
|
|
||||||
var (
|
|
||||||
bigIECExp = big.NewInt(1024)
|
|
||||||
|
|
||||||
// BigByte is one byte in bit.Ints
|
|
||||||
BigByte = big.NewInt(1)
|
|
||||||
// BigKiByte is 1,024 bytes in bit.Ints
|
|
||||||
BigKiByte = (&big.Int{}).Mul(BigByte, bigIECExp)
|
|
||||||
// BigMiByte is 1,024 k bytes in bit.Ints
|
|
||||||
BigMiByte = (&big.Int{}).Mul(BigKiByte, bigIECExp)
|
|
||||||
// BigGiByte is 1,024 m bytes in bit.Ints
|
|
||||||
BigGiByte = (&big.Int{}).Mul(BigMiByte, bigIECExp)
|
|
||||||
// BigTiByte is 1,024 g bytes in bit.Ints
|
|
||||||
BigTiByte = (&big.Int{}).Mul(BigGiByte, bigIECExp)
|
|
||||||
// BigPiByte is 1,024 t bytes in bit.Ints
|
|
||||||
BigPiByte = (&big.Int{}).Mul(BigTiByte, bigIECExp)
|
|
||||||
// BigEiByte is 1,024 p bytes in bit.Ints
|
|
||||||
BigEiByte = (&big.Int{}).Mul(BigPiByte, bigIECExp)
|
|
||||||
// BigZiByte is 1,024 e bytes in bit.Ints
|
|
||||||
BigZiByte = (&big.Int{}).Mul(BigEiByte, bigIECExp)
|
|
||||||
// BigYiByte is 1,024 z bytes in bit.Ints
|
|
||||||
BigYiByte = (&big.Int{}).Mul(BigZiByte, bigIECExp)
|
|
||||||
// BigRiByte is 1,024 y bytes in bit.Ints
|
|
||||||
BigRiByte = (&big.Int{}).Mul(BigYiByte, bigIECExp)
|
|
||||||
// BigQiByte is 1,024 r bytes in bit.Ints
|
|
||||||
BigQiByte = (&big.Int{}).Mul(BigRiByte, bigIECExp)
|
|
||||||
)
|
|
||||||
|
|
||||||
var (
|
|
||||||
bigSIExp = big.NewInt(1000)
|
|
||||||
|
|
||||||
// BigSIByte is one SI byte in big.Ints
|
|
||||||
BigSIByte = big.NewInt(1)
|
|
||||||
// BigKByte is 1,000 SI bytes in big.Ints
|
|
||||||
BigKByte = (&big.Int{}).Mul(BigSIByte, bigSIExp)
|
|
||||||
// BigMByte is 1,000 SI k bytes in big.Ints
|
|
||||||
BigMByte = (&big.Int{}).Mul(BigKByte, bigSIExp)
|
|
||||||
// BigGByte is 1,000 SI m bytes in big.Ints
|
|
||||||
BigGByte = (&big.Int{}).Mul(BigMByte, bigSIExp)
|
|
||||||
// BigTByte is 1,000 SI g bytes in big.Ints
|
|
||||||
BigTByte = (&big.Int{}).Mul(BigGByte, bigSIExp)
|
|
||||||
// BigPByte is 1,000 SI t bytes in big.Ints
|
|
||||||
BigPByte = (&big.Int{}).Mul(BigTByte, bigSIExp)
|
|
||||||
// BigEByte is 1,000 SI p bytes in big.Ints
|
|
||||||
BigEByte = (&big.Int{}).Mul(BigPByte, bigSIExp)
|
|
||||||
// BigZByte is 1,000 SI e bytes in big.Ints
|
|
||||||
BigZByte = (&big.Int{}).Mul(BigEByte, bigSIExp)
|
|
||||||
// BigYByte is 1,000 SI z bytes in big.Ints
|
|
||||||
BigYByte = (&big.Int{}).Mul(BigZByte, bigSIExp)
|
|
||||||
// BigRByte is 1,000 SI y bytes in big.Ints
|
|
||||||
BigRByte = (&big.Int{}).Mul(BigYByte, bigSIExp)
|
|
||||||
// BigQByte is 1,000 SI r bytes in big.Ints
|
|
||||||
BigQByte = (&big.Int{}).Mul(BigRByte, bigSIExp)
|
|
||||||
)
|
|
||||||
|
|
||||||
var bigBytesSizeTable = map[string]*big.Int{
|
|
||||||
"b": BigByte,
|
|
||||||
"kib": BigKiByte,
|
|
||||||
"kb": BigKByte,
|
|
||||||
"mib": BigMiByte,
|
|
||||||
"mb": BigMByte,
|
|
||||||
"gib": BigGiByte,
|
|
||||||
"gb": BigGByte,
|
|
||||||
"tib": BigTiByte,
|
|
||||||
"tb": BigTByte,
|
|
||||||
"pib": BigPiByte,
|
|
||||||
"pb": BigPByte,
|
|
||||||
"eib": BigEiByte,
|
|
||||||
"eb": BigEByte,
|
|
||||||
"zib": BigZiByte,
|
|
||||||
"zb": BigZByte,
|
|
||||||
"yib": BigYiByte,
|
|
||||||
"yb": BigYByte,
|
|
||||||
"rib": BigRiByte,
|
|
||||||
"rb": BigRByte,
|
|
||||||
"qib": BigQiByte,
|
|
||||||
"qb": BigQByte,
|
|
||||||
// Without suffix
|
|
||||||
"": BigByte,
|
|
||||||
"ki": BigKiByte,
|
|
||||||
"k": BigKByte,
|
|
||||||
"mi": BigMiByte,
|
|
||||||
"m": BigMByte,
|
|
||||||
"gi": BigGiByte,
|
|
||||||
"g": BigGByte,
|
|
||||||
"ti": BigTiByte,
|
|
||||||
"t": BigTByte,
|
|
||||||
"pi": BigPiByte,
|
|
||||||
"p": BigPByte,
|
|
||||||
"ei": BigEiByte,
|
|
||||||
"e": BigEByte,
|
|
||||||
"z": BigZByte,
|
|
||||||
"zi": BigZiByte,
|
|
||||||
"y": BigYByte,
|
|
||||||
"yi": BigYiByte,
|
|
||||||
"r": BigRByte,
|
|
||||||
"ri": BigRiByte,
|
|
||||||
"q": BigQByte,
|
|
||||||
"qi": BigQiByte,
|
|
||||||
}
|
|
||||||
|
|
||||||
var ten = big.NewInt(10)
|
|
||||||
|
|
||||||
func humanateBigBytes(s, base *big.Int, sizes []string) string {
|
|
||||||
if s.Cmp(ten) < 0 {
|
|
||||||
return fmt.Sprintf("%d B", s)
|
|
||||||
}
|
|
||||||
c := (&big.Int{}).Set(s)
|
|
||||||
val, mag := oomm(c, base, len(sizes)-1)
|
|
||||||
suffix := sizes[mag]
|
|
||||||
f := "%.0f %s"
|
|
||||||
if val < 10 {
|
|
||||||
f = "%.1f %s"
|
|
||||||
}
|
|
||||||
|
|
||||||
return fmt.Sprintf(f, val, suffix)
|
|
||||||
|
|
||||||
}
|
|
||||||
|
|
||||||
// BigBytes produces a human readable representation of an SI size.
|
|
||||||
//
|
|
||||||
// See also: ParseBigBytes.
|
|
||||||
//
|
|
||||||
// BigBytes(82854982) -> 83 MB
|
|
||||||
func BigBytes(s *big.Int) string {
|
|
||||||
sizes := []string{"B", "kB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB", "RB", "QB"}
|
|
||||||
return humanateBigBytes(s, bigSIExp, sizes)
|
|
||||||
}
|
|
||||||
|
|
||||||
// BigIBytes produces a human readable representation of an IEC size.
|
|
||||||
//
|
|
||||||
// See also: ParseBigBytes.
|
|
||||||
//
|
|
||||||
// BigIBytes(82854982) -> 79 MiB
|
|
||||||
func BigIBytes(s *big.Int) string {
|
|
||||||
sizes := []string{"B", "KiB", "MiB", "GiB", "TiB", "PiB", "EiB", "ZiB", "YiB", "RiB", "QiB"}
|
|
||||||
return humanateBigBytes(s, bigIECExp, sizes)
|
|
||||||
}
|
|
||||||
|
|
||||||
// ParseBigBytes parses a string representation of bytes into the number
|
|
||||||
// of bytes it represents.
|
|
||||||
//
|
|
||||||
// See also: BigBytes, BigIBytes.
|
|
||||||
//
|
|
||||||
// ParseBigBytes("42 MB") -> 42000000, nil
|
|
||||||
// ParseBigBytes("42 mib") -> 44040192, nil
|
|
||||||
func ParseBigBytes(s string) (*big.Int, error) {
|
|
||||||
lastDigit := 0
|
|
||||||
hasComma := false
|
|
||||||
for _, r := range s {
|
|
||||||
if !(unicode.IsDigit(r) || r == '.' || r == ',') {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
if r == ',' {
|
|
||||||
hasComma = true
|
|
||||||
}
|
|
||||||
lastDigit++
|
|
||||||
}
|
|
||||||
|
|
||||||
num := s[:lastDigit]
|
|
||||||
if hasComma {
|
|
||||||
num = strings.Replace(num, ",", "", -1)
|
|
||||||
}
|
|
||||||
|
|
||||||
val := &big.Rat{}
|
|
||||||
_, err := fmt.Sscanf(num, "%f", val)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
|
|
||||||
extra := strings.ToLower(strings.TrimSpace(s[lastDigit:]))
|
|
||||||
if m, ok := bigBytesSizeTable[extra]; ok {
|
|
||||||
mv := (&big.Rat{}).SetInt(m)
|
|
||||||
val.Mul(val, mv)
|
|
||||||
rv := &big.Int{}
|
|
||||||
rv.Div(val.Num(), val.Denom())
|
|
||||||
return rv, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
return nil, fmt.Errorf("unhandled size name: %v", extra)
|
|
||||||
}
|
|
||||||
143
vendor/github.com/dustin/go-humanize/bytes.go
generated
vendored
143
vendor/github.com/dustin/go-humanize/bytes.go
generated
vendored
@@ -1,143 +0,0 @@
|
|||||||
package humanize
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
"math"
|
|
||||||
"strconv"
|
|
||||||
"strings"
|
|
||||||
"unicode"
|
|
||||||
)
|
|
||||||
|
|
||||||
// IEC Sizes.
|
|
||||||
// kibis of bits
|
|
||||||
const (
|
|
||||||
Byte = 1 << (iota * 10)
|
|
||||||
KiByte
|
|
||||||
MiByte
|
|
||||||
GiByte
|
|
||||||
TiByte
|
|
||||||
PiByte
|
|
||||||
EiByte
|
|
||||||
)
|
|
||||||
|
|
||||||
// SI Sizes.
|
|
||||||
const (
|
|
||||||
IByte = 1
|
|
||||||
KByte = IByte * 1000
|
|
||||||
MByte = KByte * 1000
|
|
||||||
GByte = MByte * 1000
|
|
||||||
TByte = GByte * 1000
|
|
||||||
PByte = TByte * 1000
|
|
||||||
EByte = PByte * 1000
|
|
||||||
)
|
|
||||||
|
|
||||||
var bytesSizeTable = map[string]uint64{
|
|
||||||
"b": Byte,
|
|
||||||
"kib": KiByte,
|
|
||||||
"kb": KByte,
|
|
||||||
"mib": MiByte,
|
|
||||||
"mb": MByte,
|
|
||||||
"gib": GiByte,
|
|
||||||
"gb": GByte,
|
|
||||||
"tib": TiByte,
|
|
||||||
"tb": TByte,
|
|
||||||
"pib": PiByte,
|
|
||||||
"pb": PByte,
|
|
||||||
"eib": EiByte,
|
|
||||||
"eb": EByte,
|
|
||||||
// Without suffix
|
|
||||||
"": Byte,
|
|
||||||
"ki": KiByte,
|
|
||||||
"k": KByte,
|
|
||||||
"mi": MiByte,
|
|
||||||
"m": MByte,
|
|
||||||
"gi": GiByte,
|
|
||||||
"g": GByte,
|
|
||||||
"ti": TiByte,
|
|
||||||
"t": TByte,
|
|
||||||
"pi": PiByte,
|
|
||||||
"p": PByte,
|
|
||||||
"ei": EiByte,
|
|
||||||
"e": EByte,
|
|
||||||
}
|
|
||||||
|
|
||||||
func logn(n, b float64) float64 {
|
|
||||||
return math.Log(n) / math.Log(b)
|
|
||||||
}
|
|
||||||
|
|
||||||
func humanateBytes(s uint64, base float64, sizes []string) string {
|
|
||||||
if s < 10 {
|
|
||||||
return fmt.Sprintf("%d B", s)
|
|
||||||
}
|
|
||||||
e := math.Floor(logn(float64(s), base))
|
|
||||||
suffix := sizes[int(e)]
|
|
||||||
val := math.Floor(float64(s)/math.Pow(base, e)*10+0.5) / 10
|
|
||||||
f := "%.0f %s"
|
|
||||||
if val < 10 {
|
|
||||||
f = "%.1f %s"
|
|
||||||
}
|
|
||||||
|
|
||||||
return fmt.Sprintf(f, val, suffix)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Bytes produces a human readable representation of an SI size.
|
|
||||||
//
|
|
||||||
// See also: ParseBytes.
|
|
||||||
//
|
|
||||||
// Bytes(82854982) -> 83 MB
|
|
||||||
func Bytes(s uint64) string {
|
|
||||||
sizes := []string{"B", "kB", "MB", "GB", "TB", "PB", "EB"}
|
|
||||||
return humanateBytes(s, 1000, sizes)
|
|
||||||
}
|
|
||||||
|
|
||||||
// IBytes produces a human readable representation of an IEC size.
|
|
||||||
//
|
|
||||||
// See also: ParseBytes.
|
|
||||||
//
|
|
||||||
// IBytes(82854982) -> 79 MiB
|
|
||||||
func IBytes(s uint64) string {
|
|
||||||
sizes := []string{"B", "KiB", "MiB", "GiB", "TiB", "PiB", "EiB"}
|
|
||||||
return humanateBytes(s, 1024, sizes)
|
|
||||||
}
|
|
||||||
|
|
||||||
// ParseBytes parses a string representation of bytes into the number
|
|
||||||
// of bytes it represents.
|
|
||||||
//
|
|
||||||
// See Also: Bytes, IBytes.
|
|
||||||
//
|
|
||||||
// ParseBytes("42 MB") -> 42000000, nil
|
|
||||||
// ParseBytes("42 mib") -> 44040192, nil
|
|
||||||
func ParseBytes(s string) (uint64, error) {
|
|
||||||
lastDigit := 0
|
|
||||||
hasComma := false
|
|
||||||
for _, r := range s {
|
|
||||||
if !(unicode.IsDigit(r) || r == '.' || r == ',') {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
if r == ',' {
|
|
||||||
hasComma = true
|
|
||||||
}
|
|
||||||
lastDigit++
|
|
||||||
}
|
|
||||||
|
|
||||||
num := s[:lastDigit]
|
|
||||||
if hasComma {
|
|
||||||
num = strings.Replace(num, ",", "", -1)
|
|
||||||
}
|
|
||||||
|
|
||||||
f, err := strconv.ParseFloat(num, 64)
|
|
||||||
if err != nil {
|
|
||||||
return 0, err
|
|
||||||
}
|
|
||||||
|
|
||||||
extra := strings.ToLower(strings.TrimSpace(s[lastDigit:]))
|
|
||||||
if m, ok := bytesSizeTable[extra]; ok {
|
|
||||||
f *= float64(m)
|
|
||||||
if f >= math.MaxUint64 {
|
|
||||||
return 0, fmt.Errorf("too large: %v", s)
|
|
||||||
}
|
|
||||||
return uint64(f), nil
|
|
||||||
}
|
|
||||||
|
|
||||||
return 0, fmt.Errorf("unhandled size name: %v", extra)
|
|
||||||
}
|
|
||||||
116
vendor/github.com/dustin/go-humanize/comma.go
generated
vendored
116
vendor/github.com/dustin/go-humanize/comma.go
generated
vendored
@@ -1,116 +0,0 @@
|
|||||||
package humanize
|
|
||||||
|
|
||||||
import (
|
|
||||||
"bytes"
|
|
||||||
"math"
|
|
||||||
"math/big"
|
|
||||||
"strconv"
|
|
||||||
"strings"
|
|
||||||
)
|
|
||||||
|
|
||||||
// Comma produces a string form of the given number in base 10 with
|
|
||||||
// commas after every three orders of magnitude.
|
|
||||||
//
|
|
||||||
// e.g. Comma(834142) -> 834,142
|
|
||||||
func Comma(v int64) string {
|
|
||||||
sign := ""
|
|
||||||
|
|
||||||
// Min int64 can't be negated to a usable value, so it has to be special cased.
|
|
||||||
if v == math.MinInt64 {
|
|
||||||
return "-9,223,372,036,854,775,808"
|
|
||||||
}
|
|
||||||
|
|
||||||
if v < 0 {
|
|
||||||
sign = "-"
|
|
||||||
v = 0 - v
|
|
||||||
}
|
|
||||||
|
|
||||||
parts := []string{"", "", "", "", "", "", ""}
|
|
||||||
j := len(parts) - 1
|
|
||||||
|
|
||||||
for v > 999 {
|
|
||||||
parts[j] = strconv.FormatInt(v%1000, 10)
|
|
||||||
switch len(parts[j]) {
|
|
||||||
case 2:
|
|
||||||
parts[j] = "0" + parts[j]
|
|
||||||
case 1:
|
|
||||||
parts[j] = "00" + parts[j]
|
|
||||||
}
|
|
||||||
v = v / 1000
|
|
||||||
j--
|
|
||||||
}
|
|
||||||
parts[j] = strconv.Itoa(int(v))
|
|
||||||
return sign + strings.Join(parts[j:], ",")
|
|
||||||
}
|
|
||||||
|
|
||||||
// Commaf produces a string form of the given number in base 10 with
|
|
||||||
// commas after every three orders of magnitude.
|
|
||||||
//
|
|
||||||
// e.g. Commaf(834142.32) -> 834,142.32
|
|
||||||
func Commaf(v float64) string {
|
|
||||||
buf := &bytes.Buffer{}
|
|
||||||
if v < 0 {
|
|
||||||
buf.Write([]byte{'-'})
|
|
||||||
v = 0 - v
|
|
||||||
}
|
|
||||||
|
|
||||||
comma := []byte{','}
|
|
||||||
|
|
||||||
parts := strings.Split(strconv.FormatFloat(v, 'f', -1, 64), ".")
|
|
||||||
pos := 0
|
|
||||||
if len(parts[0])%3 != 0 {
|
|
||||||
pos += len(parts[0]) % 3
|
|
||||||
buf.WriteString(parts[0][:pos])
|
|
||||||
buf.Write(comma)
|
|
||||||
}
|
|
||||||
for ; pos < len(parts[0]); pos += 3 {
|
|
||||||
buf.WriteString(parts[0][pos : pos+3])
|
|
||||||
buf.Write(comma)
|
|
||||||
}
|
|
||||||
buf.Truncate(buf.Len() - 1)
|
|
||||||
|
|
||||||
if len(parts) > 1 {
|
|
||||||
buf.Write([]byte{'.'})
|
|
||||||
buf.WriteString(parts[1])
|
|
||||||
}
|
|
||||||
return buf.String()
|
|
||||||
}
|
|
||||||
|
|
||||||
// CommafWithDigits works like the Commaf but limits the resulting
|
|
||||||
// string to the given number of decimal places.
|
|
||||||
//
|
|
||||||
// e.g. CommafWithDigits(834142.32, 1) -> 834,142.3
|
|
||||||
func CommafWithDigits(f float64, decimals int) string {
|
|
||||||
return stripTrailingDigits(Commaf(f), decimals)
|
|
||||||
}
|
|
||||||
|
|
||||||
// BigComma produces a string form of the given big.Int in base 10
|
|
||||||
// with commas after every three orders of magnitude.
|
|
||||||
func BigComma(b *big.Int) string {
|
|
||||||
sign := ""
|
|
||||||
if b.Sign() < 0 {
|
|
||||||
sign = "-"
|
|
||||||
b.Abs(b)
|
|
||||||
}
|
|
||||||
|
|
||||||
athousand := big.NewInt(1000)
|
|
||||||
c := (&big.Int{}).Set(b)
|
|
||||||
_, m := oom(c, athousand)
|
|
||||||
parts := make([]string, m+1)
|
|
||||||
j := len(parts) - 1
|
|
||||||
|
|
||||||
mod := &big.Int{}
|
|
||||||
for b.Cmp(athousand) >= 0 {
|
|
||||||
b.DivMod(b, athousand, mod)
|
|
||||||
parts[j] = strconv.FormatInt(mod.Int64(), 10)
|
|
||||||
switch len(parts[j]) {
|
|
||||||
case 2:
|
|
||||||
parts[j] = "0" + parts[j]
|
|
||||||
case 1:
|
|
||||||
parts[j] = "00" + parts[j]
|
|
||||||
}
|
|
||||||
j--
|
|
||||||
}
|
|
||||||
parts[j] = strconv.Itoa(int(b.Int64()))
|
|
||||||
return sign + strings.Join(parts[j:], ",")
|
|
||||||
}
|
|
||||||
41
vendor/github.com/dustin/go-humanize/commaf.go
generated
vendored
41
vendor/github.com/dustin/go-humanize/commaf.go
generated
vendored
@@ -1,41 +0,0 @@
|
|||||||
//go:build go1.6
|
|
||||||
// +build go1.6
|
|
||||||
|
|
||||||
package humanize
|
|
||||||
|
|
||||||
import (
|
|
||||||
"bytes"
|
|
||||||
"math/big"
|
|
||||||
"strings"
|
|
||||||
)
|
|
||||||
|
|
||||||
// BigCommaf produces a string form of the given big.Float in base 10
|
|
||||||
// with commas after every three orders of magnitude.
|
|
||||||
func BigCommaf(v *big.Float) string {
|
|
||||||
buf := &bytes.Buffer{}
|
|
||||||
if v.Sign() < 0 {
|
|
||||||
buf.Write([]byte{'-'})
|
|
||||||
v.Abs(v)
|
|
||||||
}
|
|
||||||
|
|
||||||
comma := []byte{','}
|
|
||||||
|
|
||||||
parts := strings.Split(v.Text('f', -1), ".")
|
|
||||||
pos := 0
|
|
||||||
if len(parts[0])%3 != 0 {
|
|
||||||
pos += len(parts[0]) % 3
|
|
||||||
buf.WriteString(parts[0][:pos])
|
|
||||||
buf.Write(comma)
|
|
||||||
}
|
|
||||||
for ; pos < len(parts[0]); pos += 3 {
|
|
||||||
buf.WriteString(parts[0][pos : pos+3])
|
|
||||||
buf.Write(comma)
|
|
||||||
}
|
|
||||||
buf.Truncate(buf.Len() - 1)
|
|
||||||
|
|
||||||
if len(parts) > 1 {
|
|
||||||
buf.Write([]byte{'.'})
|
|
||||||
buf.WriteString(parts[1])
|
|
||||||
}
|
|
||||||
return buf.String()
|
|
||||||
}
|
|
||||||
49
vendor/github.com/dustin/go-humanize/ftoa.go
generated
vendored
49
vendor/github.com/dustin/go-humanize/ftoa.go
generated
vendored
@@ -1,49 +0,0 @@
|
|||||||
package humanize
|
|
||||||
|
|
||||||
import (
|
|
||||||
"strconv"
|
|
||||||
"strings"
|
|
||||||
)
|
|
||||||
|
|
||||||
func stripTrailingZeros(s string) string {
|
|
||||||
if !strings.ContainsRune(s, '.') {
|
|
||||||
return s
|
|
||||||
}
|
|
||||||
offset := len(s) - 1
|
|
||||||
for offset > 0 {
|
|
||||||
if s[offset] == '.' {
|
|
||||||
offset--
|
|
||||||
break
|
|
||||||
}
|
|
||||||
if s[offset] != '0' {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
offset--
|
|
||||||
}
|
|
||||||
return s[:offset+1]
|
|
||||||
}
|
|
||||||
|
|
||||||
func stripTrailingDigits(s string, digits int) string {
|
|
||||||
if i := strings.Index(s, "."); i >= 0 {
|
|
||||||
if digits <= 0 {
|
|
||||||
return s[:i]
|
|
||||||
}
|
|
||||||
i++
|
|
||||||
if i+digits >= len(s) {
|
|
||||||
return s
|
|
||||||
}
|
|
||||||
return s[:i+digits]
|
|
||||||
}
|
|
||||||
return s
|
|
||||||
}
|
|
||||||
|
|
||||||
// Ftoa converts a float to a string with no trailing zeros.
|
|
||||||
func Ftoa(num float64) string {
|
|
||||||
return stripTrailingZeros(strconv.FormatFloat(num, 'f', 6, 64))
|
|
||||||
}
|
|
||||||
|
|
||||||
// FtoaWithDigits converts a float to a string but limits the resulting string
|
|
||||||
// to the given number of decimal places, and no trailing zeros.
|
|
||||||
func FtoaWithDigits(num float64, digits int) string {
|
|
||||||
return stripTrailingZeros(stripTrailingDigits(strconv.FormatFloat(num, 'f', 6, 64), digits))
|
|
||||||
}
|
|
||||||
8
vendor/github.com/dustin/go-humanize/humanize.go
generated
vendored
8
vendor/github.com/dustin/go-humanize/humanize.go
generated
vendored
@@ -1,8 +0,0 @@
|
|||||||
/*
|
|
||||||
Package humanize converts boring ugly numbers to human-friendly strings and back.
|
|
||||||
|
|
||||||
Durations can be turned into strings such as "3 days ago", numbers
|
|
||||||
representing sizes like 82854982 into useful strings like, "83 MB" or
|
|
||||||
"79 MiB" (whichever you prefer).
|
|
||||||
*/
|
|
||||||
package humanize
|
|
||||||
192
vendor/github.com/dustin/go-humanize/number.go
generated
vendored
192
vendor/github.com/dustin/go-humanize/number.go
generated
vendored
@@ -1,192 +0,0 @@
|
|||||||
package humanize
|
|
||||||
|
|
||||||
/*
|
|
||||||
Slightly adapted from the source to fit go-humanize.
|
|
||||||
|
|
||||||
Author: https://github.com/gorhill
|
|
||||||
Source: https://gist.github.com/gorhill/5285193
|
|
||||||
|
|
||||||
*/
|
|
||||||
|
|
||||||
import (
|
|
||||||
"math"
|
|
||||||
"strconv"
|
|
||||||
)
|
|
||||||
|
|
||||||
var (
|
|
||||||
renderFloatPrecisionMultipliers = [...]float64{
|
|
||||||
1,
|
|
||||||
10,
|
|
||||||
100,
|
|
||||||
1000,
|
|
||||||
10000,
|
|
||||||
100000,
|
|
||||||
1000000,
|
|
||||||
10000000,
|
|
||||||
100000000,
|
|
||||||
1000000000,
|
|
||||||
}
|
|
||||||
|
|
||||||
renderFloatPrecisionRounders = [...]float64{
|
|
||||||
0.5,
|
|
||||||
0.05,
|
|
||||||
0.005,
|
|
||||||
0.0005,
|
|
||||||
0.00005,
|
|
||||||
0.000005,
|
|
||||||
0.0000005,
|
|
||||||
0.00000005,
|
|
||||||
0.000000005,
|
|
||||||
0.0000000005,
|
|
||||||
}
|
|
||||||
)
|
|
||||||
|
|
||||||
// FormatFloat produces a formatted number as string based on the following user-specified criteria:
|
|
||||||
// * thousands separator
|
|
||||||
// * decimal separator
|
|
||||||
// * decimal precision
|
|
||||||
//
|
|
||||||
// Usage: s := RenderFloat(format, n)
|
|
||||||
// The format parameter tells how to render the number n.
|
|
||||||
//
|
|
||||||
// See examples: http://play.golang.org/p/LXc1Ddm1lJ
|
|
||||||
//
|
|
||||||
// Examples of format strings, given n = 12345.6789:
|
|
||||||
// "#,###.##" => "12,345.67"
|
|
||||||
// "#,###." => "12,345"
|
|
||||||
// "#,###" => "12345,678"
|
|
||||||
// "#\u202F###,##" => "12 345,68"
|
|
||||||
// "#.###,###### => 12.345,678900
|
|
||||||
// "" (aka default format) => 12,345.67
|
|
||||||
//
|
|
||||||
// The highest precision allowed is 9 digits after the decimal symbol.
|
|
||||||
// There is also a version for integer number, FormatInteger(),
|
|
||||||
// which is convenient for calls within template.
|
|
||||||
func FormatFloat(format string, n float64) string {
|
|
||||||
// Special cases:
|
|
||||||
// NaN = "NaN"
|
|
||||||
// +Inf = "+Infinity"
|
|
||||||
// -Inf = "-Infinity"
|
|
||||||
if math.IsNaN(n) {
|
|
||||||
return "NaN"
|
|
||||||
}
|
|
||||||
if n > math.MaxFloat64 {
|
|
||||||
return "Infinity"
|
|
||||||
}
|
|
||||||
if n < (0.0 - math.MaxFloat64) {
|
|
||||||
return "-Infinity"
|
|
||||||
}
|
|
||||||
|
|
||||||
// default format
|
|
||||||
precision := 2
|
|
||||||
decimalStr := "."
|
|
||||||
thousandStr := ","
|
|
||||||
positiveStr := ""
|
|
||||||
negativeStr := "-"
|
|
||||||
|
|
||||||
if len(format) > 0 {
|
|
||||||
format := []rune(format)
|
|
||||||
|
|
||||||
// If there is an explicit format directive,
|
|
||||||
// then default values are these:
|
|
||||||
precision = 9
|
|
||||||
thousandStr = ""
|
|
||||||
|
|
||||||
// collect indices of meaningful formatting directives
|
|
||||||
formatIndx := []int{}
|
|
||||||
for i, char := range format {
|
|
||||||
if char != '#' && char != '0' {
|
|
||||||
formatIndx = append(formatIndx, i)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if len(formatIndx) > 0 {
|
|
||||||
// Directive at index 0:
|
|
||||||
// Must be a '+'
|
|
||||||
// Raise an error if not the case
|
|
||||||
// index: 0123456789
|
|
||||||
// +0.000,000
|
|
||||||
// +000,000.0
|
|
||||||
// +0000.00
|
|
||||||
// +0000
|
|
||||||
if formatIndx[0] == 0 {
|
|
||||||
if format[formatIndx[0]] != '+' {
|
|
||||||
panic("RenderFloat(): invalid positive sign directive")
|
|
||||||
}
|
|
||||||
positiveStr = "+"
|
|
||||||
formatIndx = formatIndx[1:]
|
|
||||||
}
|
|
||||||
|
|
||||||
// Two directives:
|
|
||||||
// First is thousands separator
|
|
||||||
// Raise an error if not followed by 3-digit
|
|
||||||
// 0123456789
|
|
||||||
// 0.000,000
|
|
||||||
// 000,000.00
|
|
||||||
if len(formatIndx) == 2 {
|
|
||||||
if (formatIndx[1] - formatIndx[0]) != 4 {
|
|
||||||
panic("RenderFloat(): thousands separator directive must be followed by 3 digit-specifiers")
|
|
||||||
}
|
|
||||||
thousandStr = string(format[formatIndx[0]])
|
|
||||||
formatIndx = formatIndx[1:]
|
|
||||||
}
|
|
||||||
|
|
||||||
// One directive:
|
|
||||||
// Directive is decimal separator
|
|
||||||
// The number of digit-specifier following the separator indicates wanted precision
|
|
||||||
// 0123456789
|
|
||||||
// 0.00
|
|
||||||
// 000,0000
|
|
||||||
if len(formatIndx) == 1 {
|
|
||||||
decimalStr = string(format[formatIndx[0]])
|
|
||||||
precision = len(format) - formatIndx[0] - 1
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// generate sign part
|
|
||||||
var signStr string
|
|
||||||
if n >= 0.000000001 {
|
|
||||||
signStr = positiveStr
|
|
||||||
} else if n <= -0.000000001 {
|
|
||||||
signStr = negativeStr
|
|
||||||
n = -n
|
|
||||||
} else {
|
|
||||||
signStr = ""
|
|
||||||
n = 0.0
|
|
||||||
}
|
|
||||||
|
|
||||||
// split number into integer and fractional parts
|
|
||||||
intf, fracf := math.Modf(n + renderFloatPrecisionRounders[precision])
|
|
||||||
|
|
||||||
// generate integer part string
|
|
||||||
intStr := strconv.FormatInt(int64(intf), 10)
|
|
||||||
|
|
||||||
// add thousand separator if required
|
|
||||||
if len(thousandStr) > 0 {
|
|
||||||
for i := len(intStr); i > 3; {
|
|
||||||
i -= 3
|
|
||||||
intStr = intStr[:i] + thousandStr + intStr[i:]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// no fractional part, we can leave now
|
|
||||||
if precision == 0 {
|
|
||||||
return signStr + intStr
|
|
||||||
}
|
|
||||||
|
|
||||||
// generate fractional part
|
|
||||||
fracStr := strconv.Itoa(int(fracf * renderFloatPrecisionMultipliers[precision]))
|
|
||||||
// may need padding
|
|
||||||
if len(fracStr) < precision {
|
|
||||||
fracStr = "000000000000000"[:precision-len(fracStr)] + fracStr
|
|
||||||
}
|
|
||||||
|
|
||||||
return signStr + intStr + decimalStr + fracStr
|
|
||||||
}
|
|
||||||
|
|
||||||
// FormatInteger produces a formatted number as string.
|
|
||||||
// See FormatFloat.
|
|
||||||
func FormatInteger(format string, n int) string {
|
|
||||||
return FormatFloat(format, float64(n))
|
|
||||||
}
|
|
||||||
25
vendor/github.com/dustin/go-humanize/ordinals.go
generated
vendored
25
vendor/github.com/dustin/go-humanize/ordinals.go
generated
vendored
@@ -1,25 +0,0 @@
|
|||||||
package humanize
|
|
||||||
|
|
||||||
import "strconv"
|
|
||||||
|
|
||||||
// Ordinal gives you the input number in a rank/ordinal format.
|
|
||||||
//
|
|
||||||
// Ordinal(3) -> 3rd
|
|
||||||
func Ordinal(x int) string {
|
|
||||||
suffix := "th"
|
|
||||||
switch x % 10 {
|
|
||||||
case 1:
|
|
||||||
if x%100 != 11 {
|
|
||||||
suffix = "st"
|
|
||||||
}
|
|
||||||
case 2:
|
|
||||||
if x%100 != 12 {
|
|
||||||
suffix = "nd"
|
|
||||||
}
|
|
||||||
case 3:
|
|
||||||
if x%100 != 13 {
|
|
||||||
suffix = "rd"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return strconv.Itoa(x) + suffix
|
|
||||||
}
|
|
||||||
127
vendor/github.com/dustin/go-humanize/si.go
generated
vendored
127
vendor/github.com/dustin/go-humanize/si.go
generated
vendored
@@ -1,127 +0,0 @@
|
|||||||
package humanize
|
|
||||||
|
|
||||||
import (
|
|
||||||
"errors"
|
|
||||||
"math"
|
|
||||||
"regexp"
|
|
||||||
"strconv"
|
|
||||||
)
|
|
||||||
|
|
||||||
var siPrefixTable = map[float64]string{
|
|
||||||
-30: "q", // quecto
|
|
||||||
-27: "r", // ronto
|
|
||||||
-24: "y", // yocto
|
|
||||||
-21: "z", // zepto
|
|
||||||
-18: "a", // atto
|
|
||||||
-15: "f", // femto
|
|
||||||
-12: "p", // pico
|
|
||||||
-9: "n", // nano
|
|
||||||
-6: "µ", // micro
|
|
||||||
-3: "m", // milli
|
|
||||||
0: "",
|
|
||||||
3: "k", // kilo
|
|
||||||
6: "M", // mega
|
|
||||||
9: "G", // giga
|
|
||||||
12: "T", // tera
|
|
||||||
15: "P", // peta
|
|
||||||
18: "E", // exa
|
|
||||||
21: "Z", // zetta
|
|
||||||
24: "Y", // yotta
|
|
||||||
27: "R", // ronna
|
|
||||||
30: "Q", // quetta
|
|
||||||
}
|
|
||||||
|
|
||||||
var revSIPrefixTable = revfmap(siPrefixTable)
|
|
||||||
|
|
||||||
// revfmap reverses the map and precomputes the power multiplier
|
|
||||||
func revfmap(in map[float64]string) map[string]float64 {
|
|
||||||
rv := map[string]float64{}
|
|
||||||
for k, v := range in {
|
|
||||||
rv[v] = math.Pow(10, k)
|
|
||||||
}
|
|
||||||
return rv
|
|
||||||
}
|
|
||||||
|
|
||||||
var riParseRegex *regexp.Regexp
|
|
||||||
|
|
||||||
func init() {
|
|
||||||
ri := `^([\-0-9.]+)\s?([`
|
|
||||||
for _, v := range siPrefixTable {
|
|
||||||
ri += v
|
|
||||||
}
|
|
||||||
ri += `]?)(.*)`
|
|
||||||
|
|
||||||
riParseRegex = regexp.MustCompile(ri)
|
|
||||||
}
|
|
||||||
|
|
||||||
// ComputeSI finds the most appropriate SI prefix for the given number
|
|
||||||
// and returns the prefix along with the value adjusted to be within
|
|
||||||
// that prefix.
|
|
||||||
//
|
|
||||||
// See also: SI, ParseSI.
|
|
||||||
//
|
|
||||||
// e.g. ComputeSI(2.2345e-12) -> (2.2345, "p")
|
|
||||||
func ComputeSI(input float64) (float64, string) {
|
|
||||||
if input == 0 {
|
|
||||||
return 0, ""
|
|
||||||
}
|
|
||||||
mag := math.Abs(input)
|
|
||||||
exponent := math.Floor(logn(mag, 10))
|
|
||||||
exponent = math.Floor(exponent/3) * 3
|
|
||||||
|
|
||||||
value := mag / math.Pow(10, exponent)
|
|
||||||
|
|
||||||
// Handle special case where value is exactly 1000.0
|
|
||||||
// Should return 1 M instead of 1000 k
|
|
||||||
if value == 1000.0 {
|
|
||||||
exponent += 3
|
|
||||||
value = mag / math.Pow(10, exponent)
|
|
||||||
}
|
|
||||||
|
|
||||||
value = math.Copysign(value, input)
|
|
||||||
|
|
||||||
prefix := siPrefixTable[exponent]
|
|
||||||
return value, prefix
|
|
||||||
}
|
|
||||||
|
|
||||||
// SI returns a string with default formatting.
|
|
||||||
//
|
|
||||||
// SI uses Ftoa to format float value, removing trailing zeros.
|
|
||||||
//
|
|
||||||
// See also: ComputeSI, ParseSI.
|
|
||||||
//
|
|
||||||
// e.g. SI(1000000, "B") -> 1 MB
|
|
||||||
// e.g. SI(2.2345e-12, "F") -> 2.2345 pF
|
|
||||||
func SI(input float64, unit string) string {
|
|
||||||
value, prefix := ComputeSI(input)
|
|
||||||
return Ftoa(value) + " " + prefix + unit
|
|
||||||
}
|
|
||||||
|
|
||||||
// SIWithDigits works like SI but limits the resulting string to the
|
|
||||||
// given number of decimal places.
|
|
||||||
//
|
|
||||||
// e.g. SIWithDigits(1000000, 0, "B") -> 1 MB
|
|
||||||
// e.g. SIWithDigits(2.2345e-12, 2, "F") -> 2.23 pF
|
|
||||||
func SIWithDigits(input float64, decimals int, unit string) string {
|
|
||||||
value, prefix := ComputeSI(input)
|
|
||||||
return FtoaWithDigits(value, decimals) + " " + prefix + unit
|
|
||||||
}
|
|
||||||
|
|
||||||
var errInvalid = errors.New("invalid input")
|
|
||||||
|
|
||||||
// ParseSI parses an SI string back into the number and unit.
|
|
||||||
//
|
|
||||||
// See also: SI, ComputeSI.
|
|
||||||
//
|
|
||||||
// e.g. ParseSI("2.2345 pF") -> (2.2345e-12, "F", nil)
|
|
||||||
func ParseSI(input string) (float64, string, error) {
|
|
||||||
found := riParseRegex.FindStringSubmatch(input)
|
|
||||||
if len(found) != 4 {
|
|
||||||
return 0, "", errInvalid
|
|
||||||
}
|
|
||||||
mag := revSIPrefixTable[found[2]]
|
|
||||||
unit := found[3]
|
|
||||||
|
|
||||||
base, err := strconv.ParseFloat(found[1], 64)
|
|
||||||
return base * mag, unit, err
|
|
||||||
}
|
|
||||||
117
vendor/github.com/dustin/go-humanize/times.go
generated
vendored
117
vendor/github.com/dustin/go-humanize/times.go
generated
vendored
@@ -1,117 +0,0 @@
|
|||||||
package humanize
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
"math"
|
|
||||||
"sort"
|
|
||||||
"time"
|
|
||||||
)
|
|
||||||
|
|
||||||
// Seconds-based time units
|
|
||||||
const (
|
|
||||||
Day = 24 * time.Hour
|
|
||||||
Week = 7 * Day
|
|
||||||
Month = 30 * Day
|
|
||||||
Year = 12 * Month
|
|
||||||
LongTime = 37 * Year
|
|
||||||
)
|
|
||||||
|
|
||||||
// Time formats a time into a relative string.
|
|
||||||
//
|
|
||||||
// Time(someT) -> "3 weeks ago"
|
|
||||||
func Time(then time.Time) string {
|
|
||||||
return RelTime(then, time.Now(), "ago", "from now")
|
|
||||||
}
|
|
||||||
|
|
||||||
// A RelTimeMagnitude struct contains a relative time point at which
|
|
||||||
// the relative format of time will switch to a new format string. A
|
|
||||||
// slice of these in ascending order by their "D" field is passed to
|
|
||||||
// CustomRelTime to format durations.
|
|
||||||
//
|
|
||||||
// The Format field is a string that may contain a "%s" which will be
|
|
||||||
// replaced with the appropriate signed label (e.g. "ago" or "from
|
|
||||||
// now") and a "%d" that will be replaced by the quantity.
|
|
||||||
//
|
|
||||||
// The DivBy field is the amount of time the time difference must be
|
|
||||||
// divided by in order to display correctly.
|
|
||||||
//
|
|
||||||
// e.g. if D is 2*time.Minute and you want to display "%d minutes %s"
|
|
||||||
// DivBy should be time.Minute so whatever the duration is will be
|
|
||||||
// expressed in minutes.
|
|
||||||
type RelTimeMagnitude struct {
|
|
||||||
D time.Duration
|
|
||||||
Format string
|
|
||||||
DivBy time.Duration
|
|
||||||
}
|
|
||||||
|
|
||||||
var defaultMagnitudes = []RelTimeMagnitude{
|
|
||||||
{time.Second, "now", time.Second},
|
|
||||||
{2 * time.Second, "1 second %s", 1},
|
|
||||||
{time.Minute, "%d seconds %s", time.Second},
|
|
||||||
{2 * time.Minute, "1 minute %s", 1},
|
|
||||||
{time.Hour, "%d minutes %s", time.Minute},
|
|
||||||
{2 * time.Hour, "1 hour %s", 1},
|
|
||||||
{Day, "%d hours %s", time.Hour},
|
|
||||||
{2 * Day, "1 day %s", 1},
|
|
||||||
{Week, "%d days %s", Day},
|
|
||||||
{2 * Week, "1 week %s", 1},
|
|
||||||
{Month, "%d weeks %s", Week},
|
|
||||||
{2 * Month, "1 month %s", 1},
|
|
||||||
{Year, "%d months %s", Month},
|
|
||||||
{18 * Month, "1 year %s", 1},
|
|
||||||
{2 * Year, "2 years %s", 1},
|
|
||||||
{LongTime, "%d years %s", Year},
|
|
||||||
{math.MaxInt64, "a long while %s", 1},
|
|
||||||
}
|
|
||||||
|
|
||||||
// RelTime formats a time into a relative string.
|
|
||||||
//
|
|
||||||
// It takes two times and two labels. In addition to the generic time
|
|
||||||
// delta string (e.g. 5 minutes), the labels are used applied so that
|
|
||||||
// the label corresponding to the smaller time is applied.
|
|
||||||
//
|
|
||||||
// RelTime(timeInPast, timeInFuture, "earlier", "later") -> "3 weeks earlier"
|
|
||||||
func RelTime(a, b time.Time, albl, blbl string) string {
|
|
||||||
return CustomRelTime(a, b, albl, blbl, defaultMagnitudes)
|
|
||||||
}
|
|
||||||
|
|
||||||
// CustomRelTime formats a time into a relative string.
|
|
||||||
//
|
|
||||||
// It takes two times two labels and a table of relative time formats.
|
|
||||||
// In addition to the generic time delta string (e.g. 5 minutes), the
|
|
||||||
// labels are used applied so that the label corresponding to the
|
|
||||||
// smaller time is applied.
|
|
||||||
func CustomRelTime(a, b time.Time, albl, blbl string, magnitudes []RelTimeMagnitude) string {
|
|
||||||
lbl := albl
|
|
||||||
diff := b.Sub(a)
|
|
||||||
|
|
||||||
if a.After(b) {
|
|
||||||
lbl = blbl
|
|
||||||
diff = a.Sub(b)
|
|
||||||
}
|
|
||||||
|
|
||||||
n := sort.Search(len(magnitudes), func(i int) bool {
|
|
||||||
return magnitudes[i].D > diff
|
|
||||||
})
|
|
||||||
|
|
||||||
if n >= len(magnitudes) {
|
|
||||||
n = len(magnitudes) - 1
|
|
||||||
}
|
|
||||||
mag := magnitudes[n]
|
|
||||||
args := []interface{}{}
|
|
||||||
escaped := false
|
|
||||||
for _, ch := range mag.Format {
|
|
||||||
if escaped {
|
|
||||||
switch ch {
|
|
||||||
case 's':
|
|
||||||
args = append(args, lbl)
|
|
||||||
case 'd':
|
|
||||||
args = append(args, diff/mag.DivBy)
|
|
||||||
}
|
|
||||||
escaped = false
|
|
||||||
} else {
|
|
||||||
escaped = ch == '%'
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return fmt.Sprintf(mag.Format, args...)
|
|
||||||
}
|
|
||||||
14
vendor/github.com/fsnotify/fsnotify/.cirrus.yml
generated
vendored
14
vendor/github.com/fsnotify/fsnotify/.cirrus.yml
generated
vendored
@@ -1,14 +0,0 @@
|
|||||||
freebsd_task:
|
|
||||||
name: 'FreeBSD'
|
|
||||||
freebsd_instance:
|
|
||||||
image_family: freebsd-14-2
|
|
||||||
install_script:
|
|
||||||
- pkg update -f
|
|
||||||
- pkg install -y go
|
|
||||||
test_script:
|
|
||||||
# run tests as user "cirrus" instead of root
|
|
||||||
- pw useradd cirrus -m
|
|
||||||
- chown -R cirrus:cirrus .
|
|
||||||
- FSNOTIFY_BUFFER=4096 sudo --preserve-env=FSNOTIFY_BUFFER -u cirrus go test -parallel 1 -race ./...
|
|
||||||
- sudo --preserve-env=FSNOTIFY_BUFFER -u cirrus go test -parallel 1 -race ./...
|
|
||||||
- FSNOTIFY_DEBUG=1 sudo --preserve-env=FSNOTIFY_BUFFER -u cirrus go test -parallel 1 -race -v ./...
|
|
||||||
10
vendor/github.com/fsnotify/fsnotify/.gitignore
generated
vendored
10
vendor/github.com/fsnotify/fsnotify/.gitignore
generated
vendored
@@ -1,10 +0,0 @@
|
|||||||
# go test -c output
|
|
||||||
*.test
|
|
||||||
*.test.exe
|
|
||||||
|
|
||||||
# Output of go build ./cmd/fsnotify
|
|
||||||
/fsnotify
|
|
||||||
/fsnotify.exe
|
|
||||||
|
|
||||||
/test/kqueue
|
|
||||||
/test/a.out
|
|
||||||
2
vendor/github.com/fsnotify/fsnotify/.mailmap
generated
vendored
2
vendor/github.com/fsnotify/fsnotify/.mailmap
generated
vendored
@@ -1,2 +0,0 @@
|
|||||||
Chris Howey <howeyc@gmail.com> <chris@howey.me>
|
|
||||||
Nathan Youngman <git@nathany.com> <4566+nathany@users.noreply.github.com>
|
|
||||||
602
vendor/github.com/fsnotify/fsnotify/CHANGELOG.md
generated
vendored
602
vendor/github.com/fsnotify/fsnotify/CHANGELOG.md
generated
vendored
@@ -1,602 +0,0 @@
|
|||||||
# Changelog
|
|
||||||
|
|
||||||
1.9.0 2024-04-04
|
|
||||||
----------------
|
|
||||||
|
|
||||||
### Changes and fixes
|
|
||||||
|
|
||||||
- all: make BufferedWatcher buffered again ([#657])
|
|
||||||
|
|
||||||
- inotify: fix race when adding/removing watches while a watched path is being
|
|
||||||
deleted ([#678], [#686])
|
|
||||||
|
|
||||||
- inotify: don't send empty event if a watched path is unmounted ([#655])
|
|
||||||
|
|
||||||
- inotify: don't register duplicate watches when watching both a symlink and its
|
|
||||||
target; previously that would get "half-added" and removing the second would
|
|
||||||
panic ([#679])
|
|
||||||
|
|
||||||
- kqueue: fix watching relative symlinks ([#681])
|
|
||||||
|
|
||||||
- kqueue: correctly mark pre-existing entries when watching a link to a dir on
|
|
||||||
kqueue ([#682])
|
|
||||||
|
|
||||||
- illumos: don't send error if changed file is deleted while processing the
|
|
||||||
event ([#678])
|
|
||||||
|
|
||||||
|
|
||||||
[#657]: https://github.com/fsnotify/fsnotify/pull/657
|
|
||||||
[#678]: https://github.com/fsnotify/fsnotify/pull/678
|
|
||||||
[#686]: https://github.com/fsnotify/fsnotify/pull/686
|
|
||||||
[#655]: https://github.com/fsnotify/fsnotify/pull/655
|
|
||||||
[#681]: https://github.com/fsnotify/fsnotify/pull/681
|
|
||||||
[#679]: https://github.com/fsnotify/fsnotify/pull/679
|
|
||||||
[#682]: https://github.com/fsnotify/fsnotify/pull/682
|
|
||||||
|
|
||||||
1.8.0 2024-10-31
|
|
||||||
----------------
|
|
||||||
|
|
||||||
### Additions
|
|
||||||
|
|
||||||
- all: add `FSNOTIFY_DEBUG` to print debug logs to stderr ([#619])
|
|
||||||
|
|
||||||
### Changes and fixes
|
|
||||||
|
|
||||||
- windows: fix behaviour of `WatchList()` to be consistent with other platforms ([#610])
|
|
||||||
|
|
||||||
- kqueue: ignore events with Ident=0 ([#590])
|
|
||||||
|
|
||||||
- kqueue: set O_CLOEXEC to prevent passing file descriptors to children ([#617])
|
|
||||||
|
|
||||||
- kqueue: emit events as "/path/dir/file" instead of "path/link/file" when watching a symlink ([#625])
|
|
||||||
|
|
||||||
- inotify: don't send event for IN_DELETE_SELF when also watching the parent ([#620])
|
|
||||||
|
|
||||||
- inotify: fix panic when calling Remove() in a goroutine ([#650])
|
|
||||||
|
|
||||||
- fen: allow watching subdirectories of watched directories ([#621])
|
|
||||||
|
|
||||||
[#590]: https://github.com/fsnotify/fsnotify/pull/590
|
|
||||||
[#610]: https://github.com/fsnotify/fsnotify/pull/610
|
|
||||||
[#617]: https://github.com/fsnotify/fsnotify/pull/617
|
|
||||||
[#619]: https://github.com/fsnotify/fsnotify/pull/619
|
|
||||||
[#620]: https://github.com/fsnotify/fsnotify/pull/620
|
|
||||||
[#621]: https://github.com/fsnotify/fsnotify/pull/621
|
|
||||||
[#625]: https://github.com/fsnotify/fsnotify/pull/625
|
|
||||||
[#650]: https://github.com/fsnotify/fsnotify/pull/650
|
|
||||||
|
|
||||||
1.7.0 - 2023-10-22
|
|
||||||
------------------
|
|
||||||
This version of fsnotify needs Go 1.17.
|
|
||||||
|
|
||||||
### Additions
|
|
||||||
|
|
||||||
- illumos: add FEN backend to support illumos and Solaris. ([#371])
|
|
||||||
|
|
||||||
- all: add `NewBufferedWatcher()` to use a buffered channel, which can be useful
|
|
||||||
in cases where you can't control the kernel buffer and receive a large number
|
|
||||||
of events in bursts. ([#550], [#572])
|
|
||||||
|
|
||||||
- all: add `AddWith()`, which is identical to `Add()` but allows passing
|
|
||||||
options. ([#521])
|
|
||||||
|
|
||||||
- windows: allow setting the ReadDirectoryChangesW() buffer size with
|
|
||||||
`fsnotify.WithBufferSize()`; the default of 64K is the highest value that
|
|
||||||
works on all platforms and is enough for most purposes, but in some cases a
|
|
||||||
highest buffer is needed. ([#521])
|
|
||||||
|
|
||||||
### Changes and fixes
|
|
||||||
|
|
||||||
- inotify: remove watcher if a watched path is renamed ([#518])
|
|
||||||
|
|
||||||
After a rename the reported name wasn't updated, or even an empty string.
|
|
||||||
Inotify doesn't provide any good facilities to update it, so just remove the
|
|
||||||
watcher. This is already how it worked on kqueue and FEN.
|
|
||||||
|
|
||||||
On Windows this does work, and remains working.
|
|
||||||
|
|
||||||
- windows: don't listen for file attribute changes ([#520])
|
|
||||||
|
|
||||||
File attribute changes are sent as `FILE_ACTION_MODIFIED` by the Windows API,
|
|
||||||
with no way to see if they're a file write or attribute change, so would show
|
|
||||||
up as a fsnotify.Write event. This is never useful, and could result in many
|
|
||||||
spurious Write events.
|
|
||||||
|
|
||||||
- windows: return `ErrEventOverflow` if the buffer is full ([#525])
|
|
||||||
|
|
||||||
Before it would merely return "short read", making it hard to detect this
|
|
||||||
error.
|
|
||||||
|
|
||||||
- kqueue: make sure events for all files are delivered properly when removing a
|
|
||||||
watched directory ([#526])
|
|
||||||
|
|
||||||
Previously they would get sent with `""` (empty string) or `"."` as the path
|
|
||||||
name.
|
|
||||||
|
|
||||||
- kqueue: don't emit spurious Create events for symbolic links ([#524])
|
|
||||||
|
|
||||||
The link would get resolved but kqueue would "forget" it already saw the link
|
|
||||||
itself, resulting on a Create for every Write event for the directory.
|
|
||||||
|
|
||||||
- all: return `ErrClosed` on `Add()` when the watcher is closed ([#516])
|
|
||||||
|
|
||||||
- other: add `Watcher.Errors` and `Watcher.Events` to the no-op `Watcher` in
|
|
||||||
`backend_other.go`, making it easier to use on unsupported platforms such as
|
|
||||||
WASM, AIX, etc. ([#528])
|
|
||||||
|
|
||||||
- other: use the `backend_other.go` no-op if the `appengine` build tag is set;
|
|
||||||
Google AppEngine forbids usage of the unsafe package so the inotify backend
|
|
||||||
won't compile there.
|
|
||||||
|
|
||||||
[#371]: https://github.com/fsnotify/fsnotify/pull/371
|
|
||||||
[#516]: https://github.com/fsnotify/fsnotify/pull/516
|
|
||||||
[#518]: https://github.com/fsnotify/fsnotify/pull/518
|
|
||||||
[#520]: https://github.com/fsnotify/fsnotify/pull/520
|
|
||||||
[#521]: https://github.com/fsnotify/fsnotify/pull/521
|
|
||||||
[#524]: https://github.com/fsnotify/fsnotify/pull/524
|
|
||||||
[#525]: https://github.com/fsnotify/fsnotify/pull/525
|
|
||||||
[#526]: https://github.com/fsnotify/fsnotify/pull/526
|
|
||||||
[#528]: https://github.com/fsnotify/fsnotify/pull/528
|
|
||||||
[#537]: https://github.com/fsnotify/fsnotify/pull/537
|
|
||||||
[#550]: https://github.com/fsnotify/fsnotify/pull/550
|
|
||||||
[#572]: https://github.com/fsnotify/fsnotify/pull/572
|
|
||||||
|
|
||||||
1.6.0 - 2022-10-13
|
|
||||||
------------------
|
|
||||||
This version of fsnotify needs Go 1.16 (this was already the case since 1.5.1,
|
|
||||||
but not documented). It also increases the minimum Linux version to 2.6.32.
|
|
||||||
|
|
||||||
### Additions
|
|
||||||
|
|
||||||
- all: add `Event.Has()` and `Op.Has()` ([#477])
|
|
||||||
|
|
||||||
This makes checking events a lot easier; for example:
|
|
||||||
|
|
||||||
if event.Op&Write == Write && !(event.Op&Remove == Remove) {
|
|
||||||
}
|
|
||||||
|
|
||||||
Becomes:
|
|
||||||
|
|
||||||
if event.Has(Write) && !event.Has(Remove) {
|
|
||||||
}
|
|
||||||
|
|
||||||
- all: add cmd/fsnotify ([#463])
|
|
||||||
|
|
||||||
A command-line utility for testing and some examples.
|
|
||||||
|
|
||||||
### Changes and fixes
|
|
||||||
|
|
||||||
- inotify: don't ignore events for files that don't exist ([#260], [#470])
|
|
||||||
|
|
||||||
Previously the inotify watcher would call `os.Lstat()` to check if a file
|
|
||||||
still exists before emitting events.
|
|
||||||
|
|
||||||
This was inconsistent with other platforms and resulted in inconsistent event
|
|
||||||
reporting (e.g. when a file is quickly removed and re-created), and generally
|
|
||||||
a source of confusion. It was added in 2013 to fix a memory leak that no
|
|
||||||
longer exists.
|
|
||||||
|
|
||||||
- all: return `ErrNonExistentWatch` when `Remove()` is called on a path that's
|
|
||||||
not watched ([#460])
|
|
||||||
|
|
||||||
- inotify: replace epoll() with non-blocking inotify ([#434])
|
|
||||||
|
|
||||||
Non-blocking inotify was not generally available at the time this library was
|
|
||||||
written in 2014, but now it is. As a result, the minimum Linux version is
|
|
||||||
bumped from 2.6.27 to 2.6.32. This hugely simplifies the code and is faster.
|
|
||||||
|
|
||||||
- kqueue: don't check for events every 100ms ([#480])
|
|
||||||
|
|
||||||
The watcher would wake up every 100ms, even when there was nothing to do. Now
|
|
||||||
it waits until there is something to do.
|
|
||||||
|
|
||||||
- macos: retry opening files on EINTR ([#475])
|
|
||||||
|
|
||||||
- kqueue: skip unreadable files ([#479])
|
|
||||||
|
|
||||||
kqueue requires a file descriptor for every file in a directory; this would
|
|
||||||
fail if a file was unreadable by the current user. Now these files are simply
|
|
||||||
skipped.
|
|
||||||
|
|
||||||
- windows: fix renaming a watched directory if the parent is also watched ([#370])
|
|
||||||
|
|
||||||
- windows: increase buffer size from 4K to 64K ([#485])
|
|
||||||
|
|
||||||
- windows: close file handle on Remove() ([#288])
|
|
||||||
|
|
||||||
- kqueue: put pathname in the error if watching a file fails ([#471])
|
|
||||||
|
|
||||||
- inotify, windows: calling Close() more than once could race ([#465])
|
|
||||||
|
|
||||||
- kqueue: improve Close() performance ([#233])
|
|
||||||
|
|
||||||
- all: various documentation additions and clarifications.
|
|
||||||
|
|
||||||
[#233]: https://github.com/fsnotify/fsnotify/pull/233
|
|
||||||
[#260]: https://github.com/fsnotify/fsnotify/pull/260
|
|
||||||
[#288]: https://github.com/fsnotify/fsnotify/pull/288
|
|
||||||
[#370]: https://github.com/fsnotify/fsnotify/pull/370
|
|
||||||
[#434]: https://github.com/fsnotify/fsnotify/pull/434
|
|
||||||
[#460]: https://github.com/fsnotify/fsnotify/pull/460
|
|
||||||
[#463]: https://github.com/fsnotify/fsnotify/pull/463
|
|
||||||
[#465]: https://github.com/fsnotify/fsnotify/pull/465
|
|
||||||
[#470]: https://github.com/fsnotify/fsnotify/pull/470
|
|
||||||
[#471]: https://github.com/fsnotify/fsnotify/pull/471
|
|
||||||
[#475]: https://github.com/fsnotify/fsnotify/pull/475
|
|
||||||
[#477]: https://github.com/fsnotify/fsnotify/pull/477
|
|
||||||
[#479]: https://github.com/fsnotify/fsnotify/pull/479
|
|
||||||
[#480]: https://github.com/fsnotify/fsnotify/pull/480
|
|
||||||
[#485]: https://github.com/fsnotify/fsnotify/pull/485
|
|
||||||
|
|
||||||
## [1.5.4] - 2022-04-25
|
|
||||||
|
|
||||||
* Windows: add missing defer to `Watcher.WatchList` [#447](https://github.com/fsnotify/fsnotify/pull/447)
|
|
||||||
* go.mod: use latest x/sys [#444](https://github.com/fsnotify/fsnotify/pull/444)
|
|
||||||
* Fix compilation for OpenBSD [#443](https://github.com/fsnotify/fsnotify/pull/443)
|
|
||||||
|
|
||||||
## [1.5.3] - 2022-04-22
|
|
||||||
|
|
||||||
* This version is retracted. An incorrect branch is published accidentally [#445](https://github.com/fsnotify/fsnotify/issues/445)
|
|
||||||
|
|
||||||
## [1.5.2] - 2022-04-21
|
|
||||||
|
|
||||||
* Add a feature to return the directories and files that are being monitored [#374](https://github.com/fsnotify/fsnotify/pull/374)
|
|
||||||
* Fix potential crash on windows if `raw.FileNameLength` exceeds `syscall.MAX_PATH` [#361](https://github.com/fsnotify/fsnotify/pull/361)
|
|
||||||
* Allow build on unsupported GOOS [#424](https://github.com/fsnotify/fsnotify/pull/424)
|
|
||||||
* Don't set `poller.fd` twice in `newFdPoller` [#406](https://github.com/fsnotify/fsnotify/pull/406)
|
|
||||||
* fix go vet warnings: call to `(*T).Fatalf` from a non-test goroutine [#416](https://github.com/fsnotify/fsnotify/pull/416)
|
|
||||||
|
|
||||||
## [1.5.1] - 2021-08-24
|
|
||||||
|
|
||||||
* Revert Add AddRaw to not follow symlinks [#394](https://github.com/fsnotify/fsnotify/pull/394)
|
|
||||||
|
|
||||||
## [1.5.0] - 2021-08-20
|
|
||||||
|
|
||||||
* Go: Increase minimum required version to Go 1.12 [#381](https://github.com/fsnotify/fsnotify/pull/381)
|
|
||||||
* Feature: Add AddRaw method which does not follow symlinks when adding a watch [#289](https://github.com/fsnotify/fsnotify/pull/298)
|
|
||||||
* Windows: Follow symlinks by default like on all other systems [#289](https://github.com/fsnotify/fsnotify/pull/289)
|
|
||||||
* CI: Use GitHub Actions for CI and cover go 1.12-1.17
|
|
||||||
[#378](https://github.com/fsnotify/fsnotify/pull/378)
|
|
||||||
[#381](https://github.com/fsnotify/fsnotify/pull/381)
|
|
||||||
[#385](https://github.com/fsnotify/fsnotify/pull/385)
|
|
||||||
* Go 1.14+: Fix unsafe pointer conversion [#325](https://github.com/fsnotify/fsnotify/pull/325)
|
|
||||||
|
|
||||||
## [1.4.9] - 2020-03-11
|
|
||||||
|
|
||||||
* Move example usage to the readme #329. This may resolve #328.
|
|
||||||
|
|
||||||
## [1.4.8] - 2020-03-10
|
|
||||||
|
|
||||||
* CI: test more go versions (@nathany 1d13583d846ea9d66dcabbfefbfb9d8e6fb05216)
|
|
||||||
* Tests: Queued inotify events could have been read by the test before max_queued_events was hit (@matthias-stone #265)
|
|
||||||
* Tests: t.Fatalf -> t.Errorf in go routines (@gdey #266)
|
|
||||||
* CI: Less verbosity (@nathany #267)
|
|
||||||
* Tests: Darwin: Exchangedata is deprecated on 10.13 (@nathany #267)
|
|
||||||
* Tests: Check if channels are closed in the example (@alexeykazakov #244)
|
|
||||||
* CI: Only run golint on latest version of go and fix issues (@cpuguy83 #284)
|
|
||||||
* CI: Add windows to travis matrix (@cpuguy83 #284)
|
|
||||||
* Docs: Remover appveyor badge (@nathany 11844c0959f6fff69ba325d097fce35bd85a8e93)
|
|
||||||
* Linux: create epoll and pipe fds with close-on-exec (@JohannesEbke #219)
|
|
||||||
* Linux: open files with close-on-exec (@linxiulei #273)
|
|
||||||
* Docs: Plan to support fanotify (@nathany ab058b44498e8b7566a799372a39d150d9ea0119 )
|
|
||||||
* Project: Add go.mod (@nathany #309)
|
|
||||||
* Project: Revise editor config (@nathany #309)
|
|
||||||
* Project: Update copyright for 2019 (@nathany #309)
|
|
||||||
* CI: Drop go1.8 from CI matrix (@nathany #309)
|
|
||||||
* Docs: Updating the FAQ section for supportability with NFS & FUSE filesystems (@Pratik32 4bf2d1fec78374803a39307bfb8d340688f4f28e )
|
|
||||||
|
|
||||||
## [1.4.7] - 2018-01-09
|
|
||||||
|
|
||||||
* BSD/macOS: Fix possible deadlock on closing the watcher on kqueue (thanks @nhooyr and @glycerine)
|
|
||||||
* Tests: Fix missing verb on format string (thanks @rchiossi)
|
|
||||||
* Linux: Fix deadlock in Remove (thanks @aarondl)
|
|
||||||
* Linux: Watch.Add improvements (avoid race, fix consistency, reduce garbage) (thanks @twpayne)
|
|
||||||
* Docs: Moved FAQ into the README (thanks @vahe)
|
|
||||||
* Linux: Properly handle inotify's IN_Q_OVERFLOW event (thanks @zeldovich)
|
|
||||||
* Docs: replace references to OS X with macOS
|
|
||||||
|
|
||||||
## [1.4.2] - 2016-10-10
|
|
||||||
|
|
||||||
* Linux: use InotifyInit1 with IN_CLOEXEC to stop leaking a file descriptor to a child process when using fork/exec [#178](https://github.com/fsnotify/fsnotify/pull/178) (thanks @pattyshack)
|
|
||||||
|
|
||||||
## [1.4.1] - 2016-10-04
|
|
||||||
|
|
||||||
* Fix flaky inotify stress test on Linux [#177](https://github.com/fsnotify/fsnotify/pull/177) (thanks @pattyshack)
|
|
||||||
|
|
||||||
## [1.4.0] - 2016-10-01
|
|
||||||
|
|
||||||
* add a String() method to Event.Op [#165](https://github.com/fsnotify/fsnotify/pull/165) (thanks @oozie)
|
|
||||||
|
|
||||||
## [1.3.1] - 2016-06-28
|
|
||||||
|
|
||||||
* Windows: fix for double backslash when watching the root of a drive [#151](https://github.com/fsnotify/fsnotify/issues/151) (thanks @brunoqc)
|
|
||||||
|
|
||||||
## [1.3.0] - 2016-04-19
|
|
||||||
|
|
||||||
* Support linux/arm64 by [patching](https://go-review.googlesource.com/#/c/21971/) x/sys/unix and switching to to it from syscall (thanks @suihkulokki) [#135](https://github.com/fsnotify/fsnotify/pull/135)
|
|
||||||
|
|
||||||
## [1.2.10] - 2016-03-02
|
|
||||||
|
|
||||||
* Fix golint errors in windows.go [#121](https://github.com/fsnotify/fsnotify/pull/121) (thanks @tiffanyfj)
|
|
||||||
|
|
||||||
## [1.2.9] - 2016-01-13
|
|
||||||
|
|
||||||
kqueue: Fix logic for CREATE after REMOVE [#111](https://github.com/fsnotify/fsnotify/pull/111) (thanks @bep)
|
|
||||||
|
|
||||||
## [1.2.8] - 2015-12-17
|
|
||||||
|
|
||||||
* kqueue: fix race condition in Close [#105](https://github.com/fsnotify/fsnotify/pull/105) (thanks @djui for reporting the issue and @ppknap for writing a failing test)
|
|
||||||
* inotify: fix race in test
|
|
||||||
* enable race detection for continuous integration (Linux, Mac, Windows)
|
|
||||||
|
|
||||||
## [1.2.5] - 2015-10-17
|
|
||||||
|
|
||||||
* inotify: use epoll_create1 for arm64 support (requires Linux 2.6.27 or later) [#100](https://github.com/fsnotify/fsnotify/pull/100) (thanks @suihkulokki)
|
|
||||||
* inotify: fix path leaks [#73](https://github.com/fsnotify/fsnotify/pull/73) (thanks @chamaken)
|
|
||||||
* kqueue: watch for rename events on subdirectories [#83](https://github.com/fsnotify/fsnotify/pull/83) (thanks @guotie)
|
|
||||||
* kqueue: avoid infinite loops from symlinks cycles [#101](https://github.com/fsnotify/fsnotify/pull/101) (thanks @illicitonion)
|
|
||||||
|
|
||||||
## [1.2.1] - 2015-10-14
|
|
||||||
|
|
||||||
* kqueue: don't watch named pipes [#98](https://github.com/fsnotify/fsnotify/pull/98) (thanks @evanphx)
|
|
||||||
|
|
||||||
## [1.2.0] - 2015-02-08
|
|
||||||
|
|
||||||
* inotify: use epoll to wake up readEvents [#66](https://github.com/fsnotify/fsnotify/pull/66) (thanks @PieterD)
|
|
||||||
* inotify: closing watcher should now always shut down goroutine [#63](https://github.com/fsnotify/fsnotify/pull/63) (thanks @PieterD)
|
|
||||||
* kqueue: close kqueue after removing watches, fixes [#59](https://github.com/fsnotify/fsnotify/issues/59)
|
|
||||||
|
|
||||||
## [1.1.1] - 2015-02-05
|
|
||||||
|
|
||||||
* inotify: Retry read on EINTR [#61](https://github.com/fsnotify/fsnotify/issues/61) (thanks @PieterD)
|
|
||||||
|
|
||||||
## [1.1.0] - 2014-12-12
|
|
||||||
|
|
||||||
* kqueue: rework internals [#43](https://github.com/fsnotify/fsnotify/pull/43)
|
|
||||||
* add low-level functions
|
|
||||||
* only need to store flags on directories
|
|
||||||
* less mutexes [#13](https://github.com/fsnotify/fsnotify/issues/13)
|
|
||||||
* done can be an unbuffered channel
|
|
||||||
* remove calls to os.NewSyscallError
|
|
||||||
* More efficient string concatenation for Event.String() [#52](https://github.com/fsnotify/fsnotify/pull/52) (thanks @mdlayher)
|
|
||||||
* kqueue: fix regression in rework causing subdirectories to be watched [#48](https://github.com/fsnotify/fsnotify/issues/48)
|
|
||||||
* kqueue: cleanup internal watch before sending remove event [#51](https://github.com/fsnotify/fsnotify/issues/51)
|
|
||||||
|
|
||||||
## [1.0.4] - 2014-09-07
|
|
||||||
|
|
||||||
* kqueue: add dragonfly to the build tags.
|
|
||||||
* Rename source code files, rearrange code so exported APIs are at the top.
|
|
||||||
* Add done channel to example code. [#37](https://github.com/fsnotify/fsnotify/pull/37) (thanks @chenyukang)
|
|
||||||
|
|
||||||
## [1.0.3] - 2014-08-19
|
|
||||||
|
|
||||||
* [Fix] Windows MOVED_TO now translates to Create like on BSD and Linux. [#36](https://github.com/fsnotify/fsnotify/issues/36)
|
|
||||||
|
|
||||||
## [1.0.2] - 2014-08-17
|
|
||||||
|
|
||||||
* [Fix] Missing create events on macOS. [#14](https://github.com/fsnotify/fsnotify/issues/14) (thanks @zhsso)
|
|
||||||
* [Fix] Make ./path and path equivalent. (thanks @zhsso)
|
|
||||||
|
|
||||||
## [1.0.0] - 2014-08-15
|
|
||||||
|
|
||||||
* [API] Remove AddWatch on Windows, use Add.
|
|
||||||
* Improve documentation for exported identifiers. [#30](https://github.com/fsnotify/fsnotify/issues/30)
|
|
||||||
* Minor updates based on feedback from golint.
|
|
||||||
|
|
||||||
## dev / 2014-07-09
|
|
||||||
|
|
||||||
* Moved to [github.com/fsnotify/fsnotify](https://github.com/fsnotify/fsnotify).
|
|
||||||
* Use os.NewSyscallError instead of returning errno (thanks @hariharan-uno)
|
|
||||||
|
|
||||||
## dev / 2014-07-04
|
|
||||||
|
|
||||||
* kqueue: fix incorrect mutex used in Close()
|
|
||||||
* Update example to demonstrate usage of Op.
|
|
||||||
|
|
||||||
## dev / 2014-06-28
|
|
||||||
|
|
||||||
* [API] Don't set the Write Op for attribute notifications [#4](https://github.com/fsnotify/fsnotify/issues/4)
|
|
||||||
* Fix for String() method on Event (thanks Alex Brainman)
|
|
||||||
* Don't build on Plan 9 or Solaris (thanks @4ad)
|
|
||||||
|
|
||||||
## dev / 2014-06-21
|
|
||||||
|
|
||||||
* Events channel of type Event rather than *Event.
|
|
||||||
* [internal] use syscall constants directly for inotify and kqueue.
|
|
||||||
* [internal] kqueue: rename events to kevents and fileEvent to event.
|
|
||||||
|
|
||||||
## dev / 2014-06-19
|
|
||||||
|
|
||||||
* Go 1.3+ required on Windows (uses syscall.ERROR_MORE_DATA internally).
|
|
||||||
* [internal] remove cookie from Event struct (unused).
|
|
||||||
* [internal] Event struct has the same definition across every OS.
|
|
||||||
* [internal] remove internal watch and removeWatch methods.
|
|
||||||
|
|
||||||
## dev / 2014-06-12
|
|
||||||
|
|
||||||
* [API] Renamed Watch() to Add() and RemoveWatch() to Remove().
|
|
||||||
* [API] Pluralized channel names: Events and Errors.
|
|
||||||
* [API] Renamed FileEvent struct to Event.
|
|
||||||
* [API] Op constants replace methods like IsCreate().
|
|
||||||
|
|
||||||
## dev / 2014-06-12
|
|
||||||
|
|
||||||
* Fix data race on kevent buffer (thanks @tilaks) [#98](https://github.com/howeyc/fsnotify/pull/98)
|
|
||||||
|
|
||||||
## dev / 2014-05-23
|
|
||||||
|
|
||||||
* [API] Remove current implementation of WatchFlags.
|
|
||||||
* current implementation doesn't take advantage of OS for efficiency
|
|
||||||
* provides little benefit over filtering events as they are received, but has extra bookkeeping and mutexes
|
|
||||||
* no tests for the current implementation
|
|
||||||
* not fully implemented on Windows [#93](https://github.com/howeyc/fsnotify/issues/93#issuecomment-39285195)
|
|
||||||
|
|
||||||
## [0.9.3] - 2014-12-31
|
|
||||||
|
|
||||||
* kqueue: cleanup internal watch before sending remove event [#51](https://github.com/fsnotify/fsnotify/issues/51)
|
|
||||||
|
|
||||||
## [0.9.2] - 2014-08-17
|
|
||||||
|
|
||||||
* [Backport] Fix missing create events on macOS. [#14](https://github.com/fsnotify/fsnotify/issues/14) (thanks @zhsso)
|
|
||||||
|
|
||||||
## [0.9.1] - 2014-06-12
|
|
||||||
|
|
||||||
* Fix data race on kevent buffer (thanks @tilaks) [#98](https://github.com/howeyc/fsnotify/pull/98)
|
|
||||||
|
|
||||||
## [0.9.0] - 2014-01-17
|
|
||||||
|
|
||||||
* IsAttrib() for events that only concern a file's metadata [#79][] (thanks @abustany)
|
|
||||||
* [Fix] kqueue: fix deadlock [#77][] (thanks @cespare)
|
|
||||||
* [NOTICE] Development has moved to `code.google.com/p/go.exp/fsnotify` in preparation for inclusion in the Go standard library.
|
|
||||||
|
|
||||||
## [0.8.12] - 2013-11-13
|
|
||||||
|
|
||||||
* [API] Remove FD_SET and friends from Linux adapter
|
|
||||||
|
|
||||||
## [0.8.11] - 2013-11-02
|
|
||||||
|
|
||||||
* [Doc] Add Changelog [#72][] (thanks @nathany)
|
|
||||||
* [Doc] Spotlight and double modify events on macOS [#62][] (reported by @paulhammond)
|
|
||||||
|
|
||||||
## [0.8.10] - 2013-10-19
|
|
||||||
|
|
||||||
* [Fix] kqueue: remove file watches when parent directory is removed [#71][] (reported by @mdwhatcott)
|
|
||||||
* [Fix] kqueue: race between Close and readEvents [#70][] (reported by @bernerdschaefer)
|
|
||||||
* [Doc] specify OS-specific limits in README (thanks @debrando)
|
|
||||||
|
|
||||||
## [0.8.9] - 2013-09-08
|
|
||||||
|
|
||||||
* [Doc] Contributing (thanks @nathany)
|
|
||||||
* [Doc] update package path in example code [#63][] (thanks @paulhammond)
|
|
||||||
* [Doc] GoCI badge in README (Linux only) [#60][]
|
|
||||||
* [Doc] Cross-platform testing with Vagrant [#59][] (thanks @nathany)
|
|
||||||
|
|
||||||
## [0.8.8] - 2013-06-17
|
|
||||||
|
|
||||||
* [Fix] Windows: handle `ERROR_MORE_DATA` on Windows [#49][] (thanks @jbowtie)
|
|
||||||
|
|
||||||
## [0.8.7] - 2013-06-03
|
|
||||||
|
|
||||||
* [API] Make syscall flags internal
|
|
||||||
* [Fix] inotify: ignore event changes
|
|
||||||
* [Fix] race in symlink test [#45][] (reported by @srid)
|
|
||||||
* [Fix] tests on Windows
|
|
||||||
* lower case error messages
|
|
||||||
|
|
||||||
## [0.8.6] - 2013-05-23
|
|
||||||
|
|
||||||
* kqueue: Use EVT_ONLY flag on Darwin
|
|
||||||
* [Doc] Update README with full example
|
|
||||||
|
|
||||||
## [0.8.5] - 2013-05-09
|
|
||||||
|
|
||||||
* [Fix] inotify: allow monitoring of "broken" symlinks (thanks @tsg)
|
|
||||||
|
|
||||||
## [0.8.4] - 2013-04-07
|
|
||||||
|
|
||||||
* [Fix] kqueue: watch all file events [#40][] (thanks @ChrisBuchholz)
|
|
||||||
|
|
||||||
## [0.8.3] - 2013-03-13
|
|
||||||
|
|
||||||
* [Fix] inoitfy/kqueue memory leak [#36][] (reported by @nbkolchin)
|
|
||||||
* [Fix] kqueue: use fsnFlags for watching a directory [#33][] (reported by @nbkolchin)
|
|
||||||
|
|
||||||
## [0.8.2] - 2013-02-07
|
|
||||||
|
|
||||||
* [Doc] add Authors
|
|
||||||
* [Fix] fix data races for map access [#29][] (thanks @fsouza)
|
|
||||||
|
|
||||||
## [0.8.1] - 2013-01-09
|
|
||||||
|
|
||||||
* [Fix] Windows path separators
|
|
||||||
* [Doc] BSD License
|
|
||||||
|
|
||||||
## [0.8.0] - 2012-11-09
|
|
||||||
|
|
||||||
* kqueue: directory watching improvements (thanks @vmirage)
|
|
||||||
* inotify: add `IN_MOVED_TO` [#25][] (requested by @cpisto)
|
|
||||||
* [Fix] kqueue: deleting watched directory [#24][] (reported by @jakerr)
|
|
||||||
|
|
||||||
## [0.7.4] - 2012-10-09
|
|
||||||
|
|
||||||
* [Fix] inotify: fixes from https://codereview.appspot.com/5418045/ (ugorji)
|
|
||||||
* [Fix] kqueue: preserve watch flags when watching for delete [#21][] (reported by @robfig)
|
|
||||||
* [Fix] kqueue: watch the directory even if it isn't a new watch (thanks @robfig)
|
|
||||||
* [Fix] kqueue: modify after recreation of file
|
|
||||||
|
|
||||||
## [0.7.3] - 2012-09-27
|
|
||||||
|
|
||||||
* [Fix] kqueue: watch with an existing folder inside the watched folder (thanks @vmirage)
|
|
||||||
* [Fix] kqueue: no longer get duplicate CREATE events
|
|
||||||
|
|
||||||
## [0.7.2] - 2012-09-01
|
|
||||||
|
|
||||||
* kqueue: events for created directories
|
|
||||||
|
|
||||||
## [0.7.1] - 2012-07-14
|
|
||||||
|
|
||||||
* [Fix] for renaming files
|
|
||||||
|
|
||||||
## [0.7.0] - 2012-07-02
|
|
||||||
|
|
||||||
* [Feature] FSNotify flags
|
|
||||||
* [Fix] inotify: Added file name back to event path
|
|
||||||
|
|
||||||
## [0.6.0] - 2012-06-06
|
|
||||||
|
|
||||||
* kqueue: watch files after directory created (thanks @tmc)
|
|
||||||
|
|
||||||
## [0.5.1] - 2012-05-22
|
|
||||||
|
|
||||||
* [Fix] inotify: remove all watches before Close()
|
|
||||||
|
|
||||||
## [0.5.0] - 2012-05-03
|
|
||||||
|
|
||||||
* [API] kqueue: return errors during watch instead of sending over channel
|
|
||||||
* kqueue: match symlink behavior on Linux
|
|
||||||
* inotify: add `DELETE_SELF` (requested by @taralx)
|
|
||||||
* [Fix] kqueue: handle EINTR (reported by @robfig)
|
|
||||||
* [Doc] Godoc example [#1][] (thanks @davecheney)
|
|
||||||
|
|
||||||
## [0.4.0] - 2012-03-30
|
|
||||||
|
|
||||||
* Go 1 released: build with go tool
|
|
||||||
* [Feature] Windows support using winfsnotify
|
|
||||||
* Windows does not have attribute change notifications
|
|
||||||
* Roll attribute notifications into IsModify
|
|
||||||
|
|
||||||
## [0.3.0] - 2012-02-19
|
|
||||||
|
|
||||||
* kqueue: add files when watch directory
|
|
||||||
|
|
||||||
## [0.2.0] - 2011-12-30
|
|
||||||
|
|
||||||
* update to latest Go weekly code
|
|
||||||
|
|
||||||
## [0.1.0] - 2011-10-19
|
|
||||||
|
|
||||||
* kqueue: add watch on file creation to match inotify
|
|
||||||
* kqueue: create file event
|
|
||||||
* inotify: ignore `IN_IGNORED` events
|
|
||||||
* event String()
|
|
||||||
* linux: common FileEvent functions
|
|
||||||
* initial commit
|
|
||||||
|
|
||||||
[#79]: https://github.com/howeyc/fsnotify/pull/79
|
|
||||||
[#77]: https://github.com/howeyc/fsnotify/pull/77
|
|
||||||
[#72]: https://github.com/howeyc/fsnotify/issues/72
|
|
||||||
[#71]: https://github.com/howeyc/fsnotify/issues/71
|
|
||||||
[#70]: https://github.com/howeyc/fsnotify/issues/70
|
|
||||||
[#63]: https://github.com/howeyc/fsnotify/issues/63
|
|
||||||
[#62]: https://github.com/howeyc/fsnotify/issues/62
|
|
||||||
[#60]: https://github.com/howeyc/fsnotify/issues/60
|
|
||||||
[#59]: https://github.com/howeyc/fsnotify/issues/59
|
|
||||||
[#49]: https://github.com/howeyc/fsnotify/issues/49
|
|
||||||
[#45]: https://github.com/howeyc/fsnotify/issues/45
|
|
||||||
[#40]: https://github.com/howeyc/fsnotify/issues/40
|
|
||||||
[#36]: https://github.com/howeyc/fsnotify/issues/36
|
|
||||||
[#33]: https://github.com/howeyc/fsnotify/issues/33
|
|
||||||
[#29]: https://github.com/howeyc/fsnotify/issues/29
|
|
||||||
[#25]: https://github.com/howeyc/fsnotify/issues/25
|
|
||||||
[#24]: https://github.com/howeyc/fsnotify/issues/24
|
|
||||||
[#21]: https://github.com/howeyc/fsnotify/issues/21
|
|
||||||
145
vendor/github.com/fsnotify/fsnotify/CONTRIBUTING.md
generated
vendored
145
vendor/github.com/fsnotify/fsnotify/CONTRIBUTING.md
generated
vendored
@@ -1,145 +0,0 @@
|
|||||||
Thank you for your interest in contributing to fsnotify! We try to review and
|
|
||||||
merge PRs in a reasonable timeframe, but please be aware that:
|
|
||||||
|
|
||||||
- To avoid "wasted" work, please discuss changes on the issue tracker first. You
|
|
||||||
can just send PRs, but they may end up being rejected for one reason or the
|
|
||||||
other.
|
|
||||||
|
|
||||||
- fsnotify is a cross-platform library, and changes must work reasonably well on
|
|
||||||
all supported platforms.
|
|
||||||
|
|
||||||
- Changes will need to be compatible; old code should still compile, and the
|
|
||||||
runtime behaviour can't change in ways that are likely to lead to problems for
|
|
||||||
users.
|
|
||||||
|
|
||||||
Testing
|
|
||||||
-------
|
|
||||||
Just `go test ./...` runs all the tests; the CI runs this on all supported
|
|
||||||
platforms. Testing different platforms locally can be done with something like
|
|
||||||
[goon] or [Vagrant], but this isn't super-easy to set up at the moment.
|
|
||||||
|
|
||||||
Use the `-short` flag to make the "stress test" run faster.
|
|
||||||
|
|
||||||
Writing new tests
|
|
||||||
-----------------
|
|
||||||
Scripts in the testdata directory allow creating test cases in a "shell-like"
|
|
||||||
syntax. The basic format is:
|
|
||||||
|
|
||||||
script
|
|
||||||
|
|
||||||
Output:
|
|
||||||
desired output
|
|
||||||
|
|
||||||
For example:
|
|
||||||
|
|
||||||
# Create a new empty file with some data.
|
|
||||||
watch /
|
|
||||||
echo data >/file
|
|
||||||
|
|
||||||
Output:
|
|
||||||
create /file
|
|
||||||
write /file
|
|
||||||
|
|
||||||
Just create a new file to add a new test; select which tests to run with
|
|
||||||
`-run TestScript/[path]`.
|
|
||||||
|
|
||||||
script
|
|
||||||
------
|
|
||||||
The script is a "shell-like" script:
|
|
||||||
|
|
||||||
cmd arg arg
|
|
||||||
|
|
||||||
Comments are supported with `#`:
|
|
||||||
|
|
||||||
# Comment
|
|
||||||
cmd arg arg # Comment
|
|
||||||
|
|
||||||
All operations are done in a temp directory; a path like "/foo" is rewritten to
|
|
||||||
"/tmp/TestFoo/foo".
|
|
||||||
|
|
||||||
Arguments can be quoted with `"` or `'`; there are no escapes and they're
|
|
||||||
functionally identical right now, but this may change in the future, so best to
|
|
||||||
assume shell-like rules.
|
|
||||||
|
|
||||||
touch "/file with spaces"
|
|
||||||
|
|
||||||
End-of-line escapes with `\` are not supported.
|
|
||||||
|
|
||||||
### Supported commands
|
|
||||||
|
|
||||||
watch path [ops] # Watch the path, reporting events for it. Nothing is
|
|
||||||
# watched by default. Optionally a list of ops can be
|
|
||||||
# given, as with AddWith(path, WithOps(...)).
|
|
||||||
unwatch path # Stop watching the path.
|
|
||||||
watchlist n # Assert watchlist length.
|
|
||||||
|
|
||||||
stop # Stop running the script; for debugging.
|
|
||||||
debug [yes/no] # Enable/disable FSNOTIFY_DEBUG (tests are run in
|
|
||||||
parallel by default, so -parallel=1 is probably a good
|
|
||||||
idea).
|
|
||||||
print [any strings] # Print text to stdout; for debugging.
|
|
||||||
|
|
||||||
touch path
|
|
||||||
mkdir [-p] dir
|
|
||||||
ln -s target link # Only ln -s supported.
|
|
||||||
mkfifo path
|
|
||||||
mknod dev path
|
|
||||||
mv src dst
|
|
||||||
rm [-r] path
|
|
||||||
chmod mode path # Octal only
|
|
||||||
sleep time-in-ms
|
|
||||||
|
|
||||||
cat path # Read path (does nothing with the data; just reads it).
|
|
||||||
echo str >>path # Append "str" to "path".
|
|
||||||
echo str >path # Truncate "path" and write "str".
|
|
||||||
|
|
||||||
require reason # Skip the test if "reason" is true; "skip" and
|
|
||||||
skip reason # "require" behave identical; it supports both for
|
|
||||||
# readability. Possible reasons are:
|
|
||||||
#
|
|
||||||
# always Always skip this test.
|
|
||||||
# symlink Symlinks are supported (requires admin
|
|
||||||
# permissions on Windows).
|
|
||||||
# mkfifo Platform doesn't support FIFO named sockets.
|
|
||||||
# mknod Platform doesn't support device nodes.
|
|
||||||
|
|
||||||
|
|
||||||
output
|
|
||||||
------
|
|
||||||
After `Output:` the desired output is given; this is indented by convention, but
|
|
||||||
that's not required.
|
|
||||||
|
|
||||||
The format of that is:
|
|
||||||
|
|
||||||
# Comment
|
|
||||||
event path # Comment
|
|
||||||
|
|
||||||
system:
|
|
||||||
event path
|
|
||||||
system2:
|
|
||||||
event path
|
|
||||||
|
|
||||||
Every event is one line, and any whitespace between the event and path are
|
|
||||||
ignored. The path can optionally be surrounded in ". Anything after a "#" is
|
|
||||||
ignored.
|
|
||||||
|
|
||||||
Platform-specific tests can be added after GOOS; for example:
|
|
||||||
|
|
||||||
watch /
|
|
||||||
touch /file
|
|
||||||
|
|
||||||
Output:
|
|
||||||
# Tested if nothing else matches
|
|
||||||
create /file
|
|
||||||
|
|
||||||
# Windows-specific test.
|
|
||||||
windows:
|
|
||||||
write /file
|
|
||||||
|
|
||||||
You can specify multiple platforms with a comma (e.g. "windows, linux:").
|
|
||||||
"kqueue" is a shortcut for all kqueue systems (BSD, macOS).
|
|
||||||
|
|
||||||
|
|
||||||
[goon]: https://github.com/arp242/goon
|
|
||||||
[Vagrant]: https://www.vagrantup.com/
|
|
||||||
[integration_test.go]: /integration_test.go
|
|
||||||
25
vendor/github.com/fsnotify/fsnotify/LICENSE
generated
vendored
25
vendor/github.com/fsnotify/fsnotify/LICENSE
generated
vendored
@@ -1,25 +0,0 @@
|
|||||||
Copyright © 2012 The Go Authors. All rights reserved.
|
|
||||||
Copyright © fsnotify Authors. All rights reserved.
|
|
||||||
|
|
||||||
Redistribution and use in source and binary forms, with or without modification,
|
|
||||||
are permitted provided that the following conditions are met:
|
|
||||||
|
|
||||||
* Redistributions of source code must retain the above copyright notice, this
|
|
||||||
list of conditions and the following disclaimer.
|
|
||||||
* Redistributions in binary form must reproduce the above copyright notice, this
|
|
||||||
list of conditions and the following disclaimer in the documentation and/or
|
|
||||||
other materials provided with the distribution.
|
|
||||||
* Neither the name of Google Inc. nor the names of its contributors may be used
|
|
||||||
to endorse or promote products derived from this software without specific
|
|
||||||
prior written permission.
|
|
||||||
|
|
||||||
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
|
|
||||||
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
|
|
||||||
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
|
||||||
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
|
|
||||||
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
|
|
||||||
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
|
||||||
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
|
|
||||||
ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
||||||
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
|
|
||||||
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
||||||
182
vendor/github.com/fsnotify/fsnotify/README.md
generated
vendored
182
vendor/github.com/fsnotify/fsnotify/README.md
generated
vendored
@@ -1,182 +0,0 @@
|
|||||||
fsnotify is a Go library to provide cross-platform filesystem notifications on
|
|
||||||
Windows, Linux, macOS, BSD, and illumos.
|
|
||||||
|
|
||||||
Go 1.17 or newer is required; the full documentation is at
|
|
||||||
https://pkg.go.dev/github.com/fsnotify/fsnotify
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
Platform support:
|
|
||||||
|
|
||||||
| Backend | OS | Status |
|
|
||||||
| :-------------------- | :--------- | :------------------------------------------------------------------------ |
|
|
||||||
| inotify | Linux | Supported |
|
|
||||||
| kqueue | BSD, macOS | Supported |
|
|
||||||
| ReadDirectoryChangesW | Windows | Supported |
|
|
||||||
| FEN | illumos | Supported |
|
|
||||||
| fanotify | Linux 5.9+ | [Not yet](https://github.com/fsnotify/fsnotify/issues/114) |
|
|
||||||
| FSEvents | macOS | [Needs support in x/sys/unix][fsevents] |
|
|
||||||
| USN Journals | Windows | [Needs support in x/sys/windows][usn] |
|
|
||||||
| Polling | *All* | [Not yet](https://github.com/fsnotify/fsnotify/issues/9) |
|
|
||||||
|
|
||||||
Linux and illumos should include Android and Solaris, but these are currently
|
|
||||||
untested.
|
|
||||||
|
|
||||||
[fsevents]: https://github.com/fsnotify/fsnotify/issues/11#issuecomment-1279133120
|
|
||||||
[usn]: https://github.com/fsnotify/fsnotify/issues/53#issuecomment-1279829847
|
|
||||||
|
|
||||||
Usage
|
|
||||||
-----
|
|
||||||
A basic example:
|
|
||||||
|
|
||||||
```go
|
|
||||||
package main
|
|
||||||
|
|
||||||
import (
|
|
||||||
"log"
|
|
||||||
|
|
||||||
"github.com/fsnotify/fsnotify"
|
|
||||||
)
|
|
||||||
|
|
||||||
func main() {
|
|
||||||
// Create new watcher.
|
|
||||||
watcher, err := fsnotify.NewWatcher()
|
|
||||||
if err != nil {
|
|
||||||
log.Fatal(err)
|
|
||||||
}
|
|
||||||
defer watcher.Close()
|
|
||||||
|
|
||||||
// Start listening for events.
|
|
||||||
go func() {
|
|
||||||
for {
|
|
||||||
select {
|
|
||||||
case event, ok := <-watcher.Events:
|
|
||||||
if !ok {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
log.Println("event:", event)
|
|
||||||
if event.Has(fsnotify.Write) {
|
|
||||||
log.Println("modified file:", event.Name)
|
|
||||||
}
|
|
||||||
case err, ok := <-watcher.Errors:
|
|
||||||
if !ok {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
log.Println("error:", err)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}()
|
|
||||||
|
|
||||||
// Add a path.
|
|
||||||
err = watcher.Add("/tmp")
|
|
||||||
if err != nil {
|
|
||||||
log.Fatal(err)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Block main goroutine forever.
|
|
||||||
<-make(chan struct{})
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Some more examples can be found in [cmd/fsnotify](cmd/fsnotify), which can be
|
|
||||||
run with:
|
|
||||||
|
|
||||||
% go run ./cmd/fsnotify
|
|
||||||
|
|
||||||
Further detailed documentation can be found in godoc:
|
|
||||||
https://pkg.go.dev/github.com/fsnotify/fsnotify
|
|
||||||
|
|
||||||
FAQ
|
|
||||||
---
|
|
||||||
### Will a file still be watched when it's moved to another directory?
|
|
||||||
No, not unless you are watching the location it was moved to.
|
|
||||||
|
|
||||||
### Are subdirectories watched?
|
|
||||||
No, you must add watches for any directory you want to watch (a recursive
|
|
||||||
watcher is on the roadmap: [#18]).
|
|
||||||
|
|
||||||
[#18]: https://github.com/fsnotify/fsnotify/issues/18
|
|
||||||
|
|
||||||
### Do I have to watch the Error and Event channels in a goroutine?
|
|
||||||
Yes. You can read both channels in the same goroutine using `select` (you don't
|
|
||||||
need a separate goroutine for both channels; see the example).
|
|
||||||
|
|
||||||
### Why don't notifications work with NFS, SMB, FUSE, /proc, or /sys?
|
|
||||||
fsnotify requires support from underlying OS to work. The current NFS and SMB
|
|
||||||
protocols does not provide network level support for file notifications, and
|
|
||||||
neither do the /proc and /sys virtual filesystems.
|
|
||||||
|
|
||||||
This could be fixed with a polling watcher ([#9]), but it's not yet implemented.
|
|
||||||
|
|
||||||
[#9]: https://github.com/fsnotify/fsnotify/issues/9
|
|
||||||
|
|
||||||
### Why do I get many Chmod events?
|
|
||||||
Some programs may generate a lot of attribute changes; for example Spotlight on
|
|
||||||
macOS, anti-virus programs, backup applications, and some others are known to do
|
|
||||||
this. As a rule, it's typically best to ignore Chmod events. They're often not
|
|
||||||
useful, and tend to cause problems.
|
|
||||||
|
|
||||||
Spotlight indexing on macOS can result in multiple events (see [#15]). A
|
|
||||||
temporary workaround is to add your folder(s) to the *Spotlight Privacy
|
|
||||||
settings* until we have a native FSEvents implementation (see [#11]).
|
|
||||||
|
|
||||||
[#11]: https://github.com/fsnotify/fsnotify/issues/11
|
|
||||||
[#15]: https://github.com/fsnotify/fsnotify/issues/15
|
|
||||||
|
|
||||||
### Watching a file doesn't work well
|
|
||||||
Watching individual files (rather than directories) is generally not recommended
|
|
||||||
as many programs (especially editors) update files atomically: it will write to
|
|
||||||
a temporary file which is then moved to to destination, overwriting the original
|
|
||||||
(or some variant thereof). The watcher on the original file is now lost, as that
|
|
||||||
no longer exists.
|
|
||||||
|
|
||||||
The upshot of this is that a power failure or crash won't leave a half-written
|
|
||||||
file.
|
|
||||||
|
|
||||||
Watch the parent directory and use `Event.Name` to filter out files you're not
|
|
||||||
interested in. There is an example of this in `cmd/fsnotify/file.go`.
|
|
||||||
|
|
||||||
Platform-specific notes
|
|
||||||
-----------------------
|
|
||||||
### Linux
|
|
||||||
When a file is removed a REMOVE event won't be emitted until all file
|
|
||||||
descriptors are closed; it will emit a CHMOD instead:
|
|
||||||
|
|
||||||
fp := os.Open("file")
|
|
||||||
os.Remove("file") // CHMOD
|
|
||||||
fp.Close() // REMOVE
|
|
||||||
|
|
||||||
This is the event that inotify sends, so not much can be changed about this.
|
|
||||||
|
|
||||||
The `fs.inotify.max_user_watches` sysctl variable specifies the upper limit for
|
|
||||||
the number of watches per user, and `fs.inotify.max_user_instances` specifies
|
|
||||||
the maximum number of inotify instances per user. Every Watcher you create is an
|
|
||||||
"instance", and every path you add is a "watch".
|
|
||||||
|
|
||||||
These are also exposed in `/proc` as `/proc/sys/fs/inotify/max_user_watches` and
|
|
||||||
`/proc/sys/fs/inotify/max_user_instances`
|
|
||||||
|
|
||||||
To increase them you can use `sysctl` or write the value to proc file:
|
|
||||||
|
|
||||||
# The default values on Linux 5.18
|
|
||||||
sysctl fs.inotify.max_user_watches=124983
|
|
||||||
sysctl fs.inotify.max_user_instances=128
|
|
||||||
|
|
||||||
To make the changes persist on reboot edit `/etc/sysctl.conf` or
|
|
||||||
`/usr/lib/sysctl.d/50-default.conf` (details differ per Linux distro; check your
|
|
||||||
distro's documentation):
|
|
||||||
|
|
||||||
fs.inotify.max_user_watches=124983
|
|
||||||
fs.inotify.max_user_instances=128
|
|
||||||
|
|
||||||
Reaching the limit will result in a "no space left on device" or "too many open
|
|
||||||
files" error.
|
|
||||||
|
|
||||||
### kqueue (macOS, all BSD systems)
|
|
||||||
kqueue requires opening a file descriptor for every file that's being watched;
|
|
||||||
so if you're watching a directory with five files then that's six file
|
|
||||||
descriptors. You will run in to your system's "max open files" limit faster on
|
|
||||||
these platforms.
|
|
||||||
|
|
||||||
The sysctl variables `kern.maxfiles` and `kern.maxfilesperproc` can be used to
|
|
||||||
control the maximum number of open files.
|
|
||||||
467
vendor/github.com/fsnotify/fsnotify/backend_fen.go
generated
vendored
467
vendor/github.com/fsnotify/fsnotify/backend_fen.go
generated
vendored
@@ -1,467 +0,0 @@
|
|||||||
//go:build solaris
|
|
||||||
|
|
||||||
// FEN backend for illumos (supported) and Solaris (untested, but should work).
|
|
||||||
//
|
|
||||||
// See port_create(3c) etc. for docs. https://www.illumos.org/man/3C/port_create
|
|
||||||
|
|
||||||
package fsnotify
|
|
||||||
|
|
||||||
import (
|
|
||||||
"errors"
|
|
||||||
"fmt"
|
|
||||||
"io/fs"
|
|
||||||
"os"
|
|
||||||
"path/filepath"
|
|
||||||
"sync"
|
|
||||||
"time"
|
|
||||||
|
|
||||||
"github.com/fsnotify/fsnotify/internal"
|
|
||||||
"golang.org/x/sys/unix"
|
|
||||||
)
|
|
||||||
|
|
||||||
type fen struct {
|
|
||||||
*shared
|
|
||||||
Events chan Event
|
|
||||||
Errors chan error
|
|
||||||
|
|
||||||
mu sync.Mutex
|
|
||||||
port *unix.EventPort
|
|
||||||
dirs map[string]Op // Explicitly watched directories
|
|
||||||
watches map[string]Op // Explicitly watched non-directories
|
|
||||||
}
|
|
||||||
|
|
||||||
var defaultBufferSize = 0
|
|
||||||
|
|
||||||
func newBackend(ev chan Event, errs chan error) (backend, error) {
|
|
||||||
w := &fen{
|
|
||||||
shared: newShared(ev, errs),
|
|
||||||
Events: ev,
|
|
||||||
Errors: errs,
|
|
||||||
dirs: make(map[string]Op),
|
|
||||||
watches: make(map[string]Op),
|
|
||||||
}
|
|
||||||
|
|
||||||
var err error
|
|
||||||
w.port, err = unix.NewEventPort()
|
|
||||||
if err != nil {
|
|
||||||
return nil, fmt.Errorf("fsnotify.NewWatcher: %w", err)
|
|
||||||
}
|
|
||||||
|
|
||||||
go w.readEvents()
|
|
||||||
return w, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *fen) Close() error {
|
|
||||||
if w.shared.close() {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
return w.port.Close()
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *fen) Add(name string) error { return w.AddWith(name) }
|
|
||||||
|
|
||||||
func (w *fen) AddWith(name string, opts ...addOpt) error {
|
|
||||||
if w.isClosed() {
|
|
||||||
return ErrClosed
|
|
||||||
}
|
|
||||||
if debug {
|
|
||||||
fmt.Fprintf(os.Stderr, "FSNOTIFY_DEBUG: %s AddWith(%q)\n",
|
|
||||||
time.Now().Format("15:04:05.000000000"), name)
|
|
||||||
}
|
|
||||||
|
|
||||||
with := getOptions(opts...)
|
|
||||||
if !w.xSupports(with.op) {
|
|
||||||
return fmt.Errorf("%w: %s", xErrUnsupported, with.op)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Currently we resolve symlinks that were explicitly requested to be
|
|
||||||
// watched. Otherwise we would use LStat here.
|
|
||||||
stat, err := os.Stat(name)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
// Associate all files in the directory.
|
|
||||||
if stat.IsDir() {
|
|
||||||
err := w.handleDirectory(name, stat, true, w.associateFile)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
w.mu.Lock()
|
|
||||||
w.dirs[name] = with.op
|
|
||||||
w.mu.Unlock()
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
err = w.associateFile(name, stat, true)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
w.mu.Lock()
|
|
||||||
w.watches[name] = with.op
|
|
||||||
w.mu.Unlock()
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *fen) Remove(name string) error {
|
|
||||||
if w.isClosed() {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
if !w.port.PathIsWatched(name) {
|
|
||||||
return fmt.Errorf("%w: %s", ErrNonExistentWatch, name)
|
|
||||||
}
|
|
||||||
if debug {
|
|
||||||
fmt.Fprintf(os.Stderr, "FSNOTIFY_DEBUG: %s Remove(%q)\n",
|
|
||||||
time.Now().Format("15:04:05.000000000"), name)
|
|
||||||
}
|
|
||||||
|
|
||||||
// The user has expressed an intent. Immediately remove this name from
|
|
||||||
// whichever watch list it might be in. If it's not in there the delete
|
|
||||||
// doesn't cause harm.
|
|
||||||
w.mu.Lock()
|
|
||||||
delete(w.watches, name)
|
|
||||||
delete(w.dirs, name)
|
|
||||||
w.mu.Unlock()
|
|
||||||
|
|
||||||
stat, err := os.Stat(name)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
// Remove associations for every file in the directory.
|
|
||||||
if stat.IsDir() {
|
|
||||||
err := w.handleDirectory(name, stat, false, w.dissociateFile)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
err = w.port.DissociatePath(name)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// readEvents contains the main loop that runs in a goroutine watching for events.
|
|
||||||
func (w *fen) readEvents() {
|
|
||||||
// If this function returns, the watcher has been closed and we can close
|
|
||||||
// these channels
|
|
||||||
defer func() {
|
|
||||||
close(w.Errors)
|
|
||||||
close(w.Events)
|
|
||||||
}()
|
|
||||||
|
|
||||||
pevents := make([]unix.PortEvent, 8)
|
|
||||||
for {
|
|
||||||
count, err := w.port.Get(pevents, 1, nil)
|
|
||||||
if err != nil && err != unix.ETIME {
|
|
||||||
// Interrupted system call (count should be 0) ignore and continue
|
|
||||||
if errors.Is(err, unix.EINTR) && count == 0 {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
// Get failed because we called w.Close()
|
|
||||||
if errors.Is(err, unix.EBADF) && w.isClosed() {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
// There was an error not caused by calling w.Close()
|
|
||||||
if !w.sendError(fmt.Errorf("port.Get: %w", err)) {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
p := pevents[:count]
|
|
||||||
for _, pevent := range p {
|
|
||||||
if pevent.Source != unix.PORT_SOURCE_FILE {
|
|
||||||
// Event from unexpected source received; should never happen.
|
|
||||||
if !w.sendError(errors.New("Event from unexpected source received")) {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
|
|
||||||
if debug {
|
|
||||||
internal.Debug(pevent.Path, pevent.Events)
|
|
||||||
}
|
|
||||||
|
|
||||||
err = w.handleEvent(&pevent)
|
|
||||||
if !w.sendError(err) {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *fen) handleDirectory(path string, stat os.FileInfo, follow bool, handler func(string, os.FileInfo, bool) error) error {
|
|
||||||
files, err := os.ReadDir(path)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
// Handle all children of the directory.
|
|
||||||
for _, entry := range files {
|
|
||||||
finfo, err := entry.Info()
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
err = handler(filepath.Join(path, finfo.Name()), finfo, false)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// And finally handle the directory itself.
|
|
||||||
return handler(path, stat, follow)
|
|
||||||
}
|
|
||||||
|
|
||||||
// handleEvent might need to emit more than one fsnotify event if the events
|
|
||||||
// bitmap matches more than one event type (e.g. the file was both modified and
|
|
||||||
// had the attributes changed between when the association was created and the
|
|
||||||
// when event was returned)
|
|
||||||
func (w *fen) handleEvent(event *unix.PortEvent) error {
|
|
||||||
var (
|
|
||||||
events = event.Events
|
|
||||||
path = event.Path
|
|
||||||
fmode = event.Cookie.(os.FileMode)
|
|
||||||
reRegister = true
|
|
||||||
)
|
|
||||||
|
|
||||||
w.mu.Lock()
|
|
||||||
_, watchedDir := w.dirs[path]
|
|
||||||
_, watchedPath := w.watches[path]
|
|
||||||
w.mu.Unlock()
|
|
||||||
isWatched := watchedDir || watchedPath
|
|
||||||
|
|
||||||
if events&unix.FILE_DELETE != 0 {
|
|
||||||
if !w.sendEvent(Event{Name: path, Op: Remove}) {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
reRegister = false
|
|
||||||
}
|
|
||||||
if events&unix.FILE_RENAME_FROM != 0 {
|
|
||||||
if !w.sendEvent(Event{Name: path, Op: Rename}) {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
// Don't keep watching the new file name
|
|
||||||
reRegister = false
|
|
||||||
}
|
|
||||||
if events&unix.FILE_RENAME_TO != 0 {
|
|
||||||
// We don't report a Rename event for this case, because Rename events
|
|
||||||
// are interpreted as referring to the _old_ name of the file, and in
|
|
||||||
// this case the event would refer to the new name of the file. This
|
|
||||||
// type of rename event is not supported by fsnotify.
|
|
||||||
|
|
||||||
// inotify reports a Remove event in this case, so we simulate this
|
|
||||||
// here.
|
|
||||||
if !w.sendEvent(Event{Name: path, Op: Remove}) {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
// Don't keep watching the file that was removed
|
|
||||||
reRegister = false
|
|
||||||
}
|
|
||||||
|
|
||||||
// The file is gone, nothing left to do.
|
|
||||||
if !reRegister {
|
|
||||||
if watchedDir {
|
|
||||||
w.mu.Lock()
|
|
||||||
delete(w.dirs, path)
|
|
||||||
w.mu.Unlock()
|
|
||||||
}
|
|
||||||
if watchedPath {
|
|
||||||
w.mu.Lock()
|
|
||||||
delete(w.watches, path)
|
|
||||||
w.mu.Unlock()
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// If we didn't get a deletion the file still exists and we're going to have
|
|
||||||
// to watch it again. Let's Stat it now so that we can compare permissions
|
|
||||||
// and have what we need to continue watching the file
|
|
||||||
|
|
||||||
stat, err := os.Lstat(path)
|
|
||||||
if err != nil {
|
|
||||||
// This is unexpected, but we should still emit an event. This happens
|
|
||||||
// most often on "rm -r" of a subdirectory inside a watched directory We
|
|
||||||
// get a modify event of something happening inside, but by the time we
|
|
||||||
// get here, the sudirectory is already gone. Clearly we were watching
|
|
||||||
// this path but now it is gone. Let's tell the user that it was
|
|
||||||
// removed.
|
|
||||||
if !w.sendEvent(Event{Name: path, Op: Remove}) {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
// Suppress extra write events on removed directories; they are not
|
|
||||||
// informative and can be confusing.
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// resolve symlinks that were explicitly watched as we would have at Add()
|
|
||||||
// time. this helps suppress spurious Chmod events on watched symlinks
|
|
||||||
if isWatched {
|
|
||||||
stat, err = os.Stat(path)
|
|
||||||
if err != nil {
|
|
||||||
// The symlink still exists, but the target is gone. Report the
|
|
||||||
// Remove similar to above.
|
|
||||||
if !w.sendEvent(Event{Name: path, Op: Remove}) {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
// Don't return the error
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if events&unix.FILE_MODIFIED != 0 {
|
|
||||||
if fmode.IsDir() && watchedDir {
|
|
||||||
if err := w.updateDirectory(path); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
} else {
|
|
||||||
if !w.sendEvent(Event{Name: path, Op: Write}) {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if events&unix.FILE_ATTRIB != 0 && stat != nil {
|
|
||||||
// Only send Chmod if perms changed
|
|
||||||
if stat.Mode().Perm() != fmode.Perm() {
|
|
||||||
if !w.sendEvent(Event{Name: path, Op: Chmod}) {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if stat != nil {
|
|
||||||
// If we get here, it means we've hit an event above that requires us to
|
|
||||||
// continue watching the file or directory
|
|
||||||
err := w.associateFile(path, stat, isWatched)
|
|
||||||
if errors.Is(err, fs.ErrNotExist) {
|
|
||||||
// Path may have been removed since the stat.
|
|
||||||
err = nil
|
|
||||||
}
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// The directory was modified, so we must find unwatched entities and watch
|
|
||||||
// them. If something was removed from the directory, nothing will happen, as
|
|
||||||
// everything else should still be watched.
|
|
||||||
func (w *fen) updateDirectory(path string) error {
|
|
||||||
files, err := os.ReadDir(path)
|
|
||||||
if err != nil {
|
|
||||||
// Directory no longer exists: probably just deleted since we got the
|
|
||||||
// event.
|
|
||||||
if errors.Is(err, fs.ErrNotExist) {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
for _, entry := range files {
|
|
||||||
path := filepath.Join(path, entry.Name())
|
|
||||||
if w.port.PathIsWatched(path) {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
|
|
||||||
finfo, err := entry.Info()
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
err = w.associateFile(path, finfo, false)
|
|
||||||
if errors.Is(err, fs.ErrNotExist) {
|
|
||||||
// File may have disappeared between getting the dir listing and
|
|
||||||
// adding the port: that's okay to ignore.
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
if !w.sendError(err) {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
if !w.sendEvent(Event{Name: path, Op: Create}) {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *fen) associateFile(path string, stat os.FileInfo, follow bool) error {
|
|
||||||
if w.isClosed() {
|
|
||||||
return ErrClosed
|
|
||||||
}
|
|
||||||
// This is primarily protecting the call to AssociatePath but it is
|
|
||||||
// important and intentional that the call to PathIsWatched is also
|
|
||||||
// protected by this mutex. Without this mutex, AssociatePath has been seen
|
|
||||||
// to error out that the path is already associated.
|
|
||||||
w.mu.Lock()
|
|
||||||
defer w.mu.Unlock()
|
|
||||||
|
|
||||||
if w.port.PathIsWatched(path) {
|
|
||||||
// Remove the old association in favor of this one If we get ENOENT,
|
|
||||||
// then while the x/sys/unix wrapper still thought that this path was
|
|
||||||
// associated, the underlying event port did not. This call will have
|
|
||||||
// cleared up that discrepancy. The most likely cause is that the event
|
|
||||||
// has fired but we haven't processed it yet.
|
|
||||||
err := w.port.DissociatePath(path)
|
|
||||||
if err != nil && !errors.Is(err, unix.ENOENT) {
|
|
||||||
return fmt.Errorf("port.DissociatePath(%q): %w", path, err)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
var events int
|
|
||||||
if !follow {
|
|
||||||
// Watch symlinks themselves rather than their targets unless this entry
|
|
||||||
// is explicitly watched.
|
|
||||||
events |= unix.FILE_NOFOLLOW
|
|
||||||
}
|
|
||||||
if true { // TODO: implement withOps()
|
|
||||||
events |= unix.FILE_MODIFIED
|
|
||||||
}
|
|
||||||
if true {
|
|
||||||
events |= unix.FILE_ATTRIB
|
|
||||||
}
|
|
||||||
err := w.port.AssociatePath(path, stat, events, stat.Mode())
|
|
||||||
if err != nil {
|
|
||||||
return fmt.Errorf("port.AssociatePath(%q): %w", path, err)
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *fen) dissociateFile(path string, stat os.FileInfo, unused bool) error {
|
|
||||||
if !w.port.PathIsWatched(path) {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
err := w.port.DissociatePath(path)
|
|
||||||
if err != nil {
|
|
||||||
return fmt.Errorf("port.DissociatePath(%q): %w", path, err)
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *fen) WatchList() []string {
|
|
||||||
if w.isClosed() {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
w.mu.Lock()
|
|
||||||
defer w.mu.Unlock()
|
|
||||||
|
|
||||||
entries := make([]string, 0, len(w.watches)+len(w.dirs))
|
|
||||||
for pathname := range w.dirs {
|
|
||||||
entries = append(entries, pathname)
|
|
||||||
}
|
|
||||||
for pathname := range w.watches {
|
|
||||||
entries = append(entries, pathname)
|
|
||||||
}
|
|
||||||
|
|
||||||
return entries
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *fen) xSupports(op Op) bool {
|
|
||||||
if op.Has(xUnportableOpen) || op.Has(xUnportableRead) ||
|
|
||||||
op.Has(xUnportableCloseWrite) || op.Has(xUnportableCloseRead) {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
583
vendor/github.com/fsnotify/fsnotify/backend_inotify.go
generated
vendored
583
vendor/github.com/fsnotify/fsnotify/backend_inotify.go
generated
vendored
@@ -1,583 +0,0 @@
|
|||||||
//go:build linux && !appengine
|
|
||||||
|
|
||||||
package fsnotify
|
|
||||||
|
|
||||||
import (
|
|
||||||
"errors"
|
|
||||||
"fmt"
|
|
||||||
"io"
|
|
||||||
"io/fs"
|
|
||||||
"os"
|
|
||||||
"path/filepath"
|
|
||||||
"strings"
|
|
||||||
"sync"
|
|
||||||
"time"
|
|
||||||
"unsafe"
|
|
||||||
|
|
||||||
"github.com/fsnotify/fsnotify/internal"
|
|
||||||
"golang.org/x/sys/unix"
|
|
||||||
)
|
|
||||||
|
|
||||||
type inotify struct {
|
|
||||||
*shared
|
|
||||||
Events chan Event
|
|
||||||
Errors chan error
|
|
||||||
|
|
||||||
// Store fd here as os.File.Read() will no longer return on close after
|
|
||||||
// calling Fd(). See: https://github.com/golang/go/issues/26439
|
|
||||||
fd int
|
|
||||||
inotifyFile *os.File
|
|
||||||
watches *watches
|
|
||||||
doneResp chan struct{} // Channel to respond to Close
|
|
||||||
|
|
||||||
// Store rename cookies in an array, with the index wrapping to 0. Almost
|
|
||||||
// all of the time what we get is a MOVED_FROM to set the cookie and the
|
|
||||||
// next event inotify sends will be MOVED_TO to read it. However, this is
|
|
||||||
// not guaranteed – as described in inotify(7) – and we may get other events
|
|
||||||
// between the two MOVED_* events (including other MOVED_* ones).
|
|
||||||
//
|
|
||||||
// A second issue is that moving a file outside the watched directory will
|
|
||||||
// trigger a MOVED_FROM to set the cookie, but we never see the MOVED_TO to
|
|
||||||
// read and delete it. So just storing it in a map would slowly leak memory.
|
|
||||||
//
|
|
||||||
// Doing it like this gives us a simple fast LRU-cache that won't allocate.
|
|
||||||
// Ten items should be more than enough for our purpose, and a loop over
|
|
||||||
// such a short array is faster than a map access anyway (not that it hugely
|
|
||||||
// matters since we're talking about hundreds of ns at the most, but still).
|
|
||||||
cookies [10]koekje
|
|
||||||
cookieIndex uint8
|
|
||||||
cookiesMu sync.Mutex
|
|
||||||
}
|
|
||||||
|
|
||||||
type (
|
|
||||||
watches struct {
|
|
||||||
wd map[uint32]*watch // wd → watch
|
|
||||||
path map[string]uint32 // pathname → wd
|
|
||||||
}
|
|
||||||
watch struct {
|
|
||||||
wd uint32 // Watch descriptor (as returned by the inotify_add_watch() syscall)
|
|
||||||
flags uint32 // inotify flags of this watch (see inotify(7) for the list of valid flags)
|
|
||||||
path string // Watch path.
|
|
||||||
recurse bool // Recursion with ./...?
|
|
||||||
}
|
|
||||||
koekje struct {
|
|
||||||
cookie uint32
|
|
||||||
path string
|
|
||||||
}
|
|
||||||
)
|
|
||||||
|
|
||||||
func newWatches() *watches {
|
|
||||||
return &watches{
|
|
||||||
wd: make(map[uint32]*watch),
|
|
||||||
path: make(map[string]uint32),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *watches) byPath(path string) *watch { return w.wd[w.path[path]] }
|
|
||||||
func (w *watches) byWd(wd uint32) *watch { return w.wd[wd] }
|
|
||||||
func (w *watches) len() int { return len(w.wd) }
|
|
||||||
func (w *watches) add(ww *watch) { w.wd[ww.wd] = ww; w.path[ww.path] = ww.wd }
|
|
||||||
func (w *watches) remove(watch *watch) { delete(w.path, watch.path); delete(w.wd, watch.wd) }
|
|
||||||
|
|
||||||
func (w *watches) removePath(path string) ([]uint32, error) {
|
|
||||||
path, recurse := recursivePath(path)
|
|
||||||
wd, ok := w.path[path]
|
|
||||||
if !ok {
|
|
||||||
return nil, fmt.Errorf("%w: %s", ErrNonExistentWatch, path)
|
|
||||||
}
|
|
||||||
|
|
||||||
watch := w.wd[wd]
|
|
||||||
if recurse && !watch.recurse {
|
|
||||||
return nil, fmt.Errorf("can't use /... with non-recursive watch %q", path)
|
|
||||||
}
|
|
||||||
|
|
||||||
delete(w.path, path)
|
|
||||||
delete(w.wd, wd)
|
|
||||||
if !watch.recurse {
|
|
||||||
return []uint32{wd}, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
wds := make([]uint32, 0, 8)
|
|
||||||
wds = append(wds, wd)
|
|
||||||
for p, rwd := range w.path {
|
|
||||||
if strings.HasPrefix(p, path) {
|
|
||||||
delete(w.path, p)
|
|
||||||
delete(w.wd, rwd)
|
|
||||||
wds = append(wds, rwd)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return wds, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *watches) updatePath(path string, f func(*watch) (*watch, error)) error {
|
|
||||||
var existing *watch
|
|
||||||
wd, ok := w.path[path]
|
|
||||||
if ok {
|
|
||||||
existing = w.wd[wd]
|
|
||||||
}
|
|
||||||
|
|
||||||
upd, err := f(existing)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
if upd != nil {
|
|
||||||
w.wd[upd.wd] = upd
|
|
||||||
w.path[upd.path] = upd.wd
|
|
||||||
|
|
||||||
if upd.wd != wd {
|
|
||||||
delete(w.wd, wd)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
var defaultBufferSize = 0
|
|
||||||
|
|
||||||
func newBackend(ev chan Event, errs chan error) (backend, error) {
|
|
||||||
// Need to set nonblocking mode for SetDeadline to work, otherwise blocking
|
|
||||||
// I/O operations won't terminate on close.
|
|
||||||
fd, errno := unix.InotifyInit1(unix.IN_CLOEXEC | unix.IN_NONBLOCK)
|
|
||||||
if fd == -1 {
|
|
||||||
return nil, errno
|
|
||||||
}
|
|
||||||
|
|
||||||
w := &inotify{
|
|
||||||
shared: newShared(ev, errs),
|
|
||||||
Events: ev,
|
|
||||||
Errors: errs,
|
|
||||||
fd: fd,
|
|
||||||
inotifyFile: os.NewFile(uintptr(fd), ""),
|
|
||||||
watches: newWatches(),
|
|
||||||
doneResp: make(chan struct{}),
|
|
||||||
}
|
|
||||||
|
|
||||||
go w.readEvents()
|
|
||||||
return w, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *inotify) Close() error {
|
|
||||||
if w.shared.close() {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// Causes any blocking reads to return with an error, provided the file
|
|
||||||
// still supports deadline operations.
|
|
||||||
err := w.inotifyFile.Close()
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
<-w.doneResp // Wait for readEvents() to finish.
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *inotify) Add(name string) error { return w.AddWith(name) }
|
|
||||||
|
|
||||||
func (w *inotify) AddWith(path string, opts ...addOpt) error {
|
|
||||||
if w.isClosed() {
|
|
||||||
return ErrClosed
|
|
||||||
}
|
|
||||||
if debug {
|
|
||||||
fmt.Fprintf(os.Stderr, "FSNOTIFY_DEBUG: %s AddWith(%q)\n",
|
|
||||||
time.Now().Format("15:04:05.000000000"), path)
|
|
||||||
}
|
|
||||||
|
|
||||||
with := getOptions(opts...)
|
|
||||||
if !w.xSupports(with.op) {
|
|
||||||
return fmt.Errorf("%w: %s", xErrUnsupported, with.op)
|
|
||||||
}
|
|
||||||
|
|
||||||
add := func(path string, with withOpts, recurse bool) error {
|
|
||||||
var flags uint32
|
|
||||||
if with.noFollow {
|
|
||||||
flags |= unix.IN_DONT_FOLLOW
|
|
||||||
}
|
|
||||||
if with.op.Has(Create) {
|
|
||||||
flags |= unix.IN_CREATE
|
|
||||||
}
|
|
||||||
if with.op.Has(Write) {
|
|
||||||
flags |= unix.IN_MODIFY
|
|
||||||
}
|
|
||||||
if with.op.Has(Remove) {
|
|
||||||
flags |= unix.IN_DELETE | unix.IN_DELETE_SELF
|
|
||||||
}
|
|
||||||
if with.op.Has(Rename) {
|
|
||||||
flags |= unix.IN_MOVED_TO | unix.IN_MOVED_FROM | unix.IN_MOVE_SELF
|
|
||||||
}
|
|
||||||
if with.op.Has(Chmod) {
|
|
||||||
flags |= unix.IN_ATTRIB
|
|
||||||
}
|
|
||||||
if with.op.Has(xUnportableOpen) {
|
|
||||||
flags |= unix.IN_OPEN
|
|
||||||
}
|
|
||||||
if with.op.Has(xUnportableRead) {
|
|
||||||
flags |= unix.IN_ACCESS
|
|
||||||
}
|
|
||||||
if with.op.Has(xUnportableCloseWrite) {
|
|
||||||
flags |= unix.IN_CLOSE_WRITE
|
|
||||||
}
|
|
||||||
if with.op.Has(xUnportableCloseRead) {
|
|
||||||
flags |= unix.IN_CLOSE_NOWRITE
|
|
||||||
}
|
|
||||||
return w.register(path, flags, recurse)
|
|
||||||
}
|
|
||||||
|
|
||||||
w.mu.Lock()
|
|
||||||
defer w.mu.Unlock()
|
|
||||||
path, recurse := recursivePath(path)
|
|
||||||
if recurse {
|
|
||||||
return filepath.WalkDir(path, func(root string, d fs.DirEntry, err error) error {
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
if !d.IsDir() {
|
|
||||||
if root == path {
|
|
||||||
return fmt.Errorf("fsnotify: not a directory: %q", path)
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// Send a Create event when adding new directory from a recursive
|
|
||||||
// watch; this is for "mkdir -p one/two/three". Usually all those
|
|
||||||
// directories will be created before we can set up watchers on the
|
|
||||||
// subdirectories, so only "one" would be sent as a Create event and
|
|
||||||
// not "one/two" and "one/two/three" (inotifywait -r has the same
|
|
||||||
// problem).
|
|
||||||
if with.sendCreate && root != path {
|
|
||||||
w.sendEvent(Event{Name: root, Op: Create})
|
|
||||||
}
|
|
||||||
|
|
||||||
return add(root, with, true)
|
|
||||||
})
|
|
||||||
}
|
|
||||||
|
|
||||||
return add(path, with, false)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *inotify) register(path string, flags uint32, recurse bool) error {
|
|
||||||
return w.watches.updatePath(path, func(existing *watch) (*watch, error) {
|
|
||||||
if existing != nil {
|
|
||||||
flags |= existing.flags | unix.IN_MASK_ADD
|
|
||||||
}
|
|
||||||
|
|
||||||
wd, err := unix.InotifyAddWatch(w.fd, path, flags)
|
|
||||||
if wd == -1 {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
|
|
||||||
if e, ok := w.watches.wd[uint32(wd)]; ok {
|
|
||||||
return e, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
if existing == nil {
|
|
||||||
return &watch{
|
|
||||||
wd: uint32(wd),
|
|
||||||
path: path,
|
|
||||||
flags: flags,
|
|
||||||
recurse: recurse,
|
|
||||||
}, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
existing.wd = uint32(wd)
|
|
||||||
existing.flags = flags
|
|
||||||
return existing, nil
|
|
||||||
})
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *inotify) Remove(name string) error {
|
|
||||||
if w.isClosed() {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
if debug {
|
|
||||||
fmt.Fprintf(os.Stderr, "FSNOTIFY_DEBUG: %s Remove(%q)\n",
|
|
||||||
time.Now().Format("15:04:05.000000000"), name)
|
|
||||||
}
|
|
||||||
|
|
||||||
w.mu.Lock()
|
|
||||||
defer w.mu.Unlock()
|
|
||||||
return w.remove(filepath.Clean(name))
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *inotify) remove(name string) error {
|
|
||||||
wds, err := w.watches.removePath(name)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
for _, wd := range wds {
|
|
||||||
_, err := unix.InotifyRmWatch(w.fd, wd)
|
|
||||||
if err != nil {
|
|
||||||
// TODO: Perhaps it's not helpful to return an error here in every
|
|
||||||
// case; the only two possible errors are:
|
|
||||||
//
|
|
||||||
// EBADF, which happens when w.fd is not a valid file descriptor of
|
|
||||||
// any kind.
|
|
||||||
//
|
|
||||||
// EINVAL, which is when fd is not an inotify descriptor or wd is
|
|
||||||
// not a valid watch descriptor. Watch descriptors are invalidated
|
|
||||||
// when they are removed explicitly or implicitly; explicitly by
|
|
||||||
// inotify_rm_watch, implicitly when the file they are watching is
|
|
||||||
// deleted.
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *inotify) WatchList() []string {
|
|
||||||
if w.isClosed() {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
w.mu.Lock()
|
|
||||||
defer w.mu.Unlock()
|
|
||||||
entries := make([]string, 0, w.watches.len())
|
|
||||||
for pathname := range w.watches.path {
|
|
||||||
entries = append(entries, pathname)
|
|
||||||
}
|
|
||||||
return entries
|
|
||||||
}
|
|
||||||
|
|
||||||
// readEvents reads from the inotify file descriptor, converts the
|
|
||||||
// received events into Event objects and sends them via the Events channel
|
|
||||||
func (w *inotify) readEvents() {
|
|
||||||
defer func() {
|
|
||||||
close(w.doneResp)
|
|
||||||
close(w.Errors)
|
|
||||||
close(w.Events)
|
|
||||||
}()
|
|
||||||
|
|
||||||
var buf [unix.SizeofInotifyEvent * 4096]byte // Buffer for a maximum of 4096 raw events
|
|
||||||
for {
|
|
||||||
if w.isClosed() {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
n, err := w.inotifyFile.Read(buf[:])
|
|
||||||
if err != nil {
|
|
||||||
if errors.Is(err, os.ErrClosed) {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
if !w.sendError(err) {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
|
|
||||||
if n < unix.SizeofInotifyEvent {
|
|
||||||
err := errors.New("notify: short read in readEvents()") // Read was too short.
|
|
||||||
if n == 0 {
|
|
||||||
err = io.EOF // If EOF is received. This should really never happen.
|
|
||||||
}
|
|
||||||
if !w.sendError(err) {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
|
|
||||||
// We don't know how many events we just read into the buffer While the
|
|
||||||
// offset points to at least one whole event.
|
|
||||||
var offset uint32
|
|
||||||
for offset <= uint32(n-unix.SizeofInotifyEvent) {
|
|
||||||
// Point to the event in the buffer.
|
|
||||||
inEvent := (*unix.InotifyEvent)(unsafe.Pointer(&buf[offset]))
|
|
||||||
|
|
||||||
if inEvent.Mask&unix.IN_Q_OVERFLOW != 0 {
|
|
||||||
if !w.sendError(ErrEventOverflow) {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
ev, ok := w.handleEvent(inEvent, &buf, offset)
|
|
||||||
if !ok {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
if !w.sendEvent(ev) {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
// Move to the next event in the buffer
|
|
||||||
offset += unix.SizeofInotifyEvent + inEvent.Len
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *inotify) handleEvent(inEvent *unix.InotifyEvent, buf *[65536]byte, offset uint32) (Event, bool) {
|
|
||||||
w.mu.Lock()
|
|
||||||
defer w.mu.Unlock()
|
|
||||||
|
|
||||||
/// If the event happened to the watched directory or the watched file, the
|
|
||||||
/// kernel doesn't append the filename to the event, but we would like to
|
|
||||||
/// always fill the the "Name" field with a valid filename. We retrieve the
|
|
||||||
/// path of the watch from the "paths" map.
|
|
||||||
///
|
|
||||||
/// Can be nil if Remove() was called in another goroutine for this path
|
|
||||||
/// inbetween reading the events from the kernel and reading the internal
|
|
||||||
/// state. Not much we can do about it, so just skip. See #616.
|
|
||||||
watch := w.watches.byWd(uint32(inEvent.Wd))
|
|
||||||
if watch == nil {
|
|
||||||
return Event{}, true
|
|
||||||
}
|
|
||||||
|
|
||||||
var (
|
|
||||||
name = watch.path
|
|
||||||
nameLen = uint32(inEvent.Len)
|
|
||||||
)
|
|
||||||
if nameLen > 0 {
|
|
||||||
/// Point "bytes" at the first byte of the filename
|
|
||||||
bb := *buf
|
|
||||||
bytes := (*[unix.PathMax]byte)(unsafe.Pointer(&bb[offset+unix.SizeofInotifyEvent]))[:nameLen:nameLen]
|
|
||||||
/// The filename is padded with NULL bytes. TrimRight() gets rid of those.
|
|
||||||
name += "/" + strings.TrimRight(string(bytes[0:nameLen]), "\x00")
|
|
||||||
}
|
|
||||||
|
|
||||||
if debug {
|
|
||||||
internal.Debug(name, inEvent.Mask, inEvent.Cookie)
|
|
||||||
}
|
|
||||||
|
|
||||||
if inEvent.Mask&unix.IN_IGNORED != 0 || inEvent.Mask&unix.IN_UNMOUNT != 0 {
|
|
||||||
w.watches.remove(watch)
|
|
||||||
return Event{}, true
|
|
||||||
}
|
|
||||||
|
|
||||||
// inotify will automatically remove the watch on deletes; just need
|
|
||||||
// to clean our state here.
|
|
||||||
if inEvent.Mask&unix.IN_DELETE_SELF == unix.IN_DELETE_SELF {
|
|
||||||
w.watches.remove(watch)
|
|
||||||
}
|
|
||||||
|
|
||||||
// We can't really update the state when a watched path is moved; only
|
|
||||||
// IN_MOVE_SELF is sent and not IN_MOVED_{FROM,TO}. So remove the watch.
|
|
||||||
if inEvent.Mask&unix.IN_MOVE_SELF == unix.IN_MOVE_SELF {
|
|
||||||
if watch.recurse { // Do nothing
|
|
||||||
return Event{}, true
|
|
||||||
}
|
|
||||||
|
|
||||||
err := w.remove(watch.path)
|
|
||||||
if err != nil && !errors.Is(err, ErrNonExistentWatch) {
|
|
||||||
if !w.sendError(err) {
|
|
||||||
return Event{}, false
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/// Skip if we're watching both this path and the parent; the parent will
|
|
||||||
/// already send a delete so no need to do it twice.
|
|
||||||
if inEvent.Mask&unix.IN_DELETE_SELF != 0 {
|
|
||||||
_, ok := w.watches.path[filepath.Dir(watch.path)]
|
|
||||||
if ok {
|
|
||||||
return Event{}, true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
ev := w.newEvent(name, inEvent.Mask, inEvent.Cookie)
|
|
||||||
// Need to update watch path for recurse.
|
|
||||||
if watch.recurse {
|
|
||||||
isDir := inEvent.Mask&unix.IN_ISDIR == unix.IN_ISDIR
|
|
||||||
/// New directory created: set up watch on it.
|
|
||||||
if isDir && ev.Has(Create) {
|
|
||||||
err := w.register(ev.Name, watch.flags, true)
|
|
||||||
if !w.sendError(err) {
|
|
||||||
return Event{}, false
|
|
||||||
}
|
|
||||||
|
|
||||||
// This was a directory rename, so we need to update all the
|
|
||||||
// children.
|
|
||||||
//
|
|
||||||
// TODO: this is of course pretty slow; we should use a better data
|
|
||||||
// structure for storing all of this, e.g. store children in the
|
|
||||||
// watch. I have some code for this in my kqueue refactor we can use
|
|
||||||
// in the future. For now I'm okay with this as it's not publicly
|
|
||||||
// available. Correctness first, performance second.
|
|
||||||
if ev.renamedFrom != "" {
|
|
||||||
for k, ww := range w.watches.wd {
|
|
||||||
if k == watch.wd || ww.path == ev.Name {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
if strings.HasPrefix(ww.path, ev.renamedFrom) {
|
|
||||||
ww.path = strings.Replace(ww.path, ev.renamedFrom, ev.Name, 1)
|
|
||||||
w.watches.wd[k] = ww
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return ev, true
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *inotify) isRecursive(path string) bool {
|
|
||||||
ww := w.watches.byPath(path)
|
|
||||||
if ww == nil { // path could be a file, so also check the Dir.
|
|
||||||
ww = w.watches.byPath(filepath.Dir(path))
|
|
||||||
}
|
|
||||||
return ww != nil && ww.recurse
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *inotify) newEvent(name string, mask, cookie uint32) Event {
|
|
||||||
e := Event{Name: name}
|
|
||||||
if mask&unix.IN_CREATE == unix.IN_CREATE || mask&unix.IN_MOVED_TO == unix.IN_MOVED_TO {
|
|
||||||
e.Op |= Create
|
|
||||||
}
|
|
||||||
if mask&unix.IN_DELETE_SELF == unix.IN_DELETE_SELF || mask&unix.IN_DELETE == unix.IN_DELETE {
|
|
||||||
e.Op |= Remove
|
|
||||||
}
|
|
||||||
if mask&unix.IN_MODIFY == unix.IN_MODIFY {
|
|
||||||
e.Op |= Write
|
|
||||||
}
|
|
||||||
if mask&unix.IN_OPEN == unix.IN_OPEN {
|
|
||||||
e.Op |= xUnportableOpen
|
|
||||||
}
|
|
||||||
if mask&unix.IN_ACCESS == unix.IN_ACCESS {
|
|
||||||
e.Op |= xUnportableRead
|
|
||||||
}
|
|
||||||
if mask&unix.IN_CLOSE_WRITE == unix.IN_CLOSE_WRITE {
|
|
||||||
e.Op |= xUnportableCloseWrite
|
|
||||||
}
|
|
||||||
if mask&unix.IN_CLOSE_NOWRITE == unix.IN_CLOSE_NOWRITE {
|
|
||||||
e.Op |= xUnportableCloseRead
|
|
||||||
}
|
|
||||||
if mask&unix.IN_MOVE_SELF == unix.IN_MOVE_SELF || mask&unix.IN_MOVED_FROM == unix.IN_MOVED_FROM {
|
|
||||||
e.Op |= Rename
|
|
||||||
}
|
|
||||||
if mask&unix.IN_ATTRIB == unix.IN_ATTRIB {
|
|
||||||
e.Op |= Chmod
|
|
||||||
}
|
|
||||||
|
|
||||||
if cookie != 0 {
|
|
||||||
if mask&unix.IN_MOVED_FROM == unix.IN_MOVED_FROM {
|
|
||||||
w.cookiesMu.Lock()
|
|
||||||
w.cookies[w.cookieIndex] = koekje{cookie: cookie, path: e.Name}
|
|
||||||
w.cookieIndex++
|
|
||||||
if w.cookieIndex > 9 {
|
|
||||||
w.cookieIndex = 0
|
|
||||||
}
|
|
||||||
w.cookiesMu.Unlock()
|
|
||||||
} else if mask&unix.IN_MOVED_TO == unix.IN_MOVED_TO {
|
|
||||||
w.cookiesMu.Lock()
|
|
||||||
var prev string
|
|
||||||
for _, c := range w.cookies {
|
|
||||||
if c.cookie == cookie {
|
|
||||||
prev = c.path
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
w.cookiesMu.Unlock()
|
|
||||||
e.renamedFrom = prev
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return e
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *inotify) xSupports(op Op) bool {
|
|
||||||
return true // Supports everything.
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *inotify) state() {
|
|
||||||
w.mu.Lock()
|
|
||||||
defer w.mu.Unlock()
|
|
||||||
for wd, ww := range w.watches.wd {
|
|
||||||
fmt.Fprintf(os.Stderr, "%4d: recurse=%t %q\n", wd, ww.recurse, ww.path)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
705
vendor/github.com/fsnotify/fsnotify/backend_kqueue.go
generated
vendored
705
vendor/github.com/fsnotify/fsnotify/backend_kqueue.go
generated
vendored
@@ -1,705 +0,0 @@
|
|||||||
//go:build freebsd || openbsd || netbsd || dragonfly || darwin
|
|
||||||
|
|
||||||
package fsnotify
|
|
||||||
|
|
||||||
import (
|
|
||||||
"errors"
|
|
||||||
"fmt"
|
|
||||||
"os"
|
|
||||||
"path/filepath"
|
|
||||||
"runtime"
|
|
||||||
"sync"
|
|
||||||
"time"
|
|
||||||
|
|
||||||
"github.com/fsnotify/fsnotify/internal"
|
|
||||||
"golang.org/x/sys/unix"
|
|
||||||
)
|
|
||||||
|
|
||||||
type kqueue struct {
|
|
||||||
*shared
|
|
||||||
Events chan Event
|
|
||||||
Errors chan error
|
|
||||||
|
|
||||||
kq int // File descriptor (as returned by the kqueue() syscall).
|
|
||||||
closepipe [2]int // Pipe used for closing kq.
|
|
||||||
watches *watches
|
|
||||||
}
|
|
||||||
|
|
||||||
type (
|
|
||||||
watches struct {
|
|
||||||
mu sync.RWMutex
|
|
||||||
wd map[int]watch // wd → watch
|
|
||||||
path map[string]int // pathname → wd
|
|
||||||
byDir map[string]map[int]struct{} // dirname(path) → wd
|
|
||||||
seen map[string]struct{} // Keep track of if we know this file exists.
|
|
||||||
byUser map[string]struct{} // Watches added with Watcher.Add()
|
|
||||||
}
|
|
||||||
watch struct {
|
|
||||||
wd int
|
|
||||||
name string
|
|
||||||
linkName string // In case of links; name is the target, and this is the link.
|
|
||||||
isDir bool
|
|
||||||
dirFlags uint32
|
|
||||||
}
|
|
||||||
)
|
|
||||||
|
|
||||||
func newWatches() *watches {
|
|
||||||
return &watches{
|
|
||||||
wd: make(map[int]watch),
|
|
||||||
path: make(map[string]int),
|
|
||||||
byDir: make(map[string]map[int]struct{}),
|
|
||||||
seen: make(map[string]struct{}),
|
|
||||||
byUser: make(map[string]struct{}),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *watches) listPaths(userOnly bool) []string {
|
|
||||||
w.mu.RLock()
|
|
||||||
defer w.mu.RUnlock()
|
|
||||||
|
|
||||||
if userOnly {
|
|
||||||
l := make([]string, 0, len(w.byUser))
|
|
||||||
for p := range w.byUser {
|
|
||||||
l = append(l, p)
|
|
||||||
}
|
|
||||||
return l
|
|
||||||
}
|
|
||||||
|
|
||||||
l := make([]string, 0, len(w.path))
|
|
||||||
for p := range w.path {
|
|
||||||
l = append(l, p)
|
|
||||||
}
|
|
||||||
return l
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *watches) watchesInDir(path string) []string {
|
|
||||||
w.mu.RLock()
|
|
||||||
defer w.mu.RUnlock()
|
|
||||||
|
|
||||||
l := make([]string, 0, 4)
|
|
||||||
for fd := range w.byDir[path] {
|
|
||||||
info := w.wd[fd]
|
|
||||||
if _, ok := w.byUser[info.name]; !ok {
|
|
||||||
l = append(l, info.name)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return l
|
|
||||||
}
|
|
||||||
|
|
||||||
// Mark path as added by the user.
|
|
||||||
func (w *watches) addUserWatch(path string) {
|
|
||||||
w.mu.Lock()
|
|
||||||
defer w.mu.Unlock()
|
|
||||||
w.byUser[path] = struct{}{}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *watches) addLink(path string, fd int) {
|
|
||||||
w.mu.Lock()
|
|
||||||
defer w.mu.Unlock()
|
|
||||||
|
|
||||||
w.path[path] = fd
|
|
||||||
w.seen[path] = struct{}{}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *watches) add(path, linkPath string, fd int, isDir bool) {
|
|
||||||
w.mu.Lock()
|
|
||||||
defer w.mu.Unlock()
|
|
||||||
|
|
||||||
w.path[path] = fd
|
|
||||||
w.wd[fd] = watch{wd: fd, name: path, linkName: linkPath, isDir: isDir}
|
|
||||||
|
|
||||||
parent := filepath.Dir(path)
|
|
||||||
byDir, ok := w.byDir[parent]
|
|
||||||
if !ok {
|
|
||||||
byDir = make(map[int]struct{}, 1)
|
|
||||||
w.byDir[parent] = byDir
|
|
||||||
}
|
|
||||||
byDir[fd] = struct{}{}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *watches) byWd(fd int) (watch, bool) {
|
|
||||||
w.mu.RLock()
|
|
||||||
defer w.mu.RUnlock()
|
|
||||||
info, ok := w.wd[fd]
|
|
||||||
return info, ok
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *watches) byPath(path string) (watch, bool) {
|
|
||||||
w.mu.RLock()
|
|
||||||
defer w.mu.RUnlock()
|
|
||||||
info, ok := w.wd[w.path[path]]
|
|
||||||
return info, ok
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *watches) updateDirFlags(path string, flags uint32) bool {
|
|
||||||
w.mu.Lock()
|
|
||||||
defer w.mu.Unlock()
|
|
||||||
|
|
||||||
fd, ok := w.path[path]
|
|
||||||
if !ok { // Already deleted: don't re-set it here.
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
info := w.wd[fd]
|
|
||||||
info.dirFlags = flags
|
|
||||||
w.wd[fd] = info
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *watches) remove(fd int, path string) bool {
|
|
||||||
w.mu.Lock()
|
|
||||||
defer w.mu.Unlock()
|
|
||||||
|
|
||||||
isDir := w.wd[fd].isDir
|
|
||||||
delete(w.path, path)
|
|
||||||
delete(w.byUser, path)
|
|
||||||
|
|
||||||
parent := filepath.Dir(path)
|
|
||||||
delete(w.byDir[parent], fd)
|
|
||||||
|
|
||||||
if len(w.byDir[parent]) == 0 {
|
|
||||||
delete(w.byDir, parent)
|
|
||||||
}
|
|
||||||
|
|
||||||
delete(w.wd, fd)
|
|
||||||
delete(w.seen, path)
|
|
||||||
return isDir
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *watches) markSeen(path string, exists bool) {
|
|
||||||
w.mu.Lock()
|
|
||||||
defer w.mu.Unlock()
|
|
||||||
if exists {
|
|
||||||
w.seen[path] = struct{}{}
|
|
||||||
} else {
|
|
||||||
delete(w.seen, path)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *watches) seenBefore(path string) bool {
|
|
||||||
w.mu.RLock()
|
|
||||||
defer w.mu.RUnlock()
|
|
||||||
_, ok := w.seen[path]
|
|
||||||
return ok
|
|
||||||
}
|
|
||||||
|
|
||||||
var defaultBufferSize = 0
|
|
||||||
|
|
||||||
func newBackend(ev chan Event, errs chan error) (backend, error) {
|
|
||||||
kq, closepipe, err := newKqueue()
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
|
|
||||||
w := &kqueue{
|
|
||||||
shared: newShared(ev, errs),
|
|
||||||
Events: ev,
|
|
||||||
Errors: errs,
|
|
||||||
kq: kq,
|
|
||||||
closepipe: closepipe,
|
|
||||||
watches: newWatches(),
|
|
||||||
}
|
|
||||||
|
|
||||||
go w.readEvents()
|
|
||||||
return w, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// newKqueue creates a new kernel event queue and returns a descriptor.
|
|
||||||
//
|
|
||||||
// This registers a new event on closepipe, which will trigger an event when
|
|
||||||
// it's closed. This way we can use kevent() without timeout/polling; without
|
|
||||||
// the closepipe, it would block forever and we wouldn't be able to stop it at
|
|
||||||
// all.
|
|
||||||
func newKqueue() (kq int, closepipe [2]int, err error) {
|
|
||||||
kq, err = unix.Kqueue()
|
|
||||||
if err != nil {
|
|
||||||
return kq, closepipe, err
|
|
||||||
}
|
|
||||||
|
|
||||||
// Register the close pipe.
|
|
||||||
err = unix.Pipe(closepipe[:])
|
|
||||||
if err != nil {
|
|
||||||
unix.Close(kq)
|
|
||||||
return kq, closepipe, err
|
|
||||||
}
|
|
||||||
unix.CloseOnExec(closepipe[0])
|
|
||||||
unix.CloseOnExec(closepipe[1])
|
|
||||||
|
|
||||||
// Register changes to listen on the closepipe.
|
|
||||||
changes := make([]unix.Kevent_t, 1)
|
|
||||||
// SetKevent converts int to the platform-specific types.
|
|
||||||
unix.SetKevent(&changes[0], closepipe[0], unix.EVFILT_READ,
|
|
||||||
unix.EV_ADD|unix.EV_ENABLE|unix.EV_ONESHOT)
|
|
||||||
|
|
||||||
ok, err := unix.Kevent(kq, changes, nil, nil)
|
|
||||||
if ok == -1 {
|
|
||||||
unix.Close(kq)
|
|
||||||
unix.Close(closepipe[0])
|
|
||||||
unix.Close(closepipe[1])
|
|
||||||
return kq, closepipe, err
|
|
||||||
}
|
|
||||||
return kq, closepipe, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *kqueue) Close() error {
|
|
||||||
if w.shared.close() {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
pathsToRemove := w.watches.listPaths(false)
|
|
||||||
for _, name := range pathsToRemove {
|
|
||||||
w.Remove(name)
|
|
||||||
}
|
|
||||||
|
|
||||||
unix.Close(w.closepipe[1]) // Send "quit" message to readEvents
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *kqueue) Add(name string) error { return w.AddWith(name) }
|
|
||||||
|
|
||||||
func (w *kqueue) AddWith(name string, opts ...addOpt) error {
|
|
||||||
if debug {
|
|
||||||
fmt.Fprintf(os.Stderr, "FSNOTIFY_DEBUG: %s AddWith(%q)\n",
|
|
||||||
time.Now().Format("15:04:05.000000000"), name)
|
|
||||||
}
|
|
||||||
|
|
||||||
with := getOptions(opts...)
|
|
||||||
if !w.xSupports(with.op) {
|
|
||||||
return fmt.Errorf("%w: %s", xErrUnsupported, with.op)
|
|
||||||
}
|
|
||||||
|
|
||||||
_, err := w.addWatch(name, noteAllEvents, false)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
w.watches.addUserWatch(name)
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *kqueue) Remove(name string) error {
|
|
||||||
if debug {
|
|
||||||
fmt.Fprintf(os.Stderr, "FSNOTIFY_DEBUG: %s Remove(%q)\n",
|
|
||||||
time.Now().Format("15:04:05.000000000"), name)
|
|
||||||
}
|
|
||||||
return w.remove(name, true)
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *kqueue) remove(name string, unwatchFiles bool) error {
|
|
||||||
if w.isClosed() {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
name = filepath.Clean(name)
|
|
||||||
info, ok := w.watches.byPath(name)
|
|
||||||
if !ok {
|
|
||||||
return fmt.Errorf("%w: %s", ErrNonExistentWatch, name)
|
|
||||||
}
|
|
||||||
|
|
||||||
err := w.register([]int{info.wd}, unix.EV_DELETE, 0)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
unix.Close(info.wd)
|
|
||||||
|
|
||||||
isDir := w.watches.remove(info.wd, name)
|
|
||||||
|
|
||||||
// Find all watched paths that are in this directory that are not external.
|
|
||||||
if unwatchFiles && isDir {
|
|
||||||
pathsToRemove := w.watches.watchesInDir(name)
|
|
||||||
for _, name := range pathsToRemove {
|
|
||||||
// Since these are internal, not much sense in propagating error to
|
|
||||||
// the user, as that will just confuse them with an error about a
|
|
||||||
// path they did not explicitly watch themselves.
|
|
||||||
w.Remove(name)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *kqueue) WatchList() []string {
|
|
||||||
if w.isClosed() {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
return w.watches.listPaths(true)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Watch all events (except NOTE_EXTEND, NOTE_LINK, NOTE_REVOKE)
|
|
||||||
const noteAllEvents = unix.NOTE_DELETE | unix.NOTE_WRITE | unix.NOTE_ATTRIB | unix.NOTE_RENAME
|
|
||||||
|
|
||||||
// addWatch adds name to the watched file set; the flags are interpreted as
|
|
||||||
// described in kevent(2).
|
|
||||||
//
|
|
||||||
// Returns the real path to the file which was added, with symlinks resolved.
|
|
||||||
func (w *kqueue) addWatch(name string, flags uint32, listDir bool) (string, error) {
|
|
||||||
if w.isClosed() {
|
|
||||||
return "", ErrClosed
|
|
||||||
}
|
|
||||||
|
|
||||||
name = filepath.Clean(name)
|
|
||||||
|
|
||||||
info, alreadyWatching := w.watches.byPath(name)
|
|
||||||
if !alreadyWatching {
|
|
||||||
fi, err := os.Lstat(name)
|
|
||||||
if err != nil {
|
|
||||||
return "", err
|
|
||||||
}
|
|
||||||
|
|
||||||
// Don't watch sockets or named pipes.
|
|
||||||
if (fi.Mode()&os.ModeSocket == os.ModeSocket) || (fi.Mode()&os.ModeNamedPipe == os.ModeNamedPipe) {
|
|
||||||
return "", nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// Follow symlinks, but only for paths added with Add(), and not paths
|
|
||||||
// we're adding from internalWatch from a listdir.
|
|
||||||
if !listDir && fi.Mode()&os.ModeSymlink == os.ModeSymlink {
|
|
||||||
link, err := os.Readlink(name)
|
|
||||||
if err != nil {
|
|
||||||
return "", err
|
|
||||||
}
|
|
||||||
if !filepath.IsAbs(link) {
|
|
||||||
link = filepath.Join(filepath.Dir(name), link)
|
|
||||||
}
|
|
||||||
|
|
||||||
_, alreadyWatching = w.watches.byPath(link)
|
|
||||||
if alreadyWatching {
|
|
||||||
// Add to watches so we don't get spurious Create events later
|
|
||||||
// on when we diff the directories.
|
|
||||||
w.watches.addLink(name, 0)
|
|
||||||
return link, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
info.linkName = name
|
|
||||||
name = link
|
|
||||||
fi, err = os.Lstat(name)
|
|
||||||
if err != nil {
|
|
||||||
return "", err
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Retry on EINTR; open() can return EINTR in practice on macOS.
|
|
||||||
// See #354, and Go issues 11180 and 39237.
|
|
||||||
for {
|
|
||||||
info.wd, err = unix.Open(name, openMode, 0)
|
|
||||||
if err == nil {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
if errors.Is(err, unix.EINTR) {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
return "", err
|
|
||||||
}
|
|
||||||
|
|
||||||
info.isDir = fi.IsDir()
|
|
||||||
}
|
|
||||||
|
|
||||||
err := w.register([]int{info.wd}, unix.EV_ADD|unix.EV_CLEAR|unix.EV_ENABLE, flags)
|
|
||||||
if err != nil {
|
|
||||||
unix.Close(info.wd)
|
|
||||||
return "", err
|
|
||||||
}
|
|
||||||
|
|
||||||
if !alreadyWatching {
|
|
||||||
w.watches.add(name, info.linkName, info.wd, info.isDir)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Watch the directory if it has not been watched before, or if it was
|
|
||||||
// watched before, but perhaps only a NOTE_DELETE (watchDirectoryFiles)
|
|
||||||
if info.isDir {
|
|
||||||
watchDir := (flags&unix.NOTE_WRITE) == unix.NOTE_WRITE &&
|
|
||||||
(!alreadyWatching || (info.dirFlags&unix.NOTE_WRITE) != unix.NOTE_WRITE)
|
|
||||||
if !w.watches.updateDirFlags(name, flags) {
|
|
||||||
return "", nil
|
|
||||||
}
|
|
||||||
|
|
||||||
if watchDir {
|
|
||||||
d := name
|
|
||||||
if info.linkName != "" {
|
|
||||||
d = info.linkName
|
|
||||||
}
|
|
||||||
if err := w.watchDirectoryFiles(d); err != nil {
|
|
||||||
return "", err
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return name, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// readEvents reads from kqueue and converts the received kevents into
|
|
||||||
// Event values that it sends down the Events channel.
|
|
||||||
func (w *kqueue) readEvents() {
|
|
||||||
defer func() {
|
|
||||||
close(w.Events)
|
|
||||||
close(w.Errors)
|
|
||||||
_ = unix.Close(w.kq)
|
|
||||||
unix.Close(w.closepipe[0])
|
|
||||||
}()
|
|
||||||
|
|
||||||
eventBuffer := make([]unix.Kevent_t, 10)
|
|
||||||
for {
|
|
||||||
kevents, err := w.read(eventBuffer)
|
|
||||||
// EINTR is okay, the syscall was interrupted before timeout expired.
|
|
||||||
if err != nil && err != unix.EINTR {
|
|
||||||
if !w.sendError(fmt.Errorf("fsnotify.readEvents: %w", err)) {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
for _, kevent := range kevents {
|
|
||||||
var (
|
|
||||||
wd = int(kevent.Ident)
|
|
||||||
mask = uint32(kevent.Fflags)
|
|
||||||
)
|
|
||||||
|
|
||||||
// Shut down the loop when the pipe is closed, but only after all
|
|
||||||
// other events have been processed.
|
|
||||||
if wd == w.closepipe[0] {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
path, ok := w.watches.byWd(wd)
|
|
||||||
if debug {
|
|
||||||
internal.Debug(path.name, &kevent)
|
|
||||||
}
|
|
||||||
|
|
||||||
// On macOS it seems that sometimes an event with Ident=0 is
|
|
||||||
// delivered, and no other flags/information beyond that, even
|
|
||||||
// though we never saw such a file descriptor. For example in
|
|
||||||
// TestWatchSymlink/277 (usually at the end, but sometimes sooner):
|
|
||||||
//
|
|
||||||
// fmt.Printf("READ: %2d %#v\n", kevent.Ident, kevent)
|
|
||||||
// unix.Kevent_t{Ident:0x2a, Filter:-4, Flags:0x25, Fflags:0x2, Data:0, Udata:(*uint8)(nil)}
|
|
||||||
// unix.Kevent_t{Ident:0x0, Filter:-4, Flags:0x25, Fflags:0x2, Data:0, Udata:(*uint8)(nil)}
|
|
||||||
//
|
|
||||||
// The first is a normal event, the second with Ident 0. No error
|
|
||||||
// flag, no data, no ... nothing.
|
|
||||||
//
|
|
||||||
// I read a bit through bsd/kern_event.c from the xnu source, but I
|
|
||||||
// don't really see an obvious location where this is triggered –
|
|
||||||
// this doesn't seem intentional, but idk...
|
|
||||||
//
|
|
||||||
// Technically fd 0 is a valid descriptor, so only skip it if
|
|
||||||
// there's no path, and if we're on macOS.
|
|
||||||
if !ok && kevent.Ident == 0 && runtime.GOOS == "darwin" {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
|
|
||||||
event := w.newEvent(path.name, path.linkName, mask)
|
|
||||||
|
|
||||||
if event.Has(Rename) || event.Has(Remove) {
|
|
||||||
w.remove(event.Name, false)
|
|
||||||
w.watches.markSeen(event.Name, false)
|
|
||||||
}
|
|
||||||
|
|
||||||
if path.isDir && event.Has(Write) && !event.Has(Remove) {
|
|
||||||
w.dirChange(event.Name)
|
|
||||||
} else if !w.sendEvent(event) {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
if event.Has(Remove) {
|
|
||||||
// Look for a file that may have overwritten this; for example,
|
|
||||||
// mv f1 f2 will delete f2, then create f2.
|
|
||||||
if path.isDir {
|
|
||||||
fileDir := filepath.Clean(event.Name)
|
|
||||||
_, found := w.watches.byPath(fileDir)
|
|
||||||
if found {
|
|
||||||
// TODO: this branch is never triggered in any test.
|
|
||||||
// Added in d6220df (2012).
|
|
||||||
// isDir check added in 8611c35 (2016): https://github.com/fsnotify/fsnotify/pull/111
|
|
||||||
//
|
|
||||||
// I don't really get how this can be triggered either.
|
|
||||||
// And it wasn't triggered in the patch that added it,
|
|
||||||
// either.
|
|
||||||
//
|
|
||||||
// Original also had a comment:
|
|
||||||
// make sure the directory exists before we watch for
|
|
||||||
// changes. When we do a recursive watch and perform
|
|
||||||
// rm -rf, the parent directory might have gone
|
|
||||||
// missing, ignore the missing directory and let the
|
|
||||||
// upcoming delete event remove the watch from the
|
|
||||||
// parent directory.
|
|
||||||
err := w.dirChange(fileDir)
|
|
||||||
if !w.sendError(err) {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
}
|
|
||||||
} else {
|
|
||||||
path := filepath.Clean(event.Name)
|
|
||||||
if fi, err := os.Lstat(path); err == nil {
|
|
||||||
err := w.sendCreateIfNew(path, fi)
|
|
||||||
if !w.sendError(err) {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// newEvent returns an platform-independent Event based on kqueue Fflags.
|
|
||||||
func (w *kqueue) newEvent(name, linkName string, mask uint32) Event {
|
|
||||||
e := Event{Name: name}
|
|
||||||
if linkName != "" {
|
|
||||||
// If the user watched "/path/link" then emit events as "/path/link"
|
|
||||||
// rather than "/path/target".
|
|
||||||
e.Name = linkName
|
|
||||||
}
|
|
||||||
|
|
||||||
if mask&unix.NOTE_DELETE == unix.NOTE_DELETE {
|
|
||||||
e.Op |= Remove
|
|
||||||
}
|
|
||||||
if mask&unix.NOTE_WRITE == unix.NOTE_WRITE {
|
|
||||||
e.Op |= Write
|
|
||||||
}
|
|
||||||
if mask&unix.NOTE_RENAME == unix.NOTE_RENAME {
|
|
||||||
e.Op |= Rename
|
|
||||||
}
|
|
||||||
if mask&unix.NOTE_ATTRIB == unix.NOTE_ATTRIB {
|
|
||||||
e.Op |= Chmod
|
|
||||||
}
|
|
||||||
// No point sending a write and delete event at the same time: if it's gone,
|
|
||||||
// then it's gone.
|
|
||||||
if e.Op.Has(Write) && e.Op.Has(Remove) {
|
|
||||||
e.Op &^= Write
|
|
||||||
}
|
|
||||||
return e
|
|
||||||
}
|
|
||||||
|
|
||||||
// watchDirectoryFiles to mimic inotify when adding a watch on a directory
|
|
||||||
func (w *kqueue) watchDirectoryFiles(dirPath string) error {
|
|
||||||
files, err := os.ReadDir(dirPath)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
for _, f := range files {
|
|
||||||
path := filepath.Join(dirPath, f.Name())
|
|
||||||
|
|
||||||
fi, err := f.Info()
|
|
||||||
if err != nil {
|
|
||||||
return fmt.Errorf("%q: %w", path, err)
|
|
||||||
}
|
|
||||||
|
|
||||||
cleanPath, err := w.internalWatch(path, fi)
|
|
||||||
if err != nil {
|
|
||||||
// No permission to read the file; that's not a problem: just skip.
|
|
||||||
// But do add it to w.fileExists to prevent it from being picked up
|
|
||||||
// as a "new" file later (it still shows up in the directory
|
|
||||||
// listing).
|
|
||||||
switch {
|
|
||||||
case errors.Is(err, unix.EACCES) || errors.Is(err, unix.EPERM):
|
|
||||||
cleanPath = filepath.Clean(path)
|
|
||||||
default:
|
|
||||||
return fmt.Errorf("%q: %w", path, err)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
w.watches.markSeen(cleanPath, true)
|
|
||||||
}
|
|
||||||
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// Search the directory for new files and send an event for them.
|
|
||||||
//
|
|
||||||
// This functionality is to have the BSD watcher match the inotify, which sends
|
|
||||||
// a create event for files created in a watched directory.
|
|
||||||
func (w *kqueue) dirChange(dir string) error {
|
|
||||||
files, err := os.ReadDir(dir)
|
|
||||||
if err != nil {
|
|
||||||
// Directory no longer exists: we can ignore this safely. kqueue will
|
|
||||||
// still give us the correct events.
|
|
||||||
if errors.Is(err, os.ErrNotExist) {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
return fmt.Errorf("fsnotify.dirChange %q: %w", dir, err)
|
|
||||||
}
|
|
||||||
|
|
||||||
for _, f := range files {
|
|
||||||
fi, err := f.Info()
|
|
||||||
if err != nil {
|
|
||||||
if errors.Is(err, os.ErrNotExist) {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
return fmt.Errorf("fsnotify.dirChange: %w", err)
|
|
||||||
}
|
|
||||||
|
|
||||||
err = w.sendCreateIfNew(filepath.Join(dir, fi.Name()), fi)
|
|
||||||
if err != nil {
|
|
||||||
// Don't need to send an error if this file isn't readable.
|
|
||||||
if errors.Is(err, unix.EACCES) || errors.Is(err, unix.EPERM) || errors.Is(err, os.ErrNotExist) {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
return fmt.Errorf("fsnotify.dirChange: %w", err)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// Send a create event if the file isn't already being tracked, and start
|
|
||||||
// watching this file.
|
|
||||||
func (w *kqueue) sendCreateIfNew(path string, fi os.FileInfo) error {
|
|
||||||
if !w.watches.seenBefore(path) {
|
|
||||||
if !w.sendEvent(Event{Name: path, Op: Create}) {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Like watchDirectoryFiles, but without doing another ReadDir.
|
|
||||||
path, err := w.internalWatch(path, fi)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
w.watches.markSeen(path, true)
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *kqueue) internalWatch(name string, fi os.FileInfo) (string, error) {
|
|
||||||
if fi.IsDir() {
|
|
||||||
// mimic Linux providing delete events for subdirectories, but preserve
|
|
||||||
// the flags used if currently watching subdirectory
|
|
||||||
info, _ := w.watches.byPath(name)
|
|
||||||
return w.addWatch(name, info.dirFlags|unix.NOTE_DELETE|unix.NOTE_RENAME, true)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Watch file to mimic Linux inotify.
|
|
||||||
return w.addWatch(name, noteAllEvents, true)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Register events with the queue.
|
|
||||||
func (w *kqueue) register(fds []int, flags int, fflags uint32) error {
|
|
||||||
changes := make([]unix.Kevent_t, len(fds))
|
|
||||||
for i, fd := range fds {
|
|
||||||
// SetKevent converts int to the platform-specific types.
|
|
||||||
unix.SetKevent(&changes[i], fd, unix.EVFILT_VNODE, flags)
|
|
||||||
changes[i].Fflags = fflags
|
|
||||||
}
|
|
||||||
|
|
||||||
// Register the events.
|
|
||||||
success, err := unix.Kevent(w.kq, changes, nil, nil)
|
|
||||||
if success == -1 {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// read retrieves pending events, or waits until an event occurs.
|
|
||||||
func (w *kqueue) read(events []unix.Kevent_t) ([]unix.Kevent_t, error) {
|
|
||||||
n, err := unix.Kevent(w.kq, nil, events, nil)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
return events[0:n], nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *kqueue) xSupports(op Op) bool {
|
|
||||||
//if runtime.GOOS == "freebsd" {
|
|
||||||
// return true // Supports everything.
|
|
||||||
//}
|
|
||||||
if op.Has(xUnportableOpen) || op.Has(xUnportableRead) ||
|
|
||||||
op.Has(xUnportableCloseWrite) || op.Has(xUnportableCloseRead) {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
22
vendor/github.com/fsnotify/fsnotify/backend_other.go
generated
vendored
22
vendor/github.com/fsnotify/fsnotify/backend_other.go
generated
vendored
@@ -1,22 +0,0 @@
|
|||||||
//go:build appengine || (!darwin && !dragonfly && !freebsd && !openbsd && !linux && !netbsd && !solaris && !windows)
|
|
||||||
|
|
||||||
package fsnotify
|
|
||||||
|
|
||||||
import "errors"
|
|
||||||
|
|
||||||
type other struct {
|
|
||||||
Events chan Event
|
|
||||||
Errors chan error
|
|
||||||
}
|
|
||||||
|
|
||||||
var defaultBufferSize = 0
|
|
||||||
|
|
||||||
func newBackend(ev chan Event, errs chan error) (backend, error) {
|
|
||||||
return nil, errors.New("fsnotify not supported on the current platform")
|
|
||||||
}
|
|
||||||
func (w *other) Close() error { return nil }
|
|
||||||
func (w *other) WatchList() []string { return nil }
|
|
||||||
func (w *other) Add(name string) error { return nil }
|
|
||||||
func (w *other) AddWith(name string, opts ...addOpt) error { return nil }
|
|
||||||
func (w *other) Remove(name string) error { return nil }
|
|
||||||
func (w *other) xSupports(op Op) bool { return false }
|
|
||||||
680
vendor/github.com/fsnotify/fsnotify/backend_windows.go
generated
vendored
680
vendor/github.com/fsnotify/fsnotify/backend_windows.go
generated
vendored
@@ -1,680 +0,0 @@
|
|||||||
//go:build windows
|
|
||||||
|
|
||||||
// Windows backend based on ReadDirectoryChangesW()
|
|
||||||
//
|
|
||||||
// https://learn.microsoft.com/en-us/windows/win32/api/winbase/nf-winbase-readdirectorychangesw
|
|
||||||
|
|
||||||
package fsnotify
|
|
||||||
|
|
||||||
import (
|
|
||||||
"errors"
|
|
||||||
"fmt"
|
|
||||||
"os"
|
|
||||||
"path/filepath"
|
|
||||||
"reflect"
|
|
||||||
"runtime"
|
|
||||||
"strings"
|
|
||||||
"sync"
|
|
||||||
"time"
|
|
||||||
"unsafe"
|
|
||||||
|
|
||||||
"github.com/fsnotify/fsnotify/internal"
|
|
||||||
"golang.org/x/sys/windows"
|
|
||||||
)
|
|
||||||
|
|
||||||
type readDirChangesW struct {
|
|
||||||
Events chan Event
|
|
||||||
Errors chan error
|
|
||||||
|
|
||||||
port windows.Handle // Handle to completion port
|
|
||||||
input chan *input // Inputs to the reader are sent on this channel
|
|
||||||
done chan chan<- error
|
|
||||||
|
|
||||||
mu sync.Mutex // Protects access to watches, closed
|
|
||||||
watches watchMap // Map of watches (key: i-number)
|
|
||||||
closed bool // Set to true when Close() is first called
|
|
||||||
}
|
|
||||||
|
|
||||||
var defaultBufferSize = 50
|
|
||||||
|
|
||||||
func newBackend(ev chan Event, errs chan error) (backend, error) {
|
|
||||||
port, err := windows.CreateIoCompletionPort(windows.InvalidHandle, 0, 0, 0)
|
|
||||||
if err != nil {
|
|
||||||
return nil, os.NewSyscallError("CreateIoCompletionPort", err)
|
|
||||||
}
|
|
||||||
w := &readDirChangesW{
|
|
||||||
Events: ev,
|
|
||||||
Errors: errs,
|
|
||||||
port: port,
|
|
||||||
watches: make(watchMap),
|
|
||||||
input: make(chan *input, 1),
|
|
||||||
done: make(chan chan<- error, 1),
|
|
||||||
}
|
|
||||||
go w.readEvents()
|
|
||||||
return w, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *readDirChangesW) isClosed() bool {
|
|
||||||
w.mu.Lock()
|
|
||||||
defer w.mu.Unlock()
|
|
||||||
return w.closed
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *readDirChangesW) sendEvent(name, renamedFrom string, mask uint64) bool {
|
|
||||||
if mask == 0 {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
|
|
||||||
event := w.newEvent(name, uint32(mask))
|
|
||||||
event.renamedFrom = renamedFrom
|
|
||||||
select {
|
|
||||||
case ch := <-w.done:
|
|
||||||
w.done <- ch
|
|
||||||
case w.Events <- event:
|
|
||||||
}
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
|
|
||||||
// Returns true if the error was sent, or false if watcher is closed.
|
|
||||||
func (w *readDirChangesW) sendError(err error) bool {
|
|
||||||
if err == nil {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
select {
|
|
||||||
case <-w.done:
|
|
||||||
return false
|
|
||||||
case w.Errors <- err:
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *readDirChangesW) Close() error {
|
|
||||||
if w.isClosed() {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
w.mu.Lock()
|
|
||||||
w.closed = true
|
|
||||||
w.mu.Unlock()
|
|
||||||
|
|
||||||
// Send "done" message to the reader goroutine
|
|
||||||
ch := make(chan error)
|
|
||||||
w.done <- ch
|
|
||||||
if err := w.wakeupReader(); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
return <-ch
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *readDirChangesW) Add(name string) error { return w.AddWith(name) }
|
|
||||||
|
|
||||||
func (w *readDirChangesW) AddWith(name string, opts ...addOpt) error {
|
|
||||||
if w.isClosed() {
|
|
||||||
return ErrClosed
|
|
||||||
}
|
|
||||||
if debug {
|
|
||||||
fmt.Fprintf(os.Stderr, "FSNOTIFY_DEBUG: %s AddWith(%q)\n",
|
|
||||||
time.Now().Format("15:04:05.000000000"), filepath.ToSlash(name))
|
|
||||||
}
|
|
||||||
|
|
||||||
with := getOptions(opts...)
|
|
||||||
if !w.xSupports(with.op) {
|
|
||||||
return fmt.Errorf("%w: %s", xErrUnsupported, with.op)
|
|
||||||
}
|
|
||||||
if with.bufsize < 4096 {
|
|
||||||
return fmt.Errorf("fsnotify.WithBufferSize: buffer size cannot be smaller than 4096 bytes")
|
|
||||||
}
|
|
||||||
|
|
||||||
in := &input{
|
|
||||||
op: opAddWatch,
|
|
||||||
path: filepath.Clean(name),
|
|
||||||
flags: sysFSALLEVENTS,
|
|
||||||
reply: make(chan error),
|
|
||||||
bufsize: with.bufsize,
|
|
||||||
}
|
|
||||||
w.input <- in
|
|
||||||
if err := w.wakeupReader(); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
return <-in.reply
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *readDirChangesW) Remove(name string) error {
|
|
||||||
if w.isClosed() {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
if debug {
|
|
||||||
fmt.Fprintf(os.Stderr, "FSNOTIFY_DEBUG: %s Remove(%q)\n",
|
|
||||||
time.Now().Format("15:04:05.000000000"), filepath.ToSlash(name))
|
|
||||||
}
|
|
||||||
|
|
||||||
in := &input{
|
|
||||||
op: opRemoveWatch,
|
|
||||||
path: filepath.Clean(name),
|
|
||||||
reply: make(chan error),
|
|
||||||
}
|
|
||||||
w.input <- in
|
|
||||||
if err := w.wakeupReader(); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
return <-in.reply
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *readDirChangesW) WatchList() []string {
|
|
||||||
if w.isClosed() {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
w.mu.Lock()
|
|
||||||
defer w.mu.Unlock()
|
|
||||||
|
|
||||||
entries := make([]string, 0, len(w.watches))
|
|
||||||
for _, entry := range w.watches {
|
|
||||||
for _, watchEntry := range entry {
|
|
||||||
for name := range watchEntry.names {
|
|
||||||
entries = append(entries, filepath.Join(watchEntry.path, name))
|
|
||||||
}
|
|
||||||
// the directory itself is being watched
|
|
||||||
if watchEntry.mask != 0 {
|
|
||||||
entries = append(entries, watchEntry.path)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return entries
|
|
||||||
}
|
|
||||||
|
|
||||||
// These options are from the old golang.org/x/exp/winfsnotify, where you could
|
|
||||||
// add various options to the watch. This has long since been removed.
|
|
||||||
//
|
|
||||||
// The "sys" in the name is misleading as they're not part of any "system".
|
|
||||||
//
|
|
||||||
// This should all be removed at some point, and just use windows.FILE_NOTIFY_*
|
|
||||||
const (
|
|
||||||
sysFSALLEVENTS = 0xfff
|
|
||||||
sysFSCREATE = 0x100
|
|
||||||
sysFSDELETE = 0x200
|
|
||||||
sysFSDELETESELF = 0x400
|
|
||||||
sysFSMODIFY = 0x2
|
|
||||||
sysFSMOVE = 0xc0
|
|
||||||
sysFSMOVEDFROM = 0x40
|
|
||||||
sysFSMOVEDTO = 0x80
|
|
||||||
sysFSMOVESELF = 0x800
|
|
||||||
sysFSIGNORED = 0x8000
|
|
||||||
)
|
|
||||||
|
|
||||||
func (w *readDirChangesW) newEvent(name string, mask uint32) Event {
|
|
||||||
e := Event{Name: name}
|
|
||||||
if mask&sysFSCREATE == sysFSCREATE || mask&sysFSMOVEDTO == sysFSMOVEDTO {
|
|
||||||
e.Op |= Create
|
|
||||||
}
|
|
||||||
if mask&sysFSDELETE == sysFSDELETE || mask&sysFSDELETESELF == sysFSDELETESELF {
|
|
||||||
e.Op |= Remove
|
|
||||||
}
|
|
||||||
if mask&sysFSMODIFY == sysFSMODIFY {
|
|
||||||
e.Op |= Write
|
|
||||||
}
|
|
||||||
if mask&sysFSMOVE == sysFSMOVE || mask&sysFSMOVESELF == sysFSMOVESELF || mask&sysFSMOVEDFROM == sysFSMOVEDFROM {
|
|
||||||
e.Op |= Rename
|
|
||||||
}
|
|
||||||
return e
|
|
||||||
}
|
|
||||||
|
|
||||||
const (
|
|
||||||
opAddWatch = iota
|
|
||||||
opRemoveWatch
|
|
||||||
)
|
|
||||||
|
|
||||||
const (
|
|
||||||
provisional uint64 = 1 << (32 + iota)
|
|
||||||
)
|
|
||||||
|
|
||||||
type input struct {
|
|
||||||
op int
|
|
||||||
path string
|
|
||||||
flags uint32
|
|
||||||
bufsize int
|
|
||||||
reply chan error
|
|
||||||
}
|
|
||||||
|
|
||||||
type inode struct {
|
|
||||||
handle windows.Handle
|
|
||||||
volume uint32
|
|
||||||
index uint64
|
|
||||||
}
|
|
||||||
|
|
||||||
type watch struct {
|
|
||||||
ov windows.Overlapped
|
|
||||||
ino *inode // i-number
|
|
||||||
recurse bool // Recursive watch?
|
|
||||||
path string // Directory path
|
|
||||||
mask uint64 // Directory itself is being watched with these notify flags
|
|
||||||
names map[string]uint64 // Map of names being watched and their notify flags
|
|
||||||
rename string // Remembers the old name while renaming a file
|
|
||||||
buf []byte // buffer, allocated later
|
|
||||||
}
|
|
||||||
|
|
||||||
type (
|
|
||||||
indexMap map[uint64]*watch
|
|
||||||
watchMap map[uint32]indexMap
|
|
||||||
)
|
|
||||||
|
|
||||||
func (w *readDirChangesW) wakeupReader() error {
|
|
||||||
err := windows.PostQueuedCompletionStatus(w.port, 0, 0, nil)
|
|
||||||
if err != nil {
|
|
||||||
return os.NewSyscallError("PostQueuedCompletionStatus", err)
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *readDirChangesW) getDir(pathname string) (dir string, err error) {
|
|
||||||
attr, err := windows.GetFileAttributes(windows.StringToUTF16Ptr(pathname))
|
|
||||||
if err != nil {
|
|
||||||
return "", os.NewSyscallError("GetFileAttributes", err)
|
|
||||||
}
|
|
||||||
if attr&windows.FILE_ATTRIBUTE_DIRECTORY != 0 {
|
|
||||||
dir = pathname
|
|
||||||
} else {
|
|
||||||
dir, _ = filepath.Split(pathname)
|
|
||||||
dir = filepath.Clean(dir)
|
|
||||||
}
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *readDirChangesW) getIno(path string) (ino *inode, err error) {
|
|
||||||
h, err := windows.CreateFile(windows.StringToUTF16Ptr(path),
|
|
||||||
windows.FILE_LIST_DIRECTORY,
|
|
||||||
windows.FILE_SHARE_READ|windows.FILE_SHARE_WRITE|windows.FILE_SHARE_DELETE,
|
|
||||||
nil, windows.OPEN_EXISTING,
|
|
||||||
windows.FILE_FLAG_BACKUP_SEMANTICS|windows.FILE_FLAG_OVERLAPPED, 0)
|
|
||||||
if err != nil {
|
|
||||||
return nil, os.NewSyscallError("CreateFile", err)
|
|
||||||
}
|
|
||||||
|
|
||||||
var fi windows.ByHandleFileInformation
|
|
||||||
err = windows.GetFileInformationByHandle(h, &fi)
|
|
||||||
if err != nil {
|
|
||||||
windows.CloseHandle(h)
|
|
||||||
return nil, os.NewSyscallError("GetFileInformationByHandle", err)
|
|
||||||
}
|
|
||||||
ino = &inode{
|
|
||||||
handle: h,
|
|
||||||
volume: fi.VolumeSerialNumber,
|
|
||||||
index: uint64(fi.FileIndexHigh)<<32 | uint64(fi.FileIndexLow),
|
|
||||||
}
|
|
||||||
return ino, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// Must run within the I/O thread.
|
|
||||||
func (m watchMap) get(ino *inode) *watch {
|
|
||||||
if i := m[ino.volume]; i != nil {
|
|
||||||
return i[ino.index]
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// Must run within the I/O thread.
|
|
||||||
func (m watchMap) set(ino *inode, watch *watch) {
|
|
||||||
i := m[ino.volume]
|
|
||||||
if i == nil {
|
|
||||||
i = make(indexMap)
|
|
||||||
m[ino.volume] = i
|
|
||||||
}
|
|
||||||
i[ino.index] = watch
|
|
||||||
}
|
|
||||||
|
|
||||||
// Must run within the I/O thread.
|
|
||||||
func (w *readDirChangesW) addWatch(pathname string, flags uint64, bufsize int) error {
|
|
||||||
pathname, recurse := recursivePath(pathname)
|
|
||||||
|
|
||||||
dir, err := w.getDir(pathname)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
ino, err := w.getIno(dir)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
w.mu.Lock()
|
|
||||||
watchEntry := w.watches.get(ino)
|
|
||||||
w.mu.Unlock()
|
|
||||||
if watchEntry == nil {
|
|
||||||
_, err := windows.CreateIoCompletionPort(ino.handle, w.port, 0, 0)
|
|
||||||
if err != nil {
|
|
||||||
windows.CloseHandle(ino.handle)
|
|
||||||
return os.NewSyscallError("CreateIoCompletionPort", err)
|
|
||||||
}
|
|
||||||
watchEntry = &watch{
|
|
||||||
ino: ino,
|
|
||||||
path: dir,
|
|
||||||
names: make(map[string]uint64),
|
|
||||||
recurse: recurse,
|
|
||||||
buf: make([]byte, bufsize),
|
|
||||||
}
|
|
||||||
w.mu.Lock()
|
|
||||||
w.watches.set(ino, watchEntry)
|
|
||||||
w.mu.Unlock()
|
|
||||||
flags |= provisional
|
|
||||||
} else {
|
|
||||||
windows.CloseHandle(ino.handle)
|
|
||||||
}
|
|
||||||
if pathname == dir {
|
|
||||||
watchEntry.mask |= flags
|
|
||||||
} else {
|
|
||||||
watchEntry.names[filepath.Base(pathname)] |= flags
|
|
||||||
}
|
|
||||||
|
|
||||||
err = w.startRead(watchEntry)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
if pathname == dir {
|
|
||||||
watchEntry.mask &= ^provisional
|
|
||||||
} else {
|
|
||||||
watchEntry.names[filepath.Base(pathname)] &= ^provisional
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// Must run within the I/O thread.
|
|
||||||
func (w *readDirChangesW) remWatch(pathname string) error {
|
|
||||||
pathname, recurse := recursivePath(pathname)
|
|
||||||
|
|
||||||
dir, err := w.getDir(pathname)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
ino, err := w.getIno(dir)
|
|
||||||
if err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
|
|
||||||
w.mu.Lock()
|
|
||||||
watch := w.watches.get(ino)
|
|
||||||
w.mu.Unlock()
|
|
||||||
|
|
||||||
if recurse && !watch.recurse {
|
|
||||||
return fmt.Errorf("can't use \\... with non-recursive watch %q", pathname)
|
|
||||||
}
|
|
||||||
|
|
||||||
err = windows.CloseHandle(ino.handle)
|
|
||||||
if err != nil {
|
|
||||||
w.sendError(os.NewSyscallError("CloseHandle", err))
|
|
||||||
}
|
|
||||||
if watch == nil {
|
|
||||||
return fmt.Errorf("%w: %s", ErrNonExistentWatch, pathname)
|
|
||||||
}
|
|
||||||
if pathname == dir {
|
|
||||||
w.sendEvent(watch.path, "", watch.mask&sysFSIGNORED)
|
|
||||||
watch.mask = 0
|
|
||||||
} else {
|
|
||||||
name := filepath.Base(pathname)
|
|
||||||
w.sendEvent(filepath.Join(watch.path, name), "", watch.names[name]&sysFSIGNORED)
|
|
||||||
delete(watch.names, name)
|
|
||||||
}
|
|
||||||
|
|
||||||
return w.startRead(watch)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Must run within the I/O thread.
|
|
||||||
func (w *readDirChangesW) deleteWatch(watch *watch) {
|
|
||||||
for name, mask := range watch.names {
|
|
||||||
if mask&provisional == 0 {
|
|
||||||
w.sendEvent(filepath.Join(watch.path, name), "", mask&sysFSIGNORED)
|
|
||||||
}
|
|
||||||
delete(watch.names, name)
|
|
||||||
}
|
|
||||||
if watch.mask != 0 {
|
|
||||||
if watch.mask&provisional == 0 {
|
|
||||||
w.sendEvent(watch.path, "", watch.mask&sysFSIGNORED)
|
|
||||||
}
|
|
||||||
watch.mask = 0
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Must run within the I/O thread.
|
|
||||||
func (w *readDirChangesW) startRead(watch *watch) error {
|
|
||||||
err := windows.CancelIo(watch.ino.handle)
|
|
||||||
if err != nil {
|
|
||||||
w.sendError(os.NewSyscallError("CancelIo", err))
|
|
||||||
w.deleteWatch(watch)
|
|
||||||
}
|
|
||||||
mask := w.toWindowsFlags(watch.mask)
|
|
||||||
for _, m := range watch.names {
|
|
||||||
mask |= w.toWindowsFlags(m)
|
|
||||||
}
|
|
||||||
if mask == 0 {
|
|
||||||
err := windows.CloseHandle(watch.ino.handle)
|
|
||||||
if err != nil {
|
|
||||||
w.sendError(os.NewSyscallError("CloseHandle", err))
|
|
||||||
}
|
|
||||||
w.mu.Lock()
|
|
||||||
delete(w.watches[watch.ino.volume], watch.ino.index)
|
|
||||||
w.mu.Unlock()
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// We need to pass the array, rather than the slice.
|
|
||||||
hdr := (*reflect.SliceHeader)(unsafe.Pointer(&watch.buf))
|
|
||||||
rdErr := windows.ReadDirectoryChanges(watch.ino.handle,
|
|
||||||
(*byte)(unsafe.Pointer(hdr.Data)), uint32(hdr.Len),
|
|
||||||
watch.recurse, mask, nil, &watch.ov, 0)
|
|
||||||
if rdErr != nil {
|
|
||||||
err := os.NewSyscallError("ReadDirectoryChanges", rdErr)
|
|
||||||
if rdErr == windows.ERROR_ACCESS_DENIED && watch.mask&provisional == 0 {
|
|
||||||
// Watched directory was probably removed
|
|
||||||
w.sendEvent(watch.path, "", watch.mask&sysFSDELETESELF)
|
|
||||||
err = nil
|
|
||||||
}
|
|
||||||
w.deleteWatch(watch)
|
|
||||||
w.startRead(watch)
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// readEvents reads from the I/O completion port, converts the
|
|
||||||
// received events into Event objects and sends them via the Events channel.
|
|
||||||
// Entry point to the I/O thread.
|
|
||||||
func (w *readDirChangesW) readEvents() {
|
|
||||||
var (
|
|
||||||
n uint32
|
|
||||||
key uintptr
|
|
||||||
ov *windows.Overlapped
|
|
||||||
)
|
|
||||||
runtime.LockOSThread()
|
|
||||||
|
|
||||||
for {
|
|
||||||
// This error is handled after the watch == nil check below.
|
|
||||||
qErr := windows.GetQueuedCompletionStatus(w.port, &n, &key, &ov, windows.INFINITE)
|
|
||||||
|
|
||||||
watch := (*watch)(unsafe.Pointer(ov))
|
|
||||||
if watch == nil {
|
|
||||||
select {
|
|
||||||
case ch := <-w.done:
|
|
||||||
w.mu.Lock()
|
|
||||||
var indexes []indexMap
|
|
||||||
for _, index := range w.watches {
|
|
||||||
indexes = append(indexes, index)
|
|
||||||
}
|
|
||||||
w.mu.Unlock()
|
|
||||||
for _, index := range indexes {
|
|
||||||
for _, watch := range index {
|
|
||||||
w.deleteWatch(watch)
|
|
||||||
w.startRead(watch)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
err := windows.CloseHandle(w.port)
|
|
||||||
if err != nil {
|
|
||||||
err = os.NewSyscallError("CloseHandle", err)
|
|
||||||
}
|
|
||||||
close(w.Events)
|
|
||||||
close(w.Errors)
|
|
||||||
ch <- err
|
|
||||||
return
|
|
||||||
case in := <-w.input:
|
|
||||||
switch in.op {
|
|
||||||
case opAddWatch:
|
|
||||||
in.reply <- w.addWatch(in.path, uint64(in.flags), in.bufsize)
|
|
||||||
case opRemoveWatch:
|
|
||||||
in.reply <- w.remWatch(in.path)
|
|
||||||
}
|
|
||||||
default:
|
|
||||||
}
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
|
|
||||||
switch qErr {
|
|
||||||
case nil:
|
|
||||||
// No error
|
|
||||||
case windows.ERROR_MORE_DATA:
|
|
||||||
if watch == nil {
|
|
||||||
w.sendError(errors.New("ERROR_MORE_DATA has unexpectedly null lpOverlapped buffer"))
|
|
||||||
} else {
|
|
||||||
// The i/o succeeded but the buffer is full.
|
|
||||||
// In theory we should be building up a full packet.
|
|
||||||
// In practice we can get away with just carrying on.
|
|
||||||
n = uint32(unsafe.Sizeof(watch.buf))
|
|
||||||
}
|
|
||||||
case windows.ERROR_ACCESS_DENIED:
|
|
||||||
// Watched directory was probably removed
|
|
||||||
w.sendEvent(watch.path, "", watch.mask&sysFSDELETESELF)
|
|
||||||
w.deleteWatch(watch)
|
|
||||||
w.startRead(watch)
|
|
||||||
continue
|
|
||||||
case windows.ERROR_OPERATION_ABORTED:
|
|
||||||
// CancelIo was called on this handle
|
|
||||||
continue
|
|
||||||
default:
|
|
||||||
w.sendError(os.NewSyscallError("GetQueuedCompletionPort", qErr))
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
|
|
||||||
var offset uint32
|
|
||||||
for {
|
|
||||||
if n == 0 {
|
|
||||||
w.sendError(ErrEventOverflow)
|
|
||||||
break
|
|
||||||
}
|
|
||||||
|
|
||||||
// Point "raw" to the event in the buffer
|
|
||||||
raw := (*windows.FileNotifyInformation)(unsafe.Pointer(&watch.buf[offset]))
|
|
||||||
|
|
||||||
// Create a buf that is the size of the path name
|
|
||||||
size := int(raw.FileNameLength / 2)
|
|
||||||
var buf []uint16
|
|
||||||
// TODO: Use unsafe.Slice in Go 1.17; https://stackoverflow.com/questions/51187973
|
|
||||||
sh := (*reflect.SliceHeader)(unsafe.Pointer(&buf))
|
|
||||||
sh.Data = uintptr(unsafe.Pointer(&raw.FileName))
|
|
||||||
sh.Len = size
|
|
||||||
sh.Cap = size
|
|
||||||
name := windows.UTF16ToString(buf)
|
|
||||||
fullname := filepath.Join(watch.path, name)
|
|
||||||
|
|
||||||
if debug {
|
|
||||||
internal.Debug(fullname, raw.Action)
|
|
||||||
}
|
|
||||||
|
|
||||||
var mask uint64
|
|
||||||
switch raw.Action {
|
|
||||||
case windows.FILE_ACTION_REMOVED:
|
|
||||||
mask = sysFSDELETESELF
|
|
||||||
case windows.FILE_ACTION_MODIFIED:
|
|
||||||
mask = sysFSMODIFY
|
|
||||||
case windows.FILE_ACTION_RENAMED_OLD_NAME:
|
|
||||||
watch.rename = name
|
|
||||||
case windows.FILE_ACTION_RENAMED_NEW_NAME:
|
|
||||||
// Update saved path of all sub-watches.
|
|
||||||
old := filepath.Join(watch.path, watch.rename)
|
|
||||||
w.mu.Lock()
|
|
||||||
for _, watchMap := range w.watches {
|
|
||||||
for _, ww := range watchMap {
|
|
||||||
if strings.HasPrefix(ww.path, old) {
|
|
||||||
ww.path = filepath.Join(fullname, strings.TrimPrefix(ww.path, old))
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
w.mu.Unlock()
|
|
||||||
|
|
||||||
if watch.names[watch.rename] != 0 {
|
|
||||||
watch.names[name] |= watch.names[watch.rename]
|
|
||||||
delete(watch.names, watch.rename)
|
|
||||||
mask = sysFSMOVESELF
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if raw.Action != windows.FILE_ACTION_RENAMED_NEW_NAME {
|
|
||||||
w.sendEvent(fullname, "", watch.names[name]&mask)
|
|
||||||
}
|
|
||||||
if raw.Action == windows.FILE_ACTION_REMOVED {
|
|
||||||
w.sendEvent(fullname, "", watch.names[name]&sysFSIGNORED)
|
|
||||||
delete(watch.names, name)
|
|
||||||
}
|
|
||||||
|
|
||||||
if watch.rename != "" && raw.Action == windows.FILE_ACTION_RENAMED_NEW_NAME {
|
|
||||||
w.sendEvent(fullname, filepath.Join(watch.path, watch.rename), watch.mask&w.toFSnotifyFlags(raw.Action))
|
|
||||||
} else {
|
|
||||||
w.sendEvent(fullname, "", watch.mask&w.toFSnotifyFlags(raw.Action))
|
|
||||||
}
|
|
||||||
|
|
||||||
if raw.Action == windows.FILE_ACTION_RENAMED_NEW_NAME {
|
|
||||||
w.sendEvent(filepath.Join(watch.path, watch.rename), "", watch.names[name]&mask)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Move to the next event in the buffer
|
|
||||||
if raw.NextEntryOffset == 0 {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
offset += raw.NextEntryOffset
|
|
||||||
|
|
||||||
// Error!
|
|
||||||
if offset >= n {
|
|
||||||
//lint:ignore ST1005 Windows should be capitalized
|
|
||||||
w.sendError(errors.New("Windows system assumed buffer larger than it is, events have likely been missed"))
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
if err := w.startRead(watch); err != nil {
|
|
||||||
w.sendError(err)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *readDirChangesW) toWindowsFlags(mask uint64) uint32 {
|
|
||||||
var m uint32
|
|
||||||
if mask&sysFSMODIFY != 0 {
|
|
||||||
m |= windows.FILE_NOTIFY_CHANGE_LAST_WRITE
|
|
||||||
}
|
|
||||||
if mask&(sysFSMOVE|sysFSCREATE|sysFSDELETE) != 0 {
|
|
||||||
m |= windows.FILE_NOTIFY_CHANGE_FILE_NAME | windows.FILE_NOTIFY_CHANGE_DIR_NAME
|
|
||||||
}
|
|
||||||
return m
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *readDirChangesW) toFSnotifyFlags(action uint32) uint64 {
|
|
||||||
switch action {
|
|
||||||
case windows.FILE_ACTION_ADDED:
|
|
||||||
return sysFSCREATE
|
|
||||||
case windows.FILE_ACTION_REMOVED:
|
|
||||||
return sysFSDELETE
|
|
||||||
case windows.FILE_ACTION_MODIFIED:
|
|
||||||
return sysFSMODIFY
|
|
||||||
case windows.FILE_ACTION_RENAMED_OLD_NAME:
|
|
||||||
return sysFSMOVEDFROM
|
|
||||||
case windows.FILE_ACTION_RENAMED_NEW_NAME:
|
|
||||||
return sysFSMOVEDTO
|
|
||||||
}
|
|
||||||
return 0
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *readDirChangesW) xSupports(op Op) bool {
|
|
||||||
if op.Has(xUnportableOpen) || op.Has(xUnportableRead) ||
|
|
||||||
op.Has(xUnportableCloseWrite) || op.Has(xUnportableCloseRead) {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
496
vendor/github.com/fsnotify/fsnotify/fsnotify.go
generated
vendored
496
vendor/github.com/fsnotify/fsnotify/fsnotify.go
generated
vendored
@@ -1,496 +0,0 @@
|
|||||||
// Package fsnotify provides a cross-platform interface for file system
|
|
||||||
// notifications.
|
|
||||||
//
|
|
||||||
// Currently supported systems:
|
|
||||||
//
|
|
||||||
// - Linux via inotify
|
|
||||||
// - BSD, macOS via kqueue
|
|
||||||
// - Windows via ReadDirectoryChangesW
|
|
||||||
// - illumos via FEN
|
|
||||||
//
|
|
||||||
// # FSNOTIFY_DEBUG
|
|
||||||
//
|
|
||||||
// Set the FSNOTIFY_DEBUG environment variable to "1" to print debug messages to
|
|
||||||
// stderr. This can be useful to track down some problems, especially in cases
|
|
||||||
// where fsnotify is used as an indirect dependency.
|
|
||||||
//
|
|
||||||
// Every event will be printed as soon as there's something useful to print,
|
|
||||||
// with as little processing from fsnotify.
|
|
||||||
//
|
|
||||||
// Example output:
|
|
||||||
//
|
|
||||||
// FSNOTIFY_DEBUG: 11:34:23.633087586 256:IN_CREATE → "/tmp/file-1"
|
|
||||||
// FSNOTIFY_DEBUG: 11:34:23.633202319 4:IN_ATTRIB → "/tmp/file-1"
|
|
||||||
// FSNOTIFY_DEBUG: 11:34:28.989728764 512:IN_DELETE → "/tmp/file-1"
|
|
||||||
package fsnotify
|
|
||||||
|
|
||||||
import (
|
|
||||||
"errors"
|
|
||||||
"fmt"
|
|
||||||
"os"
|
|
||||||
"path/filepath"
|
|
||||||
"strings"
|
|
||||||
)
|
|
||||||
|
|
||||||
// Watcher watches a set of paths, delivering events on a channel.
|
|
||||||
//
|
|
||||||
// A watcher should not be copied (e.g. pass it by pointer, rather than by
|
|
||||||
// value).
|
|
||||||
//
|
|
||||||
// # Linux notes
|
|
||||||
//
|
|
||||||
// When a file is removed a Remove event won't be emitted until all file
|
|
||||||
// descriptors are closed, and deletes will always emit a Chmod. For example:
|
|
||||||
//
|
|
||||||
// fp := os.Open("file")
|
|
||||||
// os.Remove("file") // Triggers Chmod
|
|
||||||
// fp.Close() // Triggers Remove
|
|
||||||
//
|
|
||||||
// This is the event that inotify sends, so not much can be changed about this.
|
|
||||||
//
|
|
||||||
// The fs.inotify.max_user_watches sysctl variable specifies the upper limit
|
|
||||||
// for the number of watches per user, and fs.inotify.max_user_instances
|
|
||||||
// specifies the maximum number of inotify instances per user. Every Watcher you
|
|
||||||
// create is an "instance", and every path you add is a "watch".
|
|
||||||
//
|
|
||||||
// These are also exposed in /proc as /proc/sys/fs/inotify/max_user_watches and
|
|
||||||
// /proc/sys/fs/inotify/max_user_instances
|
|
||||||
//
|
|
||||||
// To increase them you can use sysctl or write the value to the /proc file:
|
|
||||||
//
|
|
||||||
// # Default values on Linux 5.18
|
|
||||||
// sysctl fs.inotify.max_user_watches=124983
|
|
||||||
// sysctl fs.inotify.max_user_instances=128
|
|
||||||
//
|
|
||||||
// To make the changes persist on reboot edit /etc/sysctl.conf or
|
|
||||||
// /usr/lib/sysctl.d/50-default.conf (details differ per Linux distro; check
|
|
||||||
// your distro's documentation):
|
|
||||||
//
|
|
||||||
// fs.inotify.max_user_watches=124983
|
|
||||||
// fs.inotify.max_user_instances=128
|
|
||||||
//
|
|
||||||
// Reaching the limit will result in a "no space left on device" or "too many open
|
|
||||||
// files" error.
|
|
||||||
//
|
|
||||||
// # kqueue notes (macOS, BSD)
|
|
||||||
//
|
|
||||||
// kqueue requires opening a file descriptor for every file that's being watched;
|
|
||||||
// so if you're watching a directory with five files then that's six file
|
|
||||||
// descriptors. You will run in to your system's "max open files" limit faster on
|
|
||||||
// these platforms.
|
|
||||||
//
|
|
||||||
// The sysctl variables kern.maxfiles and kern.maxfilesperproc can be used to
|
|
||||||
// control the maximum number of open files, as well as /etc/login.conf on BSD
|
|
||||||
// systems.
|
|
||||||
//
|
|
||||||
// # Windows notes
|
|
||||||
//
|
|
||||||
// Paths can be added as "C:\\path\\to\\dir", but forward slashes
|
|
||||||
// ("C:/path/to/dir") will also work.
|
|
||||||
//
|
|
||||||
// When a watched directory is removed it will always send an event for the
|
|
||||||
// directory itself, but may not send events for all files in that directory.
|
|
||||||
// Sometimes it will send events for all files, sometimes it will send no
|
|
||||||
// events, and often only for some files.
|
|
||||||
//
|
|
||||||
// The default ReadDirectoryChangesW() buffer size is 64K, which is the largest
|
|
||||||
// value that is guaranteed to work with SMB filesystems. If you have many
|
|
||||||
// events in quick succession this may not be enough, and you will have to use
|
|
||||||
// [WithBufferSize] to increase the value.
|
|
||||||
type Watcher struct {
|
|
||||||
b backend
|
|
||||||
|
|
||||||
// Events sends the filesystem change events.
|
|
||||||
//
|
|
||||||
// fsnotify can send the following events; a "path" here can refer to a
|
|
||||||
// file, directory, symbolic link, or special file like a FIFO.
|
|
||||||
//
|
|
||||||
// fsnotify.Create A new path was created; this may be followed by one
|
|
||||||
// or more Write events if data also gets written to a
|
|
||||||
// file.
|
|
||||||
//
|
|
||||||
// fsnotify.Remove A path was removed.
|
|
||||||
//
|
|
||||||
// fsnotify.Rename A path was renamed. A rename is always sent with the
|
|
||||||
// old path as Event.Name, and a Create event will be
|
|
||||||
// sent with the new name. Renames are only sent for
|
|
||||||
// paths that are currently watched; e.g. moving an
|
|
||||||
// unmonitored file into a monitored directory will
|
|
||||||
// show up as just a Create. Similarly, renaming a file
|
|
||||||
// to outside a monitored directory will show up as
|
|
||||||
// only a Rename.
|
|
||||||
//
|
|
||||||
// fsnotify.Write A file or named pipe was written to. A Truncate will
|
|
||||||
// also trigger a Write. A single "write action"
|
|
||||||
// initiated by the user may show up as one or multiple
|
|
||||||
// writes, depending on when the system syncs things to
|
|
||||||
// disk. For example when compiling a large Go program
|
|
||||||
// you may get hundreds of Write events, and you may
|
|
||||||
// want to wait until you've stopped receiving them
|
|
||||||
// (see the dedup example in cmd/fsnotify).
|
|
||||||
//
|
|
||||||
// Some systems may send Write event for directories
|
|
||||||
// when the directory content changes.
|
|
||||||
//
|
|
||||||
// fsnotify.Chmod Attributes were changed. On Linux this is also sent
|
|
||||||
// when a file is removed (or more accurately, when a
|
|
||||||
// link to an inode is removed). On kqueue it's sent
|
|
||||||
// when a file is truncated. On Windows it's never
|
|
||||||
// sent.
|
|
||||||
Events chan Event
|
|
||||||
|
|
||||||
// Errors sends any errors.
|
|
||||||
Errors chan error
|
|
||||||
}
|
|
||||||
|
|
||||||
// Event represents a file system notification.
|
|
||||||
type Event struct {
|
|
||||||
// Path to the file or directory.
|
|
||||||
//
|
|
||||||
// Paths are relative to the input; for example with Add("dir") the Name
|
|
||||||
// will be set to "dir/file" if you create that file, but if you use
|
|
||||||
// Add("/path/to/dir") it will be "/path/to/dir/file".
|
|
||||||
Name string
|
|
||||||
|
|
||||||
// File operation that triggered the event.
|
|
||||||
//
|
|
||||||
// This is a bitmask and some systems may send multiple operations at once.
|
|
||||||
// Use the Event.Has() method instead of comparing with ==.
|
|
||||||
Op Op
|
|
||||||
|
|
||||||
// Create events will have this set to the old path if it's a rename. This
|
|
||||||
// only works when both the source and destination are watched. It's not
|
|
||||||
// reliable when watching individual files, only directories.
|
|
||||||
//
|
|
||||||
// For example "mv /tmp/file /tmp/rename" will emit:
|
|
||||||
//
|
|
||||||
// Event{Op: Rename, Name: "/tmp/file"}
|
|
||||||
// Event{Op: Create, Name: "/tmp/rename", RenamedFrom: "/tmp/file"}
|
|
||||||
renamedFrom string
|
|
||||||
}
|
|
||||||
|
|
||||||
// Op describes a set of file operations.
|
|
||||||
type Op uint32
|
|
||||||
|
|
||||||
// The operations fsnotify can trigger; see the documentation on [Watcher] for a
|
|
||||||
// full description, and check them with [Event.Has].
|
|
||||||
const (
|
|
||||||
// A new pathname was created.
|
|
||||||
Create Op = 1 << iota
|
|
||||||
|
|
||||||
// The pathname was written to; this does *not* mean the write has finished,
|
|
||||||
// and a write can be followed by more writes.
|
|
||||||
Write
|
|
||||||
|
|
||||||
// The path was removed; any watches on it will be removed. Some "remove"
|
|
||||||
// operations may trigger a Rename if the file is actually moved (for
|
|
||||||
// example "remove to trash" is often a rename).
|
|
||||||
Remove
|
|
||||||
|
|
||||||
// The path was renamed to something else; any watches on it will be
|
|
||||||
// removed.
|
|
||||||
Rename
|
|
||||||
|
|
||||||
// File attributes were changed.
|
|
||||||
//
|
|
||||||
// It's generally not recommended to take action on this event, as it may
|
|
||||||
// get triggered very frequently by some software. For example, Spotlight
|
|
||||||
// indexing on macOS, anti-virus software, backup software, etc.
|
|
||||||
Chmod
|
|
||||||
|
|
||||||
// File descriptor was opened.
|
|
||||||
//
|
|
||||||
// Only works on Linux and FreeBSD.
|
|
||||||
xUnportableOpen
|
|
||||||
|
|
||||||
// File was read from.
|
|
||||||
//
|
|
||||||
// Only works on Linux and FreeBSD.
|
|
||||||
xUnportableRead
|
|
||||||
|
|
||||||
// File opened for writing was closed.
|
|
||||||
//
|
|
||||||
// Only works on Linux and FreeBSD.
|
|
||||||
//
|
|
||||||
// The advantage of using this over Write is that it's more reliable than
|
|
||||||
// waiting for Write events to stop. It's also faster (if you're not
|
|
||||||
// listening to Write events): copying a file of a few GB can easily
|
|
||||||
// generate tens of thousands of Write events in a short span of time.
|
|
||||||
xUnportableCloseWrite
|
|
||||||
|
|
||||||
// File opened for reading was closed.
|
|
||||||
//
|
|
||||||
// Only works on Linux and FreeBSD.
|
|
||||||
xUnportableCloseRead
|
|
||||||
)
|
|
||||||
|
|
||||||
var (
|
|
||||||
// ErrNonExistentWatch is used when Remove() is called on a path that's not
|
|
||||||
// added.
|
|
||||||
ErrNonExistentWatch = errors.New("fsnotify: can't remove non-existent watch")
|
|
||||||
|
|
||||||
// ErrClosed is used when trying to operate on a closed Watcher.
|
|
||||||
ErrClosed = errors.New("fsnotify: watcher already closed")
|
|
||||||
|
|
||||||
// ErrEventOverflow is reported from the Errors channel when there are too
|
|
||||||
// many events:
|
|
||||||
//
|
|
||||||
// - inotify: inotify returns IN_Q_OVERFLOW – because there are too
|
|
||||||
// many queued events (the fs.inotify.max_queued_events
|
|
||||||
// sysctl can be used to increase this).
|
|
||||||
// - windows: The buffer size is too small; WithBufferSize() can be used to increase it.
|
|
||||||
// - kqueue, fen: Not used.
|
|
||||||
ErrEventOverflow = errors.New("fsnotify: queue or buffer overflow")
|
|
||||||
|
|
||||||
// ErrUnsupported is returned by AddWith() when WithOps() specified an
|
|
||||||
// Unportable event that's not supported on this platform.
|
|
||||||
//lint:ignore ST1012 not relevant
|
|
||||||
xErrUnsupported = errors.New("fsnotify: not supported with this backend")
|
|
||||||
)
|
|
||||||
|
|
||||||
// NewWatcher creates a new Watcher.
|
|
||||||
func NewWatcher() (*Watcher, error) {
|
|
||||||
ev, errs := make(chan Event, defaultBufferSize), make(chan error)
|
|
||||||
b, err := newBackend(ev, errs)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
return &Watcher{b: b, Events: ev, Errors: errs}, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewBufferedWatcher creates a new Watcher with a buffered Watcher.Events
|
|
||||||
// channel.
|
|
||||||
//
|
|
||||||
// The main use case for this is situations with a very large number of events
|
|
||||||
// where the kernel buffer size can't be increased (e.g. due to lack of
|
|
||||||
// permissions). An unbuffered Watcher will perform better for almost all use
|
|
||||||
// cases, and whenever possible you will be better off increasing the kernel
|
|
||||||
// buffers instead of adding a large userspace buffer.
|
|
||||||
func NewBufferedWatcher(sz uint) (*Watcher, error) {
|
|
||||||
ev, errs := make(chan Event, sz), make(chan error)
|
|
||||||
b, err := newBackend(ev, errs)
|
|
||||||
if err != nil {
|
|
||||||
return nil, err
|
|
||||||
}
|
|
||||||
return &Watcher{b: b, Events: ev, Errors: errs}, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// Add starts monitoring the path for changes.
|
|
||||||
//
|
|
||||||
// A path can only be watched once; watching it more than once is a no-op and will
|
|
||||||
// not return an error. Paths that do not yet exist on the filesystem cannot be
|
|
||||||
// watched.
|
|
||||||
//
|
|
||||||
// A watch will be automatically removed if the watched path is deleted or
|
|
||||||
// renamed. The exception is the Windows backend, which doesn't remove the
|
|
||||||
// watcher on renames.
|
|
||||||
//
|
|
||||||
// Notifications on network filesystems (NFS, SMB, FUSE, etc.) or special
|
|
||||||
// filesystems (/proc, /sys, etc.) generally don't work.
|
|
||||||
//
|
|
||||||
// Returns [ErrClosed] if [Watcher.Close] was called.
|
|
||||||
//
|
|
||||||
// See [Watcher.AddWith] for a version that allows adding options.
|
|
||||||
//
|
|
||||||
// # Watching directories
|
|
||||||
//
|
|
||||||
// All files in a directory are monitored, including new files that are created
|
|
||||||
// after the watcher is started. Subdirectories are not watched (i.e. it's
|
|
||||||
// non-recursive).
|
|
||||||
//
|
|
||||||
// # Watching files
|
|
||||||
//
|
|
||||||
// Watching individual files (rather than directories) is generally not
|
|
||||||
// recommended as many programs (especially editors) update files atomically: it
|
|
||||||
// will write to a temporary file which is then moved to destination,
|
|
||||||
// overwriting the original (or some variant thereof). The watcher on the
|
|
||||||
// original file is now lost, as that no longer exists.
|
|
||||||
//
|
|
||||||
// The upshot of this is that a power failure or crash won't leave a
|
|
||||||
// half-written file.
|
|
||||||
//
|
|
||||||
// Watch the parent directory and use Event.Name to filter out files you're not
|
|
||||||
// interested in. There is an example of this in cmd/fsnotify/file.go.
|
|
||||||
func (w *Watcher) Add(path string) error { return w.b.Add(path) }
|
|
||||||
|
|
||||||
// AddWith is like [Watcher.Add], but allows adding options. When using Add()
|
|
||||||
// the defaults described below are used.
|
|
||||||
//
|
|
||||||
// Possible options are:
|
|
||||||
//
|
|
||||||
// - [WithBufferSize] sets the buffer size for the Windows backend; no-op on
|
|
||||||
// other platforms. The default is 64K (65536 bytes).
|
|
||||||
func (w *Watcher) AddWith(path string, opts ...addOpt) error { return w.b.AddWith(path, opts...) }
|
|
||||||
|
|
||||||
// Remove stops monitoring the path for changes.
|
|
||||||
//
|
|
||||||
// Directories are always removed non-recursively. For example, if you added
|
|
||||||
// /tmp/dir and /tmp/dir/subdir then you will need to remove both.
|
|
||||||
//
|
|
||||||
// Removing a path that has not yet been added returns [ErrNonExistentWatch].
|
|
||||||
//
|
|
||||||
// Returns nil if [Watcher.Close] was called.
|
|
||||||
func (w *Watcher) Remove(path string) error { return w.b.Remove(path) }
|
|
||||||
|
|
||||||
// Close removes all watches and closes the Events channel.
|
|
||||||
func (w *Watcher) Close() error { return w.b.Close() }
|
|
||||||
|
|
||||||
// WatchList returns all paths explicitly added with [Watcher.Add] (and are not
|
|
||||||
// yet removed).
|
|
||||||
//
|
|
||||||
// The order is undefined, and may differ per call. Returns nil if
|
|
||||||
// [Watcher.Close] was called.
|
|
||||||
func (w *Watcher) WatchList() []string { return w.b.WatchList() }
|
|
||||||
|
|
||||||
// Supports reports if all the listed operations are supported by this platform.
|
|
||||||
//
|
|
||||||
// Create, Write, Remove, Rename, and Chmod are always supported. It can only
|
|
||||||
// return false for an Op starting with Unportable.
|
|
||||||
func (w *Watcher) xSupports(op Op) bool { return w.b.xSupports(op) }
|
|
||||||
|
|
||||||
func (o Op) String() string {
|
|
||||||
var b strings.Builder
|
|
||||||
if o.Has(Create) {
|
|
||||||
b.WriteString("|CREATE")
|
|
||||||
}
|
|
||||||
if o.Has(Remove) {
|
|
||||||
b.WriteString("|REMOVE")
|
|
||||||
}
|
|
||||||
if o.Has(Write) {
|
|
||||||
b.WriteString("|WRITE")
|
|
||||||
}
|
|
||||||
if o.Has(xUnportableOpen) {
|
|
||||||
b.WriteString("|OPEN")
|
|
||||||
}
|
|
||||||
if o.Has(xUnportableRead) {
|
|
||||||
b.WriteString("|READ")
|
|
||||||
}
|
|
||||||
if o.Has(xUnportableCloseWrite) {
|
|
||||||
b.WriteString("|CLOSE_WRITE")
|
|
||||||
}
|
|
||||||
if o.Has(xUnportableCloseRead) {
|
|
||||||
b.WriteString("|CLOSE_READ")
|
|
||||||
}
|
|
||||||
if o.Has(Rename) {
|
|
||||||
b.WriteString("|RENAME")
|
|
||||||
}
|
|
||||||
if o.Has(Chmod) {
|
|
||||||
b.WriteString("|CHMOD")
|
|
||||||
}
|
|
||||||
if b.Len() == 0 {
|
|
||||||
return "[no events]"
|
|
||||||
}
|
|
||||||
return b.String()[1:]
|
|
||||||
}
|
|
||||||
|
|
||||||
// Has reports if this operation has the given operation.
|
|
||||||
func (o Op) Has(h Op) bool { return o&h != 0 }
|
|
||||||
|
|
||||||
// Has reports if this event has the given operation.
|
|
||||||
func (e Event) Has(op Op) bool { return e.Op.Has(op) }
|
|
||||||
|
|
||||||
// String returns a string representation of the event with their path.
|
|
||||||
func (e Event) String() string {
|
|
||||||
if e.renamedFrom != "" {
|
|
||||||
return fmt.Sprintf("%-13s %q ← %q", e.Op.String(), e.Name, e.renamedFrom)
|
|
||||||
}
|
|
||||||
return fmt.Sprintf("%-13s %q", e.Op.String(), e.Name)
|
|
||||||
}
|
|
||||||
|
|
||||||
type (
|
|
||||||
backend interface {
|
|
||||||
Add(string) error
|
|
||||||
AddWith(string, ...addOpt) error
|
|
||||||
Remove(string) error
|
|
||||||
WatchList() []string
|
|
||||||
Close() error
|
|
||||||
xSupports(Op) bool
|
|
||||||
}
|
|
||||||
addOpt func(opt *withOpts)
|
|
||||||
withOpts struct {
|
|
||||||
bufsize int
|
|
||||||
op Op
|
|
||||||
noFollow bool
|
|
||||||
sendCreate bool
|
|
||||||
}
|
|
||||||
)
|
|
||||||
|
|
||||||
var debug = func() bool {
|
|
||||||
// Check for exactly "1" (rather than mere existence) so we can add
|
|
||||||
// options/flags in the future. I don't know if we ever want that, but it's
|
|
||||||
// nice to leave the option open.
|
|
||||||
return os.Getenv("FSNOTIFY_DEBUG") == "1"
|
|
||||||
}()
|
|
||||||
|
|
||||||
var defaultOpts = withOpts{
|
|
||||||
bufsize: 65536, // 64K
|
|
||||||
op: Create | Write | Remove | Rename | Chmod,
|
|
||||||
}
|
|
||||||
|
|
||||||
func getOptions(opts ...addOpt) withOpts {
|
|
||||||
with := defaultOpts
|
|
||||||
for _, o := range opts {
|
|
||||||
if o != nil {
|
|
||||||
o(&with)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return with
|
|
||||||
}
|
|
||||||
|
|
||||||
// WithBufferSize sets the [ReadDirectoryChangesW] buffer size.
|
|
||||||
//
|
|
||||||
// This only has effect on Windows systems, and is a no-op for other backends.
|
|
||||||
//
|
|
||||||
// The default value is 64K (65536 bytes) which is the highest value that works
|
|
||||||
// on all filesystems and should be enough for most applications, but if you
|
|
||||||
// have a large burst of events it may not be enough. You can increase it if
|
|
||||||
// you're hitting "queue or buffer overflow" errors ([ErrEventOverflow]).
|
|
||||||
//
|
|
||||||
// [ReadDirectoryChangesW]: https://learn.microsoft.com/en-gb/windows/win32/api/winbase/nf-winbase-readdirectorychangesw
|
|
||||||
func WithBufferSize(bytes int) addOpt {
|
|
||||||
return func(opt *withOpts) { opt.bufsize = bytes }
|
|
||||||
}
|
|
||||||
|
|
||||||
// WithOps sets which operations to listen for. The default is [Create],
|
|
||||||
// [Write], [Remove], [Rename], and [Chmod].
|
|
||||||
//
|
|
||||||
// Excluding operations you're not interested in can save quite a bit of CPU
|
|
||||||
// time; in some use cases there may be hundreds of thousands of useless Write
|
|
||||||
// or Chmod operations per second.
|
|
||||||
//
|
|
||||||
// This can also be used to add unportable operations not supported by all
|
|
||||||
// platforms; unportable operations all start with "Unportable":
|
|
||||||
// [UnportableOpen], [UnportableRead], [UnportableCloseWrite], and
|
|
||||||
// [UnportableCloseRead].
|
|
||||||
//
|
|
||||||
// AddWith returns an error when using an unportable operation that's not
|
|
||||||
// supported. Use [Watcher.Support] to check for support.
|
|
||||||
func withOps(op Op) addOpt {
|
|
||||||
return func(opt *withOpts) { opt.op = op }
|
|
||||||
}
|
|
||||||
|
|
||||||
// WithNoFollow disables following symlinks, so the symlinks themselves are
|
|
||||||
// watched.
|
|
||||||
func withNoFollow() addOpt {
|
|
||||||
return func(opt *withOpts) { opt.noFollow = true }
|
|
||||||
}
|
|
||||||
|
|
||||||
// "Internal" option for recursive watches on inotify.
|
|
||||||
func withCreate() addOpt {
|
|
||||||
return func(opt *withOpts) { opt.sendCreate = true }
|
|
||||||
}
|
|
||||||
|
|
||||||
var enableRecurse = false
|
|
||||||
|
|
||||||
// Check if this path is recursive (ends with "/..." or "\..."), and return the
|
|
||||||
// path with the /... stripped.
|
|
||||||
func recursivePath(path string) (string, bool) {
|
|
||||||
path = filepath.Clean(path)
|
|
||||||
if !enableRecurse { // Only enabled in tests for now.
|
|
||||||
return path, false
|
|
||||||
}
|
|
||||||
if filepath.Base(path) == "..." {
|
|
||||||
return filepath.Dir(path), true
|
|
||||||
}
|
|
||||||
return path, false
|
|
||||||
}
|
|
||||||
39
vendor/github.com/fsnotify/fsnotify/internal/darwin.go
generated
vendored
39
vendor/github.com/fsnotify/fsnotify/internal/darwin.go
generated
vendored
@@ -1,39 +0,0 @@
|
|||||||
//go:build darwin
|
|
||||||
|
|
||||||
package internal
|
|
||||||
|
|
||||||
import (
|
|
||||||
"syscall"
|
|
||||||
|
|
||||||
"golang.org/x/sys/unix"
|
|
||||||
)
|
|
||||||
|
|
||||||
var (
|
|
||||||
ErrSyscallEACCES = syscall.EACCES
|
|
||||||
ErrUnixEACCES = unix.EACCES
|
|
||||||
)
|
|
||||||
|
|
||||||
var maxfiles uint64
|
|
||||||
|
|
||||||
func SetRlimit() {
|
|
||||||
// Go 1.19 will do this automatically: https://go-review.googlesource.com/c/go/+/393354/
|
|
||||||
var l syscall.Rlimit
|
|
||||||
err := syscall.Getrlimit(syscall.RLIMIT_NOFILE, &l)
|
|
||||||
if err == nil && l.Cur != l.Max {
|
|
||||||
l.Cur = l.Max
|
|
||||||
syscall.Setrlimit(syscall.RLIMIT_NOFILE, &l)
|
|
||||||
}
|
|
||||||
maxfiles = l.Cur
|
|
||||||
|
|
||||||
if n, err := syscall.SysctlUint32("kern.maxfiles"); err == nil && uint64(n) < maxfiles {
|
|
||||||
maxfiles = uint64(n)
|
|
||||||
}
|
|
||||||
|
|
||||||
if n, err := syscall.SysctlUint32("kern.maxfilesperproc"); err == nil && uint64(n) < maxfiles {
|
|
||||||
maxfiles = uint64(n)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func Maxfiles() uint64 { return maxfiles }
|
|
||||||
func Mkfifo(path string, mode uint32) error { return unix.Mkfifo(path, mode) }
|
|
||||||
func Mknod(path string, mode uint32, dev int) error { return unix.Mknod(path, mode, dev) }
|
|
||||||
57
vendor/github.com/fsnotify/fsnotify/internal/debug_darwin.go
generated
vendored
57
vendor/github.com/fsnotify/fsnotify/internal/debug_darwin.go
generated
vendored
@@ -1,57 +0,0 @@
|
|||||||
package internal
|
|
||||||
|
|
||||||
import "golang.org/x/sys/unix"
|
|
||||||
|
|
||||||
var names = []struct {
|
|
||||||
n string
|
|
||||||
m uint32
|
|
||||||
}{
|
|
||||||
{"NOTE_ABSOLUTE", unix.NOTE_ABSOLUTE},
|
|
||||||
{"NOTE_ATTRIB", unix.NOTE_ATTRIB},
|
|
||||||
{"NOTE_BACKGROUND", unix.NOTE_BACKGROUND},
|
|
||||||
{"NOTE_CHILD", unix.NOTE_CHILD},
|
|
||||||
{"NOTE_CRITICAL", unix.NOTE_CRITICAL},
|
|
||||||
{"NOTE_DELETE", unix.NOTE_DELETE},
|
|
||||||
{"NOTE_EXEC", unix.NOTE_EXEC},
|
|
||||||
{"NOTE_EXIT", unix.NOTE_EXIT},
|
|
||||||
{"NOTE_EXITSTATUS", unix.NOTE_EXITSTATUS},
|
|
||||||
{"NOTE_EXIT_CSERROR", unix.NOTE_EXIT_CSERROR},
|
|
||||||
{"NOTE_EXIT_DECRYPTFAIL", unix.NOTE_EXIT_DECRYPTFAIL},
|
|
||||||
{"NOTE_EXIT_DETAIL", unix.NOTE_EXIT_DETAIL},
|
|
||||||
{"NOTE_EXIT_DETAIL_MASK", unix.NOTE_EXIT_DETAIL_MASK},
|
|
||||||
{"NOTE_EXIT_MEMORY", unix.NOTE_EXIT_MEMORY},
|
|
||||||
{"NOTE_EXIT_REPARENTED", unix.NOTE_EXIT_REPARENTED},
|
|
||||||
{"NOTE_EXTEND", unix.NOTE_EXTEND},
|
|
||||||
{"NOTE_FFAND", unix.NOTE_FFAND},
|
|
||||||
{"NOTE_FFCOPY", unix.NOTE_FFCOPY},
|
|
||||||
{"NOTE_FFCTRLMASK", unix.NOTE_FFCTRLMASK},
|
|
||||||
{"NOTE_FFLAGSMASK", unix.NOTE_FFLAGSMASK},
|
|
||||||
{"NOTE_FFNOP", unix.NOTE_FFNOP},
|
|
||||||
{"NOTE_FFOR", unix.NOTE_FFOR},
|
|
||||||
{"NOTE_FORK", unix.NOTE_FORK},
|
|
||||||
{"NOTE_FUNLOCK", unix.NOTE_FUNLOCK},
|
|
||||||
{"NOTE_LEEWAY", unix.NOTE_LEEWAY},
|
|
||||||
{"NOTE_LINK", unix.NOTE_LINK},
|
|
||||||
{"NOTE_LOWAT", unix.NOTE_LOWAT},
|
|
||||||
{"NOTE_MACHTIME", unix.NOTE_MACHTIME},
|
|
||||||
{"NOTE_MACH_CONTINUOUS_TIME", unix.NOTE_MACH_CONTINUOUS_TIME},
|
|
||||||
{"NOTE_NONE", unix.NOTE_NONE},
|
|
||||||
{"NOTE_NSECONDS", unix.NOTE_NSECONDS},
|
|
||||||
{"NOTE_OOB", unix.NOTE_OOB},
|
|
||||||
//{"NOTE_PCTRLMASK", unix.NOTE_PCTRLMASK}, -0x100000 (?!)
|
|
||||||
{"NOTE_PDATAMASK", unix.NOTE_PDATAMASK},
|
|
||||||
{"NOTE_REAP", unix.NOTE_REAP},
|
|
||||||
{"NOTE_RENAME", unix.NOTE_RENAME},
|
|
||||||
{"NOTE_REVOKE", unix.NOTE_REVOKE},
|
|
||||||
{"NOTE_SECONDS", unix.NOTE_SECONDS},
|
|
||||||
{"NOTE_SIGNAL", unix.NOTE_SIGNAL},
|
|
||||||
{"NOTE_TRACK", unix.NOTE_TRACK},
|
|
||||||
{"NOTE_TRACKERR", unix.NOTE_TRACKERR},
|
|
||||||
{"NOTE_TRIGGER", unix.NOTE_TRIGGER},
|
|
||||||
{"NOTE_USECONDS", unix.NOTE_USECONDS},
|
|
||||||
{"NOTE_VM_ERROR", unix.NOTE_VM_ERROR},
|
|
||||||
{"NOTE_VM_PRESSURE", unix.NOTE_VM_PRESSURE},
|
|
||||||
{"NOTE_VM_PRESSURE_SUDDEN_TERMINATE", unix.NOTE_VM_PRESSURE_SUDDEN_TERMINATE},
|
|
||||||
{"NOTE_VM_PRESSURE_TERMINATE", unix.NOTE_VM_PRESSURE_TERMINATE},
|
|
||||||
{"NOTE_WRITE", unix.NOTE_WRITE},
|
|
||||||
}
|
|
||||||
33
vendor/github.com/fsnotify/fsnotify/internal/debug_dragonfly.go
generated
vendored
33
vendor/github.com/fsnotify/fsnotify/internal/debug_dragonfly.go
generated
vendored
@@ -1,33 +0,0 @@
|
|||||||
package internal
|
|
||||||
|
|
||||||
import "golang.org/x/sys/unix"
|
|
||||||
|
|
||||||
var names = []struct {
|
|
||||||
n string
|
|
||||||
m uint32
|
|
||||||
}{
|
|
||||||
{"NOTE_ATTRIB", unix.NOTE_ATTRIB},
|
|
||||||
{"NOTE_CHILD", unix.NOTE_CHILD},
|
|
||||||
{"NOTE_DELETE", unix.NOTE_DELETE},
|
|
||||||
{"NOTE_EXEC", unix.NOTE_EXEC},
|
|
||||||
{"NOTE_EXIT", unix.NOTE_EXIT},
|
|
||||||
{"NOTE_EXTEND", unix.NOTE_EXTEND},
|
|
||||||
{"NOTE_FFAND", unix.NOTE_FFAND},
|
|
||||||
{"NOTE_FFCOPY", unix.NOTE_FFCOPY},
|
|
||||||
{"NOTE_FFCTRLMASK", unix.NOTE_FFCTRLMASK},
|
|
||||||
{"NOTE_FFLAGSMASK", unix.NOTE_FFLAGSMASK},
|
|
||||||
{"NOTE_FFNOP", unix.NOTE_FFNOP},
|
|
||||||
{"NOTE_FFOR", unix.NOTE_FFOR},
|
|
||||||
{"NOTE_FORK", unix.NOTE_FORK},
|
|
||||||
{"NOTE_LINK", unix.NOTE_LINK},
|
|
||||||
{"NOTE_LOWAT", unix.NOTE_LOWAT},
|
|
||||||
{"NOTE_OOB", unix.NOTE_OOB},
|
|
||||||
{"NOTE_PCTRLMASK", unix.NOTE_PCTRLMASK},
|
|
||||||
{"NOTE_PDATAMASK", unix.NOTE_PDATAMASK},
|
|
||||||
{"NOTE_RENAME", unix.NOTE_RENAME},
|
|
||||||
{"NOTE_REVOKE", unix.NOTE_REVOKE},
|
|
||||||
{"NOTE_TRACK", unix.NOTE_TRACK},
|
|
||||||
{"NOTE_TRACKERR", unix.NOTE_TRACKERR},
|
|
||||||
{"NOTE_TRIGGER", unix.NOTE_TRIGGER},
|
|
||||||
{"NOTE_WRITE", unix.NOTE_WRITE},
|
|
||||||
}
|
|
||||||
42
vendor/github.com/fsnotify/fsnotify/internal/debug_freebsd.go
generated
vendored
42
vendor/github.com/fsnotify/fsnotify/internal/debug_freebsd.go
generated
vendored
@@ -1,42 +0,0 @@
|
|||||||
package internal
|
|
||||||
|
|
||||||
import "golang.org/x/sys/unix"
|
|
||||||
|
|
||||||
var names = []struct {
|
|
||||||
n string
|
|
||||||
m uint32
|
|
||||||
}{
|
|
||||||
{"NOTE_ABSTIME", unix.NOTE_ABSTIME},
|
|
||||||
{"NOTE_ATTRIB", unix.NOTE_ATTRIB},
|
|
||||||
{"NOTE_CHILD", unix.NOTE_CHILD},
|
|
||||||
{"NOTE_CLOSE", unix.NOTE_CLOSE},
|
|
||||||
{"NOTE_CLOSE_WRITE", unix.NOTE_CLOSE_WRITE},
|
|
||||||
{"NOTE_DELETE", unix.NOTE_DELETE},
|
|
||||||
{"NOTE_EXEC", unix.NOTE_EXEC},
|
|
||||||
{"NOTE_EXIT", unix.NOTE_EXIT},
|
|
||||||
{"NOTE_EXTEND", unix.NOTE_EXTEND},
|
|
||||||
{"NOTE_FFAND", unix.NOTE_FFAND},
|
|
||||||
{"NOTE_FFCOPY", unix.NOTE_FFCOPY},
|
|
||||||
{"NOTE_FFCTRLMASK", unix.NOTE_FFCTRLMASK},
|
|
||||||
{"NOTE_FFLAGSMASK", unix.NOTE_FFLAGSMASK},
|
|
||||||
{"NOTE_FFNOP", unix.NOTE_FFNOP},
|
|
||||||
{"NOTE_FFOR", unix.NOTE_FFOR},
|
|
||||||
{"NOTE_FILE_POLL", unix.NOTE_FILE_POLL},
|
|
||||||
{"NOTE_FORK", unix.NOTE_FORK},
|
|
||||||
{"NOTE_LINK", unix.NOTE_LINK},
|
|
||||||
{"NOTE_LOWAT", unix.NOTE_LOWAT},
|
|
||||||
{"NOTE_MSECONDS", unix.NOTE_MSECONDS},
|
|
||||||
{"NOTE_NSECONDS", unix.NOTE_NSECONDS},
|
|
||||||
{"NOTE_OPEN", unix.NOTE_OPEN},
|
|
||||||
{"NOTE_PCTRLMASK", unix.NOTE_PCTRLMASK},
|
|
||||||
{"NOTE_PDATAMASK", unix.NOTE_PDATAMASK},
|
|
||||||
{"NOTE_READ", unix.NOTE_READ},
|
|
||||||
{"NOTE_RENAME", unix.NOTE_RENAME},
|
|
||||||
{"NOTE_REVOKE", unix.NOTE_REVOKE},
|
|
||||||
{"NOTE_SECONDS", unix.NOTE_SECONDS},
|
|
||||||
{"NOTE_TRACK", unix.NOTE_TRACK},
|
|
||||||
{"NOTE_TRACKERR", unix.NOTE_TRACKERR},
|
|
||||||
{"NOTE_TRIGGER", unix.NOTE_TRIGGER},
|
|
||||||
{"NOTE_USECONDS", unix.NOTE_USECONDS},
|
|
||||||
{"NOTE_WRITE", unix.NOTE_WRITE},
|
|
||||||
}
|
|
||||||
32
vendor/github.com/fsnotify/fsnotify/internal/debug_kqueue.go
generated
vendored
32
vendor/github.com/fsnotify/fsnotify/internal/debug_kqueue.go
generated
vendored
@@ -1,32 +0,0 @@
|
|||||||
//go:build freebsd || openbsd || netbsd || dragonfly || darwin
|
|
||||||
|
|
||||||
package internal
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
"os"
|
|
||||||
"strings"
|
|
||||||
"time"
|
|
||||||
|
|
||||||
"golang.org/x/sys/unix"
|
|
||||||
)
|
|
||||||
|
|
||||||
func Debug(name string, kevent *unix.Kevent_t) {
|
|
||||||
mask := uint32(kevent.Fflags)
|
|
||||||
|
|
||||||
var (
|
|
||||||
l []string
|
|
||||||
unknown = mask
|
|
||||||
)
|
|
||||||
for _, n := range names {
|
|
||||||
if mask&n.m == n.m {
|
|
||||||
l = append(l, n.n)
|
|
||||||
unknown ^= n.m
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if unknown > 0 {
|
|
||||||
l = append(l, fmt.Sprintf("0x%x", unknown))
|
|
||||||
}
|
|
||||||
fmt.Fprintf(os.Stderr, "FSNOTIFY_DEBUG: %s %10d:%-60s → %q\n",
|
|
||||||
time.Now().Format("15:04:05.000000000"), mask, strings.Join(l, " | "), name)
|
|
||||||
}
|
|
||||||
56
vendor/github.com/fsnotify/fsnotify/internal/debug_linux.go
generated
vendored
56
vendor/github.com/fsnotify/fsnotify/internal/debug_linux.go
generated
vendored
@@ -1,56 +0,0 @@
|
|||||||
package internal
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
"os"
|
|
||||||
"strings"
|
|
||||||
"time"
|
|
||||||
|
|
||||||
"golang.org/x/sys/unix"
|
|
||||||
)
|
|
||||||
|
|
||||||
func Debug(name string, mask, cookie uint32) {
|
|
||||||
names := []struct {
|
|
||||||
n string
|
|
||||||
m uint32
|
|
||||||
}{
|
|
||||||
{"IN_ACCESS", unix.IN_ACCESS},
|
|
||||||
{"IN_ATTRIB", unix.IN_ATTRIB},
|
|
||||||
{"IN_CLOSE", unix.IN_CLOSE},
|
|
||||||
{"IN_CLOSE_NOWRITE", unix.IN_CLOSE_NOWRITE},
|
|
||||||
{"IN_CLOSE_WRITE", unix.IN_CLOSE_WRITE},
|
|
||||||
{"IN_CREATE", unix.IN_CREATE},
|
|
||||||
{"IN_DELETE", unix.IN_DELETE},
|
|
||||||
{"IN_DELETE_SELF", unix.IN_DELETE_SELF},
|
|
||||||
{"IN_IGNORED", unix.IN_IGNORED},
|
|
||||||
{"IN_ISDIR", unix.IN_ISDIR},
|
|
||||||
{"IN_MODIFY", unix.IN_MODIFY},
|
|
||||||
{"IN_MOVE", unix.IN_MOVE},
|
|
||||||
{"IN_MOVED_FROM", unix.IN_MOVED_FROM},
|
|
||||||
{"IN_MOVED_TO", unix.IN_MOVED_TO},
|
|
||||||
{"IN_MOVE_SELF", unix.IN_MOVE_SELF},
|
|
||||||
{"IN_OPEN", unix.IN_OPEN},
|
|
||||||
{"IN_Q_OVERFLOW", unix.IN_Q_OVERFLOW},
|
|
||||||
{"IN_UNMOUNT", unix.IN_UNMOUNT},
|
|
||||||
}
|
|
||||||
|
|
||||||
var (
|
|
||||||
l []string
|
|
||||||
unknown = mask
|
|
||||||
)
|
|
||||||
for _, n := range names {
|
|
||||||
if mask&n.m == n.m {
|
|
||||||
l = append(l, n.n)
|
|
||||||
unknown ^= n.m
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if unknown > 0 {
|
|
||||||
l = append(l, fmt.Sprintf("0x%x", unknown))
|
|
||||||
}
|
|
||||||
var c string
|
|
||||||
if cookie > 0 {
|
|
||||||
c = fmt.Sprintf("(cookie: %d) ", cookie)
|
|
||||||
}
|
|
||||||
fmt.Fprintf(os.Stderr, "FSNOTIFY_DEBUG: %s %-30s → %s%q\n",
|
|
||||||
time.Now().Format("15:04:05.000000000"), strings.Join(l, "|"), c, name)
|
|
||||||
}
|
|
||||||
25
vendor/github.com/fsnotify/fsnotify/internal/debug_netbsd.go
generated
vendored
25
vendor/github.com/fsnotify/fsnotify/internal/debug_netbsd.go
generated
vendored
@@ -1,25 +0,0 @@
|
|||||||
package internal
|
|
||||||
|
|
||||||
import "golang.org/x/sys/unix"
|
|
||||||
|
|
||||||
var names = []struct {
|
|
||||||
n string
|
|
||||||
m uint32
|
|
||||||
}{
|
|
||||||
{"NOTE_ATTRIB", unix.NOTE_ATTRIB},
|
|
||||||
{"NOTE_CHILD", unix.NOTE_CHILD},
|
|
||||||
{"NOTE_DELETE", unix.NOTE_DELETE},
|
|
||||||
{"NOTE_EXEC", unix.NOTE_EXEC},
|
|
||||||
{"NOTE_EXIT", unix.NOTE_EXIT},
|
|
||||||
{"NOTE_EXTEND", unix.NOTE_EXTEND},
|
|
||||||
{"NOTE_FORK", unix.NOTE_FORK},
|
|
||||||
{"NOTE_LINK", unix.NOTE_LINK},
|
|
||||||
{"NOTE_LOWAT", unix.NOTE_LOWAT},
|
|
||||||
{"NOTE_PCTRLMASK", unix.NOTE_PCTRLMASK},
|
|
||||||
{"NOTE_PDATAMASK", unix.NOTE_PDATAMASK},
|
|
||||||
{"NOTE_RENAME", unix.NOTE_RENAME},
|
|
||||||
{"NOTE_REVOKE", unix.NOTE_REVOKE},
|
|
||||||
{"NOTE_TRACK", unix.NOTE_TRACK},
|
|
||||||
{"NOTE_TRACKERR", unix.NOTE_TRACKERR},
|
|
||||||
{"NOTE_WRITE", unix.NOTE_WRITE},
|
|
||||||
}
|
|
||||||
28
vendor/github.com/fsnotify/fsnotify/internal/debug_openbsd.go
generated
vendored
28
vendor/github.com/fsnotify/fsnotify/internal/debug_openbsd.go
generated
vendored
@@ -1,28 +0,0 @@
|
|||||||
package internal
|
|
||||||
|
|
||||||
import "golang.org/x/sys/unix"
|
|
||||||
|
|
||||||
var names = []struct {
|
|
||||||
n string
|
|
||||||
m uint32
|
|
||||||
}{
|
|
||||||
{"NOTE_ATTRIB", unix.NOTE_ATTRIB},
|
|
||||||
// {"NOTE_CHANGE", unix.NOTE_CHANGE}, // Not on 386?
|
|
||||||
{"NOTE_CHILD", unix.NOTE_CHILD},
|
|
||||||
{"NOTE_DELETE", unix.NOTE_DELETE},
|
|
||||||
{"NOTE_EOF", unix.NOTE_EOF},
|
|
||||||
{"NOTE_EXEC", unix.NOTE_EXEC},
|
|
||||||
{"NOTE_EXIT", unix.NOTE_EXIT},
|
|
||||||
{"NOTE_EXTEND", unix.NOTE_EXTEND},
|
|
||||||
{"NOTE_FORK", unix.NOTE_FORK},
|
|
||||||
{"NOTE_LINK", unix.NOTE_LINK},
|
|
||||||
{"NOTE_LOWAT", unix.NOTE_LOWAT},
|
|
||||||
{"NOTE_PCTRLMASK", unix.NOTE_PCTRLMASK},
|
|
||||||
{"NOTE_PDATAMASK", unix.NOTE_PDATAMASK},
|
|
||||||
{"NOTE_RENAME", unix.NOTE_RENAME},
|
|
||||||
{"NOTE_REVOKE", unix.NOTE_REVOKE},
|
|
||||||
{"NOTE_TRACK", unix.NOTE_TRACK},
|
|
||||||
{"NOTE_TRACKERR", unix.NOTE_TRACKERR},
|
|
||||||
{"NOTE_TRUNCATE", unix.NOTE_TRUNCATE},
|
|
||||||
{"NOTE_WRITE", unix.NOTE_WRITE},
|
|
||||||
}
|
|
||||||
45
vendor/github.com/fsnotify/fsnotify/internal/debug_solaris.go
generated
vendored
45
vendor/github.com/fsnotify/fsnotify/internal/debug_solaris.go
generated
vendored
@@ -1,45 +0,0 @@
|
|||||||
package internal
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
"os"
|
|
||||||
"strings"
|
|
||||||
"time"
|
|
||||||
|
|
||||||
"golang.org/x/sys/unix"
|
|
||||||
)
|
|
||||||
|
|
||||||
func Debug(name string, mask int32) {
|
|
||||||
names := []struct {
|
|
||||||
n string
|
|
||||||
m int32
|
|
||||||
}{
|
|
||||||
{"FILE_ACCESS", unix.FILE_ACCESS},
|
|
||||||
{"FILE_MODIFIED", unix.FILE_MODIFIED},
|
|
||||||
{"FILE_ATTRIB", unix.FILE_ATTRIB},
|
|
||||||
{"FILE_TRUNC", unix.FILE_TRUNC},
|
|
||||||
{"FILE_NOFOLLOW", unix.FILE_NOFOLLOW},
|
|
||||||
{"FILE_DELETE", unix.FILE_DELETE},
|
|
||||||
{"FILE_RENAME_TO", unix.FILE_RENAME_TO},
|
|
||||||
{"FILE_RENAME_FROM", unix.FILE_RENAME_FROM},
|
|
||||||
{"UNMOUNTED", unix.UNMOUNTED},
|
|
||||||
{"MOUNTEDOVER", unix.MOUNTEDOVER},
|
|
||||||
{"FILE_EXCEPTION", unix.FILE_EXCEPTION},
|
|
||||||
}
|
|
||||||
|
|
||||||
var (
|
|
||||||
l []string
|
|
||||||
unknown = mask
|
|
||||||
)
|
|
||||||
for _, n := range names {
|
|
||||||
if mask&n.m == n.m {
|
|
||||||
l = append(l, n.n)
|
|
||||||
unknown ^= n.m
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if unknown > 0 {
|
|
||||||
l = append(l, fmt.Sprintf("0x%x", unknown))
|
|
||||||
}
|
|
||||||
fmt.Fprintf(os.Stderr, "FSNOTIFY_DEBUG: %s %10d:%-30s → %q\n",
|
|
||||||
time.Now().Format("15:04:05.000000000"), mask, strings.Join(l, " | "), name)
|
|
||||||
}
|
|
||||||
40
vendor/github.com/fsnotify/fsnotify/internal/debug_windows.go
generated
vendored
40
vendor/github.com/fsnotify/fsnotify/internal/debug_windows.go
generated
vendored
@@ -1,40 +0,0 @@
|
|||||||
package internal
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
"os"
|
|
||||||
"path/filepath"
|
|
||||||
"strings"
|
|
||||||
"time"
|
|
||||||
|
|
||||||
"golang.org/x/sys/windows"
|
|
||||||
)
|
|
||||||
|
|
||||||
func Debug(name string, mask uint32) {
|
|
||||||
names := []struct {
|
|
||||||
n string
|
|
||||||
m uint32
|
|
||||||
}{
|
|
||||||
{"FILE_ACTION_ADDED", windows.FILE_ACTION_ADDED},
|
|
||||||
{"FILE_ACTION_REMOVED", windows.FILE_ACTION_REMOVED},
|
|
||||||
{"FILE_ACTION_MODIFIED", windows.FILE_ACTION_MODIFIED},
|
|
||||||
{"FILE_ACTION_RENAMED_OLD_NAME", windows.FILE_ACTION_RENAMED_OLD_NAME},
|
|
||||||
{"FILE_ACTION_RENAMED_NEW_NAME", windows.FILE_ACTION_RENAMED_NEW_NAME},
|
|
||||||
}
|
|
||||||
|
|
||||||
var (
|
|
||||||
l []string
|
|
||||||
unknown = mask
|
|
||||||
)
|
|
||||||
for _, n := range names {
|
|
||||||
if mask&n.m == n.m {
|
|
||||||
l = append(l, n.n)
|
|
||||||
unknown ^= n.m
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if unknown > 0 {
|
|
||||||
l = append(l, fmt.Sprintf("0x%x", unknown))
|
|
||||||
}
|
|
||||||
fmt.Fprintf(os.Stderr, "FSNOTIFY_DEBUG: %s %-65s → %q\n",
|
|
||||||
time.Now().Format("15:04:05.000000000"), strings.Join(l, " | "), filepath.ToSlash(name))
|
|
||||||
}
|
|
||||||
31
vendor/github.com/fsnotify/fsnotify/internal/freebsd.go
generated
vendored
31
vendor/github.com/fsnotify/fsnotify/internal/freebsd.go
generated
vendored
@@ -1,31 +0,0 @@
|
|||||||
//go:build freebsd
|
|
||||||
|
|
||||||
package internal
|
|
||||||
|
|
||||||
import (
|
|
||||||
"syscall"
|
|
||||||
|
|
||||||
"golang.org/x/sys/unix"
|
|
||||||
)
|
|
||||||
|
|
||||||
var (
|
|
||||||
ErrSyscallEACCES = syscall.EACCES
|
|
||||||
ErrUnixEACCES = unix.EACCES
|
|
||||||
)
|
|
||||||
|
|
||||||
var maxfiles uint64
|
|
||||||
|
|
||||||
func SetRlimit() {
|
|
||||||
// Go 1.19 will do this automatically: https://go-review.googlesource.com/c/go/+/393354/
|
|
||||||
var l syscall.Rlimit
|
|
||||||
err := syscall.Getrlimit(syscall.RLIMIT_NOFILE, &l)
|
|
||||||
if err == nil && l.Cur != l.Max {
|
|
||||||
l.Cur = l.Max
|
|
||||||
syscall.Setrlimit(syscall.RLIMIT_NOFILE, &l)
|
|
||||||
}
|
|
||||||
maxfiles = uint64(l.Cur)
|
|
||||||
}
|
|
||||||
|
|
||||||
func Maxfiles() uint64 { return maxfiles }
|
|
||||||
func Mkfifo(path string, mode uint32) error { return unix.Mkfifo(path, mode) }
|
|
||||||
func Mknod(path string, mode uint32, dev int) error { return unix.Mknod(path, mode, uint64(dev)) }
|
|
||||||
2
vendor/github.com/fsnotify/fsnotify/internal/internal.go
generated
vendored
2
vendor/github.com/fsnotify/fsnotify/internal/internal.go
generated
vendored
@@ -1,2 +0,0 @@
|
|||||||
// Package internal contains some helpers.
|
|
||||||
package internal
|
|
||||||
31
vendor/github.com/fsnotify/fsnotify/internal/unix.go
generated
vendored
31
vendor/github.com/fsnotify/fsnotify/internal/unix.go
generated
vendored
@@ -1,31 +0,0 @@
|
|||||||
//go:build !windows && !darwin && !freebsd && !plan9
|
|
||||||
|
|
||||||
package internal
|
|
||||||
|
|
||||||
import (
|
|
||||||
"syscall"
|
|
||||||
|
|
||||||
"golang.org/x/sys/unix"
|
|
||||||
)
|
|
||||||
|
|
||||||
var (
|
|
||||||
ErrSyscallEACCES = syscall.EACCES
|
|
||||||
ErrUnixEACCES = unix.EACCES
|
|
||||||
)
|
|
||||||
|
|
||||||
var maxfiles uint64
|
|
||||||
|
|
||||||
func SetRlimit() {
|
|
||||||
// Go 1.19 will do this automatically: https://go-review.googlesource.com/c/go/+/393354/
|
|
||||||
var l syscall.Rlimit
|
|
||||||
err := syscall.Getrlimit(syscall.RLIMIT_NOFILE, &l)
|
|
||||||
if err == nil && l.Cur != l.Max {
|
|
||||||
l.Cur = l.Max
|
|
||||||
syscall.Setrlimit(syscall.RLIMIT_NOFILE, &l)
|
|
||||||
}
|
|
||||||
maxfiles = uint64(l.Cur)
|
|
||||||
}
|
|
||||||
|
|
||||||
func Maxfiles() uint64 { return maxfiles }
|
|
||||||
func Mkfifo(path string, mode uint32) error { return unix.Mkfifo(path, mode) }
|
|
||||||
func Mknod(path string, mode uint32, dev int) error { return unix.Mknod(path, mode, dev) }
|
|
||||||
7
vendor/github.com/fsnotify/fsnotify/internal/unix2.go
generated
vendored
7
vendor/github.com/fsnotify/fsnotify/internal/unix2.go
generated
vendored
@@ -1,7 +0,0 @@
|
|||||||
//go:build !windows
|
|
||||||
|
|
||||||
package internal
|
|
||||||
|
|
||||||
func HasPrivilegesForSymlink() bool {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
41
vendor/github.com/fsnotify/fsnotify/internal/windows.go
generated
vendored
41
vendor/github.com/fsnotify/fsnotify/internal/windows.go
generated
vendored
@@ -1,41 +0,0 @@
|
|||||||
//go:build windows
|
|
||||||
|
|
||||||
package internal
|
|
||||||
|
|
||||||
import (
|
|
||||||
"errors"
|
|
||||||
|
|
||||||
"golang.org/x/sys/windows"
|
|
||||||
)
|
|
||||||
|
|
||||||
// Just a dummy.
|
|
||||||
var (
|
|
||||||
ErrSyscallEACCES = errors.New("dummy")
|
|
||||||
ErrUnixEACCES = errors.New("dummy")
|
|
||||||
)
|
|
||||||
|
|
||||||
func SetRlimit() {}
|
|
||||||
func Maxfiles() uint64 { return 1<<64 - 1 }
|
|
||||||
func Mkfifo(path string, mode uint32) error { return errors.New("no FIFOs on Windows") }
|
|
||||||
func Mknod(path string, mode uint32, dev int) error { return errors.New("no device nodes on Windows") }
|
|
||||||
|
|
||||||
func HasPrivilegesForSymlink() bool {
|
|
||||||
var sid *windows.SID
|
|
||||||
err := windows.AllocateAndInitializeSid(
|
|
||||||
&windows.SECURITY_NT_AUTHORITY,
|
|
||||||
2,
|
|
||||||
windows.SECURITY_BUILTIN_DOMAIN_RID,
|
|
||||||
windows.DOMAIN_ALIAS_RID_ADMINS,
|
|
||||||
0, 0, 0, 0, 0, 0,
|
|
||||||
&sid)
|
|
||||||
if err != nil {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
defer windows.FreeSid(sid)
|
|
||||||
token := windows.Token(0)
|
|
||||||
member, err := token.IsMember(sid)
|
|
||||||
if err != nil {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
return member || token.IsElevated()
|
|
||||||
}
|
|
||||||
64
vendor/github.com/fsnotify/fsnotify/shared.go
generated
vendored
64
vendor/github.com/fsnotify/fsnotify/shared.go
generated
vendored
@@ -1,64 +0,0 @@
|
|||||||
package fsnotify
|
|
||||||
|
|
||||||
import "sync"
|
|
||||||
|
|
||||||
type shared struct {
|
|
||||||
Events chan Event
|
|
||||||
Errors chan error
|
|
||||||
done chan struct{}
|
|
||||||
mu sync.Mutex
|
|
||||||
}
|
|
||||||
|
|
||||||
func newShared(ev chan Event, errs chan error) *shared {
|
|
||||||
return &shared{
|
|
||||||
Events: ev,
|
|
||||||
Errors: errs,
|
|
||||||
done: make(chan struct{}),
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Returns true if the event was sent, or false if watcher is closed.
|
|
||||||
func (w *shared) sendEvent(e Event) bool {
|
|
||||||
if e.Op == 0 {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
select {
|
|
||||||
case <-w.done:
|
|
||||||
return false
|
|
||||||
case w.Events <- e:
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Returns true if the error was sent, or false if watcher is closed.
|
|
||||||
func (w *shared) sendError(err error) bool {
|
|
||||||
if err == nil {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
select {
|
|
||||||
case <-w.done:
|
|
||||||
return false
|
|
||||||
case w.Errors <- err:
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w *shared) isClosed() bool {
|
|
||||||
select {
|
|
||||||
case <-w.done:
|
|
||||||
return true
|
|
||||||
default:
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Mark as closed; returns true if it was already closed.
|
|
||||||
func (w *shared) close() bool {
|
|
||||||
w.mu.Lock()
|
|
||||||
defer w.mu.Unlock()
|
|
||||||
if w.isClosed() {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
close(w.done)
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
3
vendor/github.com/fsnotify/fsnotify/staticcheck.conf
generated
vendored
3
vendor/github.com/fsnotify/fsnotify/staticcheck.conf
generated
vendored
@@ -1,3 +0,0 @@
|
|||||||
checks = ['all',
|
|
||||||
'-U1000', # Don't complain about unused functions.
|
|
||||||
]
|
|
||||||
7
vendor/github.com/fsnotify/fsnotify/system_bsd.go
generated
vendored
7
vendor/github.com/fsnotify/fsnotify/system_bsd.go
generated
vendored
@@ -1,7 +0,0 @@
|
|||||||
//go:build freebsd || openbsd || netbsd || dragonfly
|
|
||||||
|
|
||||||
package fsnotify
|
|
||||||
|
|
||||||
import "golang.org/x/sys/unix"
|
|
||||||
|
|
||||||
const openMode = unix.O_NONBLOCK | unix.O_RDONLY | unix.O_CLOEXEC
|
|
||||||
8
vendor/github.com/fsnotify/fsnotify/system_darwin.go
generated
vendored
8
vendor/github.com/fsnotify/fsnotify/system_darwin.go
generated
vendored
@@ -1,8 +0,0 @@
|
|||||||
//go:build darwin
|
|
||||||
|
|
||||||
package fsnotify
|
|
||||||
|
|
||||||
import "golang.org/x/sys/unix"
|
|
||||||
|
|
||||||
// note: this constant is not defined on BSD
|
|
||||||
const openMode = unix.O_EVTONLY | unix.O_CLOEXEC
|
|
||||||
3
vendor/github.com/go-chi/chi/v5/.gitignore
generated
vendored
3
vendor/github.com/go-chi/chi/v5/.gitignore
generated
vendored
@@ -1,3 +0,0 @@
|
|||||||
.idea
|
|
||||||
*.sw?
|
|
||||||
.vscode
|
|
||||||
341
vendor/github.com/go-chi/chi/v5/CHANGELOG.md
generated
vendored
341
vendor/github.com/go-chi/chi/v5/CHANGELOG.md
generated
vendored
@@ -1,341 +0,0 @@
|
|||||||
# Changelog
|
|
||||||
|
|
||||||
## v5.0.12 (2024-02-16)
|
|
||||||
|
|
||||||
- History of changes: see https://github.com/go-chi/chi/compare/v5.0.11...v5.0.12
|
|
||||||
|
|
||||||
|
|
||||||
## v5.0.11 (2023-12-19)
|
|
||||||
|
|
||||||
- History of changes: see https://github.com/go-chi/chi/compare/v5.0.10...v5.0.11
|
|
||||||
|
|
||||||
|
|
||||||
## v5.0.10 (2023-07-13)
|
|
||||||
|
|
||||||
- Fixed small edge case in tests of v5.0.9 for older Go versions
|
|
||||||
- History of changes: see https://github.com/go-chi/chi/compare/v5.0.9...v5.0.10
|
|
||||||
|
|
||||||
|
|
||||||
## v5.0.9 (2023-07-13)
|
|
||||||
|
|
||||||
- History of changes: see https://github.com/go-chi/chi/compare/v5.0.8...v5.0.9
|
|
||||||
|
|
||||||
|
|
||||||
## v5.0.8 (2022-12-07)
|
|
||||||
|
|
||||||
- History of changes: see https://github.com/go-chi/chi/compare/v5.0.7...v5.0.8
|
|
||||||
|
|
||||||
|
|
||||||
## v5.0.7 (2021-11-18)
|
|
||||||
|
|
||||||
- History of changes: see https://github.com/go-chi/chi/compare/v5.0.6...v5.0.7
|
|
||||||
|
|
||||||
|
|
||||||
## v5.0.6 (2021-11-15)
|
|
||||||
|
|
||||||
- History of changes: see https://github.com/go-chi/chi/compare/v5.0.5...v5.0.6
|
|
||||||
|
|
||||||
|
|
||||||
## v5.0.5 (2021-10-27)
|
|
||||||
|
|
||||||
- History of changes: see https://github.com/go-chi/chi/compare/v5.0.4...v5.0.5
|
|
||||||
|
|
||||||
|
|
||||||
## v5.0.4 (2021-08-29)
|
|
||||||
|
|
||||||
- History of changes: see https://github.com/go-chi/chi/compare/v5.0.3...v5.0.4
|
|
||||||
|
|
||||||
|
|
||||||
## v5.0.3 (2021-04-29)
|
|
||||||
|
|
||||||
- History of changes: see https://github.com/go-chi/chi/compare/v5.0.2...v5.0.3
|
|
||||||
|
|
||||||
|
|
||||||
## v5.0.2 (2021-03-25)
|
|
||||||
|
|
||||||
- History of changes: see https://github.com/go-chi/chi/compare/v5.0.1...v5.0.2
|
|
||||||
|
|
||||||
|
|
||||||
## v5.0.1 (2021-03-10)
|
|
||||||
|
|
||||||
- Small improvements
|
|
||||||
- History of changes: see https://github.com/go-chi/chi/compare/v5.0.0...v5.0.1
|
|
||||||
|
|
||||||
|
|
||||||
## v5.0.0 (2021-02-27)
|
|
||||||
|
|
||||||
- chi v5, `github.com/go-chi/chi/v5` introduces the adoption of Go's SIV to adhere to the current state-of-the-tools in Go.
|
|
||||||
- chi v1.5.x did not work out as planned, as the Go tooling is too powerful and chi's adoption is too wide.
|
|
||||||
The most responsible thing to do for everyone's benefit is to just release v5 with SIV, so I present to you all,
|
|
||||||
chi v5 at `github.com/go-chi/chi/v5`. I hope someday the developer experience and ergonomics I've been seeking
|
|
||||||
will still come to fruition in some form, see https://github.com/golang/go/issues/44550
|
|
||||||
- History of changes: see https://github.com/go-chi/chi/compare/v1.5.4...v5.0.0
|
|
||||||
|
|
||||||
|
|
||||||
## v1.5.4 (2021-02-27)
|
|
||||||
|
|
||||||
- Undo prior retraction in v1.5.3 as we prepare for v5.0.0 release
|
|
||||||
- History of changes: see https://github.com/go-chi/chi/compare/v1.5.3...v1.5.4
|
|
||||||
|
|
||||||
|
|
||||||
## v1.5.3 (2021-02-21)
|
|
||||||
|
|
||||||
- Update go.mod to go 1.16 with new retract directive marking all versions without prior go.mod support
|
|
||||||
- History of changes: see https://github.com/go-chi/chi/compare/v1.5.2...v1.5.3
|
|
||||||
|
|
||||||
|
|
||||||
## v1.5.2 (2021-02-10)
|
|
||||||
|
|
||||||
- Reverting allocation optimization as a precaution as go test -race fails.
|
|
||||||
- Minor improvements, see history below
|
|
||||||
- History of changes: see https://github.com/go-chi/chi/compare/v1.5.1...v1.5.2
|
|
||||||
|
|
||||||
|
|
||||||
## v1.5.1 (2020-12-06)
|
|
||||||
|
|
||||||
- Performance improvement: removing 1 allocation by foregoing context.WithValue, thank you @bouk for
|
|
||||||
your contribution (https://github.com/go-chi/chi/pull/555). Note: new benchmarks posted in README.
|
|
||||||
- `middleware.CleanPath`: new middleware that clean's request path of double slashes
|
|
||||||
- deprecate & remove `chi.ServerBaseContext` in favour of stdlib `http.Server#BaseContext`
|
|
||||||
- plus other tiny improvements, see full commit history below
|
|
||||||
- History of changes: see https://github.com/go-chi/chi/compare/v4.1.2...v1.5.1
|
|
||||||
|
|
||||||
|
|
||||||
## v1.5.0 (2020-11-12) - now with go.mod support
|
|
||||||
|
|
||||||
`chi` dates back to 2016 with it's original implementation as one of the first routers to adopt the newly introduced
|
|
||||||
context.Context api to the stdlib -- set out to design a router that is faster, more modular and simpler than anything
|
|
||||||
else out there -- while not introducing any custom handler types or dependencies. Today, `chi` still has zero dependencies,
|
|
||||||
and in many ways is future proofed from changes, given it's minimal nature. Between versions, chi's iterations have been very
|
|
||||||
incremental, with the architecture and api being the same today as it was originally designed in 2016. For this reason it
|
|
||||||
makes chi a pretty easy project to maintain, as well thanks to the many amazing community contributions over the years
|
|
||||||
to who all help make chi better (total of 86 contributors to date -- thanks all!).
|
|
||||||
|
|
||||||
Chi has been a labour of love, art and engineering, with the goals to offer beautiful ergonomics, flexibility, performance
|
|
||||||
and simplicity when building HTTP services with Go. I've strived to keep the router very minimal in surface area / code size,
|
|
||||||
and always improving the code wherever possible -- and as of today the `chi` package is just 1082 lines of code (not counting
|
|
||||||
middlewares, which are all optional). As well, I don't have the exact metrics, but from my analysis and email exchanges from
|
|
||||||
companies and developers, chi is used by thousands of projects around the world -- thank you all as there is no better form of
|
|
||||||
joy for me than to have art I had started be helpful and enjoyed by others. And of course I use chi in all of my own projects too :)
|
|
||||||
|
|
||||||
For me, the aesthetics of chi's code and usage are very important. With the introduction of Go's module support
|
|
||||||
(which I'm a big fan of), chi's past versioning scheme choice to v2, v3 and v4 would mean I'd require the import path
|
|
||||||
of "github.com/go-chi/chi/v4", leading to the lengthy discussion at https://github.com/go-chi/chi/issues/462.
|
|
||||||
Haha, to some, you may be scratching your head why I've spent > 1 year stalling to adopt "/vXX" convention in the import
|
|
||||||
path -- which isn't horrible in general -- but for chi, I'm unable to accept it as I strive for perfection in it's API design,
|
|
||||||
aesthetics and simplicity. It just doesn't feel good to me given chi's simple nature -- I do not foresee a "v5" or "v6",
|
|
||||||
and upgrading between versions in the future will also be just incremental.
|
|
||||||
|
|
||||||
I do understand versioning is a part of the API design as well, which is why the solution for a while has been to "do nothing",
|
|
||||||
as Go supports both old and new import paths with/out go.mod. However, now that Go module support has had time to iron out kinks and
|
|
||||||
is adopted everywhere, it's time for chi to get with the times. Luckily, I've discovered a path forward that will make me happy,
|
|
||||||
while also not breaking anyone's app who adopted a prior versioning from tags in v2/v3/v4. I've made an experimental release of
|
|
||||||
v1.5.0 with go.mod silently, and tested it with new and old projects, to ensure the developer experience is preserved, and it's
|
|
||||||
largely unnoticed. Fortunately, Go's toolchain will check the tags of a repo and consider the "latest" tag the one with go.mod.
|
|
||||||
However, you can still request a specific older tag such as v4.1.2, and everything will "just work". But new users can just
|
|
||||||
`go get github.com/go-chi/chi` or `go get github.com/go-chi/chi@latest` and they will get the latest version which contains
|
|
||||||
go.mod support, which is v1.5.0+. `chi` will not change very much over the years, just like it hasn't changed much from 4 years ago.
|
|
||||||
Therefore, we will stay on v1.x from here on, starting from v1.5.0. Any breaking changes will bump a "minor" release and
|
|
||||||
backwards-compatible improvements/fixes will bump a "tiny" release.
|
|
||||||
|
|
||||||
For existing projects who want to upgrade to the latest go.mod version, run: `go get -u github.com/go-chi/chi@v1.5.0`,
|
|
||||||
which will get you on the go.mod version line (as Go's mod cache may still remember v4.x). Brand new systems can run
|
|
||||||
`go get -u github.com/go-chi/chi` or `go get -u github.com/go-chi/chi@latest` to install chi, which will install v1.5.0+
|
|
||||||
built with go.mod support.
|
|
||||||
|
|
||||||
My apologies to the developers who will disagree with the decisions above, but, hope you'll try it and see it's a very
|
|
||||||
minor request which is backwards compatible and won't break your existing installations.
|
|
||||||
|
|
||||||
Cheers all, happy coding!
|
|
||||||
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
|
|
||||||
## v4.1.2 (2020-06-02)
|
|
||||||
|
|
||||||
- fix that handles MethodNotAllowed with path variables, thank you @caseyhadden for your contribution
|
|
||||||
- fix to replace nested wildcards correctly in RoutePattern, thank you @@unmultimedio for your contribution
|
|
||||||
- History of changes: see https://github.com/go-chi/chi/compare/v4.1.1...v4.1.2
|
|
||||||
|
|
||||||
|
|
||||||
## v4.1.1 (2020-04-16)
|
|
||||||
|
|
||||||
- fix for issue https://github.com/go-chi/chi/issues/411 which allows for overlapping regexp
|
|
||||||
route to the correct handler through a recursive tree search, thanks to @Jahaja for the PR/fix!
|
|
||||||
- new middleware.RouteHeaders as a simple router for request headers with wildcard support
|
|
||||||
- History of changes: see https://github.com/go-chi/chi/compare/v4.1.0...v4.1.1
|
|
||||||
|
|
||||||
|
|
||||||
## v4.1.0 (2020-04-1)
|
|
||||||
|
|
||||||
- middleware.LogEntry: Write method on interface now passes the response header
|
|
||||||
and an extra interface type useful for custom logger implementations.
|
|
||||||
- middleware.WrapResponseWriter: minor fix
|
|
||||||
- middleware.Recoverer: a bit prettier
|
|
||||||
- History of changes: see https://github.com/go-chi/chi/compare/v4.0.4...v4.1.0
|
|
||||||
|
|
||||||
## v4.0.4 (2020-03-24)
|
|
||||||
|
|
||||||
- middleware.Recoverer: new pretty stack trace printing (https://github.com/go-chi/chi/pull/496)
|
|
||||||
- a few minor improvements and fixes
|
|
||||||
- History of changes: see https://github.com/go-chi/chi/compare/v4.0.3...v4.0.4
|
|
||||||
|
|
||||||
|
|
||||||
## v4.0.3 (2020-01-09)
|
|
||||||
|
|
||||||
- core: fix regexp routing to include default value when param is not matched
|
|
||||||
- middleware: rewrite of middleware.Compress
|
|
||||||
- middleware: suppress http.ErrAbortHandler in middleware.Recoverer
|
|
||||||
- History of changes: see https://github.com/go-chi/chi/compare/v4.0.2...v4.0.3
|
|
||||||
|
|
||||||
|
|
||||||
## v4.0.2 (2019-02-26)
|
|
||||||
|
|
||||||
- Minor fixes
|
|
||||||
- History of changes: see https://github.com/go-chi/chi/compare/v4.0.1...v4.0.2
|
|
||||||
|
|
||||||
|
|
||||||
## v4.0.1 (2019-01-21)
|
|
||||||
|
|
||||||
- Fixes issue with compress middleware: #382 #385
|
|
||||||
- History of changes: see https://github.com/go-chi/chi/compare/v4.0.0...v4.0.1
|
|
||||||
|
|
||||||
|
|
||||||
## v4.0.0 (2019-01-10)
|
|
||||||
|
|
||||||
- chi v4 requires Go 1.10.3+ (or Go 1.9.7+) - we have deprecated support for Go 1.7 and 1.8
|
|
||||||
- router: respond with 404 on router with no routes (#362)
|
|
||||||
- router: additional check to ensure wildcard is at the end of a url pattern (#333)
|
|
||||||
- middleware: deprecate use of http.CloseNotifier (#347)
|
|
||||||
- middleware: fix RedirectSlashes to include query params on redirect (#334)
|
|
||||||
- History of changes: see https://github.com/go-chi/chi/compare/v3.3.4...v4.0.0
|
|
||||||
|
|
||||||
|
|
||||||
## v3.3.4 (2019-01-07)
|
|
||||||
|
|
||||||
- Minor middleware improvements. No changes to core library/router. Moving v3 into its
|
|
||||||
- own branch as a version of chi for Go 1.7, 1.8, 1.9, 1.10, 1.11
|
|
||||||
- History of changes: see https://github.com/go-chi/chi/compare/v3.3.3...v3.3.4
|
|
||||||
|
|
||||||
|
|
||||||
## v3.3.3 (2018-08-27)
|
|
||||||
|
|
||||||
- Minor release
|
|
||||||
- See https://github.com/go-chi/chi/compare/v3.3.2...v3.3.3
|
|
||||||
|
|
||||||
|
|
||||||
## v3.3.2 (2017-12-22)
|
|
||||||
|
|
||||||
- Support to route trailing slashes on mounted sub-routers (#281)
|
|
||||||
- middleware: new `ContentCharset` to check matching charsets. Thank you
|
|
||||||
@csucu for your community contribution!
|
|
||||||
|
|
||||||
|
|
||||||
## v3.3.1 (2017-11-20)
|
|
||||||
|
|
||||||
- middleware: new `AllowContentType` handler for explicit whitelist of accepted request Content-Types
|
|
||||||
- middleware: new `SetHeader` handler for short-hand middleware to set a response header key/value
|
|
||||||
- Minor bug fixes
|
|
||||||
|
|
||||||
|
|
||||||
## v3.3.0 (2017-10-10)
|
|
||||||
|
|
||||||
- New chi.RegisterMethod(method) to add support for custom HTTP methods, see _examples/custom-method for usage
|
|
||||||
- Deprecated LINK and UNLINK methods from the default list, please use `chi.RegisterMethod("LINK")` and `chi.RegisterMethod("UNLINK")` in an `init()` function
|
|
||||||
|
|
||||||
|
|
||||||
## v3.2.1 (2017-08-31)
|
|
||||||
|
|
||||||
- Add new `Match(rctx *Context, method, path string) bool` method to `Routes` interface
|
|
||||||
and `Mux`. Match searches the mux's routing tree for a handler that matches the method/path
|
|
||||||
- Add new `RouteMethod` to `*Context`
|
|
||||||
- Add new `Routes` pointer to `*Context`
|
|
||||||
- Add new `middleware.GetHead` to route missing HEAD requests to GET handler
|
|
||||||
- Updated benchmarks (see README)
|
|
||||||
|
|
||||||
|
|
||||||
## v3.1.5 (2017-08-02)
|
|
||||||
|
|
||||||
- Setup golint and go vet for the project
|
|
||||||
- As per golint, we've redefined `func ServerBaseContext(h http.Handler, baseCtx context.Context) http.Handler`
|
|
||||||
to `func ServerBaseContext(baseCtx context.Context, h http.Handler) http.Handler`
|
|
||||||
|
|
||||||
|
|
||||||
## v3.1.0 (2017-07-10)
|
|
||||||
|
|
||||||
- Fix a few minor issues after v3 release
|
|
||||||
- Move `docgen` sub-pkg to https://github.com/go-chi/docgen
|
|
||||||
- Move `render` sub-pkg to https://github.com/go-chi/render
|
|
||||||
- Add new `URLFormat` handler to chi/middleware sub-pkg to make working with url mime
|
|
||||||
suffixes easier, ie. parsing `/articles/1.json` and `/articles/1.xml`. See comments in
|
|
||||||
https://github.com/go-chi/chi/blob/master/middleware/url_format.go for example usage.
|
|
||||||
|
|
||||||
|
|
||||||
## v3.0.0 (2017-06-21)
|
|
||||||
|
|
||||||
- Major update to chi library with many exciting updates, but also some *breaking changes*
|
|
||||||
- URL parameter syntax changed from `/:id` to `/{id}` for even more flexible routing, such as
|
|
||||||
`/articles/{month}-{day}-{year}-{slug}`, `/articles/{id}`, and `/articles/{id}.{ext}` on the
|
|
||||||
same router
|
|
||||||
- Support for regexp for routing patterns, in the form of `/{paramKey:regExp}` for example:
|
|
||||||
`r.Get("/articles/{name:[a-z]+}", h)` and `chi.URLParam(r, "name")`
|
|
||||||
- Add `Method` and `MethodFunc` to `chi.Router` to allow routing definitions such as
|
|
||||||
`r.Method("GET", "/", h)` which provides a cleaner interface for custom handlers like
|
|
||||||
in `_examples/custom-handler`
|
|
||||||
- Deprecating `mux#FileServer` helper function. Instead, we encourage users to create their
|
|
||||||
own using file handler with the stdlib, see `_examples/fileserver` for an example
|
|
||||||
- Add support for LINK/UNLINK http methods via `r.Method()` and `r.MethodFunc()`
|
|
||||||
- Moved the chi project to its own organization, to allow chi-related community packages to
|
|
||||||
be easily discovered and supported, at: https://github.com/go-chi
|
|
||||||
- *NOTE:* please update your import paths to `"github.com/go-chi/chi"`
|
|
||||||
- *NOTE:* chi v2 is still available at https://github.com/go-chi/chi/tree/v2
|
|
||||||
|
|
||||||
|
|
||||||
## v2.1.0 (2017-03-30)
|
|
||||||
|
|
||||||
- Minor improvements and update to the chi core library
|
|
||||||
- Introduced a brand new `chi/render` sub-package to complete the story of building
|
|
||||||
APIs to offer a pattern for managing well-defined request / response payloads. Please
|
|
||||||
check out the updated `_examples/rest` example for how it works.
|
|
||||||
- Added `MethodNotAllowed(h http.HandlerFunc)` to chi.Router interface
|
|
||||||
|
|
||||||
|
|
||||||
## v2.0.0 (2017-01-06)
|
|
||||||
|
|
||||||
- After many months of v2 being in an RC state with many companies and users running it in
|
|
||||||
production, the inclusion of some improvements to the middlewares, we are very pleased to
|
|
||||||
announce v2.0.0 of chi.
|
|
||||||
|
|
||||||
|
|
||||||
## v2.0.0-rc1 (2016-07-26)
|
|
||||||
|
|
||||||
- Huge update! chi v2 is a large refactor targeting Go 1.7+. As of Go 1.7, the popular
|
|
||||||
community `"net/context"` package has been included in the standard library as `"context"` and
|
|
||||||
utilized by `"net/http"` and `http.Request` to managing deadlines, cancelation signals and other
|
|
||||||
request-scoped values. We're very excited about the new context addition and are proud to
|
|
||||||
introduce chi v2, a minimal and powerful routing package for building large HTTP services,
|
|
||||||
with zero external dependencies. Chi focuses on idiomatic design and encourages the use of
|
|
||||||
stdlib HTTP handlers and middlewares.
|
|
||||||
- chi v2 deprecates its `chi.Handler` interface and requires `http.Handler` or `http.HandlerFunc`
|
|
||||||
- chi v2 stores URL routing parameters and patterns in the standard request context: `r.Context()`
|
|
||||||
- chi v2 lower-level routing context is accessible by `chi.RouteContext(r.Context()) *chi.Context`,
|
|
||||||
which provides direct access to URL routing parameters, the routing path and the matching
|
|
||||||
routing patterns.
|
|
||||||
- Users upgrading from chi v1 to v2, need to:
|
|
||||||
1. Update the old chi.Handler signature, `func(ctx context.Context, w http.ResponseWriter, r *http.Request)` to
|
|
||||||
the standard http.Handler: `func(w http.ResponseWriter, r *http.Request)`
|
|
||||||
2. Use `chi.URLParam(r *http.Request, paramKey string) string`
|
|
||||||
or `URLParamFromCtx(ctx context.Context, paramKey string) string` to access a url parameter value
|
|
||||||
|
|
||||||
|
|
||||||
## v1.0.0 (2016-07-01)
|
|
||||||
|
|
||||||
- Released chi v1 stable https://github.com/go-chi/chi/tree/v1.0.0 for Go 1.6 and older.
|
|
||||||
|
|
||||||
|
|
||||||
## v0.9.0 (2016-03-31)
|
|
||||||
|
|
||||||
- Reuse context objects via sync.Pool for zero-allocation routing [#33](https://github.com/go-chi/chi/pull/33)
|
|
||||||
- BREAKING NOTE: due to subtle API changes, previously `chi.URLParams(ctx)["id"]` used to access url parameters
|
|
||||||
has changed to: `chi.URLParam(ctx, "id")`
|
|
||||||
31
vendor/github.com/go-chi/chi/v5/CONTRIBUTING.md
generated
vendored
31
vendor/github.com/go-chi/chi/v5/CONTRIBUTING.md
generated
vendored
@@ -1,31 +0,0 @@
|
|||||||
# Contributing
|
|
||||||
|
|
||||||
## Prerequisites
|
|
||||||
|
|
||||||
1. [Install Go][go-install].
|
|
||||||
2. Download the sources and switch the working directory:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
go get -u -d github.com/go-chi/chi
|
|
||||||
cd $GOPATH/src/github.com/go-chi/chi
|
|
||||||
```
|
|
||||||
|
|
||||||
## Submitting a Pull Request
|
|
||||||
|
|
||||||
A typical workflow is:
|
|
||||||
|
|
||||||
1. [Fork the repository.][fork]
|
|
||||||
2. [Create a topic branch.][branch]
|
|
||||||
3. Add tests for your change.
|
|
||||||
4. Run `go test`. If your tests pass, return to the step 3.
|
|
||||||
5. Implement the change and ensure the steps from the previous step pass.
|
|
||||||
6. Run `goimports -w .`, to ensure the new code conforms to Go formatting guideline.
|
|
||||||
7. [Add, commit and push your changes.][git-help]
|
|
||||||
8. [Submit a pull request.][pull-req]
|
|
||||||
|
|
||||||
[go-install]: https://golang.org/doc/install
|
|
||||||
[fork]: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo
|
|
||||||
[branch]: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-branches
|
|
||||||
[git-help]: https://docs.github.com/en
|
|
||||||
[pull-req]: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests
|
|
||||||
|
|
||||||
20
vendor/github.com/go-chi/chi/v5/LICENSE
generated
vendored
20
vendor/github.com/go-chi/chi/v5/LICENSE
generated
vendored
@@ -1,20 +0,0 @@
|
|||||||
Copyright (c) 2015-present Peter Kieltyka (https://github.com/pkieltyka), Google Inc.
|
|
||||||
|
|
||||||
MIT License
|
|
||||||
|
|
||||||
Permission is hereby granted, free of charge, to any person obtaining a copy of
|
|
||||||
this software and associated documentation files (the "Software"), to deal in
|
|
||||||
the Software without restriction, including without limitation the rights to
|
|
||||||
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
|
||||||
the Software, and to permit persons to whom the Software is furnished to do so,
|
|
||||||
subject to the following conditions:
|
|
||||||
|
|
||||||
The above copyright notice and this permission notice shall be included in all
|
|
||||||
copies or substantial portions of the Software.
|
|
||||||
|
|
||||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
||||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
|
||||||
FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
|
||||||
COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
|
||||||
IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
|
||||||
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
||||||
22
vendor/github.com/go-chi/chi/v5/Makefile
generated
vendored
22
vendor/github.com/go-chi/chi/v5/Makefile
generated
vendored
@@ -1,22 +0,0 @@
|
|||||||
.PHONY: all
|
|
||||||
all:
|
|
||||||
@echo "**********************************************************"
|
|
||||||
@echo "** chi build tool **"
|
|
||||||
@echo "**********************************************************"
|
|
||||||
|
|
||||||
|
|
||||||
.PHONY: test
|
|
||||||
test:
|
|
||||||
go clean -testcache && $(MAKE) test-router && $(MAKE) test-middleware
|
|
||||||
|
|
||||||
.PHONY: test-router
|
|
||||||
test-router:
|
|
||||||
go test -race -v .
|
|
||||||
|
|
||||||
.PHONY: test-middleware
|
|
||||||
test-middleware:
|
|
||||||
go test -race -v ./middleware
|
|
||||||
|
|
||||||
.PHONY: docs
|
|
||||||
docs:
|
|
||||||
npx docsify-cli serve ./docs
|
|
||||||
505
vendor/github.com/go-chi/chi/v5/README.md
generated
vendored
505
vendor/github.com/go-chi/chi/v5/README.md
generated
vendored
@@ -1,505 +0,0 @@
|
|||||||
# <img alt="chi" src="https://cdn.rawgit.com/go-chi/chi/master/_examples/chi.svg" width="220" />
|
|
||||||
|
|
||||||
|
|
||||||
[![GoDoc Widget]][GoDoc]
|
|
||||||
|
|
||||||
`chi` is a lightweight, idiomatic and composable router for building Go HTTP services. It's
|
|
||||||
especially good at helping you write large REST API services that are kept maintainable as your
|
|
||||||
project grows and changes. `chi` is built on the new `context` package introduced in Go 1.7 to
|
|
||||||
handle signaling, cancelation and request-scoped values across a handler chain.
|
|
||||||
|
|
||||||
The focus of the project has been to seek out an elegant and comfortable design for writing
|
|
||||||
REST API servers, written during the development of the Pressly API service that powers our
|
|
||||||
public API service, which in turn powers all of our client-side applications.
|
|
||||||
|
|
||||||
The key considerations of chi's design are: project structure, maintainability, standard http
|
|
||||||
handlers (stdlib-only), developer productivity, and deconstructing a large system into many small
|
|
||||||
parts. The core router `github.com/go-chi/chi` is quite small (less than 1000 LOC), but we've also
|
|
||||||
included some useful/optional subpackages: [middleware](/middleware), [render](https://github.com/go-chi/render)
|
|
||||||
and [docgen](https://github.com/go-chi/docgen). We hope you enjoy it too!
|
|
||||||
|
|
||||||
## Install
|
|
||||||
|
|
||||||
```sh
|
|
||||||
go get -u github.com/go-chi/chi/v5
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
## Features
|
|
||||||
|
|
||||||
* **Lightweight** - cloc'd in ~1000 LOC for the chi router
|
|
||||||
* **Fast** - yes, see [benchmarks](#benchmarks)
|
|
||||||
* **100% compatible with net/http** - use any http or middleware pkg in the ecosystem that is also compatible with `net/http`
|
|
||||||
* **Designed for modular/composable APIs** - middlewares, inline middlewares, route groups and sub-router mounting
|
|
||||||
* **Context control** - built on new `context` package, providing value chaining, cancellations and timeouts
|
|
||||||
* **Robust** - in production at Pressly, Cloudflare, Heroku, 99Designs, and many others (see [discussion](https://github.com/go-chi/chi/issues/91))
|
|
||||||
* **Doc generation** - `docgen` auto-generates routing documentation from your source to JSON or Markdown
|
|
||||||
* **Go.mod support** - as of v5, go.mod support (see [CHANGELOG](https://github.com/go-chi/chi/blob/master/CHANGELOG.md))
|
|
||||||
* **No external dependencies** - plain ol' Go stdlib + net/http
|
|
||||||
|
|
||||||
|
|
||||||
## Examples
|
|
||||||
|
|
||||||
See [_examples/](https://github.com/go-chi/chi/blob/master/_examples/) for a variety of examples.
|
|
||||||
|
|
||||||
|
|
||||||
**As easy as:**
|
|
||||||
|
|
||||||
```go
|
|
||||||
package main
|
|
||||||
|
|
||||||
import (
|
|
||||||
"net/http"
|
|
||||||
|
|
||||||
"github.com/go-chi/chi/v5"
|
|
||||||
"github.com/go-chi/chi/v5/middleware"
|
|
||||||
)
|
|
||||||
|
|
||||||
func main() {
|
|
||||||
r := chi.NewRouter()
|
|
||||||
r.Use(middleware.Logger)
|
|
||||||
r.Get("/", func(w http.ResponseWriter, r *http.Request) {
|
|
||||||
w.Write([]byte("welcome"))
|
|
||||||
})
|
|
||||||
http.ListenAndServe(":3000", r)
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
**REST Preview:**
|
|
||||||
|
|
||||||
Here is a little preview of what routing looks like with chi. Also take a look at the generated routing docs
|
|
||||||
in JSON ([routes.json](https://github.com/go-chi/chi/blob/master/_examples/rest/routes.json)) and in
|
|
||||||
Markdown ([routes.md](https://github.com/go-chi/chi/blob/master/_examples/rest/routes.md)).
|
|
||||||
|
|
||||||
I highly recommend reading the source of the [examples](https://github.com/go-chi/chi/blob/master/_examples/) listed
|
|
||||||
above, they will show you all the features of chi and serve as a good form of documentation.
|
|
||||||
|
|
||||||
```go
|
|
||||||
import (
|
|
||||||
//...
|
|
||||||
"context"
|
|
||||||
"github.com/go-chi/chi/v5"
|
|
||||||
"github.com/go-chi/chi/v5/middleware"
|
|
||||||
)
|
|
||||||
|
|
||||||
func main() {
|
|
||||||
r := chi.NewRouter()
|
|
||||||
|
|
||||||
// A good base middleware stack
|
|
||||||
r.Use(middleware.RequestID)
|
|
||||||
r.Use(middleware.RealIP)
|
|
||||||
r.Use(middleware.Logger)
|
|
||||||
r.Use(middleware.Recoverer)
|
|
||||||
|
|
||||||
// Set a timeout value on the request context (ctx), that will signal
|
|
||||||
// through ctx.Done() that the request has timed out and further
|
|
||||||
// processing should be stopped.
|
|
||||||
r.Use(middleware.Timeout(60 * time.Second))
|
|
||||||
|
|
||||||
r.Get("/", func(w http.ResponseWriter, r *http.Request) {
|
|
||||||
w.Write([]byte("hi"))
|
|
||||||
})
|
|
||||||
|
|
||||||
// RESTy routes for "articles" resource
|
|
||||||
r.Route("/articles", func(r chi.Router) {
|
|
||||||
r.With(paginate).Get("/", listArticles) // GET /articles
|
|
||||||
r.With(paginate).Get("/{month}-{day}-{year}", listArticlesByDate) // GET /articles/01-16-2017
|
|
||||||
|
|
||||||
r.Post("/", createArticle) // POST /articles
|
|
||||||
r.Get("/search", searchArticles) // GET /articles/search
|
|
||||||
|
|
||||||
// Regexp url parameters:
|
|
||||||
r.Get("/{articleSlug:[a-z-]+}", getArticleBySlug) // GET /articles/home-is-toronto
|
|
||||||
|
|
||||||
// Subrouters:
|
|
||||||
r.Route("/{articleID}", func(r chi.Router) {
|
|
||||||
r.Use(ArticleCtx)
|
|
||||||
r.Get("/", getArticle) // GET /articles/123
|
|
||||||
r.Put("/", updateArticle) // PUT /articles/123
|
|
||||||
r.Delete("/", deleteArticle) // DELETE /articles/123
|
|
||||||
})
|
|
||||||
})
|
|
||||||
|
|
||||||
// Mount the admin sub-router
|
|
||||||
r.Mount("/admin", adminRouter())
|
|
||||||
|
|
||||||
http.ListenAndServe(":3333", r)
|
|
||||||
}
|
|
||||||
|
|
||||||
func ArticleCtx(next http.Handler) http.Handler {
|
|
||||||
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
|
||||||
articleID := chi.URLParam(r, "articleID")
|
|
||||||
article, err := dbGetArticle(articleID)
|
|
||||||
if err != nil {
|
|
||||||
http.Error(w, http.StatusText(404), 404)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
ctx := context.WithValue(r.Context(), "article", article)
|
|
||||||
next.ServeHTTP(w, r.WithContext(ctx))
|
|
||||||
})
|
|
||||||
}
|
|
||||||
|
|
||||||
func getArticle(w http.ResponseWriter, r *http.Request) {
|
|
||||||
ctx := r.Context()
|
|
||||||
article, ok := ctx.Value("article").(*Article)
|
|
||||||
if !ok {
|
|
||||||
http.Error(w, http.StatusText(422), 422)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
w.Write([]byte(fmt.Sprintf("title:%s", article.Title)))
|
|
||||||
}
|
|
||||||
|
|
||||||
// A completely separate router for administrator routes
|
|
||||||
func adminRouter() http.Handler {
|
|
||||||
r := chi.NewRouter()
|
|
||||||
r.Use(AdminOnly)
|
|
||||||
r.Get("/", adminIndex)
|
|
||||||
r.Get("/accounts", adminListAccounts)
|
|
||||||
return r
|
|
||||||
}
|
|
||||||
|
|
||||||
func AdminOnly(next http.Handler) http.Handler {
|
|
||||||
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
|
||||||
ctx := r.Context()
|
|
||||||
perm, ok := ctx.Value("acl.permission").(YourPermissionType)
|
|
||||||
if !ok || !perm.IsAdmin() {
|
|
||||||
http.Error(w, http.StatusText(403), 403)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
next.ServeHTTP(w, r)
|
|
||||||
})
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
## Router interface
|
|
||||||
|
|
||||||
chi's router is based on a kind of [Patricia Radix trie](https://en.wikipedia.org/wiki/Radix_tree).
|
|
||||||
The router is fully compatible with `net/http`.
|
|
||||||
|
|
||||||
Built on top of the tree is the `Router` interface:
|
|
||||||
|
|
||||||
```go
|
|
||||||
// Router consisting of the core routing methods used by chi's Mux,
|
|
||||||
// using only the standard net/http.
|
|
||||||
type Router interface {
|
|
||||||
http.Handler
|
|
||||||
Routes
|
|
||||||
|
|
||||||
// Use appends one or more middlewares onto the Router stack.
|
|
||||||
Use(middlewares ...func(http.Handler) http.Handler)
|
|
||||||
|
|
||||||
// With adds inline middlewares for an endpoint handler.
|
|
||||||
With(middlewares ...func(http.Handler) http.Handler) Router
|
|
||||||
|
|
||||||
// Group adds a new inline-Router along the current routing
|
|
||||||
// path, with a fresh middleware stack for the inline-Router.
|
|
||||||
Group(fn func(r Router)) Router
|
|
||||||
|
|
||||||
// Route mounts a sub-Router along a `pattern` string.
|
|
||||||
Route(pattern string, fn func(r Router)) Router
|
|
||||||
|
|
||||||
// Mount attaches another http.Handler along ./pattern/*
|
|
||||||
Mount(pattern string, h http.Handler)
|
|
||||||
|
|
||||||
// Handle and HandleFunc adds routes for `pattern` that matches
|
|
||||||
// all HTTP methods.
|
|
||||||
Handle(pattern string, h http.Handler)
|
|
||||||
HandleFunc(pattern string, h http.HandlerFunc)
|
|
||||||
|
|
||||||
// Method and MethodFunc adds routes for `pattern` that matches
|
|
||||||
// the `method` HTTP method.
|
|
||||||
Method(method, pattern string, h http.Handler)
|
|
||||||
MethodFunc(method, pattern string, h http.HandlerFunc)
|
|
||||||
|
|
||||||
// HTTP-method routing along `pattern`
|
|
||||||
Connect(pattern string, h http.HandlerFunc)
|
|
||||||
Delete(pattern string, h http.HandlerFunc)
|
|
||||||
Get(pattern string, h http.HandlerFunc)
|
|
||||||
Head(pattern string, h http.HandlerFunc)
|
|
||||||
Options(pattern string, h http.HandlerFunc)
|
|
||||||
Patch(pattern string, h http.HandlerFunc)
|
|
||||||
Post(pattern string, h http.HandlerFunc)
|
|
||||||
Put(pattern string, h http.HandlerFunc)
|
|
||||||
Trace(pattern string, h http.HandlerFunc)
|
|
||||||
|
|
||||||
// NotFound defines a handler to respond whenever a route could
|
|
||||||
// not be found.
|
|
||||||
NotFound(h http.HandlerFunc)
|
|
||||||
|
|
||||||
// MethodNotAllowed defines a handler to respond whenever a method is
|
|
||||||
// not allowed.
|
|
||||||
MethodNotAllowed(h http.HandlerFunc)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Routes interface adds two methods for router traversal, which is also
|
|
||||||
// used by the github.com/go-chi/docgen package to generate documentation for Routers.
|
|
||||||
type Routes interface {
|
|
||||||
// Routes returns the routing tree in an easily traversable structure.
|
|
||||||
Routes() []Route
|
|
||||||
|
|
||||||
// Middlewares returns the list of middlewares in use by the router.
|
|
||||||
Middlewares() Middlewares
|
|
||||||
|
|
||||||
// Match searches the routing tree for a handler that matches
|
|
||||||
// the method/path - similar to routing a http request, but without
|
|
||||||
// executing the handler thereafter.
|
|
||||||
Match(rctx *Context, method, path string) bool
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Each routing method accepts a URL `pattern` and chain of `handlers`. The URL pattern
|
|
||||||
supports named params (ie. `/users/{userID}`) and wildcards (ie. `/admin/*`). URL parameters
|
|
||||||
can be fetched at runtime by calling `chi.URLParam(r, "userID")` for named parameters
|
|
||||||
and `chi.URLParam(r, "*")` for a wildcard parameter.
|
|
||||||
|
|
||||||
|
|
||||||
### Middleware handlers
|
|
||||||
|
|
||||||
chi's middlewares are just stdlib net/http middleware handlers. There is nothing special
|
|
||||||
about them, which means the router and all the tooling is designed to be compatible and
|
|
||||||
friendly with any middleware in the community. This offers much better extensibility and reuse
|
|
||||||
of packages and is at the heart of chi's purpose.
|
|
||||||
|
|
||||||
Here is an example of a standard net/http middleware where we assign a context key `"user"`
|
|
||||||
the value of `"123"`. This middleware sets a hypothetical user identifier on the request
|
|
||||||
context and calls the next handler in the chain.
|
|
||||||
|
|
||||||
```go
|
|
||||||
// HTTP middleware setting a value on the request context
|
|
||||||
func MyMiddleware(next http.Handler) http.Handler {
|
|
||||||
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
|
||||||
// create new context from `r` request context, and assign key `"user"`
|
|
||||||
// to value of `"123"`
|
|
||||||
ctx := context.WithValue(r.Context(), "user", "123")
|
|
||||||
|
|
||||||
// call the next handler in the chain, passing the response writer and
|
|
||||||
// the updated request object with the new context value.
|
|
||||||
//
|
|
||||||
// note: context.Context values are nested, so any previously set
|
|
||||||
// values will be accessible as well, and the new `"user"` key
|
|
||||||
// will be accessible from this point forward.
|
|
||||||
next.ServeHTTP(w, r.WithContext(ctx))
|
|
||||||
})
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
### Request handlers
|
|
||||||
|
|
||||||
chi uses standard net/http request handlers. This little snippet is an example of a http.Handler
|
|
||||||
func that reads a user identifier from the request context - hypothetically, identifying
|
|
||||||
the user sending an authenticated request, validated+set by a previous middleware handler.
|
|
||||||
|
|
||||||
```go
|
|
||||||
// HTTP handler accessing data from the request context.
|
|
||||||
func MyRequestHandler(w http.ResponseWriter, r *http.Request) {
|
|
||||||
// here we read from the request context and fetch out `"user"` key set in
|
|
||||||
// the MyMiddleware example above.
|
|
||||||
user := r.Context().Value("user").(string)
|
|
||||||
|
|
||||||
// respond to the client
|
|
||||||
w.Write([]byte(fmt.Sprintf("hi %s", user)))
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
### URL parameters
|
|
||||||
|
|
||||||
chi's router parses and stores URL parameters right onto the request context. Here is
|
|
||||||
an example of how to access URL params in your net/http handlers. And of course, middlewares
|
|
||||||
are able to access the same information.
|
|
||||||
|
|
||||||
```go
|
|
||||||
// HTTP handler accessing the url routing parameters.
|
|
||||||
func MyRequestHandler(w http.ResponseWriter, r *http.Request) {
|
|
||||||
// fetch the url parameter `"userID"` from the request of a matching
|
|
||||||
// routing pattern. An example routing pattern could be: /users/{userID}
|
|
||||||
userID := chi.URLParam(r, "userID")
|
|
||||||
|
|
||||||
// fetch `"key"` from the request context
|
|
||||||
ctx := r.Context()
|
|
||||||
key := ctx.Value("key").(string)
|
|
||||||
|
|
||||||
// respond to the client
|
|
||||||
w.Write([]byte(fmt.Sprintf("hi %v, %v", userID, key)))
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
## Middlewares
|
|
||||||
|
|
||||||
chi comes equipped with an optional `middleware` package, providing a suite of standard
|
|
||||||
`net/http` middlewares. Please note, any middleware in the ecosystem that is also compatible
|
|
||||||
with `net/http` can be used with chi's mux.
|
|
||||||
|
|
||||||
### Core middlewares
|
|
||||||
|
|
||||||
----------------------------------------------------------------------------------------------------
|
|
||||||
| chi/middleware Handler | description |
|
|
||||||
| :--------------------- | :---------------------------------------------------------------------- |
|
|
||||||
| [AllowContentEncoding] | Enforces a whitelist of request Content-Encoding headers |
|
|
||||||
| [AllowContentType] | Explicit whitelist of accepted request Content-Types |
|
|
||||||
| [BasicAuth] | Basic HTTP authentication |
|
|
||||||
| [Compress] | Gzip compression for clients that accept compressed responses |
|
|
||||||
| [ContentCharset] | Ensure charset for Content-Type request headers |
|
|
||||||
| [CleanPath] | Clean double slashes from request path |
|
|
||||||
| [GetHead] | Automatically route undefined HEAD requests to GET handlers |
|
|
||||||
| [Heartbeat] | Monitoring endpoint to check the servers pulse |
|
|
||||||
| [Logger] | Logs the start and end of each request with the elapsed processing time |
|
|
||||||
| [NoCache] | Sets response headers to prevent clients from caching |
|
|
||||||
| [Profiler] | Easily attach net/http/pprof to your routers |
|
|
||||||
| [RealIP] | Sets a http.Request's RemoteAddr to either X-Real-IP or X-Forwarded-For |
|
|
||||||
| [Recoverer] | Gracefully absorb panics and prints the stack trace |
|
|
||||||
| [RequestID] | Injects a request ID into the context of each request |
|
|
||||||
| [RedirectSlashes] | Redirect slashes on routing paths |
|
|
||||||
| [RouteHeaders] | Route handling for request headers |
|
|
||||||
| [SetHeader] | Short-hand middleware to set a response header key/value |
|
|
||||||
| [StripSlashes] | Strip slashes on routing paths |
|
|
||||||
| [Sunset] | Sunset set Deprecation/Sunset header to response |
|
|
||||||
| [Throttle] | Puts a ceiling on the number of concurrent requests |
|
|
||||||
| [Timeout] | Signals to the request context when the timeout deadline is reached |
|
|
||||||
| [URLFormat] | Parse extension from url and put it on request context |
|
|
||||||
| [WithValue] | Short-hand middleware to set a key/value on the request context |
|
|
||||||
----------------------------------------------------------------------------------------------------
|
|
||||||
|
|
||||||
[AllowContentEncoding]: https://pkg.go.dev/github.com/go-chi/chi/middleware#AllowContentEncoding
|
|
||||||
[AllowContentType]: https://pkg.go.dev/github.com/go-chi/chi/middleware#AllowContentType
|
|
||||||
[BasicAuth]: https://pkg.go.dev/github.com/go-chi/chi/middleware#BasicAuth
|
|
||||||
[Compress]: https://pkg.go.dev/github.com/go-chi/chi/middleware#Compress
|
|
||||||
[ContentCharset]: https://pkg.go.dev/github.com/go-chi/chi/middleware#ContentCharset
|
|
||||||
[CleanPath]: https://pkg.go.dev/github.com/go-chi/chi/middleware#CleanPath
|
|
||||||
[GetHead]: https://pkg.go.dev/github.com/go-chi/chi/middleware#GetHead
|
|
||||||
[GetReqID]: https://pkg.go.dev/github.com/go-chi/chi/middleware#GetReqID
|
|
||||||
[Heartbeat]: https://pkg.go.dev/github.com/go-chi/chi/middleware#Heartbeat
|
|
||||||
[Logger]: https://pkg.go.dev/github.com/go-chi/chi/middleware#Logger
|
|
||||||
[NoCache]: https://pkg.go.dev/github.com/go-chi/chi/middleware#NoCache
|
|
||||||
[Profiler]: https://pkg.go.dev/github.com/go-chi/chi/middleware#Profiler
|
|
||||||
[RealIP]: https://pkg.go.dev/github.com/go-chi/chi/middleware#RealIP
|
|
||||||
[Recoverer]: https://pkg.go.dev/github.com/go-chi/chi/middleware#Recoverer
|
|
||||||
[RedirectSlashes]: https://pkg.go.dev/github.com/go-chi/chi/middleware#RedirectSlashes
|
|
||||||
[RequestLogger]: https://pkg.go.dev/github.com/go-chi/chi/middleware#RequestLogger
|
|
||||||
[RequestID]: https://pkg.go.dev/github.com/go-chi/chi/middleware#RequestID
|
|
||||||
[RouteHeaders]: https://pkg.go.dev/github.com/go-chi/chi/middleware#RouteHeaders
|
|
||||||
[SetHeader]: https://pkg.go.dev/github.com/go-chi/chi/middleware#SetHeader
|
|
||||||
[StripSlashes]: https://pkg.go.dev/github.com/go-chi/chi/middleware#StripSlashes
|
|
||||||
[Sunset]: https://pkg.go.dev/github.com/go-chi/chi/v5/middleware#Sunset
|
|
||||||
[Throttle]: https://pkg.go.dev/github.com/go-chi/chi/middleware#Throttle
|
|
||||||
[ThrottleBacklog]: https://pkg.go.dev/github.com/go-chi/chi/middleware#ThrottleBacklog
|
|
||||||
[ThrottleWithOpts]: https://pkg.go.dev/github.com/go-chi/chi/middleware#ThrottleWithOpts
|
|
||||||
[Timeout]: https://pkg.go.dev/github.com/go-chi/chi/middleware#Timeout
|
|
||||||
[URLFormat]: https://pkg.go.dev/github.com/go-chi/chi/middleware#URLFormat
|
|
||||||
[WithLogEntry]: https://pkg.go.dev/github.com/go-chi/chi/middleware#WithLogEntry
|
|
||||||
[WithValue]: https://pkg.go.dev/github.com/go-chi/chi/middleware#WithValue
|
|
||||||
[Compressor]: https://pkg.go.dev/github.com/go-chi/chi/middleware#Compressor
|
|
||||||
[DefaultLogFormatter]: https://pkg.go.dev/github.com/go-chi/chi/middleware#DefaultLogFormatter
|
|
||||||
[EncoderFunc]: https://pkg.go.dev/github.com/go-chi/chi/middleware#EncoderFunc
|
|
||||||
[HeaderRoute]: https://pkg.go.dev/github.com/go-chi/chi/middleware#HeaderRoute
|
|
||||||
[HeaderRouter]: https://pkg.go.dev/github.com/go-chi/chi/middleware#HeaderRouter
|
|
||||||
[LogEntry]: https://pkg.go.dev/github.com/go-chi/chi/middleware#LogEntry
|
|
||||||
[LogFormatter]: https://pkg.go.dev/github.com/go-chi/chi/middleware#LogFormatter
|
|
||||||
[LoggerInterface]: https://pkg.go.dev/github.com/go-chi/chi/middleware#LoggerInterface
|
|
||||||
[ThrottleOpts]: https://pkg.go.dev/github.com/go-chi/chi/middleware#ThrottleOpts
|
|
||||||
[WrapResponseWriter]: https://pkg.go.dev/github.com/go-chi/chi/middleware#WrapResponseWriter
|
|
||||||
|
|
||||||
### Extra middlewares & packages
|
|
||||||
|
|
||||||
Please see https://github.com/go-chi for additional packages.
|
|
||||||
|
|
||||||
--------------------------------------------------------------------------------------------------------------------
|
|
||||||
| package | description |
|
|
||||||
|:---------------------------------------------------|:-------------------------------------------------------------
|
|
||||||
| [cors](https://github.com/go-chi/cors) | Cross-origin resource sharing (CORS) |
|
|
||||||
| [docgen](https://github.com/go-chi/docgen) | Print chi.Router routes at runtime |
|
|
||||||
| [jwtauth](https://github.com/go-chi/jwtauth) | JWT authentication |
|
|
||||||
| [hostrouter](https://github.com/go-chi/hostrouter) | Domain/host based request routing |
|
|
||||||
| [httplog](https://github.com/go-chi/httplog) | Small but powerful structured HTTP request logging |
|
|
||||||
| [httprate](https://github.com/go-chi/httprate) | HTTP request rate limiter |
|
|
||||||
| [httptracer](https://github.com/go-chi/httptracer) | HTTP request performance tracing library |
|
|
||||||
| [httpvcr](https://github.com/go-chi/httpvcr) | Write deterministic tests for external sources |
|
|
||||||
| [stampede](https://github.com/go-chi/stampede) | HTTP request coalescer |
|
|
||||||
--------------------------------------------------------------------------------------------------------------------
|
|
||||||
|
|
||||||
|
|
||||||
## context?
|
|
||||||
|
|
||||||
`context` is a tiny pkg that provides simple interface to signal context across call stacks
|
|
||||||
and goroutines. It was originally written by [Sameer Ajmani](https://github.com/Sajmani)
|
|
||||||
and is available in stdlib since go1.7.
|
|
||||||
|
|
||||||
Learn more at https://blog.golang.org/context
|
|
||||||
|
|
||||||
and..
|
|
||||||
* Docs: https://golang.org/pkg/context
|
|
||||||
* Source: https://github.com/golang/go/tree/master/src/context
|
|
||||||
|
|
||||||
|
|
||||||
## Benchmarks
|
|
||||||
|
|
||||||
The benchmark suite: https://github.com/pkieltyka/go-http-routing-benchmark
|
|
||||||
|
|
||||||
Results as of Nov 29, 2020 with Go 1.15.5 on Linux AMD 3950x
|
|
||||||
|
|
||||||
```shell
|
|
||||||
BenchmarkChi_Param 3075895 384 ns/op 400 B/op 2 allocs/op
|
|
||||||
BenchmarkChi_Param5 2116603 566 ns/op 400 B/op 2 allocs/op
|
|
||||||
BenchmarkChi_Param20 964117 1227 ns/op 400 B/op 2 allocs/op
|
|
||||||
BenchmarkChi_ParamWrite 2863413 420 ns/op 400 B/op 2 allocs/op
|
|
||||||
BenchmarkChi_GithubStatic 3045488 395 ns/op 400 B/op 2 allocs/op
|
|
||||||
BenchmarkChi_GithubParam 2204115 540 ns/op 400 B/op 2 allocs/op
|
|
||||||
BenchmarkChi_GithubAll 10000 113811 ns/op 81203 B/op 406 allocs/op
|
|
||||||
BenchmarkChi_GPlusStatic 3337485 359 ns/op 400 B/op 2 allocs/op
|
|
||||||
BenchmarkChi_GPlusParam 2825853 423 ns/op 400 B/op 2 allocs/op
|
|
||||||
BenchmarkChi_GPlus2Params 2471697 483 ns/op 400 B/op 2 allocs/op
|
|
||||||
BenchmarkChi_GPlusAll 194220 5950 ns/op 5200 B/op 26 allocs/op
|
|
||||||
BenchmarkChi_ParseStatic 3365324 356 ns/op 400 B/op 2 allocs/op
|
|
||||||
BenchmarkChi_ParseParam 2976614 404 ns/op 400 B/op 2 allocs/op
|
|
||||||
BenchmarkChi_Parse2Params 2638084 439 ns/op 400 B/op 2 allocs/op
|
|
||||||
BenchmarkChi_ParseAll 109567 11295 ns/op 10400 B/op 52 allocs/op
|
|
||||||
BenchmarkChi_StaticAll 16846 71308 ns/op 62802 B/op 314 allocs/op
|
|
||||||
```
|
|
||||||
|
|
||||||
Comparison with other routers: https://gist.github.com/pkieltyka/123032f12052520aaccab752bd3e78cc
|
|
||||||
|
|
||||||
NOTE: the allocs in the benchmark above are from the calls to http.Request's
|
|
||||||
`WithContext(context.Context)` method that clones the http.Request, sets the `Context()`
|
|
||||||
on the duplicated (alloc'd) request and returns it the new request object. This is just
|
|
||||||
how setting context on a request in Go works.
|
|
||||||
|
|
||||||
|
|
||||||
## Credits
|
|
||||||
|
|
||||||
* Carl Jackson for https://github.com/zenazn/goji
|
|
||||||
* Parts of chi's thinking comes from goji, and chi's middleware package
|
|
||||||
sources from [goji](https://github.com/zenazn/goji/tree/master/web/middleware).
|
|
||||||
* Please see goji's [LICENSE](https://github.com/zenazn/goji/blob/master/LICENSE) (MIT)
|
|
||||||
* Armon Dadgar for https://github.com/armon/go-radix
|
|
||||||
* Contributions: [@VojtechVitek](https://github.com/VojtechVitek)
|
|
||||||
|
|
||||||
We'll be more than happy to see [your contributions](./CONTRIBUTING.md)!
|
|
||||||
|
|
||||||
|
|
||||||
## Beyond REST
|
|
||||||
|
|
||||||
chi is just a http router that lets you decompose request handling into many smaller layers.
|
|
||||||
Many companies use chi to write REST services for their public APIs. But, REST is just a convention
|
|
||||||
for managing state via HTTP, and there's a lot of other pieces required to write a complete client-server
|
|
||||||
system or network of microservices.
|
|
||||||
|
|
||||||
Looking beyond REST, I also recommend some newer works in the field:
|
|
||||||
* [webrpc](https://github.com/webrpc/webrpc) - Web-focused RPC client+server framework with code-gen
|
|
||||||
* [gRPC](https://github.com/grpc/grpc-go) - Google's RPC framework via protobufs
|
|
||||||
* [graphql](https://github.com/99designs/gqlgen) - Declarative query language
|
|
||||||
* [NATS](https://nats.io) - lightweight pub-sub
|
|
||||||
|
|
||||||
|
|
||||||
## License
|
|
||||||
|
|
||||||
Copyright (c) 2015-present [Peter Kieltyka](https://github.com/pkieltyka)
|
|
||||||
|
|
||||||
Licensed under [MIT License](./LICENSE)
|
|
||||||
|
|
||||||
[GoDoc]: https://pkg.go.dev/github.com/go-chi/chi/v5
|
|
||||||
[GoDoc Widget]: https://godoc.org/github.com/go-chi/chi?status.svg
|
|
||||||
[Travis]: https://travis-ci.org/go-chi/chi
|
|
||||||
[Travis Widget]: https://travis-ci.org/go-chi/chi.svg?branch=master
|
|
||||||
5
vendor/github.com/go-chi/chi/v5/SECURITY.md
generated
vendored
5
vendor/github.com/go-chi/chi/v5/SECURITY.md
generated
vendored
@@ -1,5 +0,0 @@
|
|||||||
# Reporting Security Issues
|
|
||||||
|
|
||||||
We appreciate your efforts to responsibly disclose your findings, and will make every effort to acknowledge your contributions.
|
|
||||||
|
|
||||||
To report a security issue, please use the GitHub Security Advisory ["Report a Vulnerability"](https://github.com/go-chi/chi/security/advisories/new) tab.
|
|
||||||
49
vendor/github.com/go-chi/chi/v5/chain.go
generated
vendored
49
vendor/github.com/go-chi/chi/v5/chain.go
generated
vendored
@@ -1,49 +0,0 @@
|
|||||||
package chi
|
|
||||||
|
|
||||||
import "net/http"
|
|
||||||
|
|
||||||
// Chain returns a Middlewares type from a slice of middleware handlers.
|
|
||||||
func Chain(middlewares ...func(http.Handler) http.Handler) Middlewares {
|
|
||||||
return Middlewares(middlewares)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Handler builds and returns a http.Handler from the chain of middlewares,
|
|
||||||
// with `h http.Handler` as the final handler.
|
|
||||||
func (mws Middlewares) Handler(h http.Handler) http.Handler {
|
|
||||||
return &ChainHandler{h, chain(mws, h), mws}
|
|
||||||
}
|
|
||||||
|
|
||||||
// HandlerFunc builds and returns a http.Handler from the chain of middlewares,
|
|
||||||
// with `h http.Handler` as the final handler.
|
|
||||||
func (mws Middlewares) HandlerFunc(h http.HandlerFunc) http.Handler {
|
|
||||||
return &ChainHandler{h, chain(mws, h), mws}
|
|
||||||
}
|
|
||||||
|
|
||||||
// ChainHandler is a http.Handler with support for handler composition and
|
|
||||||
// execution.
|
|
||||||
type ChainHandler struct {
|
|
||||||
Endpoint http.Handler
|
|
||||||
chain http.Handler
|
|
||||||
Middlewares Middlewares
|
|
||||||
}
|
|
||||||
|
|
||||||
func (c *ChainHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
|
|
||||||
c.chain.ServeHTTP(w, r)
|
|
||||||
}
|
|
||||||
|
|
||||||
// chain builds a http.Handler composed of an inline middleware stack and endpoint
|
|
||||||
// handler in the order they are passed.
|
|
||||||
func chain(middlewares []func(http.Handler) http.Handler, endpoint http.Handler) http.Handler {
|
|
||||||
// Return ahead of time if there aren't any middlewares for the chain
|
|
||||||
if len(middlewares) == 0 {
|
|
||||||
return endpoint
|
|
||||||
}
|
|
||||||
|
|
||||||
// Wrap the end handler with the middleware chain
|
|
||||||
h := middlewares[len(middlewares)-1](endpoint)
|
|
||||||
for i := len(middlewares) - 2; i >= 0; i-- {
|
|
||||||
h = middlewares[i](h)
|
|
||||||
}
|
|
||||||
|
|
||||||
return h
|
|
||||||
}
|
|
||||||
137
vendor/github.com/go-chi/chi/v5/chi.go
generated
vendored
137
vendor/github.com/go-chi/chi/v5/chi.go
generated
vendored
@@ -1,137 +0,0 @@
|
|||||||
// Package chi is a small, idiomatic and composable router for building HTTP services.
|
|
||||||
//
|
|
||||||
// chi requires Go 1.14 or newer.
|
|
||||||
//
|
|
||||||
// Example:
|
|
||||||
//
|
|
||||||
// package main
|
|
||||||
//
|
|
||||||
// import (
|
|
||||||
// "net/http"
|
|
||||||
//
|
|
||||||
// "github.com/go-chi/chi/v5"
|
|
||||||
// "github.com/go-chi/chi/v5/middleware"
|
|
||||||
// )
|
|
||||||
//
|
|
||||||
// func main() {
|
|
||||||
// r := chi.NewRouter()
|
|
||||||
// r.Use(middleware.Logger)
|
|
||||||
// r.Use(middleware.Recoverer)
|
|
||||||
//
|
|
||||||
// r.Get("/", func(w http.ResponseWriter, r *http.Request) {
|
|
||||||
// w.Write([]byte("root."))
|
|
||||||
// })
|
|
||||||
//
|
|
||||||
// http.ListenAndServe(":3333", r)
|
|
||||||
// }
|
|
||||||
//
|
|
||||||
// See github.com/go-chi/chi/_examples/ for more in-depth examples.
|
|
||||||
//
|
|
||||||
// URL patterns allow for easy matching of path components in HTTP
|
|
||||||
// requests. The matching components can then be accessed using
|
|
||||||
// chi.URLParam(). All patterns must begin with a slash.
|
|
||||||
//
|
|
||||||
// A simple named placeholder {name} matches any sequence of characters
|
|
||||||
// up to the next / or the end of the URL. Trailing slashes on paths must
|
|
||||||
// be handled explicitly.
|
|
||||||
//
|
|
||||||
// A placeholder with a name followed by a colon allows a regular
|
|
||||||
// expression match, for example {number:\\d+}. The regular expression
|
|
||||||
// syntax is Go's normal regexp RE2 syntax, except that / will never be
|
|
||||||
// matched. An anonymous regexp pattern is allowed, using an empty string
|
|
||||||
// before the colon in the placeholder, such as {:\\d+}
|
|
||||||
//
|
|
||||||
// The special placeholder of asterisk matches the rest of the requested
|
|
||||||
// URL. Any trailing characters in the pattern are ignored. This is the only
|
|
||||||
// placeholder which will match / characters.
|
|
||||||
//
|
|
||||||
// Examples:
|
|
||||||
//
|
|
||||||
// "/user/{name}" matches "/user/jsmith" but not "/user/jsmith/info" or "/user/jsmith/"
|
|
||||||
// "/user/{name}/info" matches "/user/jsmith/info"
|
|
||||||
// "/page/*" matches "/page/intro/latest"
|
|
||||||
// "/page/{other}/latest" also matches "/page/intro/latest"
|
|
||||||
// "/date/{yyyy:\\d\\d\\d\\d}/{mm:\\d\\d}/{dd:\\d\\d}" matches "/date/2017/04/01"
|
|
||||||
package chi
|
|
||||||
|
|
||||||
import "net/http"
|
|
||||||
|
|
||||||
// NewRouter returns a new Mux object that implements the Router interface.
|
|
||||||
func NewRouter() *Mux {
|
|
||||||
return NewMux()
|
|
||||||
}
|
|
||||||
|
|
||||||
// Router consisting of the core routing methods used by chi's Mux,
|
|
||||||
// using only the standard net/http.
|
|
||||||
type Router interface {
|
|
||||||
http.Handler
|
|
||||||
Routes
|
|
||||||
|
|
||||||
// Use appends one or more middlewares onto the Router stack.
|
|
||||||
Use(middlewares ...func(http.Handler) http.Handler)
|
|
||||||
|
|
||||||
// With adds inline middlewares for an endpoint handler.
|
|
||||||
With(middlewares ...func(http.Handler) http.Handler) Router
|
|
||||||
|
|
||||||
// Group adds a new inline-Router along the current routing
|
|
||||||
// path, with a fresh middleware stack for the inline-Router.
|
|
||||||
Group(fn func(r Router)) Router
|
|
||||||
|
|
||||||
// Route mounts a sub-Router along a `pattern`` string.
|
|
||||||
Route(pattern string, fn func(r Router)) Router
|
|
||||||
|
|
||||||
// Mount attaches another http.Handler along ./pattern/*
|
|
||||||
Mount(pattern string, h http.Handler)
|
|
||||||
|
|
||||||
// Handle and HandleFunc adds routes for `pattern` that matches
|
|
||||||
// all HTTP methods.
|
|
||||||
Handle(pattern string, h http.Handler)
|
|
||||||
HandleFunc(pattern string, h http.HandlerFunc)
|
|
||||||
|
|
||||||
// Method and MethodFunc adds routes for `pattern` that matches
|
|
||||||
// the `method` HTTP method.
|
|
||||||
Method(method, pattern string, h http.Handler)
|
|
||||||
MethodFunc(method, pattern string, h http.HandlerFunc)
|
|
||||||
|
|
||||||
// HTTP-method routing along `pattern`
|
|
||||||
Connect(pattern string, h http.HandlerFunc)
|
|
||||||
Delete(pattern string, h http.HandlerFunc)
|
|
||||||
Get(pattern string, h http.HandlerFunc)
|
|
||||||
Head(pattern string, h http.HandlerFunc)
|
|
||||||
Options(pattern string, h http.HandlerFunc)
|
|
||||||
Patch(pattern string, h http.HandlerFunc)
|
|
||||||
Post(pattern string, h http.HandlerFunc)
|
|
||||||
Put(pattern string, h http.HandlerFunc)
|
|
||||||
Trace(pattern string, h http.HandlerFunc)
|
|
||||||
|
|
||||||
// NotFound defines a handler to respond whenever a route could
|
|
||||||
// not be found.
|
|
||||||
NotFound(h http.HandlerFunc)
|
|
||||||
|
|
||||||
// MethodNotAllowed defines a handler to respond whenever a method is
|
|
||||||
// not allowed.
|
|
||||||
MethodNotAllowed(h http.HandlerFunc)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Routes interface adds two methods for router traversal, which is also
|
|
||||||
// used by the `docgen` subpackage to generation documentation for Routers.
|
|
||||||
type Routes interface {
|
|
||||||
// Routes returns the routing tree in an easily traversable structure.
|
|
||||||
Routes() []Route
|
|
||||||
|
|
||||||
// Middlewares returns the list of middlewares in use by the router.
|
|
||||||
Middlewares() Middlewares
|
|
||||||
|
|
||||||
// Match searches the routing tree for a handler that matches
|
|
||||||
// the method/path - similar to routing a http request, but without
|
|
||||||
// executing the handler thereafter.
|
|
||||||
Match(rctx *Context, method, path string) bool
|
|
||||||
|
|
||||||
// Find searches the routing tree for the pattern that matches
|
|
||||||
// the method/path.
|
|
||||||
Find(rctx *Context, method, path string) string
|
|
||||||
}
|
|
||||||
|
|
||||||
// Middlewares type is a slice of standard middleware handlers with methods
|
|
||||||
// to compose middleware chains and http.Handler's.
|
|
||||||
type Middlewares []func(http.Handler) http.Handler
|
|
||||||
165
vendor/github.com/go-chi/chi/v5/context.go
generated
vendored
165
vendor/github.com/go-chi/chi/v5/context.go
generated
vendored
@@ -1,165 +0,0 @@
|
|||||||
package chi
|
|
||||||
|
|
||||||
import (
|
|
||||||
"context"
|
|
||||||
"net/http"
|
|
||||||
"strings"
|
|
||||||
)
|
|
||||||
|
|
||||||
// URLParam returns the url parameter from a http.Request object.
|
|
||||||
func URLParam(r *http.Request, key string) string {
|
|
||||||
if rctx := RouteContext(r.Context()); rctx != nil {
|
|
||||||
return rctx.URLParam(key)
|
|
||||||
}
|
|
||||||
return ""
|
|
||||||
}
|
|
||||||
|
|
||||||
// URLParamFromCtx returns the url parameter from a http.Request Context.
|
|
||||||
func URLParamFromCtx(ctx context.Context, key string) string {
|
|
||||||
if rctx := RouteContext(ctx); rctx != nil {
|
|
||||||
return rctx.URLParam(key)
|
|
||||||
}
|
|
||||||
return ""
|
|
||||||
}
|
|
||||||
|
|
||||||
// RouteContext returns chi's routing Context object from a
|
|
||||||
// http.Request Context.
|
|
||||||
func RouteContext(ctx context.Context) *Context {
|
|
||||||
val, _ := ctx.Value(RouteCtxKey).(*Context)
|
|
||||||
return val
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewRouteContext returns a new routing Context object.
|
|
||||||
func NewRouteContext() *Context {
|
|
||||||
return &Context{}
|
|
||||||
}
|
|
||||||
|
|
||||||
var (
|
|
||||||
// RouteCtxKey is the context.Context key to store the request context.
|
|
||||||
RouteCtxKey = &contextKey{"RouteContext"}
|
|
||||||
)
|
|
||||||
|
|
||||||
// Context is the default routing context set on the root node of a
|
|
||||||
// request context to track route patterns, URL parameters and
|
|
||||||
// an optional routing path.
|
|
||||||
type Context struct {
|
|
||||||
Routes Routes
|
|
||||||
|
|
||||||
// parentCtx is the parent of this one, for using Context as a
|
|
||||||
// context.Context directly. This is an optimization that saves
|
|
||||||
// 1 allocation.
|
|
||||||
parentCtx context.Context
|
|
||||||
|
|
||||||
// Routing path/method override used during the route search.
|
|
||||||
// See Mux#routeHTTP method.
|
|
||||||
RoutePath string
|
|
||||||
RouteMethod string
|
|
||||||
|
|
||||||
// URLParams are the stack of routeParams captured during the
|
|
||||||
// routing lifecycle across a stack of sub-routers.
|
|
||||||
URLParams RouteParams
|
|
||||||
|
|
||||||
// Route parameters matched for the current sub-router. It is
|
|
||||||
// intentionally unexported so it can't be tampered.
|
|
||||||
routeParams RouteParams
|
|
||||||
|
|
||||||
// The endpoint routing pattern that matched the request URI path
|
|
||||||
// or `RoutePath` of the current sub-router. This value will update
|
|
||||||
// during the lifecycle of a request passing through a stack of
|
|
||||||
// sub-routers.
|
|
||||||
routePattern string
|
|
||||||
|
|
||||||
// Routing pattern stack throughout the lifecycle of the request,
|
|
||||||
// across all connected routers. It is a record of all matching
|
|
||||||
// patterns across a stack of sub-routers.
|
|
||||||
RoutePatterns []string
|
|
||||||
|
|
||||||
methodsAllowed []methodTyp // allowed methods in case of a 405
|
|
||||||
methodNotAllowed bool
|
|
||||||
}
|
|
||||||
|
|
||||||
// Reset a routing context to its initial state.
|
|
||||||
func (x *Context) Reset() {
|
|
||||||
x.Routes = nil
|
|
||||||
x.RoutePath = ""
|
|
||||||
x.RouteMethod = ""
|
|
||||||
x.RoutePatterns = x.RoutePatterns[:0]
|
|
||||||
x.URLParams.Keys = x.URLParams.Keys[:0]
|
|
||||||
x.URLParams.Values = x.URLParams.Values[:0]
|
|
||||||
|
|
||||||
x.routePattern = ""
|
|
||||||
x.routeParams.Keys = x.routeParams.Keys[:0]
|
|
||||||
x.routeParams.Values = x.routeParams.Values[:0]
|
|
||||||
x.methodNotAllowed = false
|
|
||||||
x.methodsAllowed = x.methodsAllowed[:0]
|
|
||||||
x.parentCtx = nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// URLParam returns the corresponding URL parameter value from the request
|
|
||||||
// routing context.
|
|
||||||
func (x *Context) URLParam(key string) string {
|
|
||||||
for k := len(x.URLParams.Keys) - 1; k >= 0; k-- {
|
|
||||||
if x.URLParams.Keys[k] == key {
|
|
||||||
return x.URLParams.Values[k]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return ""
|
|
||||||
}
|
|
||||||
|
|
||||||
// RoutePattern builds the routing pattern string for the particular
|
|
||||||
// request, at the particular point during routing. This means, the value
|
|
||||||
// will change throughout the execution of a request in a router. That is
|
|
||||||
// why it's advised to only use this value after calling the next handler.
|
|
||||||
//
|
|
||||||
// For example,
|
|
||||||
//
|
|
||||||
// func Instrument(next http.Handler) http.Handler {
|
|
||||||
// return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
|
||||||
// next.ServeHTTP(w, r)
|
|
||||||
// routePattern := chi.RouteContext(r.Context()).RoutePattern()
|
|
||||||
// measure(w, r, routePattern)
|
|
||||||
// })
|
|
||||||
// }
|
|
||||||
func (x *Context) RoutePattern() string {
|
|
||||||
if x == nil {
|
|
||||||
return ""
|
|
||||||
}
|
|
||||||
routePattern := strings.Join(x.RoutePatterns, "")
|
|
||||||
routePattern = replaceWildcards(routePattern)
|
|
||||||
if routePattern != "/" {
|
|
||||||
routePattern = strings.TrimSuffix(routePattern, "//")
|
|
||||||
routePattern = strings.TrimSuffix(routePattern, "/")
|
|
||||||
}
|
|
||||||
return routePattern
|
|
||||||
}
|
|
||||||
|
|
||||||
// replaceWildcards takes a route pattern and recursively replaces all
|
|
||||||
// occurrences of "/*/" to "/".
|
|
||||||
func replaceWildcards(p string) string {
|
|
||||||
if strings.Contains(p, "/*/") {
|
|
||||||
return replaceWildcards(strings.Replace(p, "/*/", "/", -1))
|
|
||||||
}
|
|
||||||
return p
|
|
||||||
}
|
|
||||||
|
|
||||||
// RouteParams is a structure to track URL routing parameters efficiently.
|
|
||||||
type RouteParams struct {
|
|
||||||
Keys, Values []string
|
|
||||||
}
|
|
||||||
|
|
||||||
// Add will append a URL parameter to the end of the route param
|
|
||||||
func (s *RouteParams) Add(key, value string) {
|
|
||||||
s.Keys = append(s.Keys, key)
|
|
||||||
s.Values = append(s.Values, value)
|
|
||||||
}
|
|
||||||
|
|
||||||
// contextKey is a value for use with context.WithValue. It's used as
|
|
||||||
// a pointer so it fits in an interface{} without allocation. This technique
|
|
||||||
// for defining context keys was copied from Go 1.7's new use of context in net/http.
|
|
||||||
type contextKey struct {
|
|
||||||
name string
|
|
||||||
}
|
|
||||||
|
|
||||||
func (k *contextKey) String() string {
|
|
||||||
return "chi context value " + k.name
|
|
||||||
}
|
|
||||||
527
vendor/github.com/go-chi/chi/v5/mux.go
generated
vendored
527
vendor/github.com/go-chi/chi/v5/mux.go
generated
vendored
@@ -1,527 +0,0 @@
|
|||||||
package chi
|
|
||||||
|
|
||||||
import (
|
|
||||||
"context"
|
|
||||||
"fmt"
|
|
||||||
"net/http"
|
|
||||||
"strings"
|
|
||||||
"sync"
|
|
||||||
)
|
|
||||||
|
|
||||||
var _ Router = &Mux{}
|
|
||||||
|
|
||||||
// Mux is a simple HTTP route multiplexer that parses a request path,
|
|
||||||
// records any URL params, and executes an end handler. It implements
|
|
||||||
// the http.Handler interface and is friendly with the standard library.
|
|
||||||
//
|
|
||||||
// Mux is designed to be fast, minimal and offer a powerful API for building
|
|
||||||
// modular and composable HTTP services with a large set of handlers. It's
|
|
||||||
// particularly useful for writing large REST API services that break a handler
|
|
||||||
// into many smaller parts composed of middlewares and end handlers.
|
|
||||||
type Mux struct {
|
|
||||||
// The computed mux handler made of the chained middleware stack and
|
|
||||||
// the tree router
|
|
||||||
handler http.Handler
|
|
||||||
|
|
||||||
// The radix trie router
|
|
||||||
tree *node
|
|
||||||
|
|
||||||
// Custom method not allowed handler
|
|
||||||
methodNotAllowedHandler http.HandlerFunc
|
|
||||||
|
|
||||||
// A reference to the parent mux used by subrouters when mounting
|
|
||||||
// to a parent mux
|
|
||||||
parent *Mux
|
|
||||||
|
|
||||||
// Routing context pool
|
|
||||||
pool *sync.Pool
|
|
||||||
|
|
||||||
// Custom route not found handler
|
|
||||||
notFoundHandler http.HandlerFunc
|
|
||||||
|
|
||||||
// The middleware stack
|
|
||||||
middlewares []func(http.Handler) http.Handler
|
|
||||||
|
|
||||||
// Controls the behaviour of middleware chain generation when a mux
|
|
||||||
// is registered as an inline group inside another mux.
|
|
||||||
inline bool
|
|
||||||
}
|
|
||||||
|
|
||||||
// NewMux returns a newly initialized Mux object that implements the Router
|
|
||||||
// interface.
|
|
||||||
func NewMux() *Mux {
|
|
||||||
mux := &Mux{tree: &node{}, pool: &sync.Pool{}}
|
|
||||||
mux.pool.New = func() interface{} {
|
|
||||||
return NewRouteContext()
|
|
||||||
}
|
|
||||||
return mux
|
|
||||||
}
|
|
||||||
|
|
||||||
// ServeHTTP is the single method of the http.Handler interface that makes
|
|
||||||
// Mux interoperable with the standard library. It uses a sync.Pool to get and
|
|
||||||
// reuse routing contexts for each request.
|
|
||||||
func (mx *Mux) ServeHTTP(w http.ResponseWriter, r *http.Request) {
|
|
||||||
// Ensure the mux has some routes defined on the mux
|
|
||||||
if mx.handler == nil {
|
|
||||||
mx.NotFoundHandler().ServeHTTP(w, r)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
// Check if a routing context already exists from a parent router.
|
|
||||||
rctx, _ := r.Context().Value(RouteCtxKey).(*Context)
|
|
||||||
if rctx != nil {
|
|
||||||
mx.handler.ServeHTTP(w, r)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
// Fetch a RouteContext object from the sync pool, and call the computed
|
|
||||||
// mx.handler that is comprised of mx.middlewares + mx.routeHTTP.
|
|
||||||
// Once the request is finished, reset the routing context and put it back
|
|
||||||
// into the pool for reuse from another request.
|
|
||||||
rctx = mx.pool.Get().(*Context)
|
|
||||||
rctx.Reset()
|
|
||||||
rctx.Routes = mx
|
|
||||||
rctx.parentCtx = r.Context()
|
|
||||||
|
|
||||||
// NOTE: r.WithContext() causes 2 allocations and context.WithValue() causes 1 allocation
|
|
||||||
r = r.WithContext(context.WithValue(r.Context(), RouteCtxKey, rctx))
|
|
||||||
|
|
||||||
// Serve the request and once its done, put the request context back in the sync pool
|
|
||||||
mx.handler.ServeHTTP(w, r)
|
|
||||||
mx.pool.Put(rctx)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Use appends a middleware handler to the Mux middleware stack.
|
|
||||||
//
|
|
||||||
// The middleware stack for any Mux will execute before searching for a matching
|
|
||||||
// route to a specific handler, which provides opportunity to respond early,
|
|
||||||
// change the course of the request execution, or set request-scoped values for
|
|
||||||
// the next http.Handler.
|
|
||||||
func (mx *Mux) Use(middlewares ...func(http.Handler) http.Handler) {
|
|
||||||
if mx.handler != nil {
|
|
||||||
panic("chi: all middlewares must be defined before routes on a mux")
|
|
||||||
}
|
|
||||||
mx.middlewares = append(mx.middlewares, middlewares...)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Handle adds the route `pattern` that matches any http method to
|
|
||||||
// execute the `handler` http.Handler.
|
|
||||||
func (mx *Mux) Handle(pattern string, handler http.Handler) {
|
|
||||||
if method, rest, found := strings.Cut(pattern, " "); found {
|
|
||||||
mx.Method(method, rest, handler)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
mx.handle(mALL, pattern, handler)
|
|
||||||
}
|
|
||||||
|
|
||||||
// HandleFunc adds the route `pattern` that matches any http method to
|
|
||||||
// execute the `handlerFn` http.HandlerFunc.
|
|
||||||
func (mx *Mux) HandleFunc(pattern string, handlerFn http.HandlerFunc) {
|
|
||||||
if method, rest, found := strings.Cut(pattern, " "); found {
|
|
||||||
mx.Method(method, rest, handlerFn)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
mx.handle(mALL, pattern, handlerFn)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Method adds the route `pattern` that matches `method` http method to
|
|
||||||
// execute the `handler` http.Handler.
|
|
||||||
func (mx *Mux) Method(method, pattern string, handler http.Handler) {
|
|
||||||
m, ok := methodMap[strings.ToUpper(method)]
|
|
||||||
if !ok {
|
|
||||||
panic(fmt.Sprintf("chi: '%s' http method is not supported.", method))
|
|
||||||
}
|
|
||||||
mx.handle(m, pattern, handler)
|
|
||||||
}
|
|
||||||
|
|
||||||
// MethodFunc adds the route `pattern` that matches `method` http method to
|
|
||||||
// execute the `handlerFn` http.HandlerFunc.
|
|
||||||
func (mx *Mux) MethodFunc(method, pattern string, handlerFn http.HandlerFunc) {
|
|
||||||
mx.Method(method, pattern, handlerFn)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Connect adds the route `pattern` that matches a CONNECT http method to
|
|
||||||
// execute the `handlerFn` http.HandlerFunc.
|
|
||||||
func (mx *Mux) Connect(pattern string, handlerFn http.HandlerFunc) {
|
|
||||||
mx.handle(mCONNECT, pattern, handlerFn)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Delete adds the route `pattern` that matches a DELETE http method to
|
|
||||||
// execute the `handlerFn` http.HandlerFunc.
|
|
||||||
func (mx *Mux) Delete(pattern string, handlerFn http.HandlerFunc) {
|
|
||||||
mx.handle(mDELETE, pattern, handlerFn)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Get adds the route `pattern` that matches a GET http method to
|
|
||||||
// execute the `handlerFn` http.HandlerFunc.
|
|
||||||
func (mx *Mux) Get(pattern string, handlerFn http.HandlerFunc) {
|
|
||||||
mx.handle(mGET, pattern, handlerFn)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Head adds the route `pattern` that matches a HEAD http method to
|
|
||||||
// execute the `handlerFn` http.HandlerFunc.
|
|
||||||
func (mx *Mux) Head(pattern string, handlerFn http.HandlerFunc) {
|
|
||||||
mx.handle(mHEAD, pattern, handlerFn)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Options adds the route `pattern` that matches an OPTIONS http method to
|
|
||||||
// execute the `handlerFn` http.HandlerFunc.
|
|
||||||
func (mx *Mux) Options(pattern string, handlerFn http.HandlerFunc) {
|
|
||||||
mx.handle(mOPTIONS, pattern, handlerFn)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Patch adds the route `pattern` that matches a PATCH http method to
|
|
||||||
// execute the `handlerFn` http.HandlerFunc.
|
|
||||||
func (mx *Mux) Patch(pattern string, handlerFn http.HandlerFunc) {
|
|
||||||
mx.handle(mPATCH, pattern, handlerFn)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Post adds the route `pattern` that matches a POST http method to
|
|
||||||
// execute the `handlerFn` http.HandlerFunc.
|
|
||||||
func (mx *Mux) Post(pattern string, handlerFn http.HandlerFunc) {
|
|
||||||
mx.handle(mPOST, pattern, handlerFn)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Put adds the route `pattern` that matches a PUT http method to
|
|
||||||
// execute the `handlerFn` http.HandlerFunc.
|
|
||||||
func (mx *Mux) Put(pattern string, handlerFn http.HandlerFunc) {
|
|
||||||
mx.handle(mPUT, pattern, handlerFn)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Trace adds the route `pattern` that matches a TRACE http method to
|
|
||||||
// execute the `handlerFn` http.HandlerFunc.
|
|
||||||
func (mx *Mux) Trace(pattern string, handlerFn http.HandlerFunc) {
|
|
||||||
mx.handle(mTRACE, pattern, handlerFn)
|
|
||||||
}
|
|
||||||
|
|
||||||
// NotFound sets a custom http.HandlerFunc for routing paths that could
|
|
||||||
// not be found. The default 404 handler is `http.NotFound`.
|
|
||||||
func (mx *Mux) NotFound(handlerFn http.HandlerFunc) {
|
|
||||||
// Build NotFound handler chain
|
|
||||||
m := mx
|
|
||||||
hFn := handlerFn
|
|
||||||
if mx.inline && mx.parent != nil {
|
|
||||||
m = mx.parent
|
|
||||||
hFn = Chain(mx.middlewares...).HandlerFunc(hFn).ServeHTTP
|
|
||||||
}
|
|
||||||
|
|
||||||
// Update the notFoundHandler from this point forward
|
|
||||||
m.notFoundHandler = hFn
|
|
||||||
m.updateSubRoutes(func(subMux *Mux) {
|
|
||||||
if subMux.notFoundHandler == nil {
|
|
||||||
subMux.NotFound(hFn)
|
|
||||||
}
|
|
||||||
})
|
|
||||||
}
|
|
||||||
|
|
||||||
// MethodNotAllowed sets a custom http.HandlerFunc for routing paths where the
|
|
||||||
// method is unresolved. The default handler returns a 405 with an empty body.
|
|
||||||
func (mx *Mux) MethodNotAllowed(handlerFn http.HandlerFunc) {
|
|
||||||
// Build MethodNotAllowed handler chain
|
|
||||||
m := mx
|
|
||||||
hFn := handlerFn
|
|
||||||
if mx.inline && mx.parent != nil {
|
|
||||||
m = mx.parent
|
|
||||||
hFn = Chain(mx.middlewares...).HandlerFunc(hFn).ServeHTTP
|
|
||||||
}
|
|
||||||
|
|
||||||
// Update the methodNotAllowedHandler from this point forward
|
|
||||||
m.methodNotAllowedHandler = hFn
|
|
||||||
m.updateSubRoutes(func(subMux *Mux) {
|
|
||||||
if subMux.methodNotAllowedHandler == nil {
|
|
||||||
subMux.MethodNotAllowed(hFn)
|
|
||||||
}
|
|
||||||
})
|
|
||||||
}
|
|
||||||
|
|
||||||
// With adds inline middlewares for an endpoint handler.
|
|
||||||
func (mx *Mux) With(middlewares ...func(http.Handler) http.Handler) Router {
|
|
||||||
// Similarly as in handle(), we must build the mux handler once additional
|
|
||||||
// middleware registration isn't allowed for this stack, like now.
|
|
||||||
if !mx.inline && mx.handler == nil {
|
|
||||||
mx.updateRouteHandler()
|
|
||||||
}
|
|
||||||
|
|
||||||
// Copy middlewares from parent inline muxs
|
|
||||||
var mws Middlewares
|
|
||||||
if mx.inline {
|
|
||||||
mws = make(Middlewares, len(mx.middlewares))
|
|
||||||
copy(mws, mx.middlewares)
|
|
||||||
}
|
|
||||||
mws = append(mws, middlewares...)
|
|
||||||
|
|
||||||
im := &Mux{
|
|
||||||
pool: mx.pool, inline: true, parent: mx, tree: mx.tree, middlewares: mws,
|
|
||||||
notFoundHandler: mx.notFoundHandler, methodNotAllowedHandler: mx.methodNotAllowedHandler,
|
|
||||||
}
|
|
||||||
|
|
||||||
return im
|
|
||||||
}
|
|
||||||
|
|
||||||
// Group creates a new inline-Mux with a copy of middleware stack. It's useful
|
|
||||||
// for a group of handlers along the same routing path that use an additional
|
|
||||||
// set of middlewares. See _examples/.
|
|
||||||
func (mx *Mux) Group(fn func(r Router)) Router {
|
|
||||||
im := mx.With()
|
|
||||||
if fn != nil {
|
|
||||||
fn(im)
|
|
||||||
}
|
|
||||||
return im
|
|
||||||
}
|
|
||||||
|
|
||||||
// Route creates a new Mux and mounts it along the `pattern` as a subrouter.
|
|
||||||
// Effectively, this is a short-hand call to Mount. See _examples/.
|
|
||||||
func (mx *Mux) Route(pattern string, fn func(r Router)) Router {
|
|
||||||
if fn == nil {
|
|
||||||
panic(fmt.Sprintf("chi: attempting to Route() a nil subrouter on '%s'", pattern))
|
|
||||||
}
|
|
||||||
subRouter := NewRouter()
|
|
||||||
fn(subRouter)
|
|
||||||
mx.Mount(pattern, subRouter)
|
|
||||||
return subRouter
|
|
||||||
}
|
|
||||||
|
|
||||||
// Mount attaches another http.Handler or chi Router as a subrouter along a routing
|
|
||||||
// path. It's very useful to split up a large API as many independent routers and
|
|
||||||
// compose them as a single service using Mount. See _examples/.
|
|
||||||
//
|
|
||||||
// Note that Mount() simply sets a wildcard along the `pattern` that will continue
|
|
||||||
// routing at the `handler`, which in most cases is another chi.Router. As a result,
|
|
||||||
// if you define two Mount() routes on the exact same pattern the mount will panic.
|
|
||||||
func (mx *Mux) Mount(pattern string, handler http.Handler) {
|
|
||||||
if handler == nil {
|
|
||||||
panic(fmt.Sprintf("chi: attempting to Mount() a nil handler on '%s'", pattern))
|
|
||||||
}
|
|
||||||
|
|
||||||
// Provide runtime safety for ensuring a pattern isn't mounted on an existing
|
|
||||||
// routing pattern.
|
|
||||||
if mx.tree.findPattern(pattern+"*") || mx.tree.findPattern(pattern+"/*") {
|
|
||||||
panic(fmt.Sprintf("chi: attempting to Mount() a handler on an existing path, '%s'", pattern))
|
|
||||||
}
|
|
||||||
|
|
||||||
// Assign sub-Router's with the parent not found & method not allowed handler if not specified.
|
|
||||||
subr, ok := handler.(*Mux)
|
|
||||||
if ok && subr.notFoundHandler == nil && mx.notFoundHandler != nil {
|
|
||||||
subr.NotFound(mx.notFoundHandler)
|
|
||||||
}
|
|
||||||
if ok && subr.methodNotAllowedHandler == nil && mx.methodNotAllowedHandler != nil {
|
|
||||||
subr.MethodNotAllowed(mx.methodNotAllowedHandler)
|
|
||||||
}
|
|
||||||
|
|
||||||
mountHandler := http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
|
||||||
rctx := RouteContext(r.Context())
|
|
||||||
|
|
||||||
// shift the url path past the previous subrouter
|
|
||||||
rctx.RoutePath = mx.nextRoutePath(rctx)
|
|
||||||
|
|
||||||
// reset the wildcard URLParam which connects the subrouter
|
|
||||||
n := len(rctx.URLParams.Keys) - 1
|
|
||||||
if n >= 0 && rctx.URLParams.Keys[n] == "*" && len(rctx.URLParams.Values) > n {
|
|
||||||
rctx.URLParams.Values[n] = ""
|
|
||||||
}
|
|
||||||
|
|
||||||
handler.ServeHTTP(w, r)
|
|
||||||
})
|
|
||||||
|
|
||||||
if pattern == "" || pattern[len(pattern)-1] != '/' {
|
|
||||||
mx.handle(mALL|mSTUB, pattern, mountHandler)
|
|
||||||
mx.handle(mALL|mSTUB, pattern+"/", mountHandler)
|
|
||||||
pattern += "/"
|
|
||||||
}
|
|
||||||
|
|
||||||
method := mALL
|
|
||||||
subroutes, _ := handler.(Routes)
|
|
||||||
if subroutes != nil {
|
|
||||||
method |= mSTUB
|
|
||||||
}
|
|
||||||
n := mx.handle(method, pattern+"*", mountHandler)
|
|
||||||
|
|
||||||
if subroutes != nil {
|
|
||||||
n.subroutes = subroutes
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Routes returns a slice of routing information from the tree,
|
|
||||||
// useful for traversing available routes of a router.
|
|
||||||
func (mx *Mux) Routes() []Route {
|
|
||||||
return mx.tree.routes()
|
|
||||||
}
|
|
||||||
|
|
||||||
// Middlewares returns a slice of middleware handler functions.
|
|
||||||
func (mx *Mux) Middlewares() Middlewares {
|
|
||||||
return mx.middlewares
|
|
||||||
}
|
|
||||||
|
|
||||||
// Match searches the routing tree for a handler that matches the method/path.
|
|
||||||
// It's similar to routing a http request, but without executing the handler
|
|
||||||
// thereafter.
|
|
||||||
//
|
|
||||||
// Note: the *Context state is updated during execution, so manage
|
|
||||||
// the state carefully or make a NewRouteContext().
|
|
||||||
func (mx *Mux) Match(rctx *Context, method, path string) bool {
|
|
||||||
return mx.Find(rctx, method, path) != ""
|
|
||||||
}
|
|
||||||
|
|
||||||
// Find searches the routing tree for the pattern that matches
|
|
||||||
// the method/path.
|
|
||||||
//
|
|
||||||
// Note: the *Context state is updated during execution, so manage
|
|
||||||
// the state carefully or make a NewRouteContext().
|
|
||||||
func (mx *Mux) Find(rctx *Context, method, path string) string {
|
|
||||||
m, ok := methodMap[method]
|
|
||||||
if !ok {
|
|
||||||
return ""
|
|
||||||
}
|
|
||||||
|
|
||||||
node, _, _ := mx.tree.FindRoute(rctx, m, path)
|
|
||||||
pattern := rctx.routePattern
|
|
||||||
|
|
||||||
if node != nil {
|
|
||||||
if node.subroutes == nil {
|
|
||||||
e := node.endpoints[m]
|
|
||||||
return e.pattern
|
|
||||||
}
|
|
||||||
|
|
||||||
rctx.RoutePath = mx.nextRoutePath(rctx)
|
|
||||||
subPattern := node.subroutes.Find(rctx, method, rctx.RoutePath)
|
|
||||||
if subPattern == "" {
|
|
||||||
return ""
|
|
||||||
}
|
|
||||||
|
|
||||||
pattern = strings.TrimSuffix(pattern, "/*")
|
|
||||||
pattern += subPattern
|
|
||||||
}
|
|
||||||
|
|
||||||
return pattern
|
|
||||||
}
|
|
||||||
|
|
||||||
// NotFoundHandler returns the default Mux 404 responder whenever a route
|
|
||||||
// cannot be found.
|
|
||||||
func (mx *Mux) NotFoundHandler() http.HandlerFunc {
|
|
||||||
if mx.notFoundHandler != nil {
|
|
||||||
return mx.notFoundHandler
|
|
||||||
}
|
|
||||||
return http.NotFound
|
|
||||||
}
|
|
||||||
|
|
||||||
// MethodNotAllowedHandler returns the default Mux 405 responder whenever
|
|
||||||
// a method cannot be resolved for a route.
|
|
||||||
func (mx *Mux) MethodNotAllowedHandler(methodsAllowed ...methodTyp) http.HandlerFunc {
|
|
||||||
if mx.methodNotAllowedHandler != nil {
|
|
||||||
return mx.methodNotAllowedHandler
|
|
||||||
}
|
|
||||||
return methodNotAllowedHandler(methodsAllowed...)
|
|
||||||
}
|
|
||||||
|
|
||||||
// handle registers a http.Handler in the routing tree for a particular http method
|
|
||||||
// and routing pattern.
|
|
||||||
func (mx *Mux) handle(method methodTyp, pattern string, handler http.Handler) *node {
|
|
||||||
if len(pattern) == 0 || pattern[0] != '/' {
|
|
||||||
panic(fmt.Sprintf("chi: routing pattern must begin with '/' in '%s'", pattern))
|
|
||||||
}
|
|
||||||
|
|
||||||
// Build the computed routing handler for this routing pattern.
|
|
||||||
if !mx.inline && mx.handler == nil {
|
|
||||||
mx.updateRouteHandler()
|
|
||||||
}
|
|
||||||
|
|
||||||
// Build endpoint handler with inline middlewares for the route
|
|
||||||
var h http.Handler
|
|
||||||
if mx.inline {
|
|
||||||
mx.handler = http.HandlerFunc(mx.routeHTTP)
|
|
||||||
h = Chain(mx.middlewares...).Handler(handler)
|
|
||||||
} else {
|
|
||||||
h = handler
|
|
||||||
}
|
|
||||||
|
|
||||||
// Add the endpoint to the tree and return the node
|
|
||||||
return mx.tree.InsertRoute(method, pattern, h)
|
|
||||||
}
|
|
||||||
|
|
||||||
// routeHTTP routes a http.Request through the Mux routing tree to serve
|
|
||||||
// the matching handler for a particular http method.
|
|
||||||
func (mx *Mux) routeHTTP(w http.ResponseWriter, r *http.Request) {
|
|
||||||
// Grab the route context object
|
|
||||||
rctx := r.Context().Value(RouteCtxKey).(*Context)
|
|
||||||
|
|
||||||
// The request routing path
|
|
||||||
routePath := rctx.RoutePath
|
|
||||||
if routePath == "" {
|
|
||||||
if r.URL.RawPath != "" {
|
|
||||||
routePath = r.URL.RawPath
|
|
||||||
} else {
|
|
||||||
routePath = r.URL.Path
|
|
||||||
}
|
|
||||||
if routePath == "" {
|
|
||||||
routePath = "/"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Check if method is supported by chi
|
|
||||||
if rctx.RouteMethod == "" {
|
|
||||||
rctx.RouteMethod = r.Method
|
|
||||||
}
|
|
||||||
method, ok := methodMap[rctx.RouteMethod]
|
|
||||||
if !ok {
|
|
||||||
mx.MethodNotAllowedHandler().ServeHTTP(w, r)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
// Find the route
|
|
||||||
if _, _, h := mx.tree.FindRoute(rctx, method, routePath); h != nil {
|
|
||||||
if supportsPathValue {
|
|
||||||
setPathValue(rctx, r)
|
|
||||||
}
|
|
||||||
|
|
||||||
h.ServeHTTP(w, r)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
if rctx.methodNotAllowed {
|
|
||||||
mx.MethodNotAllowedHandler(rctx.methodsAllowed...).ServeHTTP(w, r)
|
|
||||||
} else {
|
|
||||||
mx.NotFoundHandler().ServeHTTP(w, r)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (mx *Mux) nextRoutePath(rctx *Context) string {
|
|
||||||
routePath := "/"
|
|
||||||
nx := len(rctx.routeParams.Keys) - 1 // index of last param in list
|
|
||||||
if nx >= 0 && rctx.routeParams.Keys[nx] == "*" && len(rctx.routeParams.Values) > nx {
|
|
||||||
routePath = "/" + rctx.routeParams.Values[nx]
|
|
||||||
}
|
|
||||||
return routePath
|
|
||||||
}
|
|
||||||
|
|
||||||
// Recursively update data on child routers.
|
|
||||||
func (mx *Mux) updateSubRoutes(fn func(subMux *Mux)) {
|
|
||||||
for _, r := range mx.tree.routes() {
|
|
||||||
subMux, ok := r.SubRoutes.(*Mux)
|
|
||||||
if !ok {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
fn(subMux)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// updateRouteHandler builds the single mux handler that is a chain of the middleware
|
|
||||||
// stack, as defined by calls to Use(), and the tree router (Mux) itself. After this
|
|
||||||
// point, no other middlewares can be registered on this Mux's stack. But you can still
|
|
||||||
// compose additional middlewares via Group()'s or using a chained middleware handler.
|
|
||||||
func (mx *Mux) updateRouteHandler() {
|
|
||||||
mx.handler = chain(mx.middlewares, http.HandlerFunc(mx.routeHTTP))
|
|
||||||
}
|
|
||||||
|
|
||||||
// methodNotAllowedHandler is a helper function to respond with a 405,
|
|
||||||
// method not allowed. It sets the Allow header with the list of allowed
|
|
||||||
// methods for the route.
|
|
||||||
func methodNotAllowedHandler(methodsAllowed ...methodTyp) func(w http.ResponseWriter, r *http.Request) {
|
|
||||||
return func(w http.ResponseWriter, r *http.Request) {
|
|
||||||
for _, m := range methodsAllowed {
|
|
||||||
w.Header().Add("Allow", reverseMethodMap[m])
|
|
||||||
}
|
|
||||||
w.WriteHeader(405)
|
|
||||||
w.Write(nil)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
21
vendor/github.com/go-chi/chi/v5/path_value.go
generated
vendored
21
vendor/github.com/go-chi/chi/v5/path_value.go
generated
vendored
@@ -1,21 +0,0 @@
|
|||||||
//go:build go1.22 && !tinygo
|
|
||||||
// +build go1.22,!tinygo
|
|
||||||
|
|
||||||
|
|
||||||
package chi
|
|
||||||
|
|
||||||
import "net/http"
|
|
||||||
|
|
||||||
// supportsPathValue is true if the Go version is 1.22 and above.
|
|
||||||
//
|
|
||||||
// If this is true, `net/http.Request` has methods `SetPathValue` and `PathValue`.
|
|
||||||
const supportsPathValue = true
|
|
||||||
|
|
||||||
// setPathValue sets the path values in the Request value
|
|
||||||
// based on the provided request context.
|
|
||||||
func setPathValue(rctx *Context, r *http.Request) {
|
|
||||||
for i, key := range rctx.URLParams.Keys {
|
|
||||||
value := rctx.URLParams.Values[i]
|
|
||||||
r.SetPathValue(key, value)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
19
vendor/github.com/go-chi/chi/v5/path_value_fallback.go
generated
vendored
19
vendor/github.com/go-chi/chi/v5/path_value_fallback.go
generated
vendored
@@ -1,19 +0,0 @@
|
|||||||
//go:build !go1.22 || tinygo
|
|
||||||
// +build !go1.22 tinygo
|
|
||||||
|
|
||||||
package chi
|
|
||||||
|
|
||||||
import "net/http"
|
|
||||||
|
|
||||||
// supportsPathValue is true if the Go version is 1.22 and above.
|
|
||||||
//
|
|
||||||
// If this is true, `net/http.Request` has methods `SetPathValue` and `PathValue`.
|
|
||||||
const supportsPathValue = false
|
|
||||||
|
|
||||||
// setPathValue sets the path values in the Request value
|
|
||||||
// based on the provided request context.
|
|
||||||
//
|
|
||||||
// setPathValue is only supported in Go 1.22 and above so
|
|
||||||
// this is just a blank function so that it compiles.
|
|
||||||
func setPathValue(rctx *Context, r *http.Request) {
|
|
||||||
}
|
|
||||||
890
vendor/github.com/go-chi/chi/v5/tree.go
generated
vendored
890
vendor/github.com/go-chi/chi/v5/tree.go
generated
vendored
@@ -1,890 +0,0 @@
|
|||||||
package chi
|
|
||||||
|
|
||||||
// Radix tree implementation below is a based on the original work by
|
|
||||||
// Armon Dadgar in https://github.com/armon/go-radix/blob/master/radix.go
|
|
||||||
// (MIT licensed). It's been heavily modified for use as a HTTP routing tree.
|
|
||||||
|
|
||||||
import (
|
|
||||||
"fmt"
|
|
||||||
"net/http"
|
|
||||||
"regexp"
|
|
||||||
"sort"
|
|
||||||
"strconv"
|
|
||||||
"strings"
|
|
||||||
)
|
|
||||||
|
|
||||||
type methodTyp uint
|
|
||||||
|
|
||||||
const (
|
|
||||||
mSTUB methodTyp = 1 << iota
|
|
||||||
mCONNECT
|
|
||||||
mDELETE
|
|
||||||
mGET
|
|
||||||
mHEAD
|
|
||||||
mOPTIONS
|
|
||||||
mPATCH
|
|
||||||
mPOST
|
|
||||||
mPUT
|
|
||||||
mTRACE
|
|
||||||
)
|
|
||||||
|
|
||||||
var mALL = mCONNECT | mDELETE | mGET | mHEAD |
|
|
||||||
mOPTIONS | mPATCH | mPOST | mPUT | mTRACE
|
|
||||||
|
|
||||||
var methodMap = map[string]methodTyp{
|
|
||||||
http.MethodConnect: mCONNECT,
|
|
||||||
http.MethodDelete: mDELETE,
|
|
||||||
http.MethodGet: mGET,
|
|
||||||
http.MethodHead: mHEAD,
|
|
||||||
http.MethodOptions: mOPTIONS,
|
|
||||||
http.MethodPatch: mPATCH,
|
|
||||||
http.MethodPost: mPOST,
|
|
||||||
http.MethodPut: mPUT,
|
|
||||||
http.MethodTrace: mTRACE,
|
|
||||||
}
|
|
||||||
|
|
||||||
var reverseMethodMap = map[methodTyp]string{
|
|
||||||
mCONNECT: http.MethodConnect,
|
|
||||||
mDELETE: http.MethodDelete,
|
|
||||||
mGET: http.MethodGet,
|
|
||||||
mHEAD: http.MethodHead,
|
|
||||||
mOPTIONS: http.MethodOptions,
|
|
||||||
mPATCH: http.MethodPatch,
|
|
||||||
mPOST: http.MethodPost,
|
|
||||||
mPUT: http.MethodPut,
|
|
||||||
mTRACE: http.MethodTrace,
|
|
||||||
}
|
|
||||||
|
|
||||||
// RegisterMethod adds support for custom HTTP method handlers, available
|
|
||||||
// via Router#Method and Router#MethodFunc
|
|
||||||
func RegisterMethod(method string) {
|
|
||||||
if method == "" {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
method = strings.ToUpper(method)
|
|
||||||
if _, ok := methodMap[method]; ok {
|
|
||||||
return
|
|
||||||
}
|
|
||||||
n := len(methodMap)
|
|
||||||
if n > strconv.IntSize-2 {
|
|
||||||
panic(fmt.Sprintf("chi: max number of methods reached (%d)", strconv.IntSize))
|
|
||||||
}
|
|
||||||
mt := methodTyp(2 << n)
|
|
||||||
methodMap[method] = mt
|
|
||||||
mALL |= mt
|
|
||||||
}
|
|
||||||
|
|
||||||
type nodeTyp uint8
|
|
||||||
|
|
||||||
const (
|
|
||||||
ntStatic nodeTyp = iota // /home
|
|
||||||
ntRegexp // /{id:[0-9]+}
|
|
||||||
ntParam // /{user}
|
|
||||||
ntCatchAll // /api/v1/*
|
|
||||||
)
|
|
||||||
|
|
||||||
type node struct {
|
|
||||||
// subroutes on the leaf node
|
|
||||||
subroutes Routes
|
|
||||||
|
|
||||||
// regexp matcher for regexp nodes
|
|
||||||
rex *regexp.Regexp
|
|
||||||
|
|
||||||
// HTTP handler endpoints on the leaf node
|
|
||||||
endpoints endpoints
|
|
||||||
|
|
||||||
// prefix is the common prefix we ignore
|
|
||||||
prefix string
|
|
||||||
|
|
||||||
// child nodes should be stored in-order for iteration,
|
|
||||||
// in groups of the node type.
|
|
||||||
children [ntCatchAll + 1]nodes
|
|
||||||
|
|
||||||
// first byte of the child prefix
|
|
||||||
tail byte
|
|
||||||
|
|
||||||
// node type: static, regexp, param, catchAll
|
|
||||||
typ nodeTyp
|
|
||||||
|
|
||||||
// first byte of the prefix
|
|
||||||
label byte
|
|
||||||
}
|
|
||||||
|
|
||||||
// endpoints is a mapping of http method constants to handlers
|
|
||||||
// for a given route.
|
|
||||||
type endpoints map[methodTyp]*endpoint
|
|
||||||
|
|
||||||
type endpoint struct {
|
|
||||||
// endpoint handler
|
|
||||||
handler http.Handler
|
|
||||||
|
|
||||||
// pattern is the routing pattern for handler nodes
|
|
||||||
pattern string
|
|
||||||
|
|
||||||
// parameter keys recorded on handler nodes
|
|
||||||
paramKeys []string
|
|
||||||
}
|
|
||||||
|
|
||||||
func (s endpoints) Value(method methodTyp) *endpoint {
|
|
||||||
mh, ok := s[method]
|
|
||||||
if !ok {
|
|
||||||
mh = &endpoint{}
|
|
||||||
s[method] = mh
|
|
||||||
}
|
|
||||||
return mh
|
|
||||||
}
|
|
||||||
|
|
||||||
func (n *node) InsertRoute(method methodTyp, pattern string, handler http.Handler) *node {
|
|
||||||
var parent *node
|
|
||||||
search := pattern
|
|
||||||
|
|
||||||
for {
|
|
||||||
// Handle key exhaustion
|
|
||||||
if len(search) == 0 {
|
|
||||||
// Insert or update the node's leaf handler
|
|
||||||
n.setEndpoint(method, handler, pattern)
|
|
||||||
return n
|
|
||||||
}
|
|
||||||
|
|
||||||
// We're going to be searching for a wild node next,
|
|
||||||
// in this case, we need to get the tail
|
|
||||||
var label = search[0]
|
|
||||||
var segTail byte
|
|
||||||
var segEndIdx int
|
|
||||||
var segTyp nodeTyp
|
|
||||||
var segRexpat string
|
|
||||||
if label == '{' || label == '*' {
|
|
||||||
segTyp, _, segRexpat, segTail, _, segEndIdx = patNextSegment(search)
|
|
||||||
}
|
|
||||||
|
|
||||||
var prefix string
|
|
||||||
if segTyp == ntRegexp {
|
|
||||||
prefix = segRexpat
|
|
||||||
}
|
|
||||||
|
|
||||||
// Look for the edge to attach to
|
|
||||||
parent = n
|
|
||||||
n = n.getEdge(segTyp, label, segTail, prefix)
|
|
||||||
|
|
||||||
// No edge, create one
|
|
||||||
if n == nil {
|
|
||||||
child := &node{label: label, tail: segTail, prefix: search}
|
|
||||||
hn := parent.addChild(child, search)
|
|
||||||
hn.setEndpoint(method, handler, pattern)
|
|
||||||
|
|
||||||
return hn
|
|
||||||
}
|
|
||||||
|
|
||||||
// Found an edge to match the pattern
|
|
||||||
|
|
||||||
if n.typ > ntStatic {
|
|
||||||
// We found a param node, trim the param from the search path and continue.
|
|
||||||
// This param/wild pattern segment would already be on the tree from a previous
|
|
||||||
// call to addChild when creating a new node.
|
|
||||||
search = search[segEndIdx:]
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
|
|
||||||
// Static nodes fall below here.
|
|
||||||
// Determine longest prefix of the search key on match.
|
|
||||||
commonPrefix := longestPrefix(search, n.prefix)
|
|
||||||
if commonPrefix == len(n.prefix) {
|
|
||||||
// the common prefix is as long as the current node's prefix we're attempting to insert.
|
|
||||||
// keep the search going.
|
|
||||||
search = search[commonPrefix:]
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
|
|
||||||
// Split the node
|
|
||||||
child := &node{
|
|
||||||
typ: ntStatic,
|
|
||||||
prefix: search[:commonPrefix],
|
|
||||||
}
|
|
||||||
parent.replaceChild(search[0], segTail, child)
|
|
||||||
|
|
||||||
// Restore the existing node
|
|
||||||
n.label = n.prefix[commonPrefix]
|
|
||||||
n.prefix = n.prefix[commonPrefix:]
|
|
||||||
child.addChild(n, n.prefix)
|
|
||||||
|
|
||||||
// If the new key is a subset, set the method/handler on this node and finish.
|
|
||||||
search = search[commonPrefix:]
|
|
||||||
if len(search) == 0 {
|
|
||||||
child.setEndpoint(method, handler, pattern)
|
|
||||||
return child
|
|
||||||
}
|
|
||||||
|
|
||||||
// Create a new edge for the node
|
|
||||||
subchild := &node{
|
|
||||||
typ: ntStatic,
|
|
||||||
label: search[0],
|
|
||||||
prefix: search,
|
|
||||||
}
|
|
||||||
hn := child.addChild(subchild, search)
|
|
||||||
hn.setEndpoint(method, handler, pattern)
|
|
||||||
return hn
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// addChild appends the new `child` node to the tree using the `pattern` as the trie key.
|
|
||||||
// For a URL router like chi's, we split the static, param, regexp and wildcard segments
|
|
||||||
// into different nodes. In addition, addChild will recursively call itself until every
|
|
||||||
// pattern segment is added to the url pattern tree as individual nodes, depending on type.
|
|
||||||
func (n *node) addChild(child *node, prefix string) *node {
|
|
||||||
search := prefix
|
|
||||||
|
|
||||||
// handler leaf node added to the tree is the child.
|
|
||||||
// this may be overridden later down the flow
|
|
||||||
hn := child
|
|
||||||
|
|
||||||
// Parse next segment
|
|
||||||
segTyp, _, segRexpat, segTail, segStartIdx, segEndIdx := patNextSegment(search)
|
|
||||||
|
|
||||||
// Add child depending on next up segment
|
|
||||||
switch segTyp {
|
|
||||||
|
|
||||||
case ntStatic:
|
|
||||||
// Search prefix is all static (that is, has no params in path)
|
|
||||||
// noop
|
|
||||||
|
|
||||||
default:
|
|
||||||
// Search prefix contains a param, regexp or wildcard
|
|
||||||
|
|
||||||
if segTyp == ntRegexp {
|
|
||||||
rex, err := regexp.Compile(segRexpat)
|
|
||||||
if err != nil {
|
|
||||||
panic(fmt.Sprintf("chi: invalid regexp pattern '%s' in route param", segRexpat))
|
|
||||||
}
|
|
||||||
child.prefix = segRexpat
|
|
||||||
child.rex = rex
|
|
||||||
}
|
|
||||||
|
|
||||||
if segStartIdx == 0 {
|
|
||||||
// Route starts with a param
|
|
||||||
child.typ = segTyp
|
|
||||||
|
|
||||||
if segTyp == ntCatchAll {
|
|
||||||
segStartIdx = -1
|
|
||||||
} else {
|
|
||||||
segStartIdx = segEndIdx
|
|
||||||
}
|
|
||||||
if segStartIdx < 0 {
|
|
||||||
segStartIdx = len(search)
|
|
||||||
}
|
|
||||||
child.tail = segTail // for params, we set the tail
|
|
||||||
|
|
||||||
if segStartIdx != len(search) {
|
|
||||||
// add static edge for the remaining part, split the end.
|
|
||||||
// its not possible to have adjacent param nodes, so its certainly
|
|
||||||
// going to be a static node next.
|
|
||||||
|
|
||||||
search = search[segStartIdx:] // advance search position
|
|
||||||
|
|
||||||
nn := &node{
|
|
||||||
typ: ntStatic,
|
|
||||||
label: search[0],
|
|
||||||
prefix: search,
|
|
||||||
}
|
|
||||||
hn = child.addChild(nn, search)
|
|
||||||
}
|
|
||||||
|
|
||||||
} else if segStartIdx > 0 {
|
|
||||||
// Route has some param
|
|
||||||
|
|
||||||
// starts with a static segment
|
|
||||||
child.typ = ntStatic
|
|
||||||
child.prefix = search[:segStartIdx]
|
|
||||||
child.rex = nil
|
|
||||||
|
|
||||||
// add the param edge node
|
|
||||||
search = search[segStartIdx:]
|
|
||||||
|
|
||||||
nn := &node{
|
|
||||||
typ: segTyp,
|
|
||||||
label: search[0],
|
|
||||||
tail: segTail,
|
|
||||||
}
|
|
||||||
hn = child.addChild(nn, search)
|
|
||||||
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
n.children[child.typ] = append(n.children[child.typ], child)
|
|
||||||
n.children[child.typ].Sort()
|
|
||||||
return hn
|
|
||||||
}
|
|
||||||
|
|
||||||
func (n *node) replaceChild(label, tail byte, child *node) {
|
|
||||||
for i := 0; i < len(n.children[child.typ]); i++ {
|
|
||||||
if n.children[child.typ][i].label == label && n.children[child.typ][i].tail == tail {
|
|
||||||
n.children[child.typ][i] = child
|
|
||||||
n.children[child.typ][i].label = label
|
|
||||||
n.children[child.typ][i].tail = tail
|
|
||||||
return
|
|
||||||
}
|
|
||||||
}
|
|
||||||
panic("chi: replacing missing child")
|
|
||||||
}
|
|
||||||
|
|
||||||
func (n *node) getEdge(ntyp nodeTyp, label, tail byte, prefix string) *node {
|
|
||||||
nds := n.children[ntyp]
|
|
||||||
for i := 0; i < len(nds); i++ {
|
|
||||||
if nds[i].label == label && nds[i].tail == tail {
|
|
||||||
if ntyp == ntRegexp && nds[i].prefix != prefix {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
return nds[i]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (n *node) setEndpoint(method methodTyp, handler http.Handler, pattern string) {
|
|
||||||
// Set the handler for the method type on the node
|
|
||||||
if n.endpoints == nil {
|
|
||||||
n.endpoints = make(endpoints)
|
|
||||||
}
|
|
||||||
|
|
||||||
paramKeys := patParamKeys(pattern)
|
|
||||||
|
|
||||||
if method&mSTUB == mSTUB {
|
|
||||||
n.endpoints.Value(mSTUB).handler = handler
|
|
||||||
}
|
|
||||||
if method&mALL == mALL {
|
|
||||||
h := n.endpoints.Value(mALL)
|
|
||||||
h.handler = handler
|
|
||||||
h.pattern = pattern
|
|
||||||
h.paramKeys = paramKeys
|
|
||||||
for _, m := range methodMap {
|
|
||||||
h := n.endpoints.Value(m)
|
|
||||||
h.handler = handler
|
|
||||||
h.pattern = pattern
|
|
||||||
h.paramKeys = paramKeys
|
|
||||||
}
|
|
||||||
} else {
|
|
||||||
h := n.endpoints.Value(method)
|
|
||||||
h.handler = handler
|
|
||||||
h.pattern = pattern
|
|
||||||
h.paramKeys = paramKeys
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (n *node) FindRoute(rctx *Context, method methodTyp, path string) (*node, endpoints, http.Handler) {
|
|
||||||
// Reset the context routing pattern and params
|
|
||||||
rctx.routePattern = ""
|
|
||||||
rctx.routeParams.Keys = rctx.routeParams.Keys[:0]
|
|
||||||
rctx.routeParams.Values = rctx.routeParams.Values[:0]
|
|
||||||
|
|
||||||
// Find the routing handlers for the path
|
|
||||||
rn := n.findRoute(rctx, method, path)
|
|
||||||
if rn == nil {
|
|
||||||
return nil, nil, nil
|
|
||||||
}
|
|
||||||
|
|
||||||
// Record the routing params in the request lifecycle
|
|
||||||
rctx.URLParams.Keys = append(rctx.URLParams.Keys, rctx.routeParams.Keys...)
|
|
||||||
rctx.URLParams.Values = append(rctx.URLParams.Values, rctx.routeParams.Values...)
|
|
||||||
|
|
||||||
// Record the routing pattern in the request lifecycle
|
|
||||||
if rn.endpoints[method].pattern != "" {
|
|
||||||
rctx.routePattern = rn.endpoints[method].pattern
|
|
||||||
rctx.RoutePatterns = append(rctx.RoutePatterns, rctx.routePattern)
|
|
||||||
}
|
|
||||||
|
|
||||||
return rn, rn.endpoints, rn.endpoints[method].handler
|
|
||||||
}
|
|
||||||
|
|
||||||
// Recursive edge traversal by checking all nodeTyp groups along the way.
|
|
||||||
// It's like searching through a multi-dimensional radix trie.
|
|
||||||
func (n *node) findRoute(rctx *Context, method methodTyp, path string) *node {
|
|
||||||
nn := n
|
|
||||||
search := path
|
|
||||||
|
|
||||||
for t, nds := range nn.children {
|
|
||||||
ntyp := nodeTyp(t)
|
|
||||||
if len(nds) == 0 {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
|
|
||||||
var xn *node
|
|
||||||
xsearch := search
|
|
||||||
|
|
||||||
var label byte
|
|
||||||
if search != "" {
|
|
||||||
label = search[0]
|
|
||||||
}
|
|
||||||
|
|
||||||
switch ntyp {
|
|
||||||
case ntStatic:
|
|
||||||
xn = nds.findEdge(label)
|
|
||||||
if xn == nil || !strings.HasPrefix(xsearch, xn.prefix) {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
xsearch = xsearch[len(xn.prefix):]
|
|
||||||
|
|
||||||
case ntParam, ntRegexp:
|
|
||||||
// short-circuit and return no matching route for empty param values
|
|
||||||
if xsearch == "" {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
|
|
||||||
// serially loop through each node grouped by the tail delimiter
|
|
||||||
for idx := 0; idx < len(nds); idx++ {
|
|
||||||
xn = nds[idx]
|
|
||||||
|
|
||||||
// label for param nodes is the delimiter byte
|
|
||||||
p := strings.IndexByte(xsearch, xn.tail)
|
|
||||||
|
|
||||||
if p < 0 {
|
|
||||||
if xn.tail == '/' {
|
|
||||||
p = len(xsearch)
|
|
||||||
} else {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
} else if ntyp == ntRegexp && p == 0 {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
|
|
||||||
if ntyp == ntRegexp && xn.rex != nil {
|
|
||||||
if !xn.rex.MatchString(xsearch[:p]) {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
} else if strings.IndexByte(xsearch[:p], '/') != -1 {
|
|
||||||
// avoid a match across path segments
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
|
|
||||||
prevlen := len(rctx.routeParams.Values)
|
|
||||||
rctx.routeParams.Values = append(rctx.routeParams.Values, xsearch[:p])
|
|
||||||
xsearch = xsearch[p:]
|
|
||||||
|
|
||||||
if len(xsearch) == 0 {
|
|
||||||
if xn.isLeaf() {
|
|
||||||
h := xn.endpoints[method]
|
|
||||||
if h != nil && h.handler != nil {
|
|
||||||
rctx.routeParams.Keys = append(rctx.routeParams.Keys, h.paramKeys...)
|
|
||||||
return xn
|
|
||||||
}
|
|
||||||
|
|
||||||
for endpoints := range xn.endpoints {
|
|
||||||
if endpoints == mALL || endpoints == mSTUB {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
rctx.methodsAllowed = append(rctx.methodsAllowed, endpoints)
|
|
||||||
}
|
|
||||||
|
|
||||||
// flag that the routing context found a route, but not a corresponding
|
|
||||||
// supported method
|
|
||||||
rctx.methodNotAllowed = true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// recursively find the next node on this branch
|
|
||||||
fin := xn.findRoute(rctx, method, xsearch)
|
|
||||||
if fin != nil {
|
|
||||||
return fin
|
|
||||||
}
|
|
||||||
|
|
||||||
// not found on this branch, reset vars
|
|
||||||
rctx.routeParams.Values = rctx.routeParams.Values[:prevlen]
|
|
||||||
xsearch = search
|
|
||||||
}
|
|
||||||
|
|
||||||
rctx.routeParams.Values = append(rctx.routeParams.Values, "")
|
|
||||||
|
|
||||||
default:
|
|
||||||
// catch-all nodes
|
|
||||||
rctx.routeParams.Values = append(rctx.routeParams.Values, search)
|
|
||||||
xn = nds[0]
|
|
||||||
xsearch = ""
|
|
||||||
}
|
|
||||||
|
|
||||||
if xn == nil {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
|
|
||||||
// did we find it yet?
|
|
||||||
if len(xsearch) == 0 {
|
|
||||||
if xn.isLeaf() {
|
|
||||||
h := xn.endpoints[method]
|
|
||||||
if h != nil && h.handler != nil {
|
|
||||||
rctx.routeParams.Keys = append(rctx.routeParams.Keys, h.paramKeys...)
|
|
||||||
return xn
|
|
||||||
}
|
|
||||||
|
|
||||||
for endpoints := range xn.endpoints {
|
|
||||||
if endpoints == mALL || endpoints == mSTUB {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
rctx.methodsAllowed = append(rctx.methodsAllowed, endpoints)
|
|
||||||
}
|
|
||||||
|
|
||||||
// flag that the routing context found a route, but not a corresponding
|
|
||||||
// supported method
|
|
||||||
rctx.methodNotAllowed = true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// recursively find the next node..
|
|
||||||
fin := xn.findRoute(rctx, method, xsearch)
|
|
||||||
if fin != nil {
|
|
||||||
return fin
|
|
||||||
}
|
|
||||||
|
|
||||||
// Did not find final handler, let's remove the param here if it was set
|
|
||||||
if xn.typ > ntStatic {
|
|
||||||
if len(rctx.routeParams.Values) > 0 {
|
|
||||||
rctx.routeParams.Values = rctx.routeParams.Values[:len(rctx.routeParams.Values)-1]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
}
|
|
||||||
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (n *node) findEdge(ntyp nodeTyp, label byte) *node {
|
|
||||||
nds := n.children[ntyp]
|
|
||||||
num := len(nds)
|
|
||||||
idx := 0
|
|
||||||
|
|
||||||
switch ntyp {
|
|
||||||
case ntStatic, ntParam, ntRegexp:
|
|
||||||
i, j := 0, num-1
|
|
||||||
for i <= j {
|
|
||||||
idx = i + (j-i)/2
|
|
||||||
if label > nds[idx].label {
|
|
||||||
i = idx + 1
|
|
||||||
} else if label < nds[idx].label {
|
|
||||||
j = idx - 1
|
|
||||||
} else {
|
|
||||||
i = num // breaks cond
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if nds[idx].label != label {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
return nds[idx]
|
|
||||||
|
|
||||||
default: // catch all
|
|
||||||
return nds[idx]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (n *node) isLeaf() bool {
|
|
||||||
return n.endpoints != nil
|
|
||||||
}
|
|
||||||
|
|
||||||
func (n *node) findPattern(pattern string) bool {
|
|
||||||
nn := n
|
|
||||||
for _, nds := range nn.children {
|
|
||||||
if len(nds) == 0 {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
|
|
||||||
n = nn.findEdge(nds[0].typ, pattern[0])
|
|
||||||
if n == nil {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
|
|
||||||
var idx int
|
|
||||||
var xpattern string
|
|
||||||
|
|
||||||
switch n.typ {
|
|
||||||
case ntStatic:
|
|
||||||
idx = longestPrefix(pattern, n.prefix)
|
|
||||||
if idx < len(n.prefix) {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
|
|
||||||
case ntParam, ntRegexp:
|
|
||||||
idx = strings.IndexByte(pattern, '}') + 1
|
|
||||||
|
|
||||||
case ntCatchAll:
|
|
||||||
idx = longestPrefix(pattern, "*")
|
|
||||||
|
|
||||||
default:
|
|
||||||
panic("chi: unknown node type")
|
|
||||||
}
|
|
||||||
|
|
||||||
xpattern = pattern[idx:]
|
|
||||||
if len(xpattern) == 0 {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
|
|
||||||
return n.findPattern(xpattern)
|
|
||||||
}
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
|
|
||||||
func (n *node) routes() []Route {
|
|
||||||
rts := []Route{}
|
|
||||||
|
|
||||||
n.walk(func(eps endpoints, subroutes Routes) bool {
|
|
||||||
if eps[mSTUB] != nil && eps[mSTUB].handler != nil && subroutes == nil {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
|
|
||||||
// Group methodHandlers by unique patterns
|
|
||||||
pats := make(map[string]endpoints)
|
|
||||||
|
|
||||||
for mt, h := range eps {
|
|
||||||
if h.pattern == "" {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
p, ok := pats[h.pattern]
|
|
||||||
if !ok {
|
|
||||||
p = endpoints{}
|
|
||||||
pats[h.pattern] = p
|
|
||||||
}
|
|
||||||
p[mt] = h
|
|
||||||
}
|
|
||||||
|
|
||||||
for p, mh := range pats {
|
|
||||||
hs := make(map[string]http.Handler)
|
|
||||||
if mh[mALL] != nil && mh[mALL].handler != nil {
|
|
||||||
hs["*"] = mh[mALL].handler
|
|
||||||
}
|
|
||||||
|
|
||||||
for mt, h := range mh {
|
|
||||||
if h.handler == nil {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
m := methodTypString(mt)
|
|
||||||
if m == "" {
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
hs[m] = h.handler
|
|
||||||
}
|
|
||||||
|
|
||||||
rt := Route{subroutes, hs, p}
|
|
||||||
rts = append(rts, rt)
|
|
||||||
}
|
|
||||||
|
|
||||||
return false
|
|
||||||
})
|
|
||||||
|
|
||||||
return rts
|
|
||||||
}
|
|
||||||
|
|
||||||
func (n *node) walk(fn func(eps endpoints, subroutes Routes) bool) bool {
|
|
||||||
// Visit the leaf values if any
|
|
||||||
if (n.endpoints != nil || n.subroutes != nil) && fn(n.endpoints, n.subroutes) {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
|
|
||||||
// Recurse on the children
|
|
||||||
for _, ns := range n.children {
|
|
||||||
for _, cn := range ns {
|
|
||||||
if cn.walk(fn) {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
|
|
||||||
// patNextSegment returns the next segment details from a pattern:
|
|
||||||
// node type, param key, regexp string, param tail byte, param starting index, param ending index
|
|
||||||
func patNextSegment(pattern string) (nodeTyp, string, string, byte, int, int) {
|
|
||||||
ps := strings.Index(pattern, "{")
|
|
||||||
ws := strings.Index(pattern, "*")
|
|
||||||
|
|
||||||
if ps < 0 && ws < 0 {
|
|
||||||
return ntStatic, "", "", 0, 0, len(pattern) // we return the entire thing
|
|
||||||
}
|
|
||||||
|
|
||||||
// Sanity check
|
|
||||||
if ps >= 0 && ws >= 0 && ws < ps {
|
|
||||||
panic("chi: wildcard '*' must be the last pattern in a route, otherwise use a '{param}'")
|
|
||||||
}
|
|
||||||
|
|
||||||
var tail byte = '/' // Default endpoint tail to / byte
|
|
||||||
|
|
||||||
if ps >= 0 {
|
|
||||||
// Param/Regexp pattern is next
|
|
||||||
nt := ntParam
|
|
||||||
|
|
||||||
// Read to closing } taking into account opens and closes in curl count (cc)
|
|
||||||
cc := 0
|
|
||||||
pe := ps
|
|
||||||
for i, c := range pattern[ps:] {
|
|
||||||
if c == '{' {
|
|
||||||
cc++
|
|
||||||
} else if c == '}' {
|
|
||||||
cc--
|
|
||||||
if cc == 0 {
|
|
||||||
pe = ps + i
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if pe == ps {
|
|
||||||
panic("chi: route param closing delimiter '}' is missing")
|
|
||||||
}
|
|
||||||
|
|
||||||
key := pattern[ps+1 : pe]
|
|
||||||
pe++ // set end to next position
|
|
||||||
|
|
||||||
if pe < len(pattern) {
|
|
||||||
tail = pattern[pe]
|
|
||||||
}
|
|
||||||
|
|
||||||
key, rexpat, isRegexp := strings.Cut(key, ":")
|
|
||||||
if isRegexp {
|
|
||||||
nt = ntRegexp
|
|
||||||
}
|
|
||||||
|
|
||||||
if len(rexpat) > 0 {
|
|
||||||
if rexpat[0] != '^' {
|
|
||||||
rexpat = "^" + rexpat
|
|
||||||
}
|
|
||||||
if rexpat[len(rexpat)-1] != '$' {
|
|
||||||
rexpat += "$"
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return nt, key, rexpat, tail, ps, pe
|
|
||||||
}
|
|
||||||
|
|
||||||
// Wildcard pattern as finale
|
|
||||||
if ws < len(pattern)-1 {
|
|
||||||
panic("chi: wildcard '*' must be the last value in a route. trim trailing text or use a '{param}' instead")
|
|
||||||
}
|
|
||||||
return ntCatchAll, "*", "", 0, ws, len(pattern)
|
|
||||||
}
|
|
||||||
|
|
||||||
func patParamKeys(pattern string) []string {
|
|
||||||
pat := pattern
|
|
||||||
paramKeys := []string{}
|
|
||||||
for {
|
|
||||||
ptyp, paramKey, _, _, _, e := patNextSegment(pat)
|
|
||||||
if ptyp == ntStatic {
|
|
||||||
return paramKeys
|
|
||||||
}
|
|
||||||
for i := 0; i < len(paramKeys); i++ {
|
|
||||||
if paramKeys[i] == paramKey {
|
|
||||||
panic(fmt.Sprintf("chi: routing pattern '%s' contains duplicate param key, '%s'", pattern, paramKey))
|
|
||||||
}
|
|
||||||
}
|
|
||||||
paramKeys = append(paramKeys, paramKey)
|
|
||||||
pat = pat[e:]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// longestPrefix finds the length of the shared prefix
|
|
||||||
// of two strings
|
|
||||||
func longestPrefix(k1, k2 string) int {
|
|
||||||
max := len(k1)
|
|
||||||
if l := len(k2); l < max {
|
|
||||||
max = l
|
|
||||||
}
|
|
||||||
var i int
|
|
||||||
for i = 0; i < max; i++ {
|
|
||||||
if k1[i] != k2[i] {
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return i
|
|
||||||
}
|
|
||||||
|
|
||||||
func methodTypString(method methodTyp) string {
|
|
||||||
for s, t := range methodMap {
|
|
||||||
if method == t {
|
|
||||||
return s
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return ""
|
|
||||||
}
|
|
||||||
|
|
||||||
type nodes []*node
|
|
||||||
|
|
||||||
// Sort the list of nodes by label
|
|
||||||
func (ns nodes) Sort() { sort.Sort(ns); ns.tailSort() }
|
|
||||||
func (ns nodes) Len() int { return len(ns) }
|
|
||||||
func (ns nodes) Swap(i, j int) { ns[i], ns[j] = ns[j], ns[i] }
|
|
||||||
func (ns nodes) Less(i, j int) bool { return ns[i].label < ns[j].label }
|
|
||||||
|
|
||||||
// tailSort pushes nodes with '/' as the tail to the end of the list for param nodes.
|
|
||||||
// The list order determines the traversal order.
|
|
||||||
func (ns nodes) tailSort() {
|
|
||||||
for i := len(ns) - 1; i >= 0; i-- {
|
|
||||||
if ns[i].typ > ntStatic && ns[i].tail == '/' {
|
|
||||||
ns.Swap(i, len(ns)-1)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
func (ns nodes) findEdge(label byte) *node {
|
|
||||||
num := len(ns)
|
|
||||||
idx := 0
|
|
||||||
i, j := 0, num-1
|
|
||||||
for i <= j {
|
|
||||||
idx = i + (j-i)/2
|
|
||||||
if label > ns[idx].label {
|
|
||||||
i = idx + 1
|
|
||||||
} else if label < ns[idx].label {
|
|
||||||
j = idx - 1
|
|
||||||
} else {
|
|
||||||
i = num // breaks cond
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if ns[idx].label != label {
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
return ns[idx]
|
|
||||||
}
|
|
||||||
|
|
||||||
// Route describes the details of a routing handler.
|
|
||||||
// Handlers map key is an HTTP method
|
|
||||||
type Route struct {
|
|
||||||
SubRoutes Routes
|
|
||||||
Handlers map[string]http.Handler
|
|
||||||
Pattern string
|
|
||||||
}
|
|
||||||
|
|
||||||
// WalkFunc is the type of the function called for each method and route visited by Walk.
|
|
||||||
type WalkFunc func(method string, route string, handler http.Handler, middlewares ...func(http.Handler) http.Handler) error
|
|
||||||
|
|
||||||
// Walk walks any router tree that implements Routes interface.
|
|
||||||
func Walk(r Routes, walkFn WalkFunc) error {
|
|
||||||
return walk(r, walkFn, "")
|
|
||||||
}
|
|
||||||
|
|
||||||
func walk(r Routes, walkFn WalkFunc, parentRoute string, parentMw ...func(http.Handler) http.Handler) error {
|
|
||||||
for _, route := range r.Routes() {
|
|
||||||
mws := make([]func(http.Handler) http.Handler, len(parentMw))
|
|
||||||
copy(mws, parentMw)
|
|
||||||
mws = append(mws, r.Middlewares()...)
|
|
||||||
|
|
||||||
if route.SubRoutes != nil {
|
|
||||||
if err := walk(route.SubRoutes, walkFn, parentRoute+route.Pattern, mws...); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
|
|
||||||
for method, handler := range route.Handlers {
|
|
||||||
if method == "*" {
|
|
||||||
// Ignore a "catchAll" method, since we pass down all the specific methods for each route.
|
|
||||||
continue
|
|
||||||
}
|
|
||||||
|
|
||||||
fullRoute := parentRoute + route.Pattern
|
|
||||||
fullRoute = strings.Replace(fullRoute, "/*/", "/", -1)
|
|
||||||
|
|
||||||
if chain, ok := handler.(*ChainHandler); ok {
|
|
||||||
if err := walkFn(method, fullRoute, chain.Endpoint, append(mws, chain.Middlewares...)...); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
} else {
|
|
||||||
if err := walkFn(method, fullRoute, handler, mws...); err != nil {
|
|
||||||
return err
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
return nil
|
|
||||||
}
|
|
||||||
21
vendor/github.com/go-chi/cors/LICENSE
generated
vendored
21
vendor/github.com/go-chi/cors/LICENSE
generated
vendored
@@ -1,21 +0,0 @@
|
|||||||
Copyright (c) 2014 Olivier Poitrey <rs@dailymotion.com>
|
|
||||||
Copyright (c) 2016-Present https://github.com/go-chi authors
|
|
||||||
|
|
||||||
MIT License
|
|
||||||
|
|
||||||
Permission is hereby granted, free of charge, to any person obtaining a copy of
|
|
||||||
this software and associated documentation files (the "Software"), to deal in
|
|
||||||
the Software without restriction, including without limitation the rights to
|
|
||||||
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
|
|
||||||
the Software, and to permit persons to whom the Software is furnished to do so,
|
|
||||||
subject to the following conditions:
|
|
||||||
|
|
||||||
The above copyright notice and this permission notice shall be included in all
|
|
||||||
copies or substantial portions of the Software.
|
|
||||||
|
|
||||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
||||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
|
|
||||||
FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
|
|
||||||
COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
|
|
||||||
IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
|
|
||||||
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
||||||
43
vendor/github.com/go-chi/cors/README.md
generated
vendored
43
vendor/github.com/go-chi/cors/README.md
generated
vendored
@@ -1,43 +0,0 @@
|
|||||||
# CORS net/http middleware
|
|
||||||
|
|
||||||
[go-chi/cors](https://github.com/go-chi/cors) is a fork of [github.com/rs/cors](https://github.com/rs/cors) that
|
|
||||||
provides a `net/http` compatible middleware for performing preflight CORS checks on the server side. These headers
|
|
||||||
are required for using the browser native [Fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API).
|
|
||||||
|
|
||||||
This middleware is designed to be used as a top-level middleware on the [chi](https://github.com/go-chi/chi) router.
|
|
||||||
Applying with within a `r.Group()` or using `With()` will not work without routes matching `OPTIONS` added.
|
|
||||||
|
|
||||||
## Install
|
|
||||||
|
|
||||||
`go get github.com/go-chi/cors`
|
|
||||||
|
|
||||||
## Usage
|
|
||||||
|
|
||||||
```go
|
|
||||||
func main() {
|
|
||||||
r := chi.NewRouter()
|
|
||||||
|
|
||||||
// Basic CORS
|
|
||||||
// for more ideas, see: https://developer.github.com/v3/#cross-origin-resource-sharing
|
|
||||||
r.Use(cors.Handler(cors.Options{
|
|
||||||
// AllowedOrigins: []string{"https://foo.com"}, // Use this to allow specific origin hosts
|
|
||||||
AllowedOrigins: []string{"https://*", "http://*"},
|
|
||||||
// AllowOriginFunc: func(r *http.Request, origin string) bool { return true },
|
|
||||||
AllowedMethods: []string{"GET", "POST", "PUT", "DELETE", "OPTIONS"},
|
|
||||||
AllowedHeaders: []string{"Accept", "Authorization", "Content-Type", "X-CSRF-Token"},
|
|
||||||
ExposedHeaders: []string{"Link"},
|
|
||||||
AllowCredentials: false,
|
|
||||||
MaxAge: 300, // Maximum value not ignored by any of major browsers
|
|
||||||
}))
|
|
||||||
|
|
||||||
r.Get("/", func(w http.ResponseWriter, r *http.Request) {
|
|
||||||
w.Write([]byte("welcome"))
|
|
||||||
})
|
|
||||||
|
|
||||||
http.ListenAndServe(":3000", r)
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
## Credits
|
|
||||||
|
|
||||||
All credit for the original work of this middleware goes out to [github.com/rs](https://github.com/rs).
|
|
||||||
402
vendor/github.com/go-chi/cors/cors.go
generated
vendored
402
vendor/github.com/go-chi/cors/cors.go
generated
vendored
@@ -1,402 +0,0 @@
|
|||||||
// cors package is net/http handler to handle CORS related requests
|
|
||||||
// as defined by http://www.w3.org/TR/cors/
|
|
||||||
//
|
|
||||||
// You can configure it by passing an option struct to cors.New:
|
|
||||||
//
|
|
||||||
// c := cors.New(cors.Options{
|
|
||||||
// AllowedOrigins: []string{"foo.com"},
|
|
||||||
// AllowedMethods: []string{"GET", "POST", "DELETE"},
|
|
||||||
// AllowCredentials: true,
|
|
||||||
// })
|
|
||||||
//
|
|
||||||
// Then insert the handler in the chain:
|
|
||||||
//
|
|
||||||
// handler = c.Handler(handler)
|
|
||||||
//
|
|
||||||
// See Options documentation for more options.
|
|
||||||
//
|
|
||||||
// The resulting handler is a standard net/http handler.
|
|
||||||
package cors
|
|
||||||
|
|
||||||
import (
|
|
||||||
"log"
|
|
||||||
"net/http"
|
|
||||||
"os"
|
|
||||||
"strconv"
|
|
||||||
"strings"
|
|
||||||
)
|
|
||||||
|
|
||||||
// Options is a configuration container to setup the CORS middleware.
|
|
||||||
type Options struct {
|
|
||||||
// AllowedOrigins is a list of origins a cross-domain request can be executed from.
|
|
||||||
// If the special "*" value is present in the list, all origins will be allowed.
|
|
||||||
// An origin may contain a wildcard (*) to replace 0 or more characters
|
|
||||||
// (i.e.: http://*.domain.com). Usage of wildcards implies a small performance penalty.
|
|
||||||
// Only one wildcard can be used per origin.
|
|
||||||
// Default value is ["*"]
|
|
||||||
AllowedOrigins []string
|
|
||||||
|
|
||||||
// AllowOriginFunc is a custom function to validate the origin. It takes the origin
|
|
||||||
// as argument and returns true if allowed or false otherwise. If this option is
|
|
||||||
// set, the content of AllowedOrigins is ignored.
|
|
||||||
AllowOriginFunc func(r *http.Request, origin string) bool
|
|
||||||
|
|
||||||
// AllowedMethods is a list of methods the client is allowed to use with
|
|
||||||
// cross-domain requests. Default value is simple methods (HEAD, GET and POST).
|
|
||||||
AllowedMethods []string
|
|
||||||
|
|
||||||
// AllowedHeaders is list of non simple headers the client is allowed to use with
|
|
||||||
// cross-domain requests.
|
|
||||||
// If the special "*" value is present in the list, all headers will be allowed.
|
|
||||||
// Default value is [] but "Origin" is always appended to the list.
|
|
||||||
AllowedHeaders []string
|
|
||||||
|
|
||||||
// ExposedHeaders indicates which headers are safe to expose to the API of a CORS
|
|
||||||
// API specification
|
|
||||||
ExposedHeaders []string
|
|
||||||
|
|
||||||
// AllowCredentials indicates whether the request can include user credentials like
|
|
||||||
// cookies, HTTP authentication or client side SSL certificates.
|
|
||||||
AllowCredentials bool
|
|
||||||
|
|
||||||
// MaxAge indicates how long (in seconds) the results of a preflight request
|
|
||||||
// can be cached
|
|
||||||
MaxAge int
|
|
||||||
|
|
||||||
// OptionsPassthrough instructs preflight to let other potential next handlers to
|
|
||||||
// process the OPTIONS method. Turn this on if your application handles OPTIONS.
|
|
||||||
OptionsPassthrough bool
|
|
||||||
|
|
||||||
// Debugging flag adds additional output to debug server side CORS issues
|
|
||||||
Debug bool
|
|
||||||
}
|
|
||||||
|
|
||||||
// Logger generic interface for logger
|
|
||||||
type Logger interface {
|
|
||||||
Printf(string, ...interface{})
|
|
||||||
}
|
|
||||||
|
|
||||||
// Cors http handler
|
|
||||||
type Cors struct {
|
|
||||||
// Debug logger
|
|
||||||
Log Logger
|
|
||||||
|
|
||||||
// Normalized list of plain allowed origins
|
|
||||||
allowedOrigins []string
|
|
||||||
|
|
||||||
// List of allowed origins containing wildcards
|
|
||||||
allowedWOrigins []wildcard
|
|
||||||
|
|
||||||
// Optional origin validator function
|
|
||||||
allowOriginFunc func(r *http.Request, origin string) bool
|
|
||||||
|
|
||||||
// Normalized list of allowed headers
|
|
||||||
allowedHeaders []string
|
|
||||||
|
|
||||||
// Normalized list of allowed methods
|
|
||||||
allowedMethods []string
|
|
||||||
|
|
||||||
// Normalized list of exposed headers
|
|
||||||
exposedHeaders []string
|
|
||||||
maxAge int
|
|
||||||
|
|
||||||
// Set to true when allowed origins contains a "*"
|
|
||||||
allowedOriginsAll bool
|
|
||||||
|
|
||||||
// Set to true when allowed headers contains a "*"
|
|
||||||
allowedHeadersAll bool
|
|
||||||
|
|
||||||
allowCredentials bool
|
|
||||||
optionPassthrough bool
|
|
||||||
}
|
|
||||||
|
|
||||||
// New creates a new Cors handler with the provided options.
|
|
||||||
func New(options Options) *Cors {
|
|
||||||
c := &Cors{
|
|
||||||
exposedHeaders: convert(options.ExposedHeaders, http.CanonicalHeaderKey),
|
|
||||||
allowOriginFunc: options.AllowOriginFunc,
|
|
||||||
allowCredentials: options.AllowCredentials,
|
|
||||||
maxAge: options.MaxAge,
|
|
||||||
optionPassthrough: options.OptionsPassthrough,
|
|
||||||
}
|
|
||||||
if options.Debug && c.Log == nil {
|
|
||||||
c.Log = log.New(os.Stdout, "[cors] ", log.LstdFlags)
|
|
||||||
}
|
|
||||||
|
|
||||||
// Normalize options
|
|
||||||
// Note: for origins and methods matching, the spec requires a case-sensitive matching.
|
|
||||||
// As it may error prone, we chose to ignore the spec here.
|
|
||||||
|
|
||||||
// Allowed Origins
|
|
||||||
if len(options.AllowedOrigins) == 0 {
|
|
||||||
if options.AllowOriginFunc == nil {
|
|
||||||
// Default is all origins
|
|
||||||
c.allowedOriginsAll = true
|
|
||||||
}
|
|
||||||
} else {
|
|
||||||
c.allowedOrigins = []string{}
|
|
||||||
c.allowedWOrigins = []wildcard{}
|
|
||||||
for _, origin := range options.AllowedOrigins {
|
|
||||||
// Normalize
|
|
||||||
origin = strings.ToLower(origin)
|
|
||||||
if origin == "*" {
|
|
||||||
// If "*" is present in the list, turn the whole list into a match all
|
|
||||||
c.allowedOriginsAll = true
|
|
||||||
c.allowedOrigins = nil
|
|
||||||
c.allowedWOrigins = nil
|
|
||||||
break
|
|
||||||
} else if i := strings.IndexByte(origin, '*'); i >= 0 {
|
|
||||||
// Split the origin in two: start and end string without the *
|
|
||||||
w := wildcard{origin[0:i], origin[i+1:]}
|
|
||||||
c.allowedWOrigins = append(c.allowedWOrigins, w)
|
|
||||||
} else {
|
|
||||||
c.allowedOrigins = append(c.allowedOrigins, origin)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Allowed Headers
|
|
||||||
if len(options.AllowedHeaders) == 0 {
|
|
||||||
// Use sensible defaults
|
|
||||||
c.allowedHeaders = []string{"Origin", "Accept", "Content-Type"}
|
|
||||||
} else {
|
|
||||||
// Origin is always appended as some browsers will always request for this header at preflight
|
|
||||||
c.allowedHeaders = convert(append(options.AllowedHeaders, "Origin"), http.CanonicalHeaderKey)
|
|
||||||
for _, h := range options.AllowedHeaders {
|
|
||||||
if h == "*" {
|
|
||||||
c.allowedHeadersAll = true
|
|
||||||
c.allowedHeaders = nil
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// Allowed Methods
|
|
||||||
if len(options.AllowedMethods) == 0 {
|
|
||||||
// Default is spec's "simple" methods
|
|
||||||
c.allowedMethods = []string{http.MethodGet, http.MethodPost, http.MethodHead}
|
|
||||||
} else {
|
|
||||||
c.allowedMethods = convert(options.AllowedMethods, strings.ToUpper)
|
|
||||||
}
|
|
||||||
|
|
||||||
return c
|
|
||||||
}
|
|
||||||
|
|
||||||
// Handler creates a new Cors handler with passed options.
|
|
||||||
func Handler(options Options) func(next http.Handler) http.Handler {
|
|
||||||
c := New(options)
|
|
||||||
return c.Handler
|
|
||||||
}
|
|
||||||
|
|
||||||
// AllowAll create a new Cors handler with permissive configuration allowing all
|
|
||||||
// origins with all standard methods with any header and credentials.
|
|
||||||
func AllowAll() *Cors {
|
|
||||||
return New(Options{
|
|
||||||
AllowedOrigins: []string{"*"},
|
|
||||||
AllowedMethods: []string{
|
|
||||||
http.MethodHead,
|
|
||||||
http.MethodGet,
|
|
||||||
http.MethodPost,
|
|
||||||
http.MethodPut,
|
|
||||||
http.MethodPatch,
|
|
||||||
http.MethodDelete,
|
|
||||||
},
|
|
||||||
AllowedHeaders: []string{"*"},
|
|
||||||
AllowCredentials: false,
|
|
||||||
})
|
|
||||||
}
|
|
||||||
|
|
||||||
// Handler apply the CORS specification on the request, and add relevant CORS headers
|
|
||||||
// as necessary.
|
|
||||||
func (c *Cors) Handler(next http.Handler) http.Handler {
|
|
||||||
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
|
||||||
// null or empty Origin header value is acceptable and it is considered having that header
|
|
||||||
_, hasOriginHeader := r.Header["Origin"]
|
|
||||||
|
|
||||||
if r.Method == http.MethodOptions && r.Header.Get("Access-Control-Request-Method") != "" && hasOriginHeader {
|
|
||||||
c.logf("Handler: Preflight request")
|
|
||||||
c.handlePreflight(w, r)
|
|
||||||
// Preflight requests are standalone and should stop the chain as some other
|
|
||||||
// middleware may not handle OPTIONS requests correctly. One typical example
|
|
||||||
// is authentication middleware ; OPTIONS requests won't carry authentication
|
|
||||||
// headers (see #1)
|
|
||||||
if c.optionPassthrough {
|
|
||||||
next.ServeHTTP(w, r)
|
|
||||||
} else {
|
|
||||||
w.WriteHeader(http.StatusOK)
|
|
||||||
}
|
|
||||||
} else {
|
|
||||||
c.logf("Handler: Actual request")
|
|
||||||
c.handleActualRequest(w, r)
|
|
||||||
next.ServeHTTP(w, r)
|
|
||||||
}
|
|
||||||
})
|
|
||||||
}
|
|
||||||
|
|
||||||
// handlePreflight handles pre-flight CORS requests
|
|
||||||
func (c *Cors) handlePreflight(w http.ResponseWriter, r *http.Request) {
|
|
||||||
headers := w.Header()
|
|
||||||
origin := r.Header.Get("Origin")
|
|
||||||
|
|
||||||
if r.Method != http.MethodOptions {
|
|
||||||
c.logf("Preflight aborted: %s!=OPTIONS", r.Method)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
// Always set Vary headers
|
|
||||||
// see https://github.com/rs/cors/issues/10,
|
|
||||||
// https://github.com/rs/cors/commit/dbdca4d95feaa7511a46e6f1efb3b3aa505bc43f#commitcomment-12352001
|
|
||||||
headers.Add("Vary", "Origin")
|
|
||||||
headers.Add("Vary", "Access-Control-Request-Method")
|
|
||||||
headers.Add("Vary", "Access-Control-Request-Headers")
|
|
||||||
|
|
||||||
if !c.isOriginAllowed(r, origin) {
|
|
||||||
c.logf("Preflight aborted: origin '%s' not allowed", origin)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
reqMethod := r.Header.Get("Access-Control-Request-Method")
|
|
||||||
if !c.isMethodAllowed(reqMethod) {
|
|
||||||
c.logf("Preflight aborted: method '%s' not allowed", reqMethod)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
reqHeaders := parseHeaderList(r.Header.Get("Access-Control-Request-Headers"))
|
|
||||||
if !c.areHeadersAllowed(reqHeaders) {
|
|
||||||
c.logf("Preflight aborted: headers '%v' not allowed", reqHeaders)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
if c.allowedOriginsAll {
|
|
||||||
headers.Set("Access-Control-Allow-Origin", "*")
|
|
||||||
} else {
|
|
||||||
headers.Set("Access-Control-Allow-Origin", origin)
|
|
||||||
}
|
|
||||||
// Spec says: Since the list of methods can be unbounded, simply returning the method indicated
|
|
||||||
// by Access-Control-Request-Method (if supported) can be enough
|
|
||||||
headers.Set("Access-Control-Allow-Methods", strings.ToUpper(reqMethod))
|
|
||||||
if len(reqHeaders) > 0 {
|
|
||||||
|
|
||||||
// Spec says: Since the list of headers can be unbounded, simply returning supported headers
|
|
||||||
// from Access-Control-Request-Headers can be enough
|
|
||||||
headers.Set("Access-Control-Allow-Headers", strings.Join(reqHeaders, ", "))
|
|
||||||
}
|
|
||||||
if c.allowCredentials {
|
|
||||||
headers.Set("Access-Control-Allow-Credentials", "true")
|
|
||||||
}
|
|
||||||
if c.maxAge > 0 {
|
|
||||||
headers.Set("Access-Control-Max-Age", strconv.Itoa(c.maxAge))
|
|
||||||
}
|
|
||||||
c.logf("Preflight response headers: %v", headers)
|
|
||||||
}
|
|
||||||
|
|
||||||
// handleActualRequest handles simple cross-origin requests, actual request or redirects
|
|
||||||
func (c *Cors) handleActualRequest(w http.ResponseWriter, r *http.Request) {
|
|
||||||
headers := w.Header()
|
|
||||||
// null Origin header value is acceptable and it is considered having that header
|
|
||||||
_, hasOriginHeader := r.Header["Origin"]
|
|
||||||
|
|
||||||
// Always set Vary, see https://github.com/rs/cors/issues/10
|
|
||||||
headers.Add("Vary", "Origin")
|
|
||||||
|
|
||||||
if !hasOriginHeader {
|
|
||||||
c.logf("Actual request no headers added: missing origin")
|
|
||||||
return
|
|
||||||
}
|
|
||||||
origin := r.Header.Get("Origin")
|
|
||||||
if !c.isOriginAllowed(r, origin) {
|
|
||||||
c.logf("Actual request no headers added: origin '%s' not allowed", origin)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
// Note that spec does define a way to specifically disallow a simple method like GET or
|
|
||||||
// POST. Access-Control-Allow-Methods is only used for pre-flight requests and the
|
|
||||||
// spec doesn't instruct to check the allowed methods for simple cross-origin requests.
|
|
||||||
// We think it's a nice feature to be able to have control on those methods though.
|
|
||||||
if !c.isMethodAllowed(r.Method) {
|
|
||||||
c.logf("Actual request no headers added: method '%s' not allowed", r.Method)
|
|
||||||
|
|
||||||
return
|
|
||||||
}
|
|
||||||
if c.allowedOriginsAll {
|
|
||||||
headers.Set("Access-Control-Allow-Origin", "*")
|
|
||||||
} else {
|
|
||||||
headers.Set("Access-Control-Allow-Origin", origin)
|
|
||||||
}
|
|
||||||
if len(c.exposedHeaders) > 0 {
|
|
||||||
headers.Set("Access-Control-Expose-Headers", strings.Join(c.exposedHeaders, ", "))
|
|
||||||
}
|
|
||||||
if c.allowCredentials {
|
|
||||||
headers.Set("Access-Control-Allow-Credentials", "true")
|
|
||||||
}
|
|
||||||
c.logf("Actual response added headers: %v", headers)
|
|
||||||
}
|
|
||||||
|
|
||||||
// convenience method. checks if a logger is set.
|
|
||||||
func (c *Cors) logf(format string, a ...interface{}) {
|
|
||||||
if c.Log != nil {
|
|
||||||
c.Log.Printf(format, a...)
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// isOriginAllowed checks if a given origin is allowed to perform cross-domain requests
|
|
||||||
// on the endpoint
|
|
||||||
func (c *Cors) isOriginAllowed(r *http.Request, origin string) bool {
|
|
||||||
if c.allowOriginFunc != nil {
|
|
||||||
return c.allowOriginFunc(r, origin)
|
|
||||||
}
|
|
||||||
if c.allowedOriginsAll {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
origin = strings.ToLower(origin)
|
|
||||||
for _, o := range c.allowedOrigins {
|
|
||||||
if o == origin {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
for _, w := range c.allowedWOrigins {
|
|
||||||
if w.match(origin) {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
|
|
||||||
// isMethodAllowed checks if a given method can be used as part of a cross-domain request
|
|
||||||
// on the endpoint
|
|
||||||
func (c *Cors) isMethodAllowed(method string) bool {
|
|
||||||
if len(c.allowedMethods) == 0 {
|
|
||||||
// If no method allowed, always return false, even for preflight request
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
method = strings.ToUpper(method)
|
|
||||||
if method == http.MethodOptions {
|
|
||||||
// Always allow preflight requests
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
for _, m := range c.allowedMethods {
|
|
||||||
if m == method {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
|
|
||||||
// areHeadersAllowed checks if a given list of headers are allowed to used within
|
|
||||||
// a cross-domain request.
|
|
||||||
func (c *Cors) areHeadersAllowed(requestedHeaders []string) bool {
|
|
||||||
if c.allowedHeadersAll || len(requestedHeaders) == 0 {
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
for _, header := range requestedHeaders {
|
|
||||||
header = http.CanonicalHeaderKey(header)
|
|
||||||
found := false
|
|
||||||
for _, h := range c.allowedHeaders {
|
|
||||||
if h == header {
|
|
||||||
found = true
|
|
||||||
break
|
|
||||||
}
|
|
||||||
}
|
|
||||||
if !found {
|
|
||||||
return false
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return true
|
|
||||||
}
|
|
||||||
70
vendor/github.com/go-chi/cors/utils.go
generated
vendored
70
vendor/github.com/go-chi/cors/utils.go
generated
vendored
@@ -1,70 +0,0 @@
|
|||||||
package cors
|
|
||||||
|
|
||||||
import "strings"
|
|
||||||
|
|
||||||
const toLower = 'a' - 'A'
|
|
||||||
|
|
||||||
type converter func(string) string
|
|
||||||
|
|
||||||
type wildcard struct {
|
|
||||||
prefix string
|
|
||||||
suffix string
|
|
||||||
}
|
|
||||||
|
|
||||||
func (w wildcard) match(s string) bool {
|
|
||||||
return len(s) >= len(w.prefix+w.suffix) && strings.HasPrefix(s, w.prefix) && strings.HasSuffix(s, w.suffix)
|
|
||||||
}
|
|
||||||
|
|
||||||
// convert converts a list of string using the passed converter function
|
|
||||||
func convert(s []string, c converter) []string {
|
|
||||||
out := []string{}
|
|
||||||
for _, i := range s {
|
|
||||||
out = append(out, c(i))
|
|
||||||
}
|
|
||||||
return out
|
|
||||||
}
|
|
||||||
|
|
||||||
// parseHeaderList tokenize + normalize a string containing a list of headers
|
|
||||||
func parseHeaderList(headerList string) []string {
|
|
||||||
l := len(headerList)
|
|
||||||
h := make([]byte, 0, l)
|
|
||||||
upper := true
|
|
||||||
// Estimate the number headers in order to allocate the right splice size
|
|
||||||
t := 0
|
|
||||||
for i := 0; i < l; i++ {
|
|
||||||
if headerList[i] == ',' {
|
|
||||||
t++
|
|
||||||
}
|
|
||||||
}
|
|
||||||
headers := make([]string, 0, t)
|
|
||||||
for i := 0; i < l; i++ {
|
|
||||||
b := headerList[i]
|
|
||||||
if b >= 'a' && b <= 'z' {
|
|
||||||
if upper {
|
|
||||||
h = append(h, b-toLower)
|
|
||||||
} else {
|
|
||||||
h = append(h, b)
|
|
||||||
}
|
|
||||||
} else if b >= 'A' && b <= 'Z' {
|
|
||||||
if !upper {
|
|
||||||
h = append(h, b+toLower)
|
|
||||||
} else {
|
|
||||||
h = append(h, b)
|
|
||||||
}
|
|
||||||
} else if b == '-' || b == '_' || b == '.' || (b >= '0' && b <= '9') {
|
|
||||||
h = append(h, b)
|
|
||||||
}
|
|
||||||
|
|
||||||
if b == ' ' || b == ',' || i == l-1 {
|
|
||||||
if len(h) > 0 {
|
|
||||||
// Flush the found header
|
|
||||||
headers = append(headers, string(h))
|
|
||||||
h = h[:0]
|
|
||||||
upper = true
|
|
||||||
}
|
|
||||||
} else {
|
|
||||||
upper = b == '-'
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return headers
|
|
||||||
}
|
|
||||||
21
vendor/github.com/go-viper/mapstructure/v2/.editorconfig
generated
vendored
21
vendor/github.com/go-viper/mapstructure/v2/.editorconfig
generated
vendored
@@ -1,21 +0,0 @@
|
|||||||
root = true
|
|
||||||
|
|
||||||
[*]
|
|
||||||
charset = utf-8
|
|
||||||
end_of_line = lf
|
|
||||||
indent_size = 4
|
|
||||||
indent_style = space
|
|
||||||
insert_final_newline = true
|
|
||||||
trim_trailing_whitespace = true
|
|
||||||
|
|
||||||
[*.go]
|
|
||||||
indent_style = tab
|
|
||||||
|
|
||||||
[{Makefile,*.mk}]
|
|
||||||
indent_style = tab
|
|
||||||
|
|
||||||
[*.nix]
|
|
||||||
indent_size = 2
|
|
||||||
|
|
||||||
[.golangci.yaml]
|
|
||||||
indent_size = 2
|
|
||||||
4
vendor/github.com/go-viper/mapstructure/v2/.envrc
generated
vendored
4
vendor/github.com/go-viper/mapstructure/v2/.envrc
generated
vendored
@@ -1,4 +0,0 @@
|
|||||||
if ! has nix_direnv_version || ! nix_direnv_version 3.0.4; then
|
|
||||||
source_url "https://raw.githubusercontent.com/nix-community/nix-direnv/3.0.4/direnvrc" "sha256-DzlYZ33mWF/Gs8DDeyjr8mnVmQGx7ASYqA5WlxwvBG4="
|
|
||||||
fi
|
|
||||||
use flake . --impure
|
|
||||||
6
vendor/github.com/go-viper/mapstructure/v2/.gitignore
generated
vendored
6
vendor/github.com/go-viper/mapstructure/v2/.gitignore
generated
vendored
@@ -1,6 +0,0 @@
|
|||||||
/.devenv/
|
|
||||||
/.direnv/
|
|
||||||
/.pre-commit-config.yaml
|
|
||||||
/bin/
|
|
||||||
/build/
|
|
||||||
/var/
|
|
||||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user