SearchQueryParser

SearchQueryParser

SearchQueryParser เป็นตัวแยกวิเคราะห์คำค้นหา (และเครื่องหมาย) ของเครื่องมือค้นหาแบบ Google ที่เรียบง่ายสำหรับ Swift ใช้สตริงการค้นหาและสร้างแผนผังไวยากรณ์นามธรรม แพ็คเกจนี้ใช้ได้กับ Apple Search Kit เพื่อเน้นผลลัพธ์ที่พบ

คุณสมบัติ

• ไร้สแกนเนอร์ (lexerless)
• รองรับไวยากรณ์แบบบูลีน (AND ("&"), OR ("|"), NOT ("!") ตัวดำเนินการเชิงตรรกะ)
• สัญลักษณ์แทนคำนำหน้าและคำต่อท้าย ("*")
• การค้นหาวลี
• ทนต่อข้อผิดพลาดทางไวยากรณ์ของคำค้นหา
• มีสิ่งอำนวยความสะดวกเพื่อค้นหาคำค้นหาภายในข้อความที่ป้อน

ไวยากรณ์คำค้นหา

แบบฟอร์ม Backus–Naur (BNF):

 Query = Sweeping-Mute-And-Term, ⧚’?, EOF ;
Sweeping-Mute-And-Term = Mute-And-Term, { ⧚’?, Mute-And-Term }* ;
Mute-And-Term = Or-Term, Or-Term* ;
Or-Term = And-Term, {⧚?, (‘|’ | “OR”), And-Term }* ;
And-Term = Not-Term, {⧚?, (‘&’ | “AND”), Not-Term }* ;
Not-Term = ⧚?, (’!’ | “NOT”), Not-Term | Primary-Term ;
Primary-Term = ⧚?, ’(‘ ⧚?, Mute-And-Term, ⧚? ‘)’ |
               ⧚?, “‘“ ⧚?, Phrase, ⧚? “‘“ |
               ⧚?, Prefix-Wildcard-Search-Term |
               ⧚?, Suffix-Wildcard-Search-Term |
               ⧚?, Search-Term ;
Phrase = Search-Term, { ⧚, Search-Term }* ;
Prefix-Wildcard-Search-Term = ‘*’, Search-Term ;
Suffix-Wildcard-Search-Term = Search-Term, ‘*’ ;
Search-Term = Letter | Letter, Search-Term ;
Letter = Alpha | Digit | ‘_’ ;
⧚’ = ⧚-(“*” | “!” | “&” | “(“ | “)” | “””)
⧚ = { ? any-character ?-Letter }+ ;
Alpha = ? alpha-character ? ;
Digit = "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" ;

กรณีการใช้งาน

พิมพ์แผนผังไวยากรณ์นามธรรมของคำค้นหา

import SearchQueryParser

func printQueryAST ( _ query : String ) {
    guard let parser = SearchQueryParser ( query ) , let ast = parser . astRoot
    else {
        print ( " Couldn't parse " )
        return
    }
    print ( " AST: ( ast ) " )
}

printQueryAST ( " foo bar " )

เน้นการจับคู่คำค้นหา

import SearchQueryParser

func highlightSearchQueryMatches ( query : String , in text : NSMutableAttributedString ) {
    guard let queryTerms = SearchQueryParser ( query )
    else {
        print ( " No matches found " )
        return
    }
    let tokensProvider = SearchTextScanner ( text . string )
    guard let applicator = SearchQueryApplicator ( searchQueryTerms : queryTerms ,
                                                 textTokens : tokensProvider )
    else {
        print ( " Nothing was marked " )
        return
    }
    applicator . markedRanges . forEach { range in
        text . addAttribute ( . backgroundColor , value : NSColor . yellow , range : range )
    }
}
let text = NSMutableAttributedString ( string : " Lorem ipsum ... " )
highlightSearchQueryMatches ( query : " foo & bar " , in : text ) 

การติดตั้ง

Swift Package เป็นการพึ่งพาใน Xcode 11+

1. ไปที่ "ไฟล์" -> "แพ็คเกจ Swift" -> "เพิ่มการพึ่งพาแพ็คเกจ"
2. วาง URL ที่เก็บ Search Query Parser ลงในช่องค้นหา:

https://github.com/SerhiyButz/SearchQueryParser.git

3. คลิก "ถัดไป"

4. ตรวจสอบให้แน่ใจว่าฟิลด์ "กฎ" ถูกตั้งค่าเป็นดังนี้: "เวอร์ชัน: สูงสุดถัดไป: 1.3.0"

5. คลิก "ถัดไป" เพื่อเสร็จสิ้น

หากต้องการข้อมูลเพิ่มเติม โปรดดูที่นี่

โกโก้พอดส์

เพิ่มสิ่งต่อไปนี้ใน Podfile ของคุณ:

 platform :osx , '10.12'

target 'YOUR-TARGET' do
  use_frameworks!
  pod 'SearchQueryParser' , :git => 'https://github.com/SerhiyButz/SearchQueryParser.git'
end

จากนั้นรัน pod install

ใบอนุญาต

โครงการนี้ได้รับอนุญาตภายใต้ใบอนุญาต MIT