sjoa


Namesjoa JSON
Version 1.3.1 PyPI version JSON
download
home_pagehttps://github.com/barnumbirr/sjoa
SummaryCommand-line tool to read metadata from torrent files or magnet URLs.
upload_time2024-09-04 09:25:37
maintainerNone
docs_urlNone
authorMartin Simon
requires_pythonNone
licenseNone
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <p align="center"><img src="./assets/sjoa.jpg" width=240></img></p>
<p align="center"><i>illustration generated using <a href="https://perchance.org/ai-pixel-art-generator">perchance.org</a></i></p>

<h1 align="center">sjoa</h1>

`sjoa` is a powerful command-line tool designed to read metadata from torrent
files or magnet URIs. It provides a simple and efficient way to extract
information about torrents without the need to download the actual content.

> The Sjoa is a river in Innlandet county, Norway and is one of the best
> whitewater rafting rivers in Europe renowned for its fast-moving, turbulent
> waters with Class II-V rapids depending on the water level.
>
> <p style="font-size: 12px" align="right">
>     Source: <a href="https://en.wikipedia.org/wiki/Sjoa">Wikipedia</a>
> and <a href="https://www.oars.com/blog/best-whitewater-rafting-in-europe/">OARS</a>
> </p>

The word `sjoa` was chosen as a play on words: the term "torrent" is often used
to describe a fast-flowing stream or river, typically characterized by strong
currents and rapid water movement.

## Installation

`sjoa` is implemented in Python and can be installed using pip, the Python
package manager. To install `sjoa`, simply run:

```bash
$ pip install sjoa
```

## Usage

Once installed, you can use `sjoa` from the command line.

```
$ sjoa -t examples/debian-12.2.0-amd64-DVD-1.iso.torrent
 Name            debian-12.2.0-amd64-DVD-1.iso
 Hash            267d63ffd31770e467f8d985a86633f05502c10d
 Size            3.72 GiB
 Pieces          15237 of length 256 KiB (last piece 64.00 KiB)
 Creation        2023-10-07 12:03:00 by mktorrent 1.1
 Comment         "Debian CD from cdimage.debian.org"
 Private         False
 Tracker URL(s)  • http://bttracker.debian.org:6969/announce
 Webseed URL(s)  • https://cdimage.debian.org/cdimage/release/12.2.0/amd64/iso-dvd/debian-12.2.0-amd64-DVD-1.iso
                 • https://cdimage.debian.org/cdimage/archive/12.2.0/amd64/iso-dvd/debian-12.2.0-amd64-DVD-1.iso
 Files           ┌───────────────────────────────────────────────────────────────────────┬─────────────────────┐
                 │ • debian-12.2.0-amd64-DVD-1.iso                                       │ 3.72 GiB            │
                 └───────────────────────────────────────────────────────────────────────┴─────────────────────┘
```

```
$ sjoa -m "magnet:?xt=urn:btih:2c6b6858d61da9543d4231a71db4b1c9264b0685&dn=ubuntu-22.04-desktop-amd64.iso&tr=https%3A%2F%2Ftorrent.ubuntu.com%2Fannounce&tr=https%3A%2F%2Fipv6.torrent.ubuntu.com%2Fannounce"
 Name            ubuntu-22.04-desktop-amd64.iso
 Hash            2c6b6858d61da9543d4231a71db4b1c9264b0685
 Tracker URL(s)  • https://torrent.ubuntu.com/announce
                 • https://ipv6.torrent.ubuntu.com/announce
```

## License

```
Copyright 2023-2024 Martin Simon

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```

## Buy me a coffee?

If you feel like buying me a coffee (or a beer?), donations are welcome:

