![README banner for firefox-bookmarks](https://i.imgur.com/oZ2vyCx.png)
![CI Status](https://img.shields.io/github/actions/workflow/status/BURG3R5/firefox-bookmarks/integration_tests.yml?branch=main&style=flat-square) ![PyPI](https://img.shields.io/badge/pypi-1.1.0.post1-blue?style=flat-square) ![License - AGPL v3 or later](https://img.shields.io/pypi/l/firefox-bookmarks?style=flat-square) ![Code style: YAPF](https://img.shields.io/badge/code%20style-yapf-blue?style=flat-square) ![Code style: isort](https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat-square)
# firefox-bookmarks
Manage your Firefox bookmarks with ease
## installation
```shell
pip install firefox-bookmarks
```
## usage
Import and initialize:
```python
from firefox_bookmarks import *
fb = FirefoxBookmarks()
# You can pass a `ProfileCriterion` to choose from multiple profiles
fb.connect(criterion=ProfileCriterion.LARGEST)
```
Query as you would in peewee (or Django or SQLAlchemy)
```python
github_bookmarks = fb.bookmarks(
where=Bookmark.url.contains("https://github.com"),
)
for bookmark in github_bookmarks:
print(f"Title: {bookmark.title}\nURL: {bookmark.url}\n")
```
## examples
See [the examples directory](https://github.com/BURG3R5/firefox-bookmarks/tree/main/examples)
## contributing
Want to fix a bug, add a feature, or improve documentation? Awesome! Read up on our [guidelines for contributing](https://github.com/BURG3R5/firefox-bookmarks/blob/main/.github/CONTRIBUTING.md) and then visit our [/contribute page](https://github.com/BURG3R5/firefox-bookmarks/contribute) to find good first issues! Pull requests are always welcome!
## license
Copyright (C) 2023 Aditya Rajput & other contributors
This software is licensed under the **Affero GPL v3**. You should have received [a copy](https://github.com/BURG3R5/firefox-bookmarks/blob/main/LICENSE) of the Affero GPL v3 along with this program. If not, you can visit the original [here](https://www.gnu.org/licenses/agpl-3.0.html#license-text).
Raw data
{
"_id": null,
"home_page": "https://github.com/BURG3R5/firefox-bookmarks",
"name": "firefox-bookmarks",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.10,<4.0",
"maintainer_email": "",
"keywords": "firefox,bookmarks,browser,util",
"author": "Aditya Rajput",
"author_email": "adiraj20072002@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/01/c5/6e4a68f7188213e6c78b5920df1f73ef4b4d525b5d7637888873f5c09d9e/firefox_bookmarks-1.1.0.post1.tar.gz",
"platform": null,
"description": "![README banner for firefox-bookmarks](https://i.imgur.com/oZ2vyCx.png)\n\n![CI Status](https://img.shields.io/github/actions/workflow/status/BURG3R5/firefox-bookmarks/integration_tests.yml?branch=main&style=flat-square) ![PyPI](https://img.shields.io/badge/pypi-1.1.0.post1-blue?style=flat-square) ![License - AGPL v3 or later](https://img.shields.io/pypi/l/firefox-bookmarks?style=flat-square) ![Code style: YAPF](https://img.shields.io/badge/code%20style-yapf-blue?style=flat-square) ![Code style: isort](https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat-square)\n\n# firefox-bookmarks\n\nManage your Firefox bookmarks with ease\n\n## installation\n\n```shell\npip install firefox-bookmarks\n```\n\n## usage\n\nImport and initialize:\n\n```python\nfrom firefox_bookmarks import *\n\nfb = FirefoxBookmarks()\n\n# You can pass a `ProfileCriterion` to choose from multiple profiles\nfb.connect(criterion=ProfileCriterion.LARGEST)\n```\n\nQuery as you would in peewee (or Django or SQLAlchemy)\n\n```python\ngithub_bookmarks = fb.bookmarks(\n where=Bookmark.url.contains(\"https://github.com\"),\n)\n\nfor bookmark in github_bookmarks:\n print(f\"Title: {bookmark.title}\\nURL: {bookmark.url}\\n\")\n```\n\n## examples\n\nSee [the examples directory](https://github.com/BURG3R5/firefox-bookmarks/tree/main/examples)\n\n## contributing\n\nWant to fix a bug, add a feature, or improve documentation? Awesome! Read up on our [guidelines for contributing](https://github.com/BURG3R5/firefox-bookmarks/blob/main/.github/CONTRIBUTING.md) and then visit our [/contribute page](https://github.com/BURG3R5/firefox-bookmarks/contribute) to find good first issues! Pull requests are always welcome!\n\n## license\n\nCopyright (C) 2023 Aditya Rajput & other contributors\n\nThis software is licensed under the **Affero GPL v3**. You should have received [a copy](https://github.com/BURG3R5/firefox-bookmarks/blob/main/LICENSE) of the Affero GPL v3 along with this program. If not, you can visit the original [here](https://www.gnu.org/licenses/agpl-3.0.html#license-text).\n",
"bugtrack_url": null,
"license": "AGPL-3.0-or-later",
"summary": "Manage your Firefox bookmarks with ease",
"version": "1.1.0.post1",
"project_urls": {
"Changelog": "https://github.com/BURG3R5/firefox-bookmarks/blob/main/CHANGELOG.md",
"Documentation": "https://github.com/BURG3R5/firefox-bookmarks",
"Homepage": "https://github.com/BURG3R5/firefox-bookmarks",
"Repository": "https://github.com/BURG3R5/firefox-bookmarks"
},
"split_keywords": [
"firefox",
"bookmarks",
"browser",
"util"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "bbe1e600f8cdd289fd52d1585ec336a501aa480a1377478f021ec9f9c57779aa",
"md5": "7ed0c3ec92a125e20bfe154d649a0346",
"sha256": "2e5861e822c8d0d9a84027bd1af575c7d6c42ac25fa691a44d3616eee56a8dab"
},
"downloads": -1,
"filename": "firefox_bookmarks-1.1.0.post1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7ed0c3ec92a125e20bfe154d649a0346",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10,<4.0",
"size": 24172,
"upload_time": "2023-08-30T06:24:36",
"upload_time_iso_8601": "2023-08-30T06:24:36.197819Z",
"url": "https://files.pythonhosted.org/packages/bb/e1/e600f8cdd289fd52d1585ec336a501aa480a1377478f021ec9f9c57779aa/firefox_bookmarks-1.1.0.post1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "01c56e4a68f7188213e6c78b5920df1f73ef4b4d525b5d7637888873f5c09d9e",
"md5": "370a5eaef43d6c0d84ec0195e83c9b71",
"sha256": "cb5dace029c1fe34cc242178f54519ad277584012795d3a1a1fb6469c43a4e68"
},
"downloads": -1,
"filename": "firefox_bookmarks-1.1.0.post1.tar.gz",
"has_sig": false,
"md5_digest": "370a5eaef43d6c0d84ec0195e83c9b71",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10,<4.0",
"size": 21415,
"upload_time": "2023-08-30T06:24:37",
"upload_time_iso_8601": "2023-08-30T06:24:37.595213Z",
"url": "https://files.pythonhosted.org/packages/01/c5/6e4a68f7188213e6c78b5920df1f73ef4b4d525b5d7637888873f5c09d9e/firefox_bookmarks-1.1.0.post1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-30 06:24:37",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "BURG3R5",
"github_project": "firefox-bookmarks",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "firefox-bookmarks"
}