{"id":23451224,"url":"https://github.com/peak/s3hash","last_synced_at":"2025-04-13T20:15:11.145Z","repository":{"id":57508651,"uuid":"108282135","full_name":"peak/s3hash","owner":"peak","description":"Calculate/verify ETag of an S3 object, given a file and chunk size","archived":false,"fork":false,"pushed_at":"2020-02-13T16:45:44.000Z","size":11,"stargazers_count":23,"open_issues_count":0,"forks_count":2,"subscribers_count":14,"default_branch":"master","last_synced_at":"2025-04-13T20:15:05.701Z","etag":null,"topics":["amazon-s3","etag","multipart-uploads"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/peak.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-10-25T14:31:42.000Z","updated_at":"2025-03-21T12:52:33.000Z","dependencies_parsed_at":"2022-09-13T07:02:25.548Z","dependency_job_id":null,"html_url":"https://github.com/peak/s3hash","commit_stats":null,"previous_names":["peakgames/s3hash"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peak%2Fs3hash","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peak%2Fs3hash/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peak%2Fs3hash/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/peak%2Fs3hash/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/peak","download_url":"https://codeload.github.com/peak/s3hash/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248774968,"owners_count":21159534,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["amazon-s3","etag","multipart-uploads"],"created_at":"2024-12-24T00:19:52.104Z","updated_at":"2025-04-13T20:15:11.114Z","avatar_url":"https://github.com/peak.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"![MIT License](https://img.shields.io/badge/license-MIT-blue.svg)\n![Tag](https://img.shields.io/github/tag/peakgames/s3hash.svg)\n[![godoc](https://img.shields.io/badge/godoc-reference-blue.svg)](https://godoc.org/github.com/peakgames/s3hash)\n[![Go Report](https://goreportcard.com/badge/github.com/peakgames/s3hash)](https://goreportcard.com/report/github.com/peakgames/s3hash)\n\n# s3hash #\n\nCalculate/verify hash of an S3 object, given a file and chunk size.\n\n# Purpose #\n\nFiles uploaded to Amazon S3 using the S3 multipart API will have unique `ETag` values depending on their contents **and** the chunk size used to upload the file. This package calculates what the `ETag` will be using local file contents, which is useful for:\n\n- Comparing local and remote files without downloading them again\n- Verifying an S3 upload by getting the `ETag` of the uploaded file and comparing it to the one generated locally.\n\nThis will work on all types of S3 objects, regardless of whether they're uploaded using the multipart API or not.\n\n## Installation ##\n\nUsing [go get](https://golang.org/dl/):\n\n    go get -u github.com/peakgames/s3hash/cmd/s3hash\n\nThis will install `s3hash` in your `$GOPATH/bin` directory.\n\nUsing [Homebrew](https://brew.sh/):\n\n    brew tap peakgames/s3hash https://github.com/peakgames/s3hash\n    brew install s3hash\n\n## Usage ##\n\n    Usage: s3hash [OPTION]... \u003cchunk size in MB\u003e \u003cfile\u003e\n\n      -e string\n            Verify the S3 hash of file\n      -p int\n            Use NUM workers to run in parallel (default: number of cores)\n\n## Examples ##\n\nGet hash of local file, to be uploaded to S3 using 15 MB chunks:\n\n    $ s3hash 15 filename.gz\n    adf101740e60ba411adb21d2c50feb64-3\n\nVerify hash of local file\n\n    $ s3hash -e adf101740e60ba411adb21d2c50feb64-3 15 filename.gz\n    OK\n    (exit code 0)\n\n    $ s3hash -e wronghash 15 filename.gz\n    ERROR\n    (exit code 1)\n\n## Build ##\n\nTo build s3hash manually, clone the repository and use `go build`:\n\n    git clone https://github.com/peakgames/s3hash.git\n    cd s3hash\n    go build ./cmd/s3hash\n\n\n## Contributing ##\n\nPlease create an [issue](https://github.com/peakgames/s3hash/issues) and/or a [pull request](https://github.com/peakgames/s3hash/pulls).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeak%2Fs3hash","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpeak%2Fs3hash","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpeak%2Fs3hash/lists"}