Alibaba Cloud Darabonba Array

0.1.0 · active · verified Fri Apr 17

The `alibabacloud-darabonba-array` library provides array manipulation utilities specifically designed for the Alibaba Cloud Darabonba framework. It offers methods for common array operations like appending, getting items, and checking size. Currently at version 0.1.0, it is part of the broader Alibaba Cloud SDK ecosystem and follows a release cadence tied to the Darabonba framework's development.

Common errors

```
ModuleNotFoundError: No module named 'alibabacloud_darabonba_array'
```
cause The package has not been installed or the active Python environment does not have it.

fix Ensure the package is installed: `pip install alibabacloud-darabonba-array`
```
AttributeError: module 'alibabacloud_darabonba_array' has no attribute 'Array'
```
cause Incorrect import path; the `Array` class is located within the `client` submodule.

fix Use the correct import: `from alibabacloud_darabonba_array.client import Array`
```
TypeError: 'list' object has no attribute 'to_list'
```
cause Attempting to use Darabonba `Array` methods on a standard Python list, or forgetting to initialize the `Array` object.

fix Ensure you are working with an `Array` object, initialized using `Array.initial()` or returned by another `Array` method. Example: `my_darabonba_array = Array.initial([1, 2, 3])`

Warnings

gotcha This library is designed as a utility for the Alibaba Cloud Darabonba framework and its SDKs, not as a general-purpose standalone array manipulation library like NumPy or standard Python lists. Its API might feel less 'Pythonic' compared to idiomatic Python array operations.
Fix: Understand its primary use case within the Alibaba Cloud Darabonba ecosystem. For general-purpose array needs, consider Python's built-in lists or libraries like NumPy.
breaking As a library in its early development (version 0.1.0), the API is subject to change in minor or patch versions. Method names, signatures, or class structures could be altered without a major version increment.
Fix: Pin to exact patch versions (`alibabacloud-darabonba-array==0.1.0`) in production environments and review release notes carefully before upgrading.
gotcha Many methods, such as `append`, `remove`, and `concat`, modify the `Array` object in-place and return `None`. Be aware of this behavior when chaining operations or expecting a new array object.
Fix: Always work with the original `Array` instance after calling modifying methods. Check method signatures in documentation if unsure of return values.

Install

pip install alibabacloud-darabonba-array Install with pip

Imports

Array
wrong:
```
from alibabacloud_darabonba_array import Array
```
correct:
```
from alibabacloud_darabonba_array.client import Array
```
The `Array` class is nested within the `client` module, not directly under the top-level package.

Quickstart

This quickstart demonstrates how to initialize a Darabonba `Array` object and perform common operations such as appending, retrieving items, checking size, containment, removal, and concatenation. Note that many methods modify the array in-place.

from alibabacloud_darabonba_array.client import Array

# Initialize with a list
arr = Array.initial(["a", "b", "c"])
print(f"Initial array: {arr.to_list()}")

# Append an item
Array.append(arr, "d")
print(f"After append: {arr.to_list()}")

# Get an item by index
item = Array.get_item(arr, 1)
print(f"Item at index 1: {item}")

# Get size
size = Array.size(arr)
print(f"Array size: {size}")

# Check if an item exists
contains_c = Array.contains(arr, "c")
print(f"Contains 'c': {contains_c}")

# Remove an item (by value)
Array.remove(arr, "b")
print(f"After remove 'b': {arr.to_list()}")

# Concatenate arrays
arr2 = Array.initial([1, 2])
Array.concat(arr, arr2)
print(f"After concat: {arr.to_list()}")

view raw JSON →