## is-bot
[](https://github.com/romis2012/is-bot/actions/workflows/ci.yml)
[](https://codecov.io/gh/romis2012/is-bot)
[](https://pypi.python.org/pypi/is-bot)
Python package to detect bots/crawlers/spiders via user-agent string.
This is a port of the [isbot](https://github.com/omrilotan/isbot) JavaScript module.
## Requirements
- Python >= 3.7
- regex >= 2022.8.17
## Installation
```
pip install is-bot
```
## Usage
### Simple usage
```python
from is_bot import Bots
bots = Bots()
ua = 'Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; Googlebot/2.1; +http://www.google.com/bot.html) Chrome/104.0.5112.79 Safari/537.36'
assert bots.is_bot(ua)
ua = 'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.0.0 Safari/537.36'
assert not bots.is_bot(ua)
```
### Add/remove parsing rules
```python
from is_bot import Bots
bots = Bots()
# Exclude Chrome-Lighthouse from default bot list
ua = 'Mozilla/5.0 (Linux; Android 7.0; Moto G (4)) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/98.0.4695.0 Mobile Safari/537.36 Chrome-Lighthouse'
assert bots.is_bot(ua)
bots.exclude(['chrome-lighthouse'])
assert not bots.is_bot(ua)
# Add some browser to default bot list
ua = 'SomeAwesomeBrowser/10.0 (Linux; Android 7.0)'
assert not bots.is_bot(ua)
bots.extend(['SomeAwesomeBrowser'])
assert bots.is_bot(ua)
```
### Get additional parsing information
```python
from is_bot import Bots
bots = Bots()
ua = 'Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Firefox/52.0 SearchRobot/1.0'
# view the respective match for bot user agent rule
print(bots.find(ua))
#> Search
# list all patterns that match the user agent string
print(bots.matches(ua))
#> ['(?<! (ya|yandex))search', '(?<! cu)bot']
```
Raw data
{
"_id": null,
"home_page": "https://github.com/romis2012/is-bot",
"name": "is-bot",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "python bots crawlers web-crawlers user-agent user-agent-parser",
"author": "Roman Snegirev",
"author_email": "snegiryev@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/a4/43/ec64ac14fd74d8335d223f30ce9a4e8a388e092ad6b9d66cd6d54cb95045/is_bot-0.2.4.tar.gz",
"platform": null,
"description": "## is-bot\n\n[](https://github.com/romis2012/is-bot/actions/workflows/ci.yml)\n[](https://codecov.io/gh/romis2012/is-bot)\n[](https://pypi.python.org/pypi/is-bot)\n\nPython package to detect bots/crawlers/spiders via user-agent string.\nThis is a port of the [isbot](https://github.com/omrilotan/isbot) JavaScript module.\n\n\n## Requirements\n- Python >= 3.7\n- regex >= 2022.8.17\n\n## Installation\n```\npip install is-bot\n```\n\n## Usage\n\n### Simple usage\n\n```python\nfrom is_bot import Bots\n\nbots = Bots()\n\nua = 'Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; Googlebot/2.1; +http://www.google.com/bot.html) Chrome/104.0.5112.79 Safari/537.36'\nassert bots.is_bot(ua)\n\nua = 'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/104.0.0.0 Safari/537.36'\nassert not bots.is_bot(ua)\n```\n\n### Add/remove parsing rules\n\n```python\nfrom is_bot import Bots\n\nbots = Bots()\n\n# Exclude Chrome-Lighthouse from default bot list\nua = 'Mozilla/5.0 (Linux; Android 7.0; Moto G (4)) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/98.0.4695.0 Mobile Safari/537.36 Chrome-Lighthouse'\nassert bots.is_bot(ua)\nbots.exclude(['chrome-lighthouse'])\nassert not bots.is_bot(ua)\n\n# Add some browser to default bot list\nua = 'SomeAwesomeBrowser/10.0 (Linux; Android 7.0)'\nassert not bots.is_bot(ua)\nbots.extend(['SomeAwesomeBrowser'])\nassert bots.is_bot(ua)\n```\n\n### Get additional parsing information\n\n```python\nfrom is_bot import Bots\n\nbots = Bots()\n\nua = 'Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Firefox/52.0 SearchRobot/1.0'\n\n# view the respective match for bot user agent rule\nprint(bots.find(ua))\n#> Search\n\n# list all patterns that match the user agent string\nprint(bots.matches(ua))\n#> ['(?<! (ya|yandex))search', '(?<! cu)bot']\n```\n\n\n\n",
"bugtrack_url": null,
"license": "Apache 2",
"summary": "Python package to detect bots/crawlers/spiders via user-agent",
"version": "0.2.4",
"project_urls": {
"Homepage": "https://github.com/romis2012/is-bot"
},
"split_keywords": [
"python",
"bots",
"crawlers",
"web-crawlers",
"user-agent",
"user-agent-parser"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "39188f1ee059c12924b38cf0ecf4f9b053e1980d60295a65ef018846f41ad19a",
"md5": "08f3fc72d7d1900d76320278f388ff99",
"sha256": "c23332e67d499c2d1aecd7796c851ef3ed5ae95bd3ba05d95f90f596eb0e6c25"
},
"downloads": -1,
"filename": "is_bot-0.2.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "08f3fc72d7d1900d76320278f388ff99",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 8570,
"upload_time": "2023-08-22T06:26:39",
"upload_time_iso_8601": "2023-08-22T06:26:39.390232Z",
"url": "https://files.pythonhosted.org/packages/39/18/8f1ee059c12924b38cf0ecf4f9b053e1980d60295a65ef018846f41ad19a/is_bot-0.2.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a443ec64ac14fd74d8335d223f30ce9a4e8a388e092ad6b9d66cd6d54cb95045",
"md5": "fe8ba0027efc18e5162aa9d125da54b5",
"sha256": "d35c4bf098bc4c49e6206009f78ac7c99ebb2f06bd8634911c51044a98f10d38"
},
"downloads": -1,
"filename": "is_bot-0.2.4.tar.gz",
"has_sig": false,
"md5_digest": "fe8ba0027efc18e5162aa9d125da54b5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 8160,
"upload_time": "2023-08-22T06:26:41",
"upload_time_iso_8601": "2023-08-22T06:26:41.065278Z",
"url": "https://files.pythonhosted.org/packages/a4/43/ec64ac14fd74d8335d223f30ce9a4e8a388e092ad6b9d66cd6d54cb95045/is_bot-0.2.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-22 06:26:41",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "romis2012",
"github_project": "is-bot",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "is-bot"
}
JSON
