hub / github.com/tus/tusd

github.com/tus/tusd @v2.10.0 sqlite

repository ↗ · DeepWiki ↗ · release v2.10.0 ↗

847 symbols 3,172 edges 89 files 408 documented · 48%

README

tusd

Tus logo

tus is a protocol based on HTTP for resumable file uploads. Resumable means that an upload can be interrupted at any moment and can be resumed without re-uploading the previous data again. An interruption may happen willingly, if the user wants to pause, or by accident in case of a network issue or server outage.

tusd is the official reference implementation of the tus resumable upload protocol. The protocol specifies a flexible method to upload files to remote servers using HTTP. The special feature is the ability to pause and resume uploads at any moment allowing to continue seamlessly after e.g. network interruptions.

It is capable of accepting uploads with arbitrary sizes and storing them locally on disk, on Google Cloud Storage or on AWS S3 (or any other S3-compatible storage system). Due to its modularization and extensibility, support for nearly any other cloud provider could easily be added to tusd.

Protocol version: 1.0.0

This branch contains tusd v2. If you are looking for the previous major release, after which breaking changes have been introduced, please look at the 1.13.0 tag.

Documentation

The entire documentation, including guides on installing, using, and configuring tusd can be found on the website: tus.github.io/tusd.

Build status

License

This project is licensed under the MIT license, see LICENSE.txt.

Extension points exported contracts — how you extend this code

HookHandler (Interface)

HookHandler is the main inferface to be implemented by all hook backends. [9 implementers]

pkg/hooks/hooks.go

DataStore (Interface)

DataStore is the base interface for storages to implement. It provides functions to create new uploads and fetch existin [7 …

pkg/handler/datastore.go

GCSReader (Interface)

GCSReader implements cloud.google.com/go/storage.Reader. It is used to read Google Cloud storage objects. TODO: Remain, [3 …

pkg/gcsstore/gcsservice.go

S3API (Interface)

(no doc) [5 implementers]

pkg/s3store/s3store.go

AzBlob (Interface)

(no doc) [4 implementers]

pkg/azurestore/azureservice.go

TerminaterDataStore (Interface)

TerminaterDataStore is the interface which must be implemented by DataStores if they want to receive DELETE requests usi [6 …

pkg/handler/datastore.go

GCSAPI (Interface)

GCSAPI is an interface composed of all the necessary GCS operations that are required to enable the tus protocol to work [3 …

pkg/gcsstore/gcsservice.go

AzService (Interface)

(no doc) [3 implementers]

pkg/azurestore/azureservice.go

Core symbols most depended-on inside this repo

GetUpload

called by 100

pkg/handler/datastore.go

GetInfo

called by 94

pkg/handler/datastore.go

NewHandler

called by 84

pkg/handler/handler.go

sendError

called by 66

pkg/handler/unrouted_handler.go

Set

called by 48

cmd/tusd/cli/flags.go

called by 43

pkg/gcsstore/gcsservice.go

NewUpload

called by 40

pkg/handler/datastore.go

New

called by 37

pkg/s3store/s3store.go

Shape

Method 483

Function 224

Struct 104

Interface 25

TypeAlias 6

Class 5

Languages

Go98%

Python2%

Modules by API surface

pkg/hooks/grpc/proto/hook.pb.go73 symbols

pkg/s3store/s3store.go54 symbols

pkg/handler/handler_mock_test.go46 symbols

pkg/handler/unrouted_handler.go40 symbols

pkg/gcsstore/gcsstore_mock_test.go34 symbols

pkg/azurestore/azureservice.go34 symbols

pkg/handler/datastore.go33 symbols

pkg/gcsstore/gcsservice.go32 symbols

pkg/s3store/s3store_test.go28 symbols

pkg/s3store/s3store_mock_test.go26 symbols

internal/s3log/s3log_mock_test.go26 symbols

pkg/filestore/filestore.go23 symbols

Used by 2 indexed graphs manifest dependencies, hub-wide

github.com/hcengineering/platform

github.com/opencloud-eu/opencloud

Dependencies from manifests, versioned

cel.dev/exprv0.25.1 · 1×

cloud.google.com/gov0.123.0 · 1×

cloud.google.com/go/authv0.20.0 · 1×

cloud.google.com/go/auth/oauth2adaptv0.2.8 · 1×

cloud.google.com/go/compute/metadatav0.9.0 · 1×

cloud.google.com/go/iamv1.7.0 · 1×

cloud.google.com/go/monitoringv1.24.3 · 1×

cloud.google.com/go/storagev1.62.2 · 1×

github.com/Acconut/go-httptest-recorderv1.0.0 · 1×

github.com/Azure/azure-sdk-for-go/sdk/azcorev1.21.1 · 1×

github.com/Azure/azure-sdk-for-go/sdk/azidentityv1.13.1 · 1×

github.com/Azure/azure-sdk-for-go/sdk/internalv1.12.0 · 1×

For agents

$ claude mcp add tusd \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact