Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bluk/nu_plugin_from_bencode
A converter plugin from the bencode format for Nushell.
https://github.com/bluk/nu_plugin_from_bencode
bencode bencoding nushell-plugin
Last synced: about 1 month ago
JSON representation
A converter plugin from the bencode format for Nushell.
- Host: GitHub
- URL: https://github.com/bluk/nu_plugin_from_bencode
- Owner: bluk
- License: apache-2.0
- Created: 2020-10-11T03:06:57.000Z (about 4 years ago)
- Default Branch: trunk
- Last Pushed: 2024-05-11T01:16:46.000Z (7 months ago)
- Last Synced: 2024-09-16T15:18:36.206Z (3 months ago)
- Topics: bencode, bencoding, nushell-plugin
- Language: Rust
- Homepage: https://docs.rs/nu_plugin_from_bencode/
- Size: 125 KB
- Stars: 0
- Watchers: 3
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE-APACHE
Awesome Lists containing this project
- awesome-nu - nu_plugin_from_bencode
README
# Nu Plugin From Bencode
A converter plugin from the [bencode][bep_0003] format for [Nushell][nushell].
The plugin was last tested on nushell version `0.93.0`.
The plugin is unstable as the interface `Nu` for plugins is unstable.
The plugin could be useful for inspecting a [BitTorrent][bittorrent] metainfo
file (*.torrent), but it is primarily used to explore writing a `Nu` plugin.
## Installation
```sh
cargo install nu_plugin_from_bencode
```
[Register][nushell_register] the plugin:
```sh
register /nu_plugin_from_bencode
```
By default, cargo installs to `$HOME/.cargo/bin` on Unix systems.
## Usage
The `from bencode` command is provided with no parameter arguments.
To use:
```sh
> open ubuntu-20.04.4-live-server-amd64.iso.torrent | from bencode
╭───────────────┬─────────────────────────────────────╮
│ announce │ https://torrent.ubuntu.com/announce │
│ announce-list │ [list 2 items] │
│ comment │ Ubuntu CD releases.ubuntu.com │
│ created by │ mktorrent 1.1 │
│ creation date │ 1645734525 │
│ info │ {record 4 fields} │
╰───────────────┴─────────────────────────────────────╯
> open ubuntu-20.04.4-live-server-amd64.iso.torrent | from bencode | select announce-list.0.0
╭───────────────────┬─────────────────────────────────────╮
│ announce-list.0.0 │ https://torrent.ubuntu.com/announce │
╰───────────────────┴─────────────────────────────────────╯
> open ubuntu-20.04.4-live-server-amd64.iso.torrent | from bencode | get announce-list.1.0
https://ipv6.torrent.ubuntu.com/announce
> open ubuntu-20.04.1-live-server-amd64.iso.torrent | from bencode | select info.name info.length
╭─────────────┬──────────────────────────────────────╮
│ info.name │ ubuntu-20.04.4-live-server-amd64.iso │
│ info.length │ 1331691520 │
╰─────────────┴──────────────────────────────────────╯
```
## License
Licensed under either of [Apache License, Version 2.0][LICENSE_APACHE] or [MIT
License][LICENSE_MIT] at your option.
### Contributions
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be
dual licensed as above, without any additional terms or conditions.
[LICENSE_APACHE]: LICENSE-APACHE
[LICENSE_MIT]: LICENSE-MIT
[bep_0003]: http://bittorrent.org/beps/bep_0003.html
[nushell]: https://www.nushell.sh/
[bittorrent]: http://bittorrent.org/
[nushell_register]: https://www.nushell.sh/book/plugins.html#adding-a-plugin