describe-d 0.2.0

describe.d

describe.d is a library that provides a structured interface to introspect DLang source code.

Usage

Introspection

The library provides the describe template which returns a structure with the introspection result:

import described;

/// Introspecting modules
assert(describe!(std.array).name == "module array");
assert(describe!(std.array).fullyQualifiedName == "std.array");
assert(describe!(std.array).functions.length == 1);
assert(describe!(std.array).templates.length == 31);

/// Introspecting aggregates
struct MyStruct {
  void callMe() {
  }
}

assert(describe!MyStruct.name == "MyStruct");
assert(describe!MyStruct.methods.length == 1);
assert(describe!MyStruct.methods[0].name == "callMe");
assert(describe!MyStruct.methods[0].returns.name.should.equal("void"));

/// Introspecting methods
assert(describe!(MyStruct.callMe).name == "MyStruct");
assert(describe!(MyStruct.callMe).returns.name.should.equal("void"));

Given an introspected Type like a class or struct, it can be converted to the D type using fromType:

  alias T = fromType!(describe!RandomClass.type);

  static assert(is(T == RandomClass));

Filtering

The library provides the where structure which allows you to filter the describe result.

by attribute name

  struct Test {
    @("test") void foo() { }
    @("other") void other() { }
  }

  /// Check that there is a method with the string attribute "test"
  static assert(describe!Test.methods.where.attribute!`"test"`.exists);

  /// Iterate over the methods with the "test" attribute
  static foreach(method; describe!Test.methods.where.attribute!`"test"`) {
    ...
  }

by type

The types can be queried by name or by the fullyQualifiedName

  enum moduleDescription = describe!(my.module);

  static assert(moduleDescription.aggregates.where.typeIs!"TestStructure".exists);
  static assert(moduleDescription.aggregates.where.typeIs!"my.module.TestStructure".exists);

  static assert(moduleDescription.aggregates.where.typeIsAnyOf!("TestStructure", "TestClass").exists);
  static assert(moduleDescription.aggregates.where.typeIsAnyOf!("my.module.TestStructure", "my.module.TestClass").exists);

  /// negations
  static assert(moduleDescription.aggregates.where.typeIsNot!"TestStructure".exists);
  static assert(moduleDescription.aggregates.where.typeIsNot!"my.module.TestStructure".exists);

  static assert(moduleDescription.aggregates.where.typeIsNotAnyOf!("TestStructure", "TestClass").exists);
  static assert(moduleDescription.aggregates.where.typeIsNotAnyOf!("my.module.TestStructure", "my.module.TestClass").exists);

License

This project is licensed under the MIT license - see the LICENSE file for details.