alias.md

Type aliases allow one type to be referenced and renamed as another, which can be used to create a localised reference to a foreign type.

Example

The Packtype definition can either use a Python dataclass style or the Packtype custom grammar:

=== "Python (.py)"

```python linenums="1"
import packtype
from packtype import Alias, Scalar

@packtype.package()
class PackageA:
    TypeA : Scalar[5]

@packtype.package()
class PackageB:
    TypeB : Alias[PackageA.TypeA]
```

=== "Packtype (.pt)"

```sv title="package_a.pt" linenums="1"
package package_a {
    type_a_t : Scalar[5]
}
```

```sv title="package_b.pt" linenums="1"
package package_b {
    import package_a::type_a_t
    type_b_t : type_a_t
}
```

As rendered to SystemVerilog:

package package_a;
typedef logic [4:0] type_a_t;
endpackage : package_a

package package_b;
import package_a::type_a_t;
typedef type_a_t type_b_t;
endpackage : package_b

Syntax

=== "Python (.py)"

```python linenums="1"
@packtype.package()
class PackageB:
    # Format <NAME> : Alias[<TYPE_TO_ALIAS>]
    TypeB : Alias[PackageA.TypeA]
```

=== "Packtype (.pt)"

```sv linenums="1"
package package_b {
    # Format <NAME> : <TYPE_TO_ALIAS>
    type_b_t : type_a_t
}
```