typed_soup 1.0.1 copy "typed_soup: ^1.0.1" to clipboard
typed_soup: ^1.0.1 copied to clipboard

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

example/main.dart

// ignore_for_file: constant_identifier_names

import 'package:typed_soup/typed_soup.dart';

const html_doc = """
<html>
   <head>
      <title>The Dormouse's story</title>
   </head>
   <body>
      <p class="title"><b>The Dormouse's story</b></p>
      <p class="story">Once upon a time there were three little sisters; and their names were
         <a href="http://example.com/elsie" class="sister" id="link1">Elsie</a>,
         <a href="http://example.com/lacie" class="sister" id="link2">Lacie</a> and
         <a class="sister" id="link3">Tillie</a>;
         and they lived at the bottom of a well.
         <a href="unknown">Some name</a>
      </p>
      <p class="story">...</p>
   </body>
</html>
""";

void main() {
  // 1. parse a document
  TypedSoup bs = TypedSoup(
    html_doc,
  ); // use TypedSoup.fragment(html_doc_string) if you parse a part of html

  // 2. navigate quickly to any element
  print(
    bs.body!.a!.toString(),
  ); // get String representation of this element, same as outerHtml, finds: "<a href="http://example.com/elsie" class="sister" id="link1">Elsie</a>"
  bs.find(
    'p',
    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
  bs.find('*', id: 'link1'); // find by id
  bs.find(
    '*',
    regex: r'^b',
  ); // find any element which tag starts with "b", for example: body, b, ...
  bs.find(
    'p',
    string: r'^Article #\d*',
  ); // find "p" element which text starts with "Article #[number]"
  bs.find(
    'a',
    attrs: {'href': 'http://example.com/elsie'},
  ); // finds by "href" attribute

  // 3. perform any other actions for the navigated element
  TsElement bs4 = bs
      .body!
      .p!; // quickly with tags, finds and navigates to: "<p class="title"><b>The Dormouse's story</b></p>"
  bs4.name; // get tag name, finds: "p"
  bs4.string; // get text, finds: "The Dormouse's story";
  bs4.innerHtml; // get html elements inside the element, finds: "<b>The Dormouse's story</b>"
  bs4.className; // get class attribute value, finds: "title"
  bs4['id']; // get class attribute value, finds: null
  bs4['class'] =
      'board'; // change class attribute value from 'title' to 'board'

  TsElement bs4Alt = bs.find(
    'p',
    attrs: {'class': 'story'},
  )!; // with query func you can specify attributes
  bs4.replaceWith(bs4Alt); // replace with other element
  bs4Alt
      .children; // get all element's children elements, finds: list with four "a" elements
}
0
likes
0
points
193
downloads

Publisher

verified publishermrcrbrth.my.id

Weekly Downloads

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

Repository (GitHub)
View/report issues

License

unknown (license)

Dependencies

html

More

Packages that depend on typed_soup