agilicus 1.291.1__py3-none-any.whl → 1.292.0__py3-none-any.whl

agilicus/agilicus_api_README.md

@@ -3,8 +3,8 @@ Agilicus is API-first. Modern software is controlled by other software, is open,
 
 The `agilicus_api` package is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
 
-- API version: 2025.06.26
-- Package version: 1.291.1
+- API version: 2025.07.08
+- Package version: 1.292.0
 - Build package: org.openapitools.codegen.languages.PythonClientCodegen
 For more information, please visit [https://www.agilicus.com/api](https://www.agilicus.com/api)
 
@@ -613,6 +613,17 @@ Class | Method | HTTP request | Description
 *LaunchersApi* | [**get_launcher**](agilicus_api/docs/LaunchersApi.md#get_launcher) | **GET** /v1/launchers/{launcher_id} | Get a single launcher
 *LaunchersApi* | [**list_launchers**](agilicus_api/docs/LaunchersApi.md#list_launchers) | **GET** /v1/launchers | Get all launchers
 *LaunchersApi* | [**replace_launcher**](agilicus_api/docs/LaunchersApi.md#replace_launcher) | **PUT** /v1/launchers/{launcher_id} | Create or update a launcher
+*LicensingApi* | [**create_license**](agilicus_api/docs/LicensingApi.md#create_license) | **POST** /v1/licenses | Create a license
+*LicensingApi* | [**create_product_table_version**](agilicus_api/docs/LicensingApi.md#create_product_table_version) | **POST** /v1/product_table_versions | Create a product table version
+*LicensingApi* | [**delete_license**](agilicus_api/docs/LicensingApi.md#delete_license) | **DELETE** /v1/licenses/{license_id} | Delete a license
+*LicensingApi* | [**delete_product_table_version**](agilicus_api/docs/LicensingApi.md#delete_product_table_version) | **DELETE** /v1/product_table_versions/{product_table_version_id} | Delete a product table version
+*LicensingApi* | [**get_license**](agilicus_api/docs/LicensingApi.md#get_license) | **GET** /v1/licenses/{license_id} | Get a single license
+*LicensingApi* | [**get_product_table_version**](agilicus_api/docs/LicensingApi.md#get_product_table_version) | **GET** /v1/product_table_versions/{product_table_version_id} | Get a single product table version
+*LicensingApi* | [**list_license_details**](agilicus_api/docs/LicensingApi.md#list_license_details) | **GET** /v1/license_details | Get all license details
+*LicensingApi* | [**list_licenses**](agilicus_api/docs/LicensingApi.md#list_licenses) | **GET** /v1/licenses | Get all licenses
+*LicensingApi* | [**list_product_table_versions**](agilicus_api/docs/LicensingApi.md#list_product_table_versions) | **GET** /v1/product_table_versions | Get all product table versions
+*LicensingApi* | [**replace_license**](agilicus_api/docs/LicensingApi.md#replace_license) | **PUT** /v1/licenses/{license_id} | Create or update a license
+*LicensingApi* | [**replace_product_table_version**](agilicus_api/docs/LicensingApi.md#replace_product_table_version) | **PUT** /v1/product_table_versions/{product_table_version_id} | Create or update a product table version
 *LookupsApi* | [**bulk_query_org_guids**](agilicus_api/docs/LookupsApi.md#bulk_query_org_guids) | **POST** /v1/lookups/bulk_query | List
 *LookupsApi* | [**lookup_org_guid**](agilicus_api/docs/LookupsApi.md#lookup_org_guid) | **GET** /v1/lookups/{org_id}/{guid} | Get a guid object lookup in an org
 *MessagesApi* | [**bulk_delete_messages**](agilicus_api/docs/MessagesApi.md#bulk_delete_messages) | **POST** /v1/messages/bulk_delete | Delete a list of messages and inbox items asociated to it.
@@ -1218,6 +1229,18 @@ Class | Method | HTTP request | Description
  - [LauncherSpec](agilicus_api/docs/LauncherSpec.md)
  - [LauncherStatus](agilicus_api/docs/LauncherStatus.md)
  - [LearningModeSpec](agilicus_api/docs/LearningModeSpec.md)
+ - [License](agilicus_api/docs/License.md)
+ - [LicenseConstraint](agilicus_api/docs/LicenseConstraint.md)
+ - [LicenseConstraintExpression](agilicus_api/docs/LicenseConstraintExpression.md)
+ - [LicenseConstraintName](agilicus_api/docs/LicenseConstraintName.md)
+ - [LicenseConstraintVariables](agilicus_api/docs/LicenseConstraintVariables.md)
+ - [LicenseDetails](agilicus_api/docs/LicenseDetails.md)
+ - [LicenseEvaluationInput](agilicus_api/docs/LicenseEvaluationInput.md)
+ - [LicenseSpec](agilicus_api/docs/LicenseSpec.md)
+ - [LicensedFeature](agilicus_api/docs/LicensedFeature.md)
+ - [LicensedFeatureName](agilicus_api/docs/LicensedFeatureName.md)
+ - [LicensedProduct](agilicus_api/docs/LicensedProduct.md)
+ - [LicensedProductName](agilicus_api/docs/LicensedProductName.md)
  - [ListAPIKeysResponse](agilicus_api/docs/ListAPIKeysResponse.md)
  - [ListAccessRequestsResponse](agilicus_api/docs/ListAccessRequestsResponse.md)
  - [ListActiveUsersResponse](agilicus_api/docs/ListActiveUsersResponse.md)
@@ -1278,6 +1301,8 @@ Class | Method | HTTP request | Description
  - [ListLabelledObjectsResponse](agilicus_api/docs/ListLabelledObjectsResponse.md)
  - [ListLabelsResponse](agilicus_api/docs/ListLabelsResponse.md)
  - [ListLaunchersResponse](agilicus_api/docs/ListLaunchersResponse.md)
+ - [ListLicenseDetailsResponse](agilicus_api/docs/ListLicenseDetailsResponse.md)
+ - [ListLicensesResponse](agilicus_api/docs/ListLicensesResponse.md)
  - [ListLogsResponse](agilicus_api/docs/ListLogsResponse.md)
  - [ListMFAChallengeMethods](agilicus_api/docs/ListMFAChallengeMethods.md)
  - [ListMessageEndpointsResponse](agilicus_api/docs/ListMessageEndpointsResponse.md)
@@ -1288,6 +1313,7 @@ Class | Method | HTTP request | Description
  - [ListPoliciesResponse](agilicus_api/docs/ListPoliciesResponse.md)
  - [ListPolicyRulesResponse](agilicus_api/docs/ListPolicyRulesResponse.md)
  - [ListPolicyTemplateInstancesResponse](agilicus_api/docs/ListPolicyTemplateInstancesResponse.md)
+ - [ListProductTableVersionsResponse](agilicus_api/docs/ListProductTableVersionsResponse.md)
  - [ListProductsResponse](agilicus_api/docs/ListProductsResponse.md)
  - [ListPublicFileOrgLinksResponse](agilicus_api/docs/ListPublicFileOrgLinksResponse.md)
  - [ListRegionResponse](agilicus_api/docs/ListRegionResponse.md)
@@ -1465,6 +1491,10 @@ Class | Method | HTTP request | Description
  - [Product](agilicus_api/docs/Product.md)
  - [ProductSpec](agilicus_api/docs/ProductSpec.md)
  - [ProductStatus](agilicus_api/docs/ProductStatus.md)
+ - [ProductTable](agilicus_api/docs/ProductTable.md)
+ - [ProductTableVersion](agilicus_api/docs/ProductTableVersion.md)
+ - [ProductTableVersionSpec](agilicus_api/docs/ProductTableVersionSpec.md)
+ - [ProductTableVersionString](agilicus_api/docs/ProductTableVersionString.md)
  - [PublicFileOrgLink](agilicus_api/docs/PublicFileOrgLink.md)
  - [PublicFileOrgLinkSpec](agilicus_api/docs/PublicFileOrgLinkSpec.md)
  - [RawToken](agilicus_api/docs/RawToken.md)
@@ -1613,6 +1643,8 @@ Class | Method | HTTP request | Description
  - [StatsPublishingLevelConfig](agilicus_api/docs/StatsPublishingLevelConfig.md)
  - [StorageInfo](agilicus_api/docs/StorageInfo.md)
  - [StorageRegion](agilicus_api/docs/StorageRegion.md)
+ - [SubscriptionEvaluationInput](agilicus_api/docs/SubscriptionEvaluationInput.md)
+ - [SubscriptionUsageInput](agilicus_api/docs/SubscriptionUsageInput.md)
  - [SupportRequest](agilicus_api/docs/SupportRequest.md)
  - [SupportRequestAcknowledgement](agilicus_api/docs/SupportRequestAcknowledgement.md)
  - [SupportRequestAcknowledgementSpec](agilicus_api/docs/SupportRequestAcknowledgementSpec.md)

agilicus/context.py

@@ -90,6 +90,9 @@ class ApiHelper:
         self.policy_config_api = agilicus.PolicyConfigApi(
             agilicus.ApiClient(self.configuration)
         )
+        self.licensing_api = agilicus.LicensingApi(
+            agilicus.ApiClient(self.configuration)
+        )
 
     def refresh_token(self):
         self.configuration.access_token = get_token(self.ctx)

agilicus/licensing/licensing_main.py

@@ -0,0 +1,64 @@
+import click
+import click_extension
+
+from ..output.table import output_entry
+
+from agilicus.command_helpers import Command
+
+from . import product_table_versions
+
+cmd = Command()
+
+
+@cmd.command(name="list-product-table-versions")
+@click.option("--version", default=None)
+@click.option("--published", default=None, type=bool)
+@click.option("--page-at-version", default=None)
+@click.option("--limit", default=500)
+@click.pass_context
+def list_product_table_versions(ctx, **kwargs):
+    resources = product_table_versions.list_product_table_versions(ctx, **kwargs)
+    table = product_table_versions.format_product_table_versions(ctx, resources)
+    print(table)
+
+
+@cmd.command(name="apply-product-table-version")
+@click.option(
+    "--input-file",
+    required=True,
+    type=click_extension.JSONFile("r"),
+    help="the filename; - for stdin",
+)
+@click.pass_context
+def add_product_table_version(ctx, **kwargs):
+    """
+    adds or updates a product table version as specified in a json file. If the
+    table exists, it matches based on the version.
+    """
+    result = product_table_versions.apply_product_table_version(ctx, **kwargs)
+    output_entry(ctx, result.to_dict())
+
+
+@cmd.command(name="show-product-table-version")
+@click.option("--product-table-version-id")
+@click.option("--version")
+@click.pass_context
+def show_product_table_version(ctx, **kwargs):
+    """
+    Shows a product table version, either by ID or version.
+    """
+    result = product_table_versions.show_product_table_version(ctx, **kwargs)
+    output_entry(ctx, result.to_dict())
+
+
+@cmd.command(name="delete-product-table-version")
+@click.argument("product-table-version-id")
+@click.pass_context
+def delete_product_table_version(ctx, product_table_version_id, **kwargs):
+    product_table_versions.delete_product_table_version(
+        ctx, product_table_version_id, **kwargs
+    )
+
+
+def add_commands(cli):
+    cmd.add_to_cli(cli)

agilicus/licensing/product_table_versions.py

@@ -0,0 +1,112 @@
+from operator import attrgetter
+from ..input_helpers import (
+    model_from_dict,
+    strip_none,
+)
+
+from .. import context
+
+from agilicus import (
+    create_or_update,
+    ProductTableVersion,
+)
+
+from ..output.table import (
+    format_table,
+    spec_column,
+    metadata_column,
+    constant_if_exists,
+    subtable,
+    column,
+    list_map,
+    summarize,
+)
+
+
+def list_product_table_versions(ctx, **kwargs):
+    token = context.get_token(ctx)
+    apiclient = context.get_apiclient(ctx, token)
+    result = apiclient.licensing_api.list_product_table_versions(
+        **strip_none(kwargs),
+    )
+    return result.product_table_versions
+
+
+def format_product_table_versions(ctx, templates):
+    num_subtable_rows = 10
+    feature_columns = [
+        column("name"),
+        summarize(
+            list_map(column("license_constraints", "constraints"), attrgetter("name")),
+            num_subtable_rows,
+        ),
+        summarize(
+            list_map(column("constraint_variables", "variables"), attrgetter("name")),
+            num_subtable_rows,
+        ),
+    ]
+    product_columns = [
+        column("name"),
+        summarize(
+            list_map(column("license_constraints", "constraints"), attrgetter("name")),
+            num_subtable_rows,
+        ),
+        summarize(
+            list_map(column("constraint_variables", "variables"), attrgetter("name")),
+            num_subtable_rows,
+        ),
+        column("included_features", "features"),
+    ]
+    columns = [
+        metadata_column("id"),
+        spec_column("version"),
+        constant_if_exists(spec_column("published"), "✓", default=""),
+        subtable(ctx, "spec.product_table.features", feature_columns, "features"),
+        subtable(ctx, "spec.product_table.products", product_columns, "products"),
+        summarize(
+            list_map(
+                spec_column("product_table.global_constraints", "constraints"),
+                attrgetter("name"),
+            ),
+            num_subtable_rows,
+        ),
+    ]
+
+    return format_table(ctx, templates, columns)
+
+
+def apply_product_table_version(ctx, input_file, **kwargs):
+    version = model_from_dict(ProductTableVersion, input_file)
+    token = context.get_token(ctx)
+    apiclient = context.get_apiclient(ctx, token)
+    resp, _ = create_or_update(
+        version,
+        lambda obj: apiclient.licensing_api.create_product_table_version(obj),
+        lambda guid, obj: apiclient.licensing_api.replace_product_table_version(
+            guid, product_table_version=obj
+        ),
+        to_dict=False,
+    )
+    return resp
+
+
+def delete_product_table_version(ctx, product_table_version_id):
+    token = context.get_token(ctx)
+    apiclient = context.get_apiclient(ctx, token)
+    apiclient.licensing_api.delete_product_table_version(product_table_version_id)
+
+
+def show_product_table_version(ctx, product_table_version_id, version, **kwargs):
+    token = context.get_token(ctx)
+    apiclient = context.get_apiclient(ctx, token)
+    if not version and not product_table_version_id:
+        raise ValueError("version or product_table_version must be provided")
+    if version:
+        result = apiclient.licensing_api.list_product_table_versions(
+            version=version, limit=1
+        )
+        if not result.product_table_versions:
+            raise ValueError(f"version {version} not found")
+        return result.product_table_versions[0]
+
+    return apiclient.licensing_api.get_product_table_version(product_table_version_id)

agilicus/main.py

@@ -86,6 +86,7 @@ from .features.features import format_features
 from .credentials_commands import credentials_main
 from .files_pkg import files_main
 from .policy_config import policy_config_main
+from .licensing import licensing_main
 
 from .version import __version__
 
@@ -377,9 +378,14 @@ def cli(
         context.save_refreshable_token(ctx, tokens.RefreshableAccessToken())
 
     if not org_id:
-        if not token:
-            token = context.get_token(ctx)
-        org_id = context.get_org_id(ctx, token)
+        # this is optional, used primarily for the prompt
+        try:
+            if not token:
+                token = context.get_token(ctx)
+                org_id = context.get_org_id(ctx, token)
+        except Exception as exc:
+            print("Exception in get_token: ", exc)
+            pass
 
     if org_id:
         org = orgs.get(ctx, org_id)
@@ -8611,6 +8617,7 @@ def delete_connector_services(ctx, *args, **kwargs):
 @cli.command(name="list-support-requests")
 @click.option("--org-id", default=None)
 @click.option("--user-id", default=None)
+@click.option("--supporting-user-org-id", default=None)
 @click.option("--limit", default=500)
 @click.pass_context
 def list_support_requests(ctx, **kwargs):
@@ -8817,6 +8824,7 @@ def main():
     policy_config_main.add_commands(cli)
     messages_main.add_commands(cli)
     databases.add_commands(cli)
+    licensing_main.add_commands(cli)
 
     cli(auto_envvar_prefix="AGILICUS")
 

agilicus/output/table.py

@@ -178,7 +178,7 @@ def status_column(in_name, out_name=None, **kwargs):
     return subobject_column(in_name, out_name, "status", **kwargs)
 
 
-def constant_if_exists(column: OutputColumn, constant):
+def constant_if_exists(column: OutputColumn, constant, default=None):
     orig = column.format_fn
 
     def check(val):
@@ -187,16 +187,60 @@ def constant_if_exists(column: OutputColumn, constant):
 
         if val:
             return constant
-        return None
+        return default
 
     column.format_fn = check
     return column
 
 
+def list_count(column: OutputColumn):
+    orig = column.format_fn
+
+    def formatter(val):
+        if isinstance(val, list):
+            return len(val)
+        if orig:
+            val = orig(val)
+        return val
+
+    column.format_fn = formatter
+    return column
+
+
+def list_map(column: OutputColumn, mapfn: Callable):
+    orig = column.getter
+
+    def getter(record, getter):
+        if orig:
+            val = orig(record, getter)
+        else:
+            val = getter(column.in_name)(record)
+        if isinstance(val, list):
+            val = [mapfn(v) for v in val]
+        return val
+
+    column.getter = getter
+    return column
+
+
 def summarize(column: OutputColumn, max_length: int):
     orig = column.format_fn
 
+    def format_list(val):
+        if len(val) <= max_length:
+            if orig:
+                val = orig(val)
+            return val
+
+        val = val[:max_length]
+        if orig:
+            val = orig(val)
+        return val + "[truncated]"
+
     def formatter(val):
+        if isinstance(val, list):
+            return format_list(val)
+
         if orig:
             val = orig(val)
 

agilicus/users.py

@@ -1208,7 +1208,8 @@ def _get_support_request(apiclient, request_id, org_id=None, **kwargs):
 
 def list_support_requests(ctx, **kwargs):
     apiclient = context.get_apiclient_from_ctx(ctx)
-    update_org_from_input_or_ctx(kwargs, ctx, **kwargs)
+    if kwargs.get("supporting_user_org_id", None) is None:
+        update_org_from_input_or_ctx(kwargs, ctx, **kwargs)
     input_helpers.pop_item_if_none(kwargs)
     query_results = apiclient.user_api.list_support_requests(**kwargs)
     return query_results.support_requests

{agilicus-1.291.1.dist-info → agilicus-1.292.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: agilicus
-Version: 1.291.1
+Version: 1.292.0
 Summary: Agilicus SDK
 Home-page: https://www.agilicus.com/
 License: MIT