internal/config/structs.go (view raw)
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 | //nolint:lll
package config
// keep config structs here so that lll ignores the long lines (go doesn't support multi-line struct tags)
import (
"fmt"
"net/url"
"path/filepath"
"strings"
"github.com/creasty/defaults"
)
type Config struct {
DataPath string `comment:"Path to store index data."`
Web Web `comment:"Settings for the web server"`
Importer Importer `comment:"Settings for the import job"`
}
type Link struct {
Name string `comment:"Human-readable name of link."`
URL URL `comment:"URL target."`
}
type Web struct {
ContentSecurityPolicy CSP `comment:"Content-Security-Policy header to send with requests. Should only need changing if ExtraHeadHTML is used."`
GracefulShutdownTimeout Duration `comment:"How long to wait for connections to finish before shutting down."`
ListenAddress string `comment:"Which address or hostname to listen on. IPv6 addresses need square brackets."`
Port int `comment:"Port number to listen on."`
BaseURL URL `comment:"Absolute URL to this instance, useful if behind a reverse proxy"`
SentryDSN string `comment:"If set, will send server errors to Sentry"`
Environment string `comment:"Affects logging parameters. One of 'development' or 'production'"`
ExtraHeadHTML string `comment:"Content to add to HTML <head>. Can be used to override styling, add scripts, etc."`
Headers map[string]string `comment:"Extra headers to send with HTTP requests"`
LogRequests bool `comment:"Whether to log incoming HTTP requests"`
SearchTimeout Duration `comment:"Timeout for search requests"`
OtherInstance *Link `comment:"Link to another instance (e.g. stable <-> unstable)."`
}
type Importer struct {
Sources map[string]Source
LowMemory bool `comment:"Use less memory at the expense of import performance"`
BatchSize int `comment:"Number of items to process in each batch (affects memory usage)."`
Timeout Duration `comment:"Abort fetch and import process for all jobs if it takes longer than this value."`
UpdateAt LocalTime `comment:"Time of day (UTC) to run fetch/import process"`
}
type Source struct {
Name string `default:"-" comment:"Human-readable name of source for generating links"`
Order uint ` comment:"Order in which to show source in web interface."`
Key string ` comment:"Machine-readable name of source. Must be URL- and path-safe."`
Enable bool ` comment:"Controls whether to show in the web interface and to run fetch/import jobs."`
Fetcher Fetcher ` comment:"How to fetch options.json. One of 'channel', 'channel-nixpkgs' or 'download'."`
Importer ImporterType `default:"options" comment:"Kind of data available from source. Currently supports 'packages' and 'options'."`
Channel string ` comment:"(Fetcher=channel) Local name for channel, (Fetcher=channel-nixpkgs) Remote name of channel."`
URL string ` comment:"(Fetcher=channel) Remote URL for channel, (Fetcher=download) Path containing files named 'revision' and 'options.json'."`
Attribute string `default:"options" comment:"(Fetcher=channel) Nix attribute name (i.e. nix-build -A) that builds an {options,packages}.json"`
ImportPath string ` comment:"(Fetcher=channel) Sub-path of imported channel which contains the attribute above, e.g. release.nix"`
Timeout Duration `default:"5m" comment:"Abort import if it takes longer than this."`
OutputPath string `default:"share/doc/nixos" comment:"(Fetcher=channel) Path under ./result symlink to folder containing {options,packages}.json."`
Repo Repository ` comment:"Used to generate declaration/definition links"`
Programs ProgramsDB ` comment:"Used to enable searching for programs in multi-program packages"`
Manpages Manpages ` comment:"Used to enable searching for manpages"`
JSONDepth int `default:"1" comment:"Depth at which packages/object object is to be found"`
}
type ProgramsDB struct {
Enable bool `comment:"Enable searching for programs in multi-program packages"`
Attribute string `comment:"Nix attribute name (i.e. nix-instantiate) that builds a programs.sqlite file"`
}
type Manpages struct {
Enable bool `comment:"Enable searching for manpages"`
Path string `comment:"Path to the manpage-urls.json file from repository root"`
}
func (source Source) String() string {
switch source.Importer {
case Options:
return source.Name + " " + source.Importer.String()
case Packages:
return source.Name
case All:
return "Combined"
default:
return fmt.Sprintf("Source(%s)", source.Name)
}
}
func (source *Source) SetDefaults() {
if defaults.CanUpdate(source.Name) {
source.Name = strings.ToTitle(source.Key[0:1]) + source.Key[1:]
}
}
func (source *Source) JoinFilePath(name string) string {
//nolint:forbidigo // is not absolute
return filepath.Join("sources", source.Key, name)
}
func (source *Source) LocalURL() *url.URL {
p, err := url.JoinPath("/", source.Importer.String(), source.Key, "/")
if err != nil {
panic(err.Error())
}
return &url.URL{
Path: p,
}
}
|