aea.configurations.data`_`types¶

Base config data types.

JSONSerializable Objects¶

class JSONSerializable(ABC)

Interface for JSON-serializable objects.

json¶

 | @property
 | @abstractmethod
 | json() -> Dict

Compute the JSON representation.

from`_`json¶

 | @classmethod
 | from_json(cls, obj: Dict) -> "JSONSerializable"

Build from a JSON object.

PackageVersion Objects¶

@functools.total_ordering
class PackageVersion()

A package version.

``init``¶

 | __init__(version_like: PackageVersionLike) -> None

Initialize a package version.

Arguments:

version_like: a string, os a semver.VersionInfo object.

is`_`latest¶

 | @property
 | is_latest() -> bool

Check whether the version is 'latest'.

``str``¶

 | __str__() -> str

Get the string representation.

``eq``¶

 | __eq__(other: Any) -> bool

Check equality.

``lt``¶

 | __lt__(other: Any) -> bool

Compare with another object.

PackageType Objects¶

class PackageType(Enum)

Package types.

to`_`plural¶

 | to_plural() -> str

Get the plural name.

PackageType.AGENT.to_plural() 'agents' PackageType.PROTOCOL.to_plural() 'protocols' PackageType.CONNECTION.to_plural() 'connections' PackageType.SKILL.to_plural() 'skills' PackageType.CONTRACT.to_plural() 'contracts'

Returns:

pluralised package type

``str``¶

 | __str__() -> str

Convert to string.

ComponentType Objects¶

class ComponentType(Enum)

Enum of component types supported.

to`_`package`_`type¶

 | to_package_type() -> PackageType

Get package type for component type.

plurals¶

 | @staticmethod
 | plurals() -> Collection[str]

Get the collection of type names, plural.

ComponentType.plurals() ['protocols', 'connections', 'skills', 'contracts']

Returns:

list of all pluralised component types

to`_`plural¶

 | to_plural() -> str

Get the plural version of the component type.

ComponentType.PROTOCOL.to_plural() 'protocols' ComponentType.CONNECTION.to_plural() 'connections' ComponentType.SKILL.to_plural() 'skills' ComponentType.CONTRACT.to_plural() 'contracts'

Returns:

pluralised component type

``str``¶

 | __str__() -> str

Get the string representation.

PublicId Objects¶

class PublicId(JSONSerializable)

This class implement a public identifier.

A public identifier is composed of three elements: - author - name - version

The concatenation of those three elements gives the public identifier:

author/name:version

public_id = PublicId("author", "my_package", "0.1.0") assert public_id.author == "author" assert public_id.name == "my_package" assert public_id.version == "0.1.0" another_public_id = PublicId("author", "my_package", "0.1.0") assert hash(public_id) == hash(another_public_id) assert public_id == another_public_id latest_public_id = PublicId("author", "my_package", "latest") latest_public_id latest_public_id.package_version.is_latest True

``init``¶

 | __init__(author: SimpleIdOrStr, name: SimpleIdOrStr, version: Optional[PackageVersionLike] = None) -> None

Initialize the public identifier.

author¶

 | @property
 | author() -> str

Get the author.

name¶

 | @property
 | name() -> str

Get the name.

version¶

 | @property
 | version() -> str

Get the version string.

package`_`version¶

 | @property
 | package_version() -> PackageVersion

Get the package version object.

to`_`any¶

 | to_any() -> "PublicId"

Return the same public id, but with any version.

same`_`prefix¶

 | same_prefix(other: "PublicId") -> bool

Check if the other public id has the same author and name of this.

to`_`latest¶

 | to_latest() -> "PublicId"

Return the same public id, but with latest version.

is`_`valid`_`str¶

 | @classmethod
 | is_valid_str(cls, public_id_string: str) -> bool

Check if a string is a public id.

Arguments:

public_id_string: the public id in string format.

Returns:

bool indicating validity

