💾 Archived View for source.community › ckaznocha › gemini › blob › main › url.go captured on 2024-08-18 at 18:03:10. Gemini links have been rewritten to link to archived content

-=-=-=-=-=-=-

                                                         .
,-. ,-. . . ,-. ,-. ,-.    ,-. ,-. ,-,-. ,-,-. . . ,-. . |- . .
`-. | | | | |   |   |-'    |   | | | | | | | | | | | | | |  | |
`-' `-' `-^ '   `-' `-' :: `-' `-' ' ' ' ' ' ' `-^ ' ' ' `' `-|
                                                             /|
                                                            `-'

ckaznocha / gemini

git clone https://source.community/ckaznocha/gemini.git

Branches

Log

Tree

/url.go (main)

↑ /

blob

View raw contents of /url.go (main)

────╮
   1│ package gemini
   2│ 
   3│ import (
   4│ 	"fmt"
   5│ 	"net/url"
   6│ 	"unicode/utf8"
   7│ )
   8│ 
   9│ // URI represents a Gemini URI.
  10│ //
  11│ // Resources hosted via Gemini are identified using URIs with the scheme
  12│ // "gemini".  This scheme is syntactically compatible with the generic URI
  13│ // syntax defined in RFC 3986, but does not support all components of the
  14│ // generic syntax.  In particular, the authority component is allowed and
  15│ // required, but its userinfo subcomponent is NOT allowed.  The host
  16│ // subcomponent is required.  The port subcomponent is optional, with a default
  17│ // value of 1965.  The path, query and fragment components are allowed and have
  18│ // no special meanings beyond those defined by the generic syntax.  Spaces in
  19│ // gemini URIs should be encoded as %20, not +.
  20│ type URI struct {
  21│ 	url *url.URL
  22│ 
  23│ 	Host     string
  24│ 	Port     string
  25│ 	Path     string
  26│ 	Fragment string
  27│ 
  28│ 	// Query is the decoded query section. The original query is stored in
  29│ 	// RawQuery.
  30│ 	Query string
  31│ 
  32│ 	// RawQuery is the original query section as received by the server. Use
  33│ 	// this in the event you need to parse a query section into a url.Values.
  34│ 	RawQuery string
  35│ }
  36│ 
  37│ // ParseRequestURI parses a raw URI string into a Gemini URI. It returns an error if
  38│ // the URI is invalid.
  39│ func ParseRequestURI(rawURI string) (*URI, error) {
  40│ 	if !utf8.ValidString(rawURI) {
  41│ 		return nil, fmt.Errorf("%w: request URI must be valid utf-8", ErrMalformedURI)
  42│ 	}
  43│ 
  44│ 	uri, err := url.ParseRequestURI(rawURI)
  45│ 	if err != nil {
  46│ 		return nil, fmt.Errorf("%w: %s", ErrMalformedURI, err)
  47│ 	}
  48│ 
  49│ 	if !uri.IsAbs() {
  50│ 		return nil, fmt.Errorf("%w: request URI cannot be relative", ErrMalformedURI)
  51│ 	}
  52│ 
  53│ 	if uri.User != nil {
  54│ 		return nil, fmt.Errorf("%w: URI cannot have a user", ErrMalformedURI)
  55│ 	}
  56│ 
  57│ 	if uri.Host == "" {
  58│ 		return nil, fmt.Errorf("%w: URI must have a host", ErrMalformedURI)
  59│ 	}
  60│ 
  61│ 	query, err := url.PathUnescape(uri.RawQuery)
  62│ 	if err != nil {
  63│ 		return nil, fmt.Errorf("%w: URI has a malformed query section: %s", ErrMalformedURI, err)
  64│ 	}
  65│ 
  66│ 	return &URI{
  67│ 		Host:     uri.Hostname(),
  68│ 		Port:     uri.Port(),
  69│ 		Path:     uri.Path,
  70│ 		Fragment: uri.Fragment,
  71│ 		Query:    query,
  72│ 		RawQuery: uri.RawQuery,
  73│ 		url:      uri,
  74│ 	}, nil
  75│ }
  76│ 
  77│ func (u *URI) String() string {
  78│ 	if u.url == nil {
  79│ 		u.url = &url.URL{
  80│ 			Scheme:   "gemini",
  81│ 			Host:     u.Host,
  82│ 			Path:     u.Path,
  83│ 			RawQuery: u.RawQuery,
  84│ 			Fragment: u.Fragment,
  85│ 		}
  86│ 	}
  87│ 
  88│ 	return u.url.String()
  89│ }
────╯

· · ·

info@source.community