A Simple and clean way to explore Bookmarks Data.
Project description
Bookmark Parser - Explore Your Browser Bookmark Data ๐
COC ยท Community ยท Docs (Below)
๐ซ Introduction :
The main goal of BookmarkParser Module is to allow people to easily explore and play with their bookmarks' data in an easy-structured way with a variety of functionality.
โซ Browsers tested on:
Google Chrome
Brave
Installing BookmarkParser :
via pip (recommended) :
pip install BookmarkParser
or
via pip + github :
pip install git+https://github.com/AidenEllis/BookmarkParser.git
๐ค Docs:
Let's import the moduele and show you along :
from BookmarkParser import Bookmarks
bookmarks = Bookmarks()
๐ฅจ Bookmarks class:
- Arguments:
filepath: str
: file path of the Bookmarks file. Usually used for manually assign a file. Google it with your specific browser brand.
browser: str
: Automatically finding your browser file path. Currently, only works with'Chrome', 'Brave'
just pass in either of these browser name and it'll find theBookmarks
file.
Setting up out Class
from BookmarkParser import Bookmarks
bookmarks = Bookmarks(browser='Chrome').setup() # Automatic Path setup
# or
bookmarks = Bookmarks(filepath="C://File/to/somewhere/Bookmarks").setup() # Manual File setup
Let's actually use it
from BookmarkParser import Bookmarks
bookmarks = Bookmarks(filepath="C://File/to/somewhere/Bookmarks").setup() # Manual File insert
a = bookmarks.bookmark_bar # --> List
b = bookmarks.synced # --> List
c = bookmarks.other # --> List
# These are the 3 types of ROOT Bookamarks Folder
you can iterate through it
from BookmarkParser import Bookmarks
bookmarks = Bookmarks(filepath="C://File/to/somewhere/Bookmarks").setup() # Manual File insert
for bookmark in bookmarks.bookmark_bar:
print(bookmark) # Returns a list of Bookmarked items (urls and folders)
BookmarkFolder
Attribute & Attributes Functions :
name
: Name of the folder or the link
path
: Path to the bookmarked item e.g. "Bookmarks/bookmarks_tab/title"
url
: Returns url of the bookmarked item (different urls for folders and links)
datetime
: Returns the date-time of when it was added
children
(only available for folders) (returns urls and child folders)
is_folder
: Cheks the if the bookmark item is folder or not.
url
: Gives back the browser url of the bookmark item.
-
urls
: returns all the urls (objects) within the current folder๐ Self (Parent) โโโ ๐ Child 1 โ โโโ ๐ Link 1 โ โ โโโ ๐ Link 2 โ โ โโโ ๐ Link 3 โ โโโ ๐ Link 4 โ โโโ ๐ Link 5 โ โโโ ๐ Link 6 โ
num_urls
: Returns the total amount of urls within the current folder. (this does not contains urls from nested folders)
-
nestedUrls
: returns all the urls within the current folder and also from the nested folders.๐ Self (Parent) โโโ ๐ Child 1 โ โโโ ๐ Link 1 โ โ โโโ ๐ Link 2 โ โ โโโ ๐ Link 3 โ โโโ ๐ Link 4 โ โโโ ๐ Link 5 โ โโโ ๐ Link 6 โ
-
folders
: Returns all the child folders (This does not contain any nested folders)๐ Self (Parent) โโโ ๐ Child 1 โ โ โโโ ๐ Child 1's child (1) โ โโโ ๐ Child 2 โ โ โโโ ๐ Child 2's child (1) โ โ โโโ ๐ Child 2's child (2) โ โโโ
num_folders
: Returns the total number of only child folders.
-
subfolders
: Returns all the child and its nested subfolders within the chosen directory.๐ Self (Parent) โโโ ๐ Child 1 โ โ โโโ ๐ Child 1's child (1) โ โโโ ๐ Child 2 โ โ โโโ ๐ Child 2's child (1) โ โ โโโ ๐ Child 2's child (2) โ โ โโโ ๐ Child 2's child (2)'s child(1) โ โโโ
num_subfolders
: Returns the total number of subfolders (including child and nested folders)
Here, have a cookie (ใฅ๏ฝก โโฟโฟโ๏ฝก) ใฅ๐ช
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for BookmarkParser-1.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d800ad7752d56e14a5ab9fc971be99845614e7508cab311c798d5e2ee4dce3e2 |
|
MD5 | 9a7c38f59d0fb93a4003bedb129cc6ae |
|
BLAKE2b-256 | ec6e6b3fc3f90d5f5e1a5a9bcf38d99a72c99207c3991fdb9dd45a9a57fb6ef7 |