Skip to main content

Crate use_php_docblock

Crate use_php_docblock 

Source
Expand description

§use-php-docblock

PHPDoc block metadata primitives for RustUse.

§Experimental

use-php-docblock is experimental while use-php remains below 0.3.0.

§Example

use use_php_docblock::{Docblock, DocblockTag, DocblockTagKind, TagName};

let block = Docblock::new("/**\n * Create a user.\n *\n * Stores metadata only.\n */")?;
let tag = DocblockTag::new(TagName::new("return")?).with_kind(DocblockTagKind::Return);

assert_eq!(block.summary(), "Create a user.");
assert_eq!(tag.kind(), Some(DocblockTagKind::Return));

§Scope

  • PHPDoc summary/body metadata, common tag labels, tag names, and type-string wrappers.

§Non-goals

  • Complete PHPDoc parsing, type-expression parsing, inheritance, or analyzer-specific dialects.

§License

Licensed under either Apache-2.0 or MIT.

Structs§

Docblock
PHPDoc block summary/body metadata.
DocblockBody
DocblockSummary
DocblockTag
Lightweight PHPDoc tag metadata.
DocblockTypeString
TagName

Enums§

DocblockTagKind
Common PHPDoc tag kind metadata.
PhpDocblockError
Error returned when PHPDoc metadata is invalid.

Functions§

clean_docblock_text
split_docblock_summary_body