1
0
Fork 0
mirror of https://github.com/moby/moby.git synced 2022-11-09 12:21:53 -05:00
moby--moby/pkg
Sebastiaan van Stijn 5f89a6a78e
pkg/urlutil: deprecate, and move to builder/remotecontext/urlutil
pkg/urlutil (despite its poorly chosen name) is not really intended as a generic
utility to handle URLs, and should only be used by the builder to handle (remote)
build contexts.

- IsURL() only does a very rudimentary check for http(s):// prefixes, without any
  other validation, but due to its name may give incorrect expectations.
- IsGitURL() is written specifically with docker build remote git contexts in
  mind, and has handling for backward-compatibility, where strings that are
  not URLs, but start with "github.com/" are accepted.

Because of the above, this patch:

- moves the package inside builder/remotecontext, close to where it's intended
  to be used (ideally this would be part of build/remotecontext itself, but this
  package imports many other dependencies, which would introduce those as extra
  dependencies in the CLI).
- deprecates pkg/urlutil, but adds aliases as there are some external consumers.

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2022-04-12 19:58:05 +02:00
..
aaparser
archive Finish refactor of UID/GID usage to a new struct 2022-03-14 16:28:57 -04:00
authorization
broadcaster
capabilities
chrootarchive Finish refactor of UID/GID usage to a new struct 2022-03-14 16:28:57 -04:00
containerfs Finish refactor of UID/GID usage to a new struct 2022-03-14 16:28:57 -04:00
devicemapper
directory
dmesg
filenotify
fileutils Avoid platform-specific NewPatternMatcher function in TestCompile 2022-01-20 09:08:16 -08:00
fsutils
homedir
idtools Finish refactor of UID/GID usage to a new struct 2022-03-14 16:28:57 -04:00
ioutils
jsonmessage
longpath
loopback
namesgenerator Merge pull request #43210 from tianon/frozen-names-generator 2022-02-10 20:38:44 +01:00
parsers pkg/system: move IsWindowsClient to pkg/parsers/operatingsystem 2022-03-17 10:26:50 +01:00
pidfile
platform missing windows arm64 arch detection 2022-04-09 16:10:42 +02:00
plugingetter
plugins staticcheck: ignore "SA1019: strings.Title is deprecated" 2022-03-16 12:11:54 +01:00
pools
progress refactor: move from io/ioutil to io and os package 2021-08-27 14:56:57 +08:00
pubsub
reexec
signal pkg/signal: remove DefaultStopSignal const 2021-08-11 10:31:29 +02:00
stack
stdcopy
streamformatter
stringid
sysinfo Update handling of deprecated kernel (tcp) memory options 2022-03-17 09:56:39 +01:00
system pkg/system: move IsWindowsClient to pkg/parsers/operatingsystem 2022-03-17 10:26:50 +01:00
tailfile
tarsum pkg/archive: audit gosec file-traversal lints 2022-02-18 15:42:22 -05:00
truncindex
urlutil pkg/urlutil: deprecate, and move to builder/remotecontext/urlutil 2022-04-12 19:58:05 +02:00
useragent
README.md Rename a few docker to moby 2017-10-25 13:56:12 +02:00

pkg/ is a collection of utility packages used by the Moby project without being specific to its internals.

Utility packages are kept separate from the moby core codebase to keep it as small and concise as possible. If some utilities grow larger and their APIs stabilize, they may be moved to their own repository under the Moby organization, to facilitate re-use by other projects. However that is not the priority.

The directory pkg is named after the same directory in the camlistore project. Since Brad is a core Go maintainer, we thought it made sense to copy his methods for organizing Go code :) Thanks Brad!

Because utility packages are small and neatly separated from the rest of the codebase, they are a good place to start for aspiring maintainers and contributors. Get in touch if you want to help maintain them!