https://github.com/digitalmoksha/mdurl-rb

URL utilities for motion-markdown-it
https://github.com/digitalmoksha/mdurl-rb

ruby rubymotion

Last synced: over 1 year ago
JSON representation

URL utilities for motion-markdown-it

• Host: GitHub
• URL: https://github.com/digitalmoksha/mdurl-rb
• Owner: digitalmoksha
• License: other
• Created: 2015-03-25T20:25:34.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2023-01-14T18:30:23.000Z (over 3 years ago)
• Last Synced: 2025-03-18T03:38:48.121Z (over 1 year ago)
• Topics: ruby, rubymotion
• Language: Ruby
• Homepage:
• Size: 23.4 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# mdurl-rb

[![Gem Version](https://badge.fury.io/rb/mdurl-rb.svg)](http://badge.fury.io/rb/mdurl-rb)

[![Build Status](https://github.com/digitalmoksha/mdurl-rb/actions/workflows/ci.yml/badge.svg)](https://github.com/digitalmoksha/mdurl-rb/actions/workflows/ci.yml)

This gem is a port of the [mdurl javascript package](https://github.com/markdown-it/mdurl) by Vitaly Puzrin and Alex Kocharin, that is used for the [markdown-it](https://github.com/markdown-it/markdown-it) package.

_Currently synced with mdurl 1.0.1_

---

URL utilities for [motion-markdown-it](https://github.com/digitalmoksha/motion-markdown-it) parser, for both Ruby and RubyMotion

## API

_As this gem was ported from the Javascript version, there may still be some mixture of Javascript terminology below'_

### MDUrl::Encode.encode(str [, exclude, keepEncoded]) -> String

Percent-encode a string, avoiding double encoding. Don't touch `/a-zA-Z0-9/` +

excluded chars + `/%[a-fA-F0-9]{2}/` (if not disabled). Broken surrorates are

replaced with `U+FFFD`.

Params:

- __str__ - input string.

- __exclude__ - optional, `;/?:@&=+$,-_.!~*'()#`. Additional chars to keep intact

  (except `/a-zA-Z0-9/`).

- __keepEncoded__ - optional, `true`. By default it skips already encoded sequences

  (`/%[a-fA-F0-9]{2}/`). If set to `false`, `%` will be encoded.

### MDUrl::Encode::DEFAULT_CHARACTERS, MDUrl::Encode::COMPONENT_CHARACTERS

You can use these constants as second argument to `encode` function.

 - `DEFAULT_CHARACTERS` is the same exclude set as in the standard `encodeURI()` function

 - `COMPONENT_CHARACTERS` is the same exclude set as in the `encodeURIComponent()` function

For example, `MDUrl::Encode.encode('something', MDUrl::Encode::COMPONENT_CHARACTERS, true)` is roughly the equivalent of

the `encodeURIComponent()` function in Javascript (except `encode()` doesn't throw).

### MDUrl::Decode.decode(str [, exclude]) -> String

Decode percent-encoded string. Invalid percent-encoded sequences (e.g. `%2G`)

are left as is. Invalid UTF-8 characters are replaced with `U+FFFD`.

Params:

- __str__ - input string.

- __exclude__ - set of characters to leave encoded, optional, `;/?:@&=+$,#`.

### MDUrl::Decode::DEFTAULT_CHARS, MDUrl::Decode::COMPONENT_CHARS

You can use these constants as second argument to `decode` function.

 - `DEFTAULT_CHARS` is the same exclude set as in the standard `decodeURI()` function

 - `COMPONENT_CHARS` is the same exclude set as in the `decodeURIComponent()` function

For example, `MDUrl::Decode.decode('something', MDUrl::Decode::DEFTAULT_CHARS)` has the same behavior as

`decodeURI('something')` in javascript on a correctly encoded input.

### MDUrl::Url.parse(url, slashesDenoteHost) -> urlObs

Parse url string. Similar to node's [url.parse](http://nodejs.org/api/url.html#url_url_parse_urlstr_parsequerystring_slashesdenotehost), but without any

normalizations and query string parse.

 - __url__ - input url (string)

 - __slashesDenoteHost__ - if url starts with `//`, expect a hostname after it. Optional, `false`.

Result (hash):

- protocol

- slashes

- auth

- port

- hostname

- hash

- search

- pathname

Difference with node's `url`:

1. No leading slash in paths, e.g. in `url.parse('http://foo?bar')` pathname is

   `""` (empty string), not `"/"`

2. Backslashes are not replaced with slashes, so `http:\\example.org\` is

   treated like a relative path

3. Trailing colon is treated like a part of the path, i.e. in

   `http://example.org:foo` pathname is `:foo`

4. Nothing is URL-encoded in the resulting object, (in joyent/node some chars

   in auth and paths are encoded)

5. `url.parse()` does not have `parseQueryString` argument

6. Removed extraneous result properties: `host`, `path`, `query`, etc.,

   which can be constructed using other parts of the url.

### MDUrl::Format.format(urlObject)

Format an object previously obtained with `.parse()` function. Similar to node's

[url.format](http://nodejs.org/api/url.html#url_url_format_urlobj).

## License

[MIT](https://github.com/markdown-it/mdurl/blob/master/LICENSE)