# Jvav
Useful tools for crawling study resources. Supports Python library operations and command-line usage, with additional proxy options and cache support.
## INSTALL
```
# python >= 3.9
pip install jvav -U
```
## LIB
- DmmUtil
- JavDbUtil
- JavLibUtil
- JavBusUtil
- AvgleUtil
- MagnetUtil
- SukebeiUtil
- WikiUtil
- TransUtil
- 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.9.13 for development, please use python <= 3.9.
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.9.13/bin/python -m venv .venv -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~
- [ ] support RankUtil in CMD
- [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.9",
"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/0e/bb/152ee61f93407ba5ce30abaa83ec82f523369c4c682d6356f7bce3dd3d53/jvav-2.5.1.tar.gz",
"platform": null,
"description": "# Jvav\n\nUseful tools for crawling study resources. Supports Python library operations and command-line usage, with additional proxy options and cache support.\n\n## INSTALL\n\n```\n# python >= 3.9\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- 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.9.13 for development, please use python <= 3.9. \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.9.13/bin/python -m venv .venv -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- [ ] support RankUtil in CMD\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": "2.5.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": "8102c208a1ccd4debac0ddc25d16d1411adab90b3a9ff61a6c831ed062ab7b00",
"md5": "9af304ca1c0bd54dde9b08a835df7a8b",
"sha256": "67aabd1d9af3f18fc949b505f627ec19b57ddd1766c916f655ea7a731f0f3b8b"
},
"downloads": -1,
"filename": "Jvav-2.5.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9af304ca1c0bd54dde9b08a835df7a8b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "~=3.9",
"size": 32096,
"upload_time": "2024-10-19T08:45:39",
"upload_time_iso_8601": "2024-10-19T08:45:39.069874Z",
"url": "https://files.pythonhosted.org/packages/81/02/c208a1ccd4debac0ddc25d16d1411adab90b3a9ff61a6c831ed062ab7b00/Jvav-2.5.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0ebb152ee61f93407ba5ce30abaa83ec82f523369c4c682d6356f7bce3dd3d53",
"md5": "cd8c962272591cf5949ec5ebbf5e90ae",
"sha256": "a6ba06685eb5030bcc3765994a46bf9807c8dc3f0369f1f0cf07842d0fde8100"
},
"downloads": -1,
"filename": "jvav-2.5.1.tar.gz",
"has_sig": false,
"md5_digest": "cd8c962272591cf5949ec5ebbf5e90ae",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "~=3.9",
"size": 34489,
"upload_time": "2024-10-19T08:45:40",
"upload_time_iso_8601": "2024-10-19T08:45:40.968210Z",
"url": "https://files.pythonhosted.org/packages/0e/bb/152ee61f93407ba5ce30abaa83ec82f523369c4c682d6356f7bce3dd3d53/jvav-2.5.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-19 08:45:40",
"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"
}
JSON