```
BTC : bc1qq04jnuqqavpccfptmddqjkg7cuspy3new4sxq9
DOGE: DRBkryyau5CMxpBzVmrBAjK6dVdMZSBsuS
ETH : 0x2238A11856428b72E80D70Be8666729497059d95
LTC : MQwXsBrArLRHQzwQZAjJPNrxGS1uNDDKX6
```

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/barnumbirr/sjoa",
    "name": "sjoa",
    "maintainer": null,
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": null,
    "keywords": null,
    "author": "Martin Simon",
    "author_email": "martin@simon.tf",
    "download_url": "https://files.pythonhosted.org/packages/33/60/47e6a5a7f5bbc0708a91264660a798658ef786a7f341c9bd8b95c4d0e317/sjoa-1.3.1.tar.gz",
    "platform": null,
    "description": "<p align=\"center\"><img src=\"./assets/sjoa.jpg\" width=240></img></p>\n<p align=\"center\"><i>illustration generated using <a href=\"https://perchance.org/ai-pixel-art-generator\">perchance.org</a></i></p>\n\n<h1 align=\"center\">sjoa</h1>\n\n`sjoa` is a powerful command-line tool designed to read metadata from torrent\nfiles or magnet URIs. It provides a simple and efficient way to extract\ninformation about torrents without the need to download the actual content.\n\n> The Sjoa is a river in Innlandet county, Norway and is one of the best\n> whitewater rafting rivers in Europe renowned for its fast-moving, turbulent\n> waters with Class II-V rapids depending on the water level.\n>\n> <p style=\"font-size: 12px\" align=\"right\">\n>     Source: <a href=\"https://en.wikipedia.org/wiki/Sjoa\">Wikipedia</a>\n> and <a href=\"https://www.oars.com/blog/best-whitewater-rafting-in-europe/\">OARS</a>\n> </p>\n\nThe word `sjoa` was chosen as a play on words: the term \"torrent\" is often used\nto describe a fast-flowing stream or river, typically characterized by strong\ncurrents and rapid water movement.\n\n## Installation\n\n`sjoa` is implemented in Python and can be installed using pip, the Python\npackage manager. To install `sjoa`, simply run:\n\n```bash\n$ pip install sjoa\n```\n\n## Usage\n\nOnce installed, you can use `sjoa` from the command line.\n\n```\n$ sjoa -t examples/debian-12.2.0-amd64-DVD-1.iso.torrent\n Name            debian-12.2.0-amd64-DVD-1.iso\n Hash            267d63ffd31770e467f8d985a86633f05502c10d\n Size            3.72 GiB\n Pieces          15237 of length 256 KiB (last piece 64.00 KiB)\n Creation        2023-10-07 12:03:00 by mktorrent 1.1\n Comment         \"Debian CD from cdimage.debian.org\"\n Private         False\n Tracker URL(s)  \u2022 http://bttracker.debian.org:6969/announce\n Webseed URL(s)  \u2022 https://cdimage.debian.org/cdimage/release/12.2.0/amd64/iso-dvd/debian-12.2.0-amd64-DVD-1.iso\n                 \u2022 https://cdimage.debian.org/cdimage/archive/12.2.0/amd64/iso-dvd/debian-12.2.0-amd64-DVD-1.iso\n Files           \u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n                 \u2502 \u2022 debian-12.2.0-amd64-DVD-1.iso                                       \u2502 3.72 GiB            \u2502\n                 \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n```\n$ sjoa -m \"magnet:?xt=urn:btih:2c6b6858d61da9543d4231a71db4b1c9264b0685&dn=ubuntu-22.04-desktop-amd64.iso&tr=https%3A%2F%2Ftorrent.ubuntu.com%2Fannounce&tr=https%3A%2F%2Fipv6.torrent.ubuntu.com%2Fannounce\"\n Name            ubuntu-22.04-desktop-amd64.iso\n Hash            2c6b6858d61da9543d4231a71db4b1c9264b0685\n Tracker URL(s)  \u2022 https://torrent.ubuntu.com/announce\n                 \u2022 https://ipv6.torrent.ubuntu.com/announce\n```\n\n## License\n\n```\nCopyright 2023-2024 Martin Simon\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n   http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```\n\n## Buy me a coffee?\n\nIf you feel like buying me a coffee (or a beer?), donations are welcome:\n\n```\nBTC : bc1qq04jnuqqavpccfptmddqjkg7cuspy3new4sxq9\nDOGE: DRBkryyau5CMxpBzVmrBAjK6dVdMZSBsuS\nETH : 0x2238A11856428b72E80D70Be8666729497059d95\nLTC : MQwXsBrArLRHQzwQZAjJPNrxGS1uNDDKX6\n```\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Command-line tool to read metadata from torrent files or magnet URLs.",
    "version": "1.3.1",
    "project_urls": {
        "Download": "https://github.com/barnumbirr/sjoa/archive/refs/heads/master.zip",
        "Homepage": "https://github.com/barnumbirr/sjoa"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "7a15a04bff3bb5607d3c81d0a5474982a238bc8291818814a27abbc98409e1ff",
                "md5": "6bbf4ac7b37e87ea892650dcff51567e",
                "sha256": "b8cc679efbad0e54d199ba4965dc462071d9a69557e799309ad3d9cd19f623d0"
            },
            "downloads": -1,
            "filename": "sjoa-1.3.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "6bbf4ac7b37e87ea892650dcff51567e",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 11055,
            "upload_time": "2024-09-04T09:25:36",
            "upload_time_iso_8601": "2024-09-04T09:25:36.093885Z",
            "url": "https://files.pythonhosted.org/packages/7a/15/a04bff3bb5607d3c81d0a5474982a238bc8291818814a27abbc98409e1ff/sjoa-1.3.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "336047e6a5a7f5bbc0708a91264660a798658ef786a7f341c9bd8b95c4d0e317",
                "md5": "0464e092374e0032e0e2ae4e77db7340",
                "sha256": "bd1b5c749bd6b3a09cf275e18782bef564b5e254c6144436b9024dd4fed9c422"
            },
            "downloads": -1,
            "filename": "sjoa-1.3.1.tar.gz",
            "has_sig": false,
            "md5_digest": "0464e092374e0032e0e2ae4e77db7340",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 11205,
            "upload_time": "2024-09-04T09:25:37",
            "upload_time_iso_8601": "2024-09-04T09:25:37.002518Z",
            "url": "https://files.pythonhosted.org/packages/33/60/47e6a5a7f5bbc0708a91264660a798658ef786a7f341c9bd8b95c4d0e317/sjoa-1.3.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-09-04 09:25:37",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "barnumbirr",
    "github_project": "sjoa",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [],
    "lcname": "sjoa"
}
        
Elapsed time: 2.09328s