Crate awint_macro_internals

This crate exists because of limitations with proc-macro crates. We need to be able to test errors returned from the code generation function while also being able to test the macros themselves. This might also be reused by people who have new storage types.

This is also available as a hidden reexport from the main awint crate if the “std” feature is enabled

Re-exports

• pub use awint_ext;
• pub use awint_ext::awint_core;
• pub use triple_arena;

Structs

• Ast
• CCMacroError
• CWidth
  For concatenation widths
• CodeGen
  Note: the type must be unambiguous for the construction functions
• Component
• Concatenation
• FnNames
• Lower
• Names
  Prefixes used for codegen names and functions. Most of these should be prefixed with two underscores and the crate name to prevent collisions.
• PBind
• PCWidth
• PText
• PVal
• PWidth
• Usb
  Usize and/or String Bound. If s.is_empty(), then there is no arbitrary string in the bound and the base value is 0. x is added on to the value.
• Usbr

Enums

• Bind
• ComponentType
• Delimiter
• FillerAlign
• Text
• Value
• Width
  Bitwidth as described by a single value or one value minus another

Constants

• AWINT_FN_NAMES
• AWINT_NAMES
  Default names for awint

Functions

• awi_construction_fn
• awi_s
• awint_awi_lit_construction_fn
• awint_bits_const_wrapper
• awint_bits_lit_construction_fn
• awint_extawi_lit_construction_fn
• awint_inlawi_lit_construction_fn
• awint_macro_awi
• awint_macro_bits
• awint_macro_cc
• awint_macro_extawi
• awint_macro_inlawi
• awint_must_use
• awint_static_construction_fn
• awint_unreachable_construction_fn
• cc_construction_fn
• cc_macro
  Input parsing and code generation function for corresponding concatenations of components macros.
• cc_macro_code_gen
  Lowering of the parsed structs into Rust code.
• chars_to_string
• color_text
  Wrap s in ANSI delimiters for terminal colors. {90..=97} => {grey, red, green, yellow, blue, purple, cyan, white}
• error_and_help
• extawi_construction_fn
• extawi_s
• i128_to_nonzerousize
• i128_to_usize
• i128_try_parse
  Tries parsing as hexadecimal, octal, binary, and decimal
• identity_const_wrapper
• inlawi_construction_fn
• inlawi_s
• parse_range
  Tries to parse raw input as a range. Looks for the existence of top level “..” or “..=” punctuation. If allow_single_bit_range is set, will return a single bit range if “..” or “..=” does not exist.
• parse_usb
  In ranges we commonly see stuff like (x + y) or (x - y) with one of them being a constant we can parse, which passes upward the Usb and Usbr chain to get calculated into a static width.
• stage1
  Looks for the existence of a top level “[]” delimited group and uses the last one as a bit range.
• stage2
• stage3
• stage4
• stage5
• token_stream_to_ast
  Parses input TokenStream into “raw” concatenations of components in Vec<char> strings
• unstable_native_bits
• unstable_native_inlawi
  Returns architecture-independent Rust code that returns an InlAwi preset with the value of bits.
• unstable_native_inlawi_ty
  Returns architecture-independent Rust code that returns an InlAwi type with bitwidth w.
• usize_to_i128