suchbar

Crates.iosuchbar
lib.rssuchbar
version1.0.0
sourcesrc
created_at2023-04-27 13:55:22.292869
updated_at2023-12-07 20:29:50.71266
descriptionsuchbar - enduser-learnable-language for database queries.
homepage
repositoryhttps://github.com/NORICS-net/suchbar
max_upload_size
id850398
size47,180
Micha Glave (migmedia)

documentation

README

SuchBar - Enduser-learnable language for database queries.

Crates.io MIT licensed Documentation

A query language that can be learned by normal users, similar to an internet search engine.

A query like "plz=26440-26452 OR (Eisen AND sn!=Hammer*)" could generate such a SQL:

SELECT 
    pa.shortname, pa.description, pa.taxnumber, pb.longname, pb.postcode, pb.city, pb.street 
FROM partner_partner pa, partner_branchstore pb 
WHERE 
  pa.id = pb.cmrpartner AND 
  (
    ( pb.postcode>='26440' AND 
      pb.postcode<='26452' 
    ) OR
    ( pa.shortname LIKE '%Eisen%' OR 
      pa.description LIKE '%Eisen%' OR
      pa.taxnumber LIKE '%Eisen%' OR
      pb.city LIKE '%Eisen%' OR
      pb.street LIKE '%Eisen%' 
    ) AND 
    NOT pa.shortname LIKE 'Hammer%' 
 )
LIMIT 20;
Boolean Operator Alternative Symbol Description
AND && Requires both terms on either side of the Boolean operator to be present for a match.
NOT ! Requires that the following term not be present.
OR || Requires that either term (or both terms) be present for a match.

Usage:

Register the search-fields.

The fields available for searching are registered: DbField::new("db-fieldname", db-type, "permission", &["name", "alternative_name", "abbr"]),

Beispiel

const SUCHBAR: Suchbar = Suchbar::new(&[
    DbField::new("pa.shortname", TEXT, "STD", &["sname", "sn"]),
    DbField::new("pa.description", TEXT, "STD", &["desc", "d"]),
    DbField::new("pa.taxnumber", VARCHAR(15), "STD", &["ust_id", "tax", "ustid"]),
    DbField::new("pb.city", VARCHAR(35), "STD", &["city"]),
    DbField::new("pb.street", VARCHAR(55), "STD", &["street", "st"]),
    DbField::new("pb.postcode", VARCHAR(5), "STD", &["plz", "zip"]),
]);

fn main() {
    let suche = "plz=26440-26452 OR (Eisen AND sn!=Hammer*)";
    match SUCHBAR.exec(suche) {
        Err(c) => println!("\n{c}"),
        Ok(sr) => {
            let query = format ! (
            "SELECT pa.shortname, pa.description, pa.taxnumber, \
                    pb.longname, pb.postcode AS INTEGER, pb.city, pb.street \
                    FROM partner_partner pa, partner_branchstore pb \
                    WHERE pa.id = pb.cmrpartner{} LIMIT 20",
            sr.to_sql("AND")
            );
        }
    }
}
Commit count: 4

cargo fmt