describe-d 0.4.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!"attributes[i].name".equal(`"test"`).exists);

  /// Iterate over the methods with the "test" attribute
  static foreach(method; describe!Test.methods.where!"attributes[i].name".equal(`"test"`)) {
    ...
  }

by type

The types can be queried by name or by the fullyQualifiedName

  enum moduleDescription = describe!(my.module);

  enum containsAnyTestStructure = moduleDescription.aggregates
    .where!"type.name"
    .equal("TestStructure")
    .exists;

  enum containsMyTestStructure = moduleDescription.aggregates
    .where!"type.fullyQualifiedName"
    .equal("my.module.TestStructure")
    .exists;

  enum testAggregates = moduleDescription.aggregates
    .where!"type.name"
    .isAnyOf(["TestStructure", "TestClass"]);

negation

You can use the not method to negate any filter:

  enum moduleDescription = describe!(my.module);

  enum releaseStructures = moduleDescription.aggregates
    .where!"type.name"
    .not.equal("TestStructure");

License

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