{"id":14008062,"url":"https://github.com/hairyhenderson/go-fsimpl","last_synced_at":"2026-02-05T16:06:01.745Z","repository":{"id":37036103,"uuid":"357616167","full_name":"hairyhenderson/go-fsimpl","owner":"hairyhenderson","description":"Go io/fs.FS filesystem implementations for various URL schemes","archived":false,"fork":false,"pushed_at":"2026-01-10T14:08:31.000Z","size":1831,"stargazers_count":319,"open_issues_count":2,"forks_count":25,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-01-11T04:16:32.979Z","etag":null,"topics":["aws","aws-s3","consul","distributed-tracing","filesystem","gcs","git","go","golang","iofs","opentelemetry","s3","url","vault"],"latest_commit_sha":null,"homepage":"https://pkg.go.dev/github.com/hairyhenderson/go-fsimpl","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/hairyhenderson.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"hairyhenderson"}},"created_at":"2021-04-13T16:15:36.000Z","updated_at":"2026-01-10T14:08:22.000Z","dependencies_parsed_at":"2023-02-18T19:00:46.067Z","dependency_job_id":"0c3aa01b-50fd-4393-836b-2fbd6adba776","html_url":"https://github.com/hairyhenderson/go-fsimpl","commit_stats":{"total_commits":528,"total_committers":8,"mean_commits":66.0,"dds":0.2537878787878788,"last_synced_commit":"a936a91ff21c7aab433a3b2e1d2803c10b736adb"},"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"purl":"pkg:github/hairyhenderson/go-fsimpl","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hairyhenderson%2Fgo-fsimpl","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hairyhenderson%2Fgo-fsimpl/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hairyhenderson%2Fgo-fsimpl/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hairyhenderson%2Fgo-fsimpl/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hairyhenderson","download_url":"https://codeload.github.com/hairyhenderson/go-fsimpl/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hairyhenderson%2Fgo-fsimpl/sbom","scorecard":{"id":453031,"data":{"date":"2025-08-11","repo":{"name":"github.com/hairyhenderson/go-fsimpl","commit":"a6c4140c554d25fb1b7d1103f5cff2fcf96fef8b"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":6.8,"checks":[{"name":"Maintained","score":10,"reason":"20 commit(s) and 1 issue activity found in the last 90 days -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Code-Review","score":2,"reason":"Found 1/4 approved changesets -- score normalized to 2","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: topLevel 'contents' permission set to 'write': .github/workflows/benchmark.yml:10","Info: topLevel 'contents' permission set to 'read': .github/workflows/build.yml:10","Info: topLevel 'contents' permission set to 'read': .github/workflows/conventional-commits.yml:13","Info: topLevel 'contents' permission set to 'read': .github/workflows/lint.yml:8","Warn: topLevel 'contents' permission set to 'write': .github/workflows/release-please.yml:9","Info: topLevel 'contents' permission set to 'read': .github/workflows/trivy.yml:14","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Pinned-Dependencies","score":10,"reason":"all dependencies are pinned","details":["Info:  14 out of  14 GitHub-owned GitHubAction dependencies pinned","Info:   5 out of   5 third-party GitHubAction dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Security-Policy","score":9,"reason":"security policy file detected","details":["Info: security policy file detected: github.com/hairyhenderson/.github/SECURITY.md:1","Info: Found linked content: github.com/hairyhenderson/.github/SECURITY.md:1","Warn: One or no descriptive hints of disclosure, vulnerability, and/or timelines in security policy","Info: Found text in security policy: github.com/hairyhenderson/.github/SECURITY.md:1"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"SAST","score":10,"reason":"SAST tool is run on all commits","details":["Info: all commits (30) are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":8,"reason":"2 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GO-2022-0635","Warn: Project is vulnerable to: GO-2022-0646"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-19T08:42:02.010Z","repository_id":37036103,"created_at":"2025-08-19T08:42:02.010Z","updated_at":"2025-08-19T08:42:02.010Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29125114,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-05T14:05:12.718Z","status":"ssl_error","status_checked_at":"2026-02-05T14:03:53.078Z","response_time":65,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["aws","aws-s3","consul","distributed-tracing","filesystem","gcs","git","go","golang","iofs","opentelemetry","s3","url","vault"],"created_at":"2024-08-10T11:01:11.768Z","updated_at":"2026-02-05T16:06:01.739Z","avatar_url":"https://github.com/hairyhenderson.png","language":"Go","funding_links":["https://github.com/sponsors/hairyhenderson"],"categories":["Go"],"sub_categories":[],"readme":"# hairyhenderson/go-fsimpl\n\n[![GoDoc][godoc-image]][godocs]\n[![Build][gh-actions-image]][gh-actions-url]\n\nThis module contains a collection of Go _filesystem implementations_ that can\nbe discovered dynamically by URL scheme.\n\nThese filesystems implement the [`fs.FS`](https://pkg.go.dev/io/fs#FS) interface\n[introduced in Go 1.16](https://go.dev/doc/go1.16#fs). This means that currently all implementations are\nread-only, however this may change in the future (see\n[golang/go#45757](https://github.com/golang/go/issues/45757) for progress).\n\nMost implementations implement the [`fs.ReadDirFS`](https://pkg.go.dev/io/fs#ReadDirFS)\ninterface, though the `httpfs` filesystem does not.\n\nSome extensions are available to help add specific functionality to certain\nfilesystems:\n- `WithContextFS` - injects a context into a filesystem, for propagating\n\tcancellation in filesystems that support it.\n- `WithHeaderFS` - sets the `http.Header` for all HTTP requests used by the\n\tfilesystem. This can be useful for authentication, or for requesting\n\tspecific content types.\n- `WithHTTPClientFS` - sets the `*http.Client` for all HTTP requests to be made\n\twith.\n\nMany of the filesystem packages also have their own extensions.\n\nThis module also provides `ContentType`, an extension to the\n[`fs.FileInfo`](https://pkg.go.dev/io/fs#FileInfo) type to help identify an\nappropriate MIME content type for a given file. For filesystems that support it,\nthe HTTP `Content-Type` header is used for this. Otherwise, the type is guessed\nfrom the file extension.\n\n## History \u0026 Project Status\n\nThis module is _in active development_, and the API is still subject to breaking\nchanges.\n\nThe filesystem packages should operate correctly, based on the tests, but there\nmay be edge cases that are not covered. Please open an issue if you find one!\n\nMost of these filesystems are based on code from [gomplate](https://github.com/hairyhenderson/gomplate),\nwhich supports all of these as datasources. This module is intended to \neventually be used within gomplate.\n\n## Supported Filesystems\n\nHere's the list of filesystems \u0026 URL schemes supported by this module:\n\n| Package    | Scheme(s) | Description |\n|------------|-----------|-------------|\n| [awsimdsfs]| `aws+imds` | [AWS IMDS][] |\n| [awssmfs]  | `aws+sm` | [AWS Secrets Manager][] |\n| [awssmpfs] | `aws+smp` | [AWS Systems Manager Parameter Store][AWS SMP] |\n| [blobfs]   | `azblob` | [Azure Blob Storage][] |\n| [blobfs]   | `gs` | [Google Cloud Storage][] |\n| [blobfs]   | `s3` | [Amazon S3][] |\n| [consulfs] | `consul`, `consul+http`, `consul+https` | [HashiCorp Consul][] |\n| [filefs]   | `file` | local filesystem |\n| [gcpmetafs] | `gcp+meta` | [GCP Metadata][] |\n| [gitfs]    | `git`, `git+file`, `git+http`, `git+https`, `git+ssh` | local/remote git repository |\n| [httpfs]   | `http`, `https` | HTTP server |\n| [tracefs]  | n/a | a filesystem that instruments other filesystems for tracing with [OpenTelemetry][] |\n| [vaultfs]  | `vault`, `vault+http`, `vault+https` | [HashiCorp Vault][] |\n\nSee the individual package documentation for more details.\n\n## Installation\n\nUse `go get` to install the latest version of `go-fsimpl`:\n\n```console\n$ go get -u github.com/hairyhenderson/go-fsimpl\n```\n\n## Usage\n\nIf you know that you want an HTTP filesystem, for example:\n\n```go\nimport (\n\t\"net/url\"\n\n\t\"github.com/hairyhenderson/go-fsimpl/httpfs\"\n)\n\nfunc main() {\n\tbase, _ := url.Parse(\"https://example.com\")\n\tfsys, _ := httpfs.New(base)\n\n\tf, _ := fsys.Open(\"hello.txt\")\n\tdefer f.Close()\n\n\t// now do what you like with the file...\n}\n```\n\nIf you're not sure what filesystem type you need (for example, if you're dealing\nwith a user-provided URL), you can use a filesystem mux:\n\n```go\nimport (\n\t\"github.com/hairyhenderson/go-fsimpl\"\n\t\"github.com/hairyhenderson/go-fsimpl/blobfs\"\n\t\"github.com/hairyhenderson/go-fsimpl/filefs\"\n\t\"github.com/hairyhenderson/go-fsimpl/gitfs\"\n\t\"github.com/hairyhenderson/go-fsimpl/httpfs\"\n)\n\nfunc main() {\n\tmux := fsimpl.NewMux()\n\tmux.Add(filefs.FS)\n\tmux.Add(httpfs.FS)\n\tmux.Add(blobfs.FS)\n\tmux.Add(gitfs.FS)\n\n\t// for example, a URL that points to a subdirectory at a specific tag in a\n\t// given git repo, hosted on GitHub and authenticated with SSH...\n\tfsys, err := mux.Lookup(\"git+ssh://git@github.com/foo/bar.git//baz#refs/tags/v1.0.0\")\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tf, _ := fsys.Open(\"hello.txt\")\n\tdefer f.Close()\n\n\t// now do what you like with the file...\n}\n```\n\n## Developing\n\nYou will require `git` including `git daemon` and `consul` executables on your path for running the tests.\n\n## License\n\n[The MIT License](http://opensource.org/licenses/MIT)\n\nCopyright (c) 2021-2024 Dave Henderson\n\n[godocs]: https://pkg.go.dev/github.com/hairyhenderson/go-fsimpl\n[godoc-image]: https://pkg.go.dev/badge/github.com/hairyhenderson/go-fsimpl\n[gh-actions-image]: https://github.com/hairyhenderson/go-fsimpl/actions/workflows/build.yml/badge.svg\n[gh-actions-url]: https://github.com/hairyhenderson/go-fsimpl/actions?workflow=Build\u0026branch=main\n\n[AWS IMDS]: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html\n[AWS SMP]: https://aws.amazon.com/systems-manager/features#Parameter_Store\n[AWS Secrets Manager]: https://aws.amazon.com/secrets-manager\n[HashiCorp Consul]: https://consul.io\n[HashiCorp Vault]: https://vaultproject.io\n[Amazon S3]: https://aws.amazon.com/s3/\n[Google Cloud Storage]: https://cloud.google.com/storage/\n[Azure Blob Storage]: https://azure.microsoft.com/en-us/services/storage/blobs/\n[OpenTelemetry]: https://opentelemetry.io\n[GCP Metadata]: https://cloud.google.com/compute/docs/metadata/overview\n\n[awsimdsfs]: https://pkg.go.dev/github.com/hairyhenderson/go-fsimpl/awsimdsfs\n[awssmfs]: https://pkg.go.dev/github.com/hairyhenderson/go-fsimpl/awssmfs\n[awssmpfs]: https://pkg.go.dev/github.com/hairyhenderson/go-fsimpl/awssmpfs\n[blobfs]: https://pkg.go.dev/github.com/hairyhenderson/go-fsimpl/blobfs\n[consulfs]: https://pkg.go.dev/github.com/hairyhenderson/go-fsimpl/consulfs\n[filefs]: https://pkg.go.dev/github.com/hairyhenderson/go-fsimpl/filefs\n[gitfs]: https://pkg.go.dev/github.com/hairyhenderson/go-fsimpl/gitfs\n[blobfs]: https://pkg.go.dev/github.com/hairyhenderson/go-fsimpl/blobfs\n[httpfs]: https://pkg.go.dev/github.com/hairyhenderson/go-fsimpl/httpfs\n[blobfs]: https://pkg.go.dev/github.com/hairyhenderson/go-fsimpl/blobfs\n[tracefs]: https://pkg.go.dev/github.com/hairyhenderson/go-fsimpl/tracefs\n[vaultfs]: https://pkg.go.dev/github.com/hairyhenderson/go-fsimpl/vaultfs\n[gcpmetafs]: https://pkg.go.dev/github.com/hairyhenderson/go-fsimpl/gcpmetafs\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhairyhenderson%2Fgo-fsimpl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhairyhenderson%2Fgo-fsimpl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhairyhenderson%2Fgo-fsimpl/lists"}