go-parser 0.1.5

The parser of the Goscript project.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

// Copyright 2022 The Goscript Authors. All rights reserved.
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.

//! This crate is part of the Goscript project. Please refer to <https://goscript.dev> for more information.
//!
//! It's a port of the the parser from the Go standard library <https://github.com/golang/go/tree/release-branch.go1.12/src/go/parser>
//!  
//! # Usage:
//! ```
//! fn parse_file() {
//!     let source = "package main ...";
//!     let mut fs = go_parser::FileSet::new();
//!     let o = &mut go_parser::AstObjects::new();
//!     let el = &mut go_parser::ErrorList::new();
//!     let (p, _) = go_parser::parse_file(o, &mut fs, el, "./main.go", source, false);
//!     print!("{}", p.get_errors());
//! }
//! ```
//!
//! # Feature
//! - `btree_map`: Make it use BTreeMap instead of HashMap
//!

mod errors;
mod map;
mod objects;
mod parser;
mod position;
mod scanner;
mod token;

pub mod ast;
pub mod scope;
pub mod visitor;

pub use errors::*;
pub use map::{Map, MapIter};
pub use objects::*;
pub use parser::Parser;
pub use position::*;
pub use token::*;

pub fn parse_file<'a>(
    o: &'a mut AstObjects,
    fs: &'a mut FileSet,
    el: &'a ErrorList,
    name: &str,
    src: &'a str,
    trace: bool,
) -> (parser::Parser<'a>, Option<ast::File>) {
    let f = fs.add_file(name.to_string(), None, src.chars().count());
    let mut p = parser::Parser::new(o, f, el, src, trace);
    let file = p.parse_file();
    (p, file)
}