from`_`str¶

 | @classmethod
 | from_str(cls, public_id_string: str) -> "PublicId"

Initialize the public id from the string.

str(PublicId.from_str("author/package_name:0.1.0")) 'author/package_name:0.1.0'

A bad formatted input raises value error:

PublicId.from_str("bad/formatted:input") Traceback (most recent call last): ... ValueError: Input 'bad/formatted:input' is not well formatted.

Arguments:

public_id_string: the public id in string format.

Returns:

the public id object.

Raises:

ValueError: if the string in input is not well formatted.

try`_`from`_`str¶

 | @classmethod
 | try_from_str(cls, public_id_string: str) -> Optional["PublicId"]

Safely try to get public id from string.

Arguments:

public_id_string: the public id in string format.

Returns:

the public id object or None

from`_`uri`_`path¶

 | @classmethod
 | from_uri_path(cls, public_id_uri_path: str) -> "PublicId"

Initialize the public id from the string.

str(PublicId.from_uri_path("author/package_name/0.1.0")) 'author/package_name:0.1.0'

A bad formatted input raises value error:

PublicId.from_uri_path("bad/formatted:input") Traceback (most recent call last): ... ValueError: Input 'bad/formatted:input' is not well formatted.

Arguments:

public_id_uri_path: the public id in uri path string format.

Returns:

the public id object.

Raises:

ValueError: if the string in input is not well formatted.

to`_`uri`_`path¶

 | @property
 | to_uri_path() -> str

Turn the public id into a uri path string.

Returns:

uri path string

json¶

 | @property
 | json() -> Dict

Compute the JSON representation.

from`_`json¶

 | @classmethod
 | from_json(cls, obj: Dict) -> "PublicId"

Build from a JSON object.

``hash``¶

 | __hash__() -> int

Get the hash.

``str``¶

 | __str__() -> str

Get the string representation.

``repr``¶

 | __repr__() -> str

Get the representation.

``eq``¶

 | __eq__(other: Any) -> bool

Compare with another object.

``lt``¶

 | __lt__(other: Any) -> bool

Compare two public ids.

public_id_1 = PublicId("author_1", "name_1", "0.1.0") public_id_2 = PublicId("author_1", "name_1", "0.1.1") public_id_3 = PublicId("author_1", "name_2", "0.1.0") public_id_1 > public_id_2 False public_id_1 < public_id_2 True

public_id_1 < public_id_3 Traceback (most recent call last): ... ValueError: The public IDs author_1/name_1:0.1.0 and author_1/name_2:0.1.0 cannot be compared. Their author or name attributes are different.

Arguments:

other: the object to compate to

Raises:

ValueError: if the public ids cannot be confirmed

Returns:

whether or not the inequality is satisfied

PackageId Objects¶

class PackageId()

A package identifier.

``init``¶

 | __init__(package_type: Union[PackageType, str], public_id: PublicId) -> None

Initialize the package id.

Arguments:

package_type: the package type.
public_id: the public id.

package`_`type¶

 | @property
 | package_type() -> PackageType

Get the package type.

public`_`id¶

 | @property
 | public_id() -> PublicId

Get the public id.

author¶

 | @property
 | author() -> str

Get the author of the package.

name¶

 | @property
 | name() -> str

Get the name of the package.

version¶

 | @property
 | version() -> str

Get the version of the package.

package`_`prefix¶

 | @property
 | package_prefix() -> Tuple[PackageType, str, str]

Get the package identifier without the version.

from`_`uri`_`path¶

 | @classmethod
 | from_uri_path(cls, package_id_uri_path: str) -> "PackageId"

Initialize the package id from the string.

str(PackageId.from_uri_path("skill/author/package_name/0.1.0")) '(skill, author/package_name:0.1.0)'

A bad formatted input raises value error:

PackageId.from_uri_path("very/bad/formatted:input") Traceback (most recent call last): ... ValueError: Input 'very/bad/formatted:input' is not well formatted.

Arguments:

