Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/doriantaylor/rb-uri-ni
RFC 6920 ni:/// URI handler
https://github.com/doriantaylor/rb-uri-ni
rfc-6920 ruby uri
Last synced: 2 months ago
JSON representation
RFC 6920 ni:/// URI handler
- Host: GitHub
- URL: https://github.com/doriantaylor/rb-uri-ni
- Owner: doriantaylor
- License: apache-2.0
- Created: 2019-12-30T09:16:26.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2020-03-18T05:13:13.000Z (almost 5 years ago)
- Last Synced: 2024-08-08T17:30:11.641Z (5 months ago)
- Topics: rfc-6920, ruby, uri
- Language: Ruby
- Homepage:
- Size: 25.4 KB
- Stars: 2
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# URI::NI - RFC6920 Named Identifiers
This module implements the `ni:` URI scheme from [RFC
6920](https://tools.ietf.org/html/rfc6920).
```ruby
require 'uri'
require 'uri-ni' # or 'uri/ni', if you prefer
ni = URI::NI.compute 'some data'
# => #
ni.hexdigest
# => "1307990e6ba5ca145eb35e99182a9bec46531bc54ddf656a602c780fa0240dee"
```
This of course corresponds to:
```bash
$ echo -n some data | sha256sum
1307990e6ba5ca145eb35e99182a9bec46531bc54ddf656a602c780fa0240dee -
```
This works as expected:
```ruby
ni = URI('ni:///sha-256;4wwup6dvg7fBqXXdwkKGtnXnFOu7xyzNXwQBcwIxq1c')
# => #
```
RFC 6920 [specifies a
registry](https://www.iana.org/assignments/named-information/named-information.xhtml)
for algorithm designators. Of that list, `sha-256`, `sha-384` and
`sha-512` are implemented. Eventually I will get around to doing the
SHA-3 digests as well as the truncated SHA-256 ones. Implemented but
_not_ in the registry are `md5`, `sha-1` and `rmd-160`. Really these
identifiers only matter when you are trying to `compute` a new
digest. For instance you can do this:
```ruby
ni = URI('ni:///lol;wut')
# => #
```
…and the parser won't complain. But, if you then tried to take this
result and compute a new digest with it:
```ruby
ni
# => #
ni.compute 'derp'
# URI::InvalidComponentError: Can't resolve a Digest context for the algorithm lol.
```
The purpose of this configuration is so that the parser doesn't croak
on unexpected input, but otherwise assumes you know what you're
doing. As such, there is no attempt to measure or otherwise divine the
representation of any updates to the `digest` component:
```ruby
ni = URI::NI.compute 'some data'
# => #
ni.digest = 'whatever'
# => "whatever"
ni
# => #
```
In addition to computing new digest URIs, this module will return the
interesting part of its contents in binary, hexadecimal, base64, and
(with a soft dependency), [base32](https://rubygems.org/gems/base32).
There are accessors and mutators for `digest`, `hexdigest`,
`b32digest`, and `b64digest`.
Finally, this module will also reuse any extant `Digest::Instance`
object as long as it is in the inventory, and furthermore the
`compute` method takes a block:
```ruby
ctx = Digest::SHA256.new
# => #
ctx << 'hello world'
# => #
ni = URI::NI.compute ctx
# => #
ni.hexdigest
# => "b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9"
ni = URI::NI.compute do |ctx|
ctx << 'hello world'
end
# => #
```
## Documentation
Generated and deposited [in the usual
place](http://www.rubydoc.info/github/doriantaylor/rb-uri-ni/master).
## Installation
You know how to do this:
$ gem install uri-ni
Or, [download it off rubygems.org](https://rubygems.org/gems/uri-ni).
## Contributing
Bug reports and pull requests are welcome at
[the GitHub repository](https://github.com/doriantaylor/rb-uri-ni).
## Copyright & License
©2019 [Dorian Taylor](https://doriantaylor.com/)
This software is provided under
the [Apache License, 2.0](https://www.apache.org/licenses/LICENSE-2.0).