Module `OpamUrl`Source

URL parsing and printing, with support for our different backends

Sourcetype version_control = [

| `git
| `darcs
| `hg

]

Sourcetype backend = [

| `http
| `rsync
| version_control

]

Sourceval string_of_backend : backend -> string

Sourceexception Parse_error of string

Sourceval backend_of_string : string -> [> backend ]

Tolerates lots of backward compatibility names;

raises Parse_error
on unknown protocol

Sourcetype t = {

transport : string;
(*
the part just before '://'
*)
path : string;
(*
the part after '://'
*)
hash : string option;
(*
the optional branch/ref specification, at the end after a '#'
*)
backend : backend;
(*
the backend that opam should use to handle this url
*)

}

Source

val parse : 
  ?backend:backend ->
  ?handle_suffix:bool ->
  ?from_file:bool ->
  string ->
  t

Same as of_string, but allows enforcing the expected backend, and may otherwise guess version control from the suffix by default (for e.g. https://foo/bar.git). (this should be disabled when parsing from files). Note that handle_suffix also handles user-name in ssh addresses (e.g. "ssh://git@github.com/..."). If from_file is set to false, it resolves rsync/file relative path.

raises Parse_error

Source

val parse_opt : 
  ?quiet:bool ->
  ?backend:backend ->
  ?handle_suffix:bool ->
  ?from_file:bool ->
  string ->
  t option

Same as parse, but catch Parse_error. In this case, display a warning if quiet is not set to true.

include OpamStd.ABSTRACT with type t := t

Sourceval of_string : string -> t

Sourceval to_string : t -> string

Sourceval to_json : t -> OpamJson.t

Sourceval of_json : OpamJson.t -> t option

Sourcemodule Set : OpamStd.SET with type elt = t

Sourcemodule Map : OpamStd.MAP with type key = t

Sourceval empty : t

Dummy filler url

Sourceval base_url : t -> string

Returns the url string without the VC part (i.e. "git+foo://bar" returns "foo://bar")

Sourceval basename : t -> string

The last part of the url path, e.g. "http://foo/bar/this" or "http://that.here/"

Sourceval root : t -> t

Returns the url with all path components but the first one (the hostname) dropped, e.g. "http://some.host/some/path" becomes "http://some.host"

Sourceval has_trailing_slash : t -> bool

Sourceval local_dir : t -> OpamFilename.Dir.t option

Check if the URL matches an existing local directory, and return it

Sourceval local_file : t -> OpamFilename.t option

Check if the URL matches an existing local file, and return it

Sourceval guess_version_control : string -> [> version_control ] option

If the given url-string has no 'transport://' specification and corresponds to an existing local path, check for version-control clues at that path

Sourceval map_file_url : (string -> string) -> t -> t

map_file_url f url applies f to the path portion of url if transport is "file".

Sourcemodule Op : sig ... end

Install

Dune Dependency

Authors

Maintainers

Sources

doc/opam-core/OpamUrl/index.html

Module `OpamUrl`Source

package opam-core

Install

Dune Dependency

Authors

Maintainers

Sources

doc/opam-core/OpamUrl/index.html

Module OpamUrlSource

Module `OpamUrl`Source