package_id_uri_path: the package id in uri path string format.

Returns:

the package id object.

Raises:

ValueError: if the string in input is not well formatted.

to`_`uri`_`path¶

 | @property
 | to_uri_path() -> str

Turn the package id into a uri path string.

Returns:

uri path string

``hash``¶

 | __hash__() -> int

Get the hash.

``str``¶

 | __str__() -> str

Get the string representation.

``repr``¶

 | __repr__() -> str

Get the object representation in string.

``eq``¶

 | __eq__(other: Any) -> bool

Compare with another object.

``lt``¶

 | __lt__(other: Any) -> bool

Compare two public ids.

ComponentId Objects¶

class ComponentId(PackageId)

Class to represent a component identifier.

A component id is a package id, but excludes the case when the package is an agent.

pacakge_id = PackageId(PackageType.PROTOCOL, PublicId("author", "name", "0.1.0")) component_id = ComponentId(ComponentType.PROTOCOL, PublicId("author", "name", "0.1.0")) pacakge_id == component_id True

component_id2 = ComponentId(ComponentType.PROTOCOL, PublicId("author", "name", "0.1.1")) pacakge_id == component_id2 False

``init``¶

 | __init__(component_type: Union[ComponentType, str], public_id: PublicId) -> None

Initialize the component id.

Arguments:

component_type: the component type.
public_id: the public id.

component`_`type¶

 | @property
 | component_type() -> ComponentType

Get the component type.

component`_`prefix¶

 | @property
 | component_prefix() -> PackageIdPrefix

Get the component identifier without the version.

same`_`prefix¶

 | same_prefix(other: "ComponentId") -> bool

Check if the other component id has the same type, author and name of this.

prefix`_`import`_`path¶

 | @property
 | prefix_import_path() -> str

Get the prefix import path for this component.

json¶

 | @property
 | json() -> Dict

Get the JSON representation.

from`_`json¶

 | @classmethod
 | from_json(cls, json_data: Dict) -> "ComponentId"

Create component id from json data.

PyPIPackageName Objects¶

class PyPIPackageName(RegexConstrainedString)

A PyPI Package name.

GitRef Objects¶

class GitRef(RegexConstrainedString)

A Git reference.

It can be a branch name, a commit hash or a tag.

Dependency Objects¶

class Dependency()

This class represents a PyPI dependency.

