web_query 0.4.0

A Flutter package that using simple syntax to parse html and json data.

0.4.0

Breaking Changes

• Removed old protocol support: The newProtocol parameter has been removed from QueryString and related functions. The library now exclusively uses the new protocol syntax.
• Removed legacy files: Deleted selector.dart, expression.dart, separator.dart, and web_query.dart (~20KB code reduction)

New Features

• UI Components (exported via package:web_query/ui.dart):

  • JsonTreeView: Interactive collapsible JSON tree viewer with syntax highlighting
  • HtmlTreeView: Interactive collapsible HTML tree viewer
  • DataQueryWidget: Complete data reader widget with HTML/JSON views and query filtering
  • filterHtmlOnly() and filterHtml(): Utility functions with optional unwanted selectors

• Modular Architecture:

  • Extracted UI utilities into html_utils.dart, html_tree_view.dart, json_tree_view.dart
  • Better code organization and maintainability
  • Cleaner separation of concerns

Improvements

• Performance: Tree views use lazy loading and show first 50 items with "Show more" functionality
• Code Quality: Removed ~20KB of legacy code
• API Simplification: Single protocol, cleaner API surface
• Testing: Added PageData.auto tests for automatic content type detection

Migration Guide

If you were using the old protocol:

// Before (0.3.0 and earlier)
QueryString(query, newProtocol: false)
webValue(node, selectors, newProtocol: false)

// After (0.4.0+)
QueryString(query)

The old Selectors class and related APIs have been removed. Use QueryString with the new protocol syntax instead.

0.3.0

What's New

• URL Scheme: Added url: scheme for querying and modifying URLs

  • Query URL components: url:host, url:path, url:query, url:fragment, etc.
  • Query parameters: url:queryParameters/key
  • Modify URLs: url:?page=2, url:?_host=new.com
  • Supports all transforms including regexp

• Simplified Regexp Syntax: Added ?regexp= as shorthand for ?transform=regexp:

  • ?regexp=/pattern/ - Pattern-only mode
  • ?regexp=/pattern/replacement/ - Replace mode
  • Multiple regexp params are chained: ?regexp=/a/b/&regexp=/c/d/

• Multiline Regexp Support:

  • multiLine: true enabled by default for all regexp operations
  • \ALL keyword matches entire content (expands to ^[\s\S]*$)
  • Better handling of newlines in patterns

• DataQueryWidget UI Component:

  • Interactive HTML tree view with collapsible nodes
  • Real-time QueryString filtering
  • Switch between HTML and JSON views
  • Visual query results panel
  • Example project demonstrating usage

• Examples:

  // URL queries
  'url:host'                    // Get hostname
  'url:?page=2'                 // Modify query param
  'url:?regexp=/https/http/'    // Transform URL
    
  // Simplified regexp
  'h1@text?regexp=/Title/Header/'
  '*li@text?regexp=/\ALL/Replaced/'
    
  // Multiline matching
  'div@text?regexp=/^Line 2/Matched/'  // Match start of line
  'div@text?regexp=/\ALL/Replaced/'    // Match all content
  

0.2.8

What's New

• Filter Transform: Added powerful filter parameter to filter query results

  • Include filters: filter=word matches items containing "word"
  • Exclude filters: filter=!word excludes items containing "word"
  • Combined filters: filter=a !b includes "a" AND excludes "b"
  • Escaped characters: Support for \ (space), \; (semicolon), \& (ampersand)

• Enhanced Parameter Parsing:

  • Smart handling of & in transform, filter, and update parameters
  • Intelligent semicolon splitting for regexp transforms (preserves ; within /pattern/replacement/)
  • Proper escaping/unescaping for special characters

• Examples:

  // Filter by inclusion
  '*li/@text?filter=Apple'
    
  // Filter by exclusion
  '*li/@text?filter=!Banana'
    
  // Combined filters
  '*li/@text?filter=fruit !bad'
    
  // With escaped characters
  '*li/@text?filter=Date\ Fruit'  // Matches "Date Fruit"
  '*li/@text?filter=\&'            // Matches items with "&"
    
  // Mixed with transforms
  '*li/@text?transform=regexp:/Fig/Big/&filter=&'
  

0.2.7

• adding filter transform to filter result.

0.2.6

• make / before @ optional
• fix transform regexp cannot have & bug.

0.2.5

• adding *+ and *- to navigate siblings.

0.2.0

• breaking change:
  • after || part mean optional (previous version is required)
  • , default is required. (previous version is optional)
  • adding ++ & mean required.
  • adding | mean optional.
  • remove required?= parameter
  • remove !suffix in json path part.
• adding ++ and || separator to query statement. (part after ++ mean required)
• adding | and , to separate multi path (part after | mean optional , after , mean required)
• adding | to attribute to support multi attributes (part after | mean optional )

0.1.1

• Fixed bug with query paramters include ? and chinese.

0.1.0

• Added new QueryString API with features:
  • Simplified scheme syntax (json: and html: prefixes)
  • HTML selectors with * prefixes
  • Default HTML scheme
  • Class name checking with @.class
  • Wildcard class name matching
  • Transform operations
  • Query chaining
  • Required/optional queries
  • RegExp transforms
  • Better error handling

0.0.5

• Support for escape characters in selectors
• Fixed handling of + in query strings

0.0.4

• Initial version with basic web querying functionality
• HTML element selection
• JSON path navigation
• Basic attribute access

0.0.1

• initial release.