beautiful_soup_dart 0.0.1

Dart native package inspired by Beautiful Soup Python library. Provides easy ways of navigating, searching, and modifying the HTML tree.

Beautiful Soup

Dart native package inspired by Beautiful Soup Python library. Provides easy ways of navigating, searching, and modifying the HTML tree.

Usage

A simple usage example:

import 'package:beautiful_soup_dart/beautiful_soup.dart';

/// 1. parse a document String
BeautifulSoup bs = BeautifulSoup(html_doc_string);
// use BeautifulSoup.fragment(html_doc_string) if you parse a part of html

/// 2. navigate quickly to any element
bs.body!.a!; // get String representation of this element, same as outerHtml
bs.find('p', attrs: {'class': 'story'}); // finds first element with html tag "p" and which has "class" attribute with value "story"
bs.findAll('a', attrs: {'class': true}); // finds all elements with html tag "a" and which have defined "class" attribute with whatever value

Bs4Element bs4 = bs.body!.p!; // quickly with tags

/// 3. perform any other actions for the navigated element
bs4.name; // get tag name
bs4.string; // get text
bs4.toString(); // get String representation of this element, same as outerHtml
bs4.innerHtml; // get html elements inside the element
bs4.className; // get class attribute value
bs4['class']; // get class attribute value
bs4['class'] = 'board'; // change class attribute value to 'board'
bs4.children; // get all element's children elements
bs4.replaceWith(otherBs4Element); // replace with other element
... and many more

Check test folder for more examples.

Table of Contents

The unlinked titles are not yet implemented.

• Navigating the tree
  • Going down
    • Navigating using tag names
    • .contents and .children
    • .descendants
    • .string
    • .strings and .stripped_strings
  • Going up
    • .parent
    • .parents
  • Going sideways
    • .nextSibling and .previousSibling
    • .nextSiblings and .previousSiblings
  • Going back and forth
    • .nextElement and .previousElement
    • .nextElements and .previousElements
• Searching the tree
  • findFirstAny() - returns the top most (first) element of the parse tree, of any tag type
  • findAll()
  • find()
  • findParents() and findParent()
  • findNextSiblings() and findNextSibling()
  • findPreviousSiblings() and findPreviousSibling()
  • findAllNext() and findNext()
  • findAllPrevious() and findPrevious()
• Modifying the tree
  • Changing tag names and attributes
  • Modifying .string
  • append()
  • extend()
  • newTag()
  • insert()
  • insertBefore() and insertAfter()
  • clear()
  • extract()
  • decompose()
  • replace_with()
  • wrap()
  • unwrap()
  • smooth()
• Output
  • prettify()
  • escape()
  • unescape()
  • getText()

Features and bugs

Please file feature requests and bugs at the issue tracker or feel free to raise a PR.