{"id":37112893,"url":"https://github.com/spatialcurrent/gocat","last_synced_at":"2026-01-14T13:20:20.554Z","repository":{"id":35123791,"uuid":"184349183","full_name":"spatialcurrent/gocat","owner":"spatialcurrent","description":"Super simple command line program for concatenating files.","archived":false,"fork":false,"pushed_at":"2023-03-06T22:41:30.000Z","size":143,"stargazers_count":1,"open_issues_count":4,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-06-21T03:15:37.811Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","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/spatialcurrent.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-05-01T00:23:29.000Z","updated_at":"2022-01-30T18:21:21.000Z","dependencies_parsed_at":"2024-06-21T02:08:02.898Z","dependency_job_id":"9e801437-07d1-4c4a-9f9f-05a69cbfc98c","html_url":"https://github.com/spatialcurrent/gocat","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/spatialcurrent/gocat","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spatialcurrent%2Fgocat","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spatialcurrent%2Fgocat/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spatialcurrent%2Fgocat/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spatialcurrent%2Fgocat/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/spatialcurrent","download_url":"https://codeload.github.com/spatialcurrent/gocat/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spatialcurrent%2Fgocat/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28421041,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T10:47:48.104Z","status":"ssl_error","status_checked_at":"2026-01-14T10:46:19.031Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":[],"created_at":"2026-01-14T13:20:19.656Z","updated_at":"2026-01-14T13:20:20.534Z","avatar_url":"https://github.com/spatialcurrent.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![CircleCI](https://circleci.com/gh/spatialcurrent/gocat/tree/main.svg?style=svg)](https://circleci.com/gh/spatialcurrent/gocat/tree/main)\n[![Go Report Card](https://goreportcard.com/badge/spatialcurrent/gocat?style=flat-square)](https://goreportcard.com/report/github.com/spatialcurrent/gocat)\n[![PkgGoDev](https://pkg.go.dev/badge/mod/github.com/spatialcurrent/gocat)](https://pkg.go.dev/github.com/spatialcurrent/gocat)\n[![License](http://img.shields.io/badge/license-MIT-red.svg?style=flat)](https://github.com/spatialcurrent/gocat/blob/master/LICENSE)\n\n# gocat\n\n# Description\n\n**gocat** is a super simple command line program for concatenating files.  **gocat** lazily loads files to reduce memory usage and the number of active file pointers.  **gocat** can read from local files, HTTP(S) endpoints, and files on S3.\n\n## Platforms\n\nThe following platforms are supported.  Pull requests to support other platforms are welcome!\n\n| GOOS | 386 | amd64 | arm | arm64 |\n| ---- | --- | ----- | --- | ----- |\n| darwin | - | ✓ | - | - |\n| freebsd | ✓ | ✓ | ✓ | - |\n| linux | ✓ | ✓ | ✓ | ✓ |\n| openbsd | ✓ | ✓ | - | - |\n| solaris | - | ✓ | - | - |\n| windows | ✓ | ✓ | - | - |\n\n## Releases\n\nFind releases for the supported platforms at [https://github.com/spatialcurrent/gocat/releases](https://github.com/spatialcurrent/gocat/releases).  See the **Building** section below to build for another platform from source.\n\n## Usage\n\nSee the usage below or the following examples.\n\n```shell\ngocat is a super simple utility to concatenate files (local, remote, or on AWS S3) provided as positional arguments.\nSupports stdin (aka \"-\"), local files (path/to/file or file://path/to/file), remote files (http://path/to/file), or files on AWS S3 (s3://path/to/file).\nSupports the following compression algorithms: bzip2, flate, gzip, none, snappy, zip, zlib.\n\nUsage:\n  gocat [flags] [-|stdin|FILE|URI]...\n\nFlags:\n  -a, --append-new-lines               append new lines to files\n      --aws-access-key-id string       AWS Access Key ID\n      --aws-default-region string      AWS Default Region\n      --aws-profile string             AWS Profile\n      --aws-region string              AWS Region (overrides default region)\n      --aws-secret-access-key string   AWS Secret Access Key\n      --aws-session-token string       AWS Session Token\n  -b, --buffer-size int                buffer size for file reader (default 4096)\n  -h, --help                           help for gocat\n      --version                        show version\n```\n\n## Examples\n\n### Shell\n\n```shell\ngocat \"~/.bash_aliases\" \"~/.bashrc\"\n```\n\n### Remote File\n\n`gocat` arguments can point to remote files\n\n```shell\ngocat https://spatialcurrent.io\n```\n\n### All Files With Extension\n\n`gocat` will print every file given as a positional argument, which can be useful when looking through thousands of files.\n\n```shell\ngocat $( find . -print | grep -i '.*[.]md')\n```\n\n## Building\n\n**gocat** is written in pure Go.  The only dependency needed to compile the program is [Go](https://go.dev/).\n\nThis project supports the use of [direnv](https://direnv.net/) to manage environment variables.\n\nIf using `macOS`, follow the `macOS` instructions below.\n\nUse `make bin/gocat` to build for your local operating system.  Use `make build_release` to build for a release.  Alternatively, you can call `go build` directly for your specific scenario.\n\n### macOS\n\nTo install `go` on macOS with homebrew use `brew install go`.\n\nTo install `direnv` on macOS with homebrew use `brew install direnv`.  If using bash, then add `eval \\\"$(direnv hook bash)\\\"` to the `~/.bash_profile` file .  If using zsh, then add `eval \\\"$(direnv hook zsh)\\\"` to the `~/.zshrc` file.\n\n## Testing\n\n**CLI**\n\nTo run CLI testes use `make test_cli`, which uses [shUnit2](https://github.com/kward/shunit2).  If you recive a `shunit2:FATAL Please declare TMPDIR with path on partition with exec permission.` error, you can modify the `TMPDIR` environment variable in line or with `export TMPDIR=\u003cYOUR TEMP DIRECTORY HERE\u003e`. For example:\n\n```\nTMPDIR=\"/usr/local/tmp\" make test_cli\n```\n\n**Go**\n\nTo run Go tests use `make test_go` or (`bash scripts/test.sh`), which runs unit tests, `go vet`, `go vet with shadow`, [errcheck](https://github.com/kisielk/errcheck), [staticcheck](https://staticcheck.io/), and [misspell](https://github.com/client9/misspell).\n\n## Contributing\n\n[Spatial Current, Inc.](https://spatialcurrent.io) is currently accepting pull requests for this repository.  We'd love to have your contributions!  Please see [Contributing.md](https://github.com/spatialcurrent/gocat/blob/master/CONTRIBUTING.md) for how to get started.\n\n## License\n\nThis work is distributed under the **MIT License**.  See **LICENSE** file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspatialcurrent%2Fgocat","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspatialcurrent%2Fgocat","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspatialcurrent%2Fgocat/lists"}