As an API Consumer, I would like to know if a Repository is Empty

John Garcia

Recently, the accounting of Bitbucket resources has changed a bit, so that the first 33kB of an empty repository is reflected in the size reported by the repositories call. A customer has the following to say:

We’ve previously been using the repositories API endpoint to fetch details about repositories and specifically their size and if they’re empty, until recently empty repositories used to return 0 as their size however recently they’ve been returning sizes - whats changed?

How would you now suggest one detects if a repository is actually empty or not? Any plans to implement an `empty?` boolean?

evzijst

While the disk size (bytes) does have a correlation to the repo's content, it is too simple to assume that an empty repo takes up zero bytes.

Even an empty repo contains the basic SCM files and so is not 0 bytes. Nor is it necessarily deterministic as a newer version of the SCM might format these files slightly differently and so show a slightly different size.

@john-garcia-atlassian makes good suggestions. An empty repo has no commits and so I'd just check for that:

$ curl -s https://api.bitbucket.org/2.0/repositories/evzijst/emptygit/commits | jsonify
{
    "page": 1,
    "pagelen": 30,
    "values": []
}

If the "values" element is empty, the repo contains no commits.