nzb


Namenzb JSON
Version 0.3.0 PyPI version JSON
download
home_pageNone
SummaryA spec compliant parser and meta editor for NZB files
upload_time2024-10-11 13:28:51
maintainerNone
docs_urlNone
authorNone
requires_python>=3.10
licenseNone
keywords nzb parser usenet
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls. 
            <br/>
<p align="center">
  <a href="https://github.com/Ravencentric/nzb">
    <img src="https://raw.githubusercontent.com/Ravencentric/nzb/main/docs/assets/logo.png" alt="Logo" width="200">
  </a>
  <p align="center">
    A spec compliant parser and meta editor for NZB files
  </p>
</p>

<div align="center">

[![PyPI - Version](https://img.shields.io/pypi/v/nzb?link=https%3A%2F%2Fpypi.org%2Fproject%2Fnzb%2F)](https://pypi.org/project/nzb/)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/nzb)
![License](https://img.shields.io/github/license/Ravencentric/nzb)
![Checked with mypy](https://www.mypy-lang.org/static/mypy_badge.svg)
![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)

![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/Ravencentric/nzb/release.yml)
![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/ravencentric/nzb/test.yml?label=tests)
[![codecov](https://codecov.io/gh/Ravencentric/nzb/graph/badge.svg?token=FFSOFFOM6J)](https://codecov.io/gh/Ravencentric/nzb)

</div>

## Table Of Contents

* [About](#about)
* [Installation](#installation)
* [Docs](#docs)
* [License](#license)


## About

A [spec](https://sabnzbd.org/wiki/extra/nzb-spec) compliant parser and meta editor for NZB files.

## Installation

`nzb` is available on [PyPI](https://pypi.org/project/nzb/), so you can simply use [pip](https://github.com/pypa/pip) to install it.

```sh
pip install nzb
```

## Usage

```py
from nzb import NZBParser

nzb = NZBParser.from_file("Big Buck Bunny - S01E01.mkv.nzb").parse()

print(f"{nzb.file.name} ({nzb.file.size.human_readable()})")
#> Big Buck Bunny - S01E01.mkv (16.7MiB)

for file in nzb.files:
    print((file.name, file.size, file.datetime.isoformat(), file.groups))
    #> ("Big Buck Bunny - S01E01.mkv", 17521761, "2024-01-28T11:18:28+00:00", ("alt.binaries.boneless",))
    #> ("Big Buck Bunny - S01E01.mkv.par2", 1089, "2024-01-28T11:18:29+00:00", ("alt.binaries.boneless",))
    #> ("Big Buck Bunny - S01E01.mkv.vol00+01.par2", 741017, "2024-01-28T11:18:29+00:00", ("alt.binaries.boneless",))
    #> ("Big Buck Bunny - S01E01.mkv.vol01+02.par2", 1480494, "2024-01-28T11:18:29+00:00", ("alt.binaries.boneless",))
    #> ("Big Buck Bunny - S01E01.mkv.vol03+04.par2", 2960528, "2024-01-28T11:18:29+00:00", ("alt.binaries.boneless",))
```

## Docs

Checkout the complete documentation [here](https://nzb.ravencentric.cc/).

## License

Distributed under the [MIT](https://choosealicense.com/licenses/mit/) License. See [LICENSE](https://github.com/Ravencentric/nzb/blob/main/LICENSE) for more information.

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "nzb",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": null,
    "keywords": "nzb, parser, usenet",
    "author": null,
    "author_email": "Ravencentric <me@ravencentric.cc>",
    "download_url": "https://files.pythonhosted.org/packages/13/16/cfb8bf13fe42f5843b4c9b088171e9c2afc0da85e77b74c48410d5a69474/nzb-0.3.0.tar.gz",
    "platform": null,
    "description": "<br/>\n<p align=\"center\">\n  <a href=\"https://github.com/Ravencentric/nzb\">\n    <img src=\"https://raw.githubusercontent.com/Ravencentric/nzb/main/docs/assets/logo.png\" alt=\"Logo\" width=\"200\">\n  </a>\n  <p align=\"center\">\n    A spec compliant parser and meta editor for NZB files\n  </p>\n</p>\n\n<div align=\"center\">\n\n[![PyPI - Version](https://img.shields.io/pypi/v/nzb?link=https%3A%2F%2Fpypi.org%2Fproject%2Fnzb%2F)](https://pypi.org/project/nzb/)\n![PyPI - Python Version](https://img.shields.io/pypi/pyversions/nzb)\n![License](https://img.shields.io/github/license/Ravencentric/nzb)\n![Checked with mypy](https://www.mypy-lang.org/static/mypy_badge.svg)\n![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)\n\n![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/Ravencentric/nzb/release.yml)\n![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/ravencentric/nzb/test.yml?label=tests)\n[![codecov](https://codecov.io/gh/Ravencentric/nzb/graph/badge.svg?token=FFSOFFOM6J)](https://codecov.io/gh/Ravencentric/nzb)\n\n</div>\n\n## Table Of Contents\n\n* [About](#about)\n* [Installation](#installation)\n* [Docs](#docs)\n* [License](#license)\n\n\n## About\n\nA [spec](https://sabnzbd.org/wiki/extra/nzb-spec) compliant parser and meta editor for NZB files.\n\n## Installation\n\n`nzb` is available on [PyPI](https://pypi.org/project/nzb/), so you can simply use [pip](https://github.com/pypa/pip) to install it.\n\n```sh\npip install nzb\n```\n\n## Usage\n\n```py\nfrom nzb import NZBParser\n\nnzb = NZBParser.from_file(\"Big Buck Bunny - S01E01.mkv.nzb\").parse()\n\nprint(f\"{nzb.file.name} ({nzb.file.size.human_readable()})\")\n#> Big Buck Bunny - S01E01.mkv (16.7MiB)\n\nfor file in nzb.files:\n    print((file.name, file.size, file.datetime.isoformat(), file.groups))\n    #> (\"Big Buck Bunny - S01E01.mkv\", 17521761, \"2024-01-28T11:18:28+00:00\", (\"alt.binaries.boneless\",))\n    #> (\"Big Buck Bunny - S01E01.mkv.par2\", 1089, \"2024-01-28T11:18:29+00:00\", (\"alt.binaries.boneless\",))\n    #> (\"Big Buck Bunny - S01E01.mkv.vol00+01.par2\", 741017, \"2024-01-28T11:18:29+00:00\", (\"alt.binaries.boneless\",))\n    #> (\"Big Buck Bunny - S01E01.mkv.vol01+02.par2\", 1480494, \"2024-01-28T11:18:29+00:00\", (\"alt.binaries.boneless\",))\n    #> (\"Big Buck Bunny - S01E01.mkv.vol03+04.par2\", 2960528, \"2024-01-28T11:18:29+00:00\", (\"alt.binaries.boneless\",))\n```\n\n## Docs\n\nCheckout the complete documentation [here](https://nzb.ravencentric.cc/).\n\n## License\n\nDistributed under the [MIT](https://choosealicense.com/licenses/mit/) License. See [LICENSE](https://github.com/Ravencentric/nzb/blob/main/LICENSE) for more information.\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "A spec compliant parser and meta editor for NZB files",
    "version": "0.3.0",
    "project_urls": {
        "Documentation": "https://nzb.ravencentric.cc",
        "Homepage": "https://nzb.ravencentric.cc",
        "Repository": "https://github.com/Ravencentric/nzb"
    },
    "split_keywords": [
        "nzb",
        " parser",
        " usenet"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "561b83af2cdbc8bf154b740fe5b37a44f9a6d15ab127e91f5edfd24f34dc36e2",
                "md5": "33fdd7a71644b5238d779617102f925e",
                "sha256": "fe7d6117c86e05117198b418c68b210f3e8fe9cd7006d6d093cecb2e1c290afc"
            },
            "downloads": -1,
            "filename": "nzb-0.3.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "33fdd7a71644b5238d779617102f925e",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 13377,
            "upload_time": "2024-10-11T13:28:49",
            "upload_time_iso_8601": "2024-10-11T13:28:49.359023Z",
            "url": "https://files.pythonhosted.org/packages/56/1b/83af2cdbc8bf154b740fe5b37a44f9a6d15ab127e91f5edfd24f34dc36e2/nzb-0.3.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "1316cfb8bf13fe42f5843b4c9b088171e9c2afc0da85e77b74c48410d5a69474",
                "md5": "9f0a9545fdb357a38b71f1b9de5aec6a",
                "sha256": "b0bb45c8c8078ad4498b168c6eec3e05a0ddad9572ecf8e8d465cfc563e64807"
            },
            "downloads": -1,
            "filename": "nzb-0.3.0.tar.gz",
            "has_sig": false,
            "md5_digest": "9f0a9545fdb357a38b71f1b9de5aec6a",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 144273,
            "upload_time": "2024-10-11T13:28:51",
            "upload_time_iso_8601": "2024-10-11T13:28:51.526399Z",
            "url": "https://files.pythonhosted.org/packages/13/16/cfb8bf13fe42f5843b4c9b088171e9c2afc0da85e77b74c48410d5a69474/nzb-0.3.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-10-11 13:28:51",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "Ravencentric",
    "github_project": "nzb",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "nzb"
}
None
Elapsed time: 1.12274s