https://github.com/simonmittag/puri

Commandline utility to parse uri
https://github.com/simonmittag/puri

command-line command-line-tool commandline host key path port scheme url urlparams urlparser urlpattern urls urlscheme value

Last synced: 12 months ago
JSON representation

Commandline utility to parse uri

• Host: GitHub
• URL: https://github.com/simonmittag/puri
• Owner: simonmittag
• License: apache-2.0
• Created: 2024-04-15T23:13:45.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2024-04-21T04:30:18.000Z (about 2 years ago)
• Last Synced: 2025-01-18T07:43:51.020Z (over 1 year ago)
• Topics: command-line, command-line-tool, commandline, host, key, path, port, scheme, url, urlparams, urlparser, urlpattern, urls, urlscheme, value
• Language: Go
• Homepage:
• Size: 53.7 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: ReadMe.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

          
![](logo.png)

`puri` ("parse uri") is a robust commandline utility that reads and extracts uri components. It processes URLs

with and without schemes.

[![Circleci Builds](https://circleci.com/gh/simonmittag/puri.svg?style=shield)](https://circleci.com/gh/simonmittag/puri)

[![Github Workflows](https://github.com/simonmittag/mse6/workflows/Go/badge.svg)](https://github.com/simonmittag/puri/actions)

[![Github Issues](https://img.shields.io/github/issues/simonmittag/puri)](https://github.com/simonmittag/puri/issues)

[![Github Activity](https://img.shields.io/github/commit-activity/m/simonmittag/puri)](https://img.shields.io/github/commit-activity/m/simonmittag/puri)  

[![CodeClimate Maintainability](https://api.codeclimate.com/v1/badges/1f3771faf0b714cab0de/maintainability)](https://codeclimate.com/github/simonmittag/puri/maintainability)

[![CodeClimate Test Coverage](https://api.codeclimate.com/v1/badges/1f3771faf0b714cab0de/test_coverage)](https://codeclimate.com/github/simonmittag/puri/test_coverage)

[![Go Version](https://img.shields.io/github/go-mod/go-version/simonmittag/puri)](https://img.shields.io/github/go-mod/go-version/simonmittag/puri)

[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)

[![Version](https://img.shields.io/badge/version-0.1.9-orange)](https://github.com/simonmittag/puri/releases/tag/v0.1.9)

## What's New

### v0.1.9

* bugfix for url withouth proper paths

### v0.1.8

* bugfix for url paths containing domains

### v0.1.7

* added simple path parsing that makes this more intuitive over standard library interpretation

## Up and running

### Homebrew

```

brew tap simonmittag/cli &&

  brew install puri &&

  puri 

```

### Golang

```bash

git clone https://github.com/simonmittag/puri && cd puri && 

go install github.com/simonmittag/puri/cmd/puri && 

puri 

```

## Usage

```

~ λ puri

puri[v0.1.9]

Usage: puri [-s]|[-o]|[-r]|[-p]|[-q name]|[-h]|[-v] scheme://host:port#a?k=v

  -h	print usage instructions

  -o	extract host

  -p	extract path

  -q string

    	extract query param

  -r	extract port

  -s	extract scheme

  -v	print puri version

```

## Examples

Get URI path without scheme specified

```

λ puri -p bar.com/foo?k=foo

  /foo

```

Get URI host without scheme specified

```

λ puri -o bar.com?k=foo

  bar.com

```

Get URI query param

```

λ puri -q k https://www.bar.com?k=foo

  foo

```

Get URI path (includes anchor)

```

λ puri -p https://www.foo.com/q#bar?k=v

  /q#bar

```

## Contributions

The puri team welcomes all [contributors](https://github.com/simonmittag/puri/blob/master/CONTRIBUTING.md). Everyone interacting with the project's codebase, issue trackers, chat rooms and mailing lists

is expected to follow the [code of conduct](https://github.com/simonmittag/puri/blob/master/CODE_OF_CONDUCT.md)