# fsouza/fake-gcs-server

Google Cloud Storage emulator & testing library.

Repository: https://github.com/fsouza/fake-gcs-server
Canonical: https://ross.abutalabs.com/products/fake-gcs-server
Homepage: https://pkg.go.dev/github.com/fsouza/fake-gcs-server/fakestorage?tab=doc
Language: Go
License: BSD-2-Clause
License Family: permissive
Last push: 2026-08-25T23:57:25+00:00

## Health v2 (maintenance only)
Score: 99/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 99, longevity 100
- inputs: {"age_days": 3398, "days_push": 8, "days_rel": 9, "gap_med": 16.0, "n_releases_24m": 15}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1450, forks 284 (observed 2026-08-28T04:04:45.869124+00:00)

## What it is
fake-gcs-server is a Google Cloud Storage emulator that can run as a standalone binary/Docker image or be embedded as a Go library in test suites. It implements the GCS API so applications can be tested against a local, preloaded fake storage backend without touching real cloud resources.

## Use cases
- emulate google cloud storage locally for integration tests
- mock gcs api in docker for tests in any language
- preload test buckets and objects into a fake gcs server
- use a fake storage client in Go unit tests
- run CI tests without real GCS credentials
- develop against GCS-dependent code offline

## When to choose
- you need a local or CI-friendly stand-in for Google Cloud Storage
- you write Go tests that depend on the GCS client and want an in-process fake
- you want to preload fixture data into buckets via a mounted folder

## When to avoid
- you need actual durable cloud object storage
- you need an emulator for other GCP services like datastore or pubsub
- you require full fidelity to every GCS API feature or edge-case behavior

## Facets
- artifact type: service
- maturity: active
- function: testing, mock-api, object-storage, http-server, cli
- domain: developer-tools, testing, cloud-computing, apis
- platform: go, cli, cross-platform
- tags: gcs-emulator, google-cloud-storage, mock-server, integration-testing, test-double, docker

## Member repositories
- fsouza/fake-gcs-server (main) score 99

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:45.869124+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:35:55.973853+00:00, confidence not recorded.
  - readme: https://github.com/fsouza/fake-gcs-server (fetched 2026-08-28T04:04:45.869124+00:00, sha 087bcbbab710)
  - homepage: https://pkg.go.dev/github.com/fsouza/fake-gcs-server/fakestorage?tab=doc (fetched 2026-08-29T11:45:25.893060+00:00, sha 612657fdea2a)
  - site_page: https://pkg.go.dev/about (fetched 2026-08-29T11:45:25.902663+00:00, sha 757852027879)
  - site_page: https://go.dev/project (fetched 2026-08-29T11:45:25.904704+00:00, sha d5ca00bb378b)
- Data as of 2026-08-30T08:39:29.467469+00:00.