It contains the following information: - version: a version specifier(s) (e.g. '==0.1.0'). - index: the PyPI index where to download the package from (default: https://pypi.org) - git: the URL to the Git repository (e.g. https://github.com/fetchai/agents-aea.git) - ref: either the branch name, the tag, the commit number or a Git reference (default: 'master'.)

If the 'git' field is set, the 'version' field will be ignored. These fields will be forwarded to the 'pip' command.

``init``¶

 | __init__(name: Union[PyPIPackageName, str], version: Union[str, SpecifierSet] = "", index: Optional[str] = None, git: Optional[str] = None, ref: Optional[Union[GitRef, str]] = None) -> None

Initialize a PyPI dependency.

Arguments:

name: the package name.
version: the specifier set object
index: the URL to the PyPI server.
git: the URL to a git repository.
ref: the Git reference (branch/commit/tag).

name¶

 | @property
 | name() -> str

Get the name.

version¶

 | @property
 | version() -> str

Get the version.

index¶

 | @property
 | index() -> Optional[str]

Get the index.

git¶

 | @property
 | git() -> Optional[str]

Get the git.

ref¶

 | @property
 | ref() -> Optional[str]

Get the ref.

from`_`json¶

 | @classmethod
 | from_json(cls, obj: Dict[str, Dict[str, str]]) -> "Dependency"

Parse a dependency object from a dictionary.

to`_`json¶

 | to_json() -> Dict[str, Dict[str, str]]

Transform the object to JSON.

get`_`pip`_`install`_`args¶

 | get_pip_install_args() -> List[str]

Get 'pip install' arguments.

``str``¶

 | __str__() -> str

Get the string representation.

``eq``¶

 | __eq__(other: Any) -> bool

Compare with another object.

Dependencies¶

A dictionary from package name to dependency data structure (see above). The package name must satisfy the constraints on Python packages names.

The main advantage of having a dictionary is that we implicitly filter out dependency duplicates. We cannot have two items with the same package name since the keys of a YAML object form a set.

CRUDCollection Objects¶

class CRUDCollection(Generic[T])

Interface of a CRUD collection.

``init``¶

 | __init__() -> None

Instantiate a CRUD collection.

create¶

 | create(item_id: str, item: T) -> None

Add an item.

Arguments:

item_id: the item id.
item: the item to be added.

Raises:

ValueError: if the item with the same id is already in the collection.

read¶

 | read(item_id: str) -> Optional[T]

Get an item by its name.

Arguments:

item_id: the item id.

Returns:

the associated item, or None if the item id is not present.

update¶

 | update(item_id: str, item: T) -> None

Update an existing item.

Arguments:

item_id: the item id.
item: the item to be added.

delete¶

 | delete(item_id: str) -> None

Delete an item.

read`_`all¶

 | read_all() -> List[Tuple[str, T]]

Read all the items.

keys¶

 | keys() -> Set[str]

Get the set of keys.

aea.configurations.data_types¶

JSONSerializable Objects¶

json¶

from_json¶

PackageVersion Objects¶

__init__¶

is_latest¶

__str__¶

__eq__¶

__lt__¶

PackageType Objects¶

to_plural¶

__str__¶

ComponentType Objects¶

to_package_type¶

plurals¶

to_plural¶

__str__¶

PublicId Objects¶

__init__¶

author¶

name¶

version¶

package_version¶

to_any¶

same_prefix¶

to_latest¶

is_valid_str¶

from_str¶

try_from_str¶

from_uri_path¶

to_uri_path¶

json¶

from_json¶

__hash__¶

__str__¶

__repr__¶

__eq__¶

__lt__¶

PackageId Objects¶

__init__¶

package_type¶

public_id¶

author¶

name¶

version¶

package_prefix¶

from_uri_path¶

to_uri_path¶

__hash__¶

__str__¶

__repr__¶

__eq__¶

__lt__¶

ComponentId Objects¶

__init__¶

component_type¶

component_prefix¶

same_prefix¶

prefix_import_path¶

json¶

from_json¶

PyPIPackageName Objects¶

GitRef Objects¶

Dependency Objects¶

__init__¶

name¶

version¶

index¶

git¶

ref¶

from_json¶

to_json¶

get_pip_install_args¶

__str__¶

__eq__¶

Dependencies¶

CRUDCollection Objects¶

__init__¶

create¶

aea.configurations.data`_`types¶

from`_`json¶

``init``¶

is`_`latest¶

``str``¶

``eq``¶

``lt``¶

to`_`plural¶

``str``¶

to`_`package`_`type¶

to`_`plural¶

``str``¶

``init``¶

package`_`version¶

to`_`any¶

same`_`prefix¶

to`_`latest¶

is`_`valid`_`str¶

from`_`str¶

try`_`from`_`str¶

from`_`uri`_`path¶

to`_`uri`_`path¶

from`_`json¶

``hash``¶

``str``¶

``repr``¶

``eq``¶

``lt``¶

``init``¶

package`_`type¶

public`_`id¶

package`_`prefix¶

from`_`uri`_`path¶

to`_`uri`_`path¶

``hash``¶

``str``¶

``repr``¶

``eq``¶

``lt``¶

``init``¶

component`_`type¶

component`_`prefix¶

same`_`prefix¶

prefix`_`import`_`path¶

from`_`json¶

``init``¶

from`_`json¶

to`_`json¶

get`_`pip`_`install`_`args¶

``str``¶

``eq``¶

``init``¶

read`_`all¶