# Jvav
Useful tools for Jav. Supports Python library operations and command-line usage, with additional proxy options and cache support.
## INSTALL
```
# python >= 3.7
pip install jvav -U
```
## LIB
- DmmUtil
- JavDbUtil
- JavLibUtil
- JavBusUtil
- AvgleUtil
- MagnetUtil
- SukebeiUtil
- WikiUtil
- TransUtil
- SgpUtil
- RankUtil
```py
# A sample for DmmUtil
import jvav
util = jvav.DmmUtil()
util.get_nice_avs_by_star_name('小倉由菜')
util.get_score_by_id('cawd-441')
util.get_all_top_stars()
```
## CMD
```shell
usage: cmd.py [-h] [-v] [-av1 AV1] [-av2 AV2] [-av3 AV3] [-sg SG] [-auth AUTH]
[-nc] [-uc] [-sr SR] [-srn SRN] [-tg TG] [-pv1 PV1] [-pv2 PV2]
[-tp] [-p PROXY]
optional arguments:
-h, --help show this help message and exit
-v, --version Check version
-av1 AV1 Followed by a code, search this code on JavBus
-av2 AV2 Followed by a code, search this code on Sukebei
-av3 AV3 Followed by a code, search this code on JavDb
-sg SG Followed by a code, search the explainer video of this
code
-auth AUTH Followed by a authentication code for JavBus, get it
from cookie key: bus_auth
-nc Filter out high-definition subtitles magnet links
-uc Filter out uncoded magnet links
-sr SR Followed by an actress name, get a list of high-rated
codes based on the actress name
-srn SRN Followed by an actress name, get a list of the most
recent codes based on the actress name
-tg TG Followed by a keyword, search for codes based on the
keyword
-pv1 PV1 Followed by a code, get the corresponding preview
video of the code on DMM
-pv2 PV2 Follow a code, get the corresponding preview video of
the code on Avgle
-tp Get the top 25 ranking of DMM actresses
-p PROXY, --proxy PROXY
Followed by a proxy server address (by default reads
the value of the environment variable http_proxy)
```
## DEV
I use python-3.7.12 for development, please use python <= 3.7.
And it is recommended to use python virtual environment to avoid some unnecessary problems.
Here is my developing steps:
```shell
git clone https://github.com/akynazh/jvav.git
cd jvav
~/.pyenv/versions/3.7.12/bin/python -m venv .venv
source ./.venv/bin/activate
pip3 install -r requirements.txt
```
And then you can enjoy coding! Remember to write or run test cases in `tests/test.py`.
Please make sure the test is okay before submitting your code~
## TODO
The following are some functions to be implemented, and I look forward to your contribution~
- [ ] fix SgpUtil(currently not work)
- [ ] support RankUtil in CMD
- [ ] fix JavLibUtil(currently not work because of cloudflare)
- [x] cache the successful query results locally (Thanks: [@akynazh](https://github.com/akynazh))
- [x] support javdb.com (Thanks: [@Steven-Fake](https://github.com/Steven-Fake))
- [ ] support db.msin.jp
- [x] support JavDbUtil in cmd (Thanks: [@akynazh](https://github.com/akynazh))
## Thanks
<a href="https://www.jetbrains.com/">
<img src="https://resources.jetbrains.com/storage/products/company/brand/logos/jb_beam.png" alt="JetBrains Logo (Main) logo." style="width: 200px;"></a>
Thanks to JetBrains for their support to this project!
Raw data
{
"_id": null,
"home_page": "https://github.com/akynazh/jvav",
"name": "Jvav",
"maintainer": null,
"docs_url": null,
"requires_python": "~=3.7",
"maintainer_email": null,
"keywords": "jav japan av api library python spider",
"author": "akynazh",
"author_email": "akynazh@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/8d/1a/81ddf4d4bfc44574cd70291b3d2a8be2d9c5be986ad9c4552deb5ba2f181/Jvav-1.9.1.tar.gz",
"platform": null,
"description": "# Jvav\n\nUseful tools for Jav. Supports Python library operations and command-line usage, with additional proxy options and cache support.\n\n## INSTALL\n\n```\n# python >= 3.7\npip install jvav -U\n```\n\n## LIB\n\n- DmmUtil\n- JavDbUtil\n- JavLibUtil\n- JavBusUtil\n- AvgleUtil\n- MagnetUtil\n- SukebeiUtil\n- WikiUtil\n- TransUtil\n- SgpUtil\n- RankUtil\n\n```py\n# A sample for DmmUtil\nimport jvav\n\nutil = jvav.DmmUtil()\nutil.get_nice_avs_by_star_name('\u5c0f\u5009\u7531\u83dc')\nutil.get_score_by_id('cawd-441')\nutil.get_all_top_stars()\n```\n\n## CMD\n\n```shell\nusage: cmd.py [-h] [-v] [-av1 AV1] [-av2 AV2] [-av3 AV3] [-sg SG] [-auth AUTH]\n [-nc] [-uc] [-sr SR] [-srn SRN] [-tg TG] [-pv1 PV1] [-pv2 PV2]\n [-tp] [-p PROXY]\n\noptional arguments:\n -h, --help show this help message and exit\n -v, --version Check version\n -av1 AV1 Followed by a code, search this code on JavBus\n -av2 AV2 Followed by a code, search this code on Sukebei\n -av3 AV3 Followed by a code, search this code on JavDb\n -sg SG Followed by a code, search the explainer video of this\n code\n -auth AUTH Followed by a authentication code for JavBus, get it\n from cookie key: bus_auth\n -nc Filter out high-definition subtitles magnet links\n -uc Filter out uncoded magnet links\n -sr SR Followed by an actress name, get a list of high-rated\n codes based on the actress name\n -srn SRN Followed by an actress name, get a list of the most\n recent codes based on the actress name\n -tg TG Followed by a keyword, search for codes based on the\n keyword\n -pv1 PV1 Followed by a code, get the corresponding preview\n video of the code on DMM\n -pv2 PV2 Follow a code, get the corresponding preview video of\n the code on Avgle\n -tp Get the top 25 ranking of DMM actresses\n -p PROXY, --proxy PROXY\n Followed by a proxy server address (by default reads\n the value of the environment variable http_proxy)\n```\n\n## DEV\n\nI use python-3.7.12 for development, please use python <= 3.7. \n\nAnd it is recommended to use python virtual environment to avoid some unnecessary problems.\n\nHere is my developing steps:\n\n```shell\ngit clone https://github.com/akynazh/jvav.git\ncd jvav\n~/.pyenv/versions/3.7.12/bin/python -m venv .venv\nsource ./.venv/bin/activate\npip3 install -r requirements.txt\n```\n\nAnd then you can enjoy coding! Remember to write or run test cases in `tests/test.py`.\nPlease make sure the test is okay before submitting your code~\n\n## TODO\n\nThe following are some functions to be implemented, and I look forward to your contribution~ \n\n- [ ] fix SgpUtil(currently not work)\n- [ ] support RankUtil in CMD\n- [ ] fix JavLibUtil(currently not work because of cloudflare)\n- [x] cache the successful query results locally (Thanks: [@akynazh](https://github.com/akynazh))\n- [x] support javdb.com (Thanks: [@Steven-Fake](https://github.com/Steven-Fake))\n- [ ] support db.msin.jp\n- [x] support JavDbUtil in cmd (Thanks: [@akynazh](https://github.com/akynazh))\n\n## Thanks\n\n<a href=\"https://www.jetbrains.com/\">\n<img src=\"https://resources.jetbrains.com/storage/products/company/brand/logos/jb_beam.png\" alt=\"JetBrains Logo (Main) logo.\" style=\"width: 200px;\"></a>\n\nThanks to JetBrains for their support to this project!\n",
"bugtrack_url": null,
"license": "GPLv3",
"summary": "Useful tools for Jav.",
"version": "1.9.1",
"project_urls": {
"Download": "https://github.com/akynazh/jvav/releases/latest",
"Homepage": "https://github.com/akynazh/jvav",
"Source": "https://github.com/akynazh/jvav",
"Tracker": "https://github.com/akynazh/jvav/issues"
},
"split_keywords": [
"jav",
"japan",
"av",
"api",
"library",
"python",
"spider"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "19c819010cf656e5941964b9ef369c265a7b0735668454e5f8fe340f877b7e1a",
"md5": "fa5248ffbae3d8af2ba7a3269dcba6a8",
"sha256": "055ac92a921e2533de2ecf4db9bfcf31542870355cf53be223706da7290f7606"
},
"downloads": -1,
"filename": "Jvav-1.9.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "fa5248ffbae3d8af2ba7a3269dcba6a8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "~=3.7",
"size": 31801,
"upload_time": "2024-04-26T15:54:53",
"upload_time_iso_8601": "2024-04-26T15:54:53.581951Z",
"url": "https://files.pythonhosted.org/packages/19/c8/19010cf656e5941964b9ef369c265a7b0735668454e5f8fe340f877b7e1a/Jvav-1.9.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8d1a81ddf4d4bfc44574cd70291b3d2a8be2d9c5be986ad9c4552deb5ba2f181",
"md5": "16ef3547666ff7e3ab6a9581fdbc3c5a",
"sha256": "c15862d5b4d4feae7a1229eecb021fd44d2d398e462dd2159a8e4c5d328016a3"
},
"downloads": -1,
"filename": "Jvav-1.9.1.tar.gz",
"has_sig": false,
"md5_digest": "16ef3547666ff7e3ab6a9581fdbc3c5a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "~=3.7",
"size": 33188,
"upload_time": "2024-04-26T15:54:55",
"upload_time_iso_8601": "2024-04-26T15:54:55.661484Z",
"url": "https://files.pythonhosted.org/packages/8d/1a/81ddf4d4bfc44574cd70291b3d2a8be2d9c5be986ad9c4552deb5ba2f181/Jvav-1.9.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-26 15:54:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "akynazh",
"github_project": "jvav",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "jvav"
}