webdav/sync/go/pkg/mod/github.com/fredbi/uri@v0.0.0-20181227131451-3dcfdacbaaf3 - 志元云盘

File OriginalPic	EditTime	Size
fixtures	2024-09-19 10:33:56	689 B
doc.go	2024-09-19 10:33:56	498 B
go.mod	2024-09-19 10:33:56	175 B
go.sum	2024-09-19 10:33:56	521 B
GRAMMAR	2024-09-19 10:33:56	3.04 KB
LICENSE.md	2024-09-19 10:33:56	1.08 KB
README.md	2024-09-19 10:33:56	2.55 KB
uri.go	2024-09-19 10:33:56	13.45 KB
uri_test.go	2024-09-19 10:33:56	22.07 KB

# uri
[![Build Status](https://travis-ci.org/fredbi/uri.svg?branch=master)](https://travis-ci.org/fredbi/uri)
[![codecov](https://codecov.io/gh/fredbi/uri/branch/master/graph/badge.svg)](https://codecov.io/gh/fredbi/uri)
[![license](http://img.shields.io/badge/license/License-MIT-yellow.svg)](https://raw.githubusercontent.com/fredbi/uri/master/LICENSE.md)
[![GoDoc](https://godoc.org/github.com/fredbi/uri?status.svg)](http://godoc.org/github.com/fredbi/uri)
[![GolangCI](https://golangci.com/badges/github.com/fredbi/uri.svg)](https://golangci.com)
[![Go Report Card](https://goreportcard.com/badge/github.com/fredbi/uri)](https://goreportcard.com/report/github.com/fredbi/uri)

Package uri is meant to be an RFC 3986 compliant URI builder, parser and validator for golang.

It supports strict RFC validation for URI and URI relative references.

## Usage

##### Parsing

```golang 
	u, err := Parse("https://example.com:8080/path")
	if err != nil {
		fmt.Printf("Invalid URI")
	} else {
		fmt.Printf("%s", u.Scheme())
	}
	// Output: https
```

```golang 
	u, err := ParseReference("//example.com/path")
	if err != nil {
		fmt.Printf("Invalid URI reference")
	} else {
		fmt.Printf("%s", u.Authority().Path())
	}
	// Output: /path
```

##### Validation

```golang 
    isValid := IsURI("urn://example.com?query=x#fragment/path") // true
    isValid= IsURI("//example.com?query=x#fragment/path") // false

isValid= IsURIReference("//example.com?query=x#fragment/path") // true
```

##### Building

## Reference specifications
* https://tools.ietf.org/html/rfc3986

Internationalization support:
* https://tools.ietf.org/html/rfc3987

IPv6 addressing scheme reference and erratum:
* https://tools.ietf.org/html/rfc6874

This allows for stricter conformance than the `net/url` golang standard libary,
which provides a workable but loose implementation of the RFC.

This package concentrates on RFC 3986 strictness for URI validation. 
At the moment, there is no attempt to normalize or auto-escape strings. 
For url normalization, see github.com/PuertokitoBio/purell.

## Disclaimer

Not supported:
* provisions for "IPvFuture" are not implemented

hostnames vs domain names:
* a list of common schemes triggers the validation of hostname against domain name rules

Example:

## Credits

Tests have been aggregated from test suites of URI validators from other languages:
perl, python, scala, .Net. and the golang url standard library.

> This package was initially based on the work from ttacon/uri (credits: Trey Tacon)
> Extra features like MySQL URIs present in the original repo have been removed.

云盘

Home / 志元云盘 / webdav / sync / go / pkg / mod / github.com / fredbi / [email protected]