Skip to content

Latest commit

 

History

History
108 lines (78 loc) · 2.45 KB

README.md

File metadata and controls

108 lines (78 loc) · 2.45 KB

accessors

Build Status License Dub Version codecov

accessors module allows to generate getters and setters automatically.

Deprecation warning: accessors has been succeeded by boilerplate.

Usage

import accessors;

class WithAccessors
{
    @Read @Write
    private int num_;

    mixin(GenerateFieldAccessors);
}

@Read and @Write generate the following two methods:

public final @property auto num() inout @nogc nothrow pure @safe
{
    return this.num_;
}

public final @property void num(int num) @nogc nothrow pure @safe
{
    this.num_ = num;
}

The accessors names are derived from the appropriate member variables by removing an underscore from the beginning or the end of the variable name.

Available user defined attributes

  • @Read
  • @ConstRead
  • @Write

As you can see there are multiple attributes that can be used to generate getters and only one for the setters. The getters differ by the return type. @Read returns an inout value, @ConstRead - a const value.

Accessor visibility

Visibility of the generated accessors is by default public, but it can be changed. In order to achieve this, you have to pass public, protected, private or package as argument to the attribute:

import accessors;

class WithAccessors
{
    @Read("public") @Write("protected")
    private int num_;

    mixin(GenerateFieldAccessors);
}

Example

import accessors;
import std.stdio;

class Person
{
    @Read @Write
    private uint age_;

    @ConstRead
    private string name_;

    this(in string name, in uint age = 0)
    {
        this.name_ = name;
        this.age_ = age;
    }

    mixin(GenerateFieldAccessors);
}

void main()
{
    auto person = new Person("Saul Kripke");

    person.age = 57;

    writeln(person.name, ": ", person.age);
}

Bugs

If you experience compile-time problems, open an issue with the information about the type of the member variable fails.