v2: Next major version

[Acconut]

Tasks to be done:

General

• change go.mod to ../v2 and update internal references to .../v2 (see v2: Next major version #672 (comment))
• Switch to new structured logging package: https://pkg.go.dev/log/slog@master, https://thedevelopercafe.com/articles/logging-in-go-with-slog-a7bb489755c2
• Pass context values down to storages and hooks while retaining context values (Closes Passing also context.Context to PreUpload and PreFinish callbacks #713, Reusing provided HTTP context in UnroutedHandler #443, Retains HTTP Context values #455, disconnect context in a dedicated middleware #315, Passing the context to sync callbacks #740, Retain request context values while detaching to avoid cancellation. #342)
• Look through TODOs in code
• Look through lint errors in code

Hooks

• docs: Update documentation about hooks
• docs: Add plugin hooks to documentation
• cli: Consider moving hooks in pkg/
• cli: Add tests for hook implementations and system
• handler: Allow modifying the HTTP response when stopping an upload
• grpc: Add headers to hook request
• grpc: Add documentation to proto files
• grpc: Move proto file into better, public location
• plugin: Stop zombie processes when tusd terminates
• plugin: Move into public package. The plugin should not import for the cmd directory
• plugin: Clean up hooks/plugin.go

Locking

• Implement functionality for filelocker
• Adapt implementation at tusd-etcd-locker
• Add tests for new functionality in handler
• Increase default read timeout to reduce their likelihood
• Add documentation

S3

• Upgrade to AWS SDK v2
• Fix file already closed error (Close is already called by HTTP transport)

Testing

• Thorough testing of filestore and s3store under bad network conditions

Release

• Release notes (breaking changes, new features)
• Blog post
• Tweet

[oliverpool]

Somewhere in your checklist, you should also add change go.mod to ../v2 and update internal references to .../v2 (see https://go.dev/doc/modules/major-version) - automated tool: https://github.com/marwan-at-work/mod

Currently the v2 is not importable as a go package:

~ go get github.com/tus/[email protected]
go: github.com/tus/[email protected]: invalid version: module contains a go.mod file, so module path must match major version ("github.com/tus/tusd/v2")

~ go get github.com/tus/tusd/[email protected]
go: github.com/tus/[email protected]: invalid version: module contains a go.mod file, so module path must match major version ("github.com/tus/tusd/v2"

[Acconut]

Thanks for the hint, @oliverpool. We need to look into this, you are right.

[Acconut]

There are still some TODOs, but they can be addressed once this has been merged in main.