# `ht.sr`

`ht.sr` is the identifier for the package provider of [Sourcehut](https://sourcehut.org). The official instance is located at [sr.ht](https://sr.ht).

This provider enables sourcing individual files from a Sourcehut repository.

## `instdat.sourcehut_instance`

The URL to the Sourcehut Git server. This defaults to `git.sr.ht`.

## `instdat.repo_owner`

The owner of the target repository, including the tilde (`~`).

## `instdat.repo_name`

The name of the target repository.

## `instdat.repo_ref`

The [Git reference](https://git-scm.com/book/en/v2/Git-Internals-Git-References) (a tag, branch, or commit) of the target repository.

## `instdat.filemaps`

A table which contains mappings for files on Sourcehut and their local counterparts.

The key for each item in the table should correspond to the full path on the Sourcehut repository, and the value should be the local destination.