# python-nozomi
[](https://travis-ci.com/Alfa-Q/python-nozomi)
[](https://app.codacy.com/gh/Alfa-Q/python-nozomi/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)
[](https://app.codacy.com/gh/Alfa-Q/python-nozomi/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_coverage)
[](https://badge.fury.io/py/python-nozomi)
[](https://www.python.org/downloads/release/python-370/)
nozomi.la API in Python.
## Features
- Retrieving media posts
- Downloading media
## Installation
```
$ pip install python-nozomi
```
## Upgrade
```
$ pip install python-nozomi --upgrade
```
## Example Usage
Retrieve and download a single post provided a URL
```python
from pathlib import Path
from nozomi import api
url = 'https://nozomi.la/post/26905532.html#veigar'
# Retrieve post metadata using the URL
post = api.get_post(url)
# Download the post
api.download_media(post, Path.cwd())
```
Retrieve and download multiple posts provided a list of URLs
```python
from pathlib import Path
from nozomi import api
urls = [
'https://nozomi.la/post/26905532.html#veigar',
"https://nozomi.la/post/26932594.html#cho'gath",
'https://nozomi.la/post/25802243.html#nautilus'
]
# Retrieve all of the post metadata using the URLs
posts = api.get_posts(urls)
# Download the posts
for post in posts:
api.download_media(post, Path.cwd())
```
Retrieve and download all posts containing certain tags
```python
# The tags that the posts retrieved must contain
positive_tags = ['veigar', 'wallpaper']
# Gets all posts with the tags 'veigar', 'wallpaper'
for post in api.get_posts_with_tags(positive_tags):
api.download_media(post, Path.cwd())
```
Retrieve all posts containing certain tags, ignoring blacklisted tags
```python
# The blacklisted tags
negative_tags = ['chogath']
# Gets all posts with the tags 'veigar' and 'wallpaper' without the 'chogath' tag.
for post in api.get_posts_with_tags(positive_tags, negative_tags):
api.download_media(post, Path.cwd())
```
Raw data
{
"_id": null,
"home_page": "https://github.com/Alfa-Q/python-nozomi",
"name": "python-nozomi",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "nozomi,nozomi.la,api,video,image,anime",
"author": "Alfa_Q",
"author_email": "alfakyuu@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/92/86/e1959ccae0f7e56ef1c7ddc1fd8ab51868dd86703c423aecffb5962ec294/python-nozomi-2.0.0.tar.gz",
"platform": null,
"description": "# python-nozomi\r\n\r\n[](https://travis-ci.com/Alfa-Q/python-nozomi)\r\n[](https://app.codacy.com/gh/Alfa-Q/python-nozomi/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_grade)\r\n[](https://app.codacy.com/gh/Alfa-Q/python-nozomi/dashboard?utm_source=gh&utm_medium=referral&utm_content=&utm_campaign=Badge_coverage)\r\n[](https://badge.fury.io/py/python-nozomi)\r\n[](https://www.python.org/downloads/release/python-370/)\r\n\r\nnozomi.la API in Python.\r\n\r\n## Features\r\n\r\n- Retrieving media posts\r\n- Downloading media\r\n\r\n## Installation\r\n\r\n```\r\n$ pip install python-nozomi\r\n```\r\n\r\n## Upgrade\r\n\r\n```\r\n$ pip install python-nozomi --upgrade\r\n```\r\n\r\n## Example Usage\r\n\r\nRetrieve and download a single post provided a URL\r\n\r\n```python\r\nfrom pathlib import Path\r\nfrom nozomi import api\r\n\r\nurl = 'https://nozomi.la/post/26905532.html#veigar'\r\n\r\n# Retrieve post metadata using the URL\r\npost = api.get_post(url)\r\n\r\n# Download the post\r\napi.download_media(post, Path.cwd())\r\n```\r\n\r\nRetrieve and download multiple posts provided a list of URLs\r\n\r\n```python\r\nfrom pathlib import Path\r\nfrom nozomi import api\r\n\r\nurls = [\r\n 'https://nozomi.la/post/26905532.html#veigar',\r\n \"https://nozomi.la/post/26932594.html#cho'gath\",\r\n 'https://nozomi.la/post/25802243.html#nautilus'\r\n]\r\n\r\n# Retrieve all of the post metadata using the URLs\r\nposts = api.get_posts(urls)\r\n\r\n# Download the posts\r\nfor post in posts:\r\n api.download_media(post, Path.cwd())\r\n```\r\n\r\nRetrieve and download all posts containing certain tags\r\n\r\n```python\r\n# The tags that the posts retrieved must contain\r\npositive_tags = ['veigar', 'wallpaper']\r\n\r\n# Gets all posts with the tags 'veigar', 'wallpaper'\r\nfor post in api.get_posts_with_tags(positive_tags):\r\n api.download_media(post, Path.cwd())\r\n```\r\n\r\nRetrieve all posts containing certain tags, ignoring blacklisted tags\r\n\r\n```python\r\n# The blacklisted tags\r\nnegative_tags = ['chogath']\r\n\r\n# Gets all posts with the tags 'veigar' and 'wallpaper' without the 'chogath' tag.\r\nfor post in api.get_posts_with_tags(positive_tags, negative_tags):\r\n api.download_media(post, Path.cwd())\r\n```\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Nozomi API for retrieving images, videos, gifs.",
"version": "2.0.0",
"project_urls": {
"Download": "https://github.com/Alfa-Q/python-nozomi/archive/2.0.0.tar.gz",
"Homepage": "https://github.com/Alfa-Q/python-nozomi"
},
"split_keywords": [
"nozomi",
"nozomi.la",
"api",
"video",
"image",
"anime"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "ba76308bb4a5d002ed265196b4af94b4cc7379f6beac8036c21497e004f1d9dc",
"md5": "7166a1786d5b817084a2510a6f06539b",
"sha256": "7f9c075cc482ce891afd5c864c684b871239be907e45692f501e93619be7b8e8"
},
"downloads": -1,
"filename": "python_nozomi-2.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7166a1786d5b817084a2510a6f06539b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 8745,
"upload_time": "2023-05-31T04:46:59",
"upload_time_iso_8601": "2023-05-31T04:46:59.900402Z",
"url": "https://files.pythonhosted.org/packages/ba/76/308bb4a5d002ed265196b4af94b4cc7379f6beac8036c21497e004f1d9dc/python_nozomi-2.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9286e1959ccae0f7e56ef1c7ddc1fd8ab51868dd86703c423aecffb5962ec294",
"md5": "218607004e0e165de3934fd188d3b80b",
"sha256": "90b7dc9c3dc29f6ad8693cabb1a548ce6317a2d88ba45b65d65681feb6f43884"
},
"downloads": -1,
"filename": "python-nozomi-2.0.0.tar.gz",
"has_sig": false,
"md5_digest": "218607004e0e165de3934fd188d3b80b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 8465,
"upload_time": "2023-05-31T04:47:02",
"upload_time_iso_8601": "2023-05-31T04:47:02.192388Z",
"url": "https://files.pythonhosted.org/packages/92/86/e1959ccae0f7e56ef1c7ddc1fd8ab51868dd86703c423aecffb5962ec294/python-nozomi-2.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-05-31 04:47:02",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Alfa-Q",
"github_project": "python-nozomi",
"travis_ci": true,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "python-nozomi"
}
JSON
