blue-sandbox 5.294.1__py3-none-any.whl → 5.320.1__py3-none-any.whl

blue_sandbox/.abcli/microsoft_building_damage_assessment/install.sh

@@ -1,50 +0,0 @@
-#! /usr/bin/env bash
-
-function blue_sandbox_microsoft_building_damage_assessment_install() {
-    local options=$1
-    local do_dryrun=$(abcli_option_int "$options" dryrun 0)
-    local recreate_env=$(abcli_option_int "$options" recreate_env 0)
-
-    if [[ -d "$abcli_path_git/building-damage-assessment" ]]; then
-        abcli_log "✅  building-damage-assessment"
-    else
-        abcli_git_clone https://github.com/microsoft/building-damage-assessment.git
-        [[ $? -ne 0 ]] && return 1
-    fi
-
-    [[ "$abcli_is_github_workflow" == true ]] ||
-        [[ "$abcli_is_sagemaker_system" == true ]] &&
-        return 0
-
-    if [[ "$recreate_env" == 1 ]]; then
-        abcli_conda_rm name=bda
-        [[ $? -ne 0 ]] && return 1
-    fi
-
-    local exists=$(abcli_conda_exists name=bda)
-    if [[ "$exists" == 0 ]]; then
-        # https://github.com/microsoft/building-damage-assessment?tab=readme-ov-file#setup
-        conda env create \
-            -f $abcli_path_git/building-damage-assessment/environment.yml
-        [[ $? -ne 0 ]] && return 1
-    fi
-
-    conda activate bda
-    [[ $? -ne 0 ]] && return 1
-
-    pushd $abcli_path_git/blue-sandbox >/dev/null
-    pip3 install -e .
-    [[ $? -ne 0 ]] && return 1
-    popd >/dev/null
-
-    [[ "$abcli_is_mac" == true ]] &&
-        brew install wget
-
-    return 0
-}
-
-function abcli_install_microsoft_building_damage_assessment() {
-    blue_sandbox_microsoft_building_damage_assessment_install "$@"
-}
-
-abcli_install_module microsoft_building_damage_assessment 1.1.1

blue_sandbox/.abcli/microsoft_building_damage_assessment/label.sh

@@ -1,26 +0,0 @@
-#! /usr/bin/env bash
-
-function blue_sandbox_microsoft_building_damage_assessment_label() {
-    local options=$1
-    local do_dryrun=$(abcli_option_int "$options" dryrun 0)
-    local do_download=$(abcli_option_int "$options" download $(abcli_not $do_dryrun))
-    local do_upload=$(abcli_option_int "$options" upload $(abcli_not $do_dryrun))
-
-    local object_name=$(abcli_clarify_object $2 .)
-    [[ "$do_download" == 1 ]] &&
-        abcli_download - $object_name
-
-    abcli_log "labeling $object_name ..."
-
-    abcli_eval dryrun=$do_dryrun \
-        python3 -m blue_sandbox.microsoft_building_damage_assessment \
-        label \
-        --object_name $object_name \
-        "${@:3}"
-    local status="$?"
-
-    [[ "$do_upload" == 1 ]] &&
-        abcli_upload - $object_name
-
-    return $status
-}

blue_sandbox/.abcli/microsoft_building_damage_assessment/tensorboard.sh

@@ -1,21 +0,0 @@
-#! /usr/bin/env bash
-
-function blue_sandbox_microsoft_building_damage_assessment_tensorboard() {
-    local options=$1
-    local do_dryrun=$(abcli_option_int "$options" dryrun 0)
-    local do_browse=$(abcli_option_int "$options" browse $(abcli_not $do_dryrun))
-    local do_download=$(abcli_option_int "$options" download $(abcli_not $do_dryrun))
-    local port=$(abcli_option "$options" port 8889)
-
-    local model_object_name=$(abcli_clarify_object $2 .)
-    [[ "$do_download" == 1 ]] &&
-        abcli_download - $model_object_name
-
-    [[ "$do_browse" == 1 ]] &&
-        abcli_browse http://localhost:$port/
-
-    abcli_eval ,$options \
-        tensorboard \
-        --logdir $ABCLI_OBJECT_ROOT/$model_object_name/logs/ \
-        --port $port
-}

blue_sandbox/.abcli/microsoft_building_damage_assessment/train.sh

@@ -1,53 +0,0 @@
-#! /usr/bin/env bash
-
-function blue_sandbox_microsoft_building_damage_assessment_train() {
-    local options=$1
-    local do_dryrun=$(abcli_option_int "$options" dryrun 0)
-    local do_download=$(abcli_option_int "$options" download $(abcli_not $do_dryrun))
-    local do_upload=$(abcli_option_int "$options" upload $(abcli_not $do_dryrun))
-
-    local dataset_object_name=$(abcli_clarify_object $2 .)
-    [[ "$do_download" == 1 ]] &&
-        abcli_download - $dataset_object_name
-
-    local model_object_name=$(abcli_clarify_object $3 $dataset_object_name-model-$(abcli_string_timestamp_short))
-
-    abcli_log "training $dataset_object_name -> $model_object_name ..."
-
-    conda activate bda
-    [[ $? -ne 0 ]] && return 1
-
-    abcli_eval dryrun=$do_dryrun \
-        python3 -m blue_sandbox.microsoft_building_damage_assessment \
-        train \
-        --dataset_object_name $dataset_object_name \
-        --model_object_name $model_object_name \
-        "${@:4}"
-    [[ $? -ne 0 ]] && return 1
-
-    abcli_eval dryrun=$do_dryrun,path=$abcli_path_git/building-damage-assessment \
-        python3 project_setup.py \
-        --skip_health_check \
-        --config $ABCLI_OBJECT_ROOT/$model_object_name/config.yml
-    [[ $? -ne 0 ]] && return 1
-
-    abcli_eval dryrun=$do_dryrun,path=$abcli_path_git/building-damage-assessment \
-        python3 create_masks.py \
-        --config $ABCLI_OBJECT_ROOT/$model_object_name/config.yml
-    [[ $? -ne 0 ]] && return 1
-
-    abcli_eval dryrun=$do_dryrun,path=$abcli_path_git/building-damage-assessment \
-        python3 fine_tune.py \
-        --config $ABCLI_OBJECT_ROOT/$model_object_name/config.yml
-    [[ $? -ne 0 ]] && return 1
-
-    abcli_eval dryrun=$do_dryrun,path=$abcli_path_git/building-damage-assessment \
-        python3 inference.py \
-        --config $ABCLI_OBJECT_ROOT/$model_object_name/config.yml
-    [[ $? -ne 0 ]] && return 1
-
-    [[ "$do_upload" == 1 ]] &&
-        abcli_upload - $model_object_name
-
-    return 0
-}

blue_sandbox/.abcli/microsoft_building_damage_assessment.sh

@@ -1,15 +0,0 @@
-#! /usr/bin/env bash
-
-function blue_sandbox_microsoft_building_damage_assessment() {
-    local task=$(abcli_unpack_keyword $1 help)
-
-    local function_name=blue_sandbox_microsoft_building_damage_assessment_$task
-    if [[ $(type -t $function_name) == "function" ]]; then
-        $function_name "${@:2}"
-        return
-    fi
-
-    python3 -m blue_sandbox.microsoft_building_damage_assessment "$@"
-}
-
-abcli_source_caller_suffix_path /microsoft_building_damage_assessment

blue_sandbox/.abcli/sagesemseg/cache_dataset.sh

@@ -1,49 +0,0 @@
-#! /usr/bin/env bash
-
-function runme() {
-    local options=$1
-
-    local script_full_name="${BASH_SOURCE[0]}"
-    local script_name=$(abcli_script_get name)
-
-    abcli_scripts source - sagesemseg/consts
-
-    if [ $(abcli_option_int "$options" help 0) == 1 ]; then
-        local options="$sagesemseg_cache_dataset_options,rm"
-        abcli_meta_script_show_usage $script_full_name "$EOP[$options]$EOPE" \
-            "cache dataset."
-        return
-    fi
-
-    local dataset_name=$(abcli_option "$options" dataset pascal-voc)
-    local do_rm=$(abcli_option "$options" rm 0)
-    local suffix=$(abcli_option "$options" suffix v1)
-
-    local dataset_object_name=$dataset_name-$suffix
-
-    local dataset_object_path=$ABCLI_OBJECT_ROOT/$dataset_object_name
-    mkdir -pv $dataset_object_path
-
-    if [[ -d "$dataset_object_path/$dataset_name" ]]; then
-        abcli_log "✅ $dataset_object_name/$dataset_name/"
-        return
-    fi
-
-    abcli_log "caching $dataset_object_name"
-
-    pushd $dataset_object_path >/dev/null
-
-    if [[ ! -f "$dataset_name.tgz" ]]; then
-        curl -O https://fast-ai-imagelocal.s3.amazonaws.com/pascal-voc.tgz
-    else
-        abcli_log "✅ $dataset_object_name/$dataset_name.tgz"
-    fi
-
-    tar -xvf $dataset_name.tgz
-
-    [[ "$do_rm" == 1 ]] && rm -v $dataset_name.tgz
-
-    popd >/dev/null
-}
-
-runme "$@"

blue_sandbox/.abcli/sagesemseg/consts.sh

@@ -1,3 +0,0 @@
-#! /usr/bin/env bash
-
-export sagesemseg_cache_dataset_options="dataset=pascal-voc,suffix=<v1>"

blue_sandbox/.abcli/sagesemseg/train.sh

@@ -1,48 +0,0 @@
-#! /usr/bin/env bash
-
-function runme() {
-    local options=$1
-
-    local script_full_name="${BASH_SOURCE[0]}"
-    local script_name=$(abcli_script_get name)
-
-    abcli_scripts source - sagesemseg/consts
-
-    if [ $(abcli_option_int "$options" help 0) == 1 ]; then
-        local options="dryrun,~upload"
-        local args="[--deploy 0]$ABCUL[--delete_endpoint 0]$ABCUL[--epochs 10]$ABCUL[--instance_type ml.p3.2xlarge]"
-        abcli_meta_script_show_usage $script_full_name "$EOP[$options]$ABCUL[test|<dataset-object-name>]$ABCUL[-|<model-object-name>]$ABCUL$args$EOPE" \
-            "<dataset-object-name> -train-> <model-object-name>."
-        return
-    fi
-
-    local do_dryrun=$(abcli_option_int "$options" dryrun 0)
-    local do_upload=$(abcli_not $do_dryrun)
-
-    local dataset_object_name=$(abcli_clarify_object "$2" test)
-    if [[ "$dataset_object_name" == "test" ]]; then
-        dataset_object_name="pascal-voc-v1-debug-v2"
-        do_upload=0
-    fi
-
-    do_upload=$(abcli_option_int "$options" upload $do_upload)
-
-    local model_object_name=$(abcli_clarify_object "$3" sagesemseg-model-test-$(abcli_string_timestamp))
-
-    abcli_log "$script_name: $dataset_object_name -> $model_object_name"
-
-    abcli_tags set \
-        $model_object_name \
-        trained_on.$dataset_object_name
-
-    abcli_eval dryrun=$do_dryrun \
-        python3 -m blue_sandbox.cemetry.sagesemseg train_model \
-        --dataset_object_name $dataset_object_name \
-        --model_object_name $model_object_name \
-        "${@:4}"
-
-    [[ "$do_upload" == 1 ]] &&
-        abcli_upload - $model_object_name
-}
-
-runme "$@"

blue_sandbox/.abcli/sagesemseg/upload_dataset.sh

@@ -1,47 +0,0 @@
-#! /usr/bin/env bash
-
-function runme() {
-    local options=$1
-
-    local script_full_name="${BASH_SOURCE[0]}"
-    local script_name=$(abcli_script_get name)
-
-    abcli_scripts source - sagesemseg/consts
-
-    if [ $(abcli_option_int "$options" help 0) == 1 ]; then
-        local cache_options=$sagesemseg_cache_dataset_options
-        local options="dryrun,suffix=<v1>"
-        local args="[--count <count>]"
-        abcli_meta_script_show_usage $script_full_name "$EOP[$cache_options]$ABCUL[$options]$ABCUL$args" \
-            "upload dataset to SageMaker for training."
-        return
-    fi
-
-    local cache_options=$1
-    local dataset_name=$(abcli_option "$cache_options" dataset pascal-voc)
-    local cache_suffix=$(abcli_option "$cache_options" suffix v1)
-
-    local dataset_object_name=$dataset_name
-    [[ ! -z "$cache_suffix" ]] && dataset_object_name=$dataset_name-$cache_suffix
-
-    [[ "$dataset_name" == "pascal-voc" ]] &&
-        abcli_scripts source dryrun=$do_dryrun \
-            sagesemseg/cache_dataset \
-            "$cache_options"
-
-    local options=$2
-    local do_dryrun=$(abcli_option_int "$options" dryrun 0)
-    local suffix=$(abcli_option "$options" suffix v1)
-
-    local object_name=$dataset_object_name-$suffix
-
-    abcli_log "$script_name: $dataset_object_name -> ☁️ / $object_name"
-
-    abcli_eval dryrun=$do_dryrun \
-        python3 -m blue_sandbox.cemetry.sagesemseg upload_dataset \
-        --dataset_object_name $dataset_object_name \
-        --object_name $object_name \
-        "${@:3}"
-}
-
-runme "$@"

blue_sandbox/.abcli/tests/microsoft_building_damage_assessment_ingest.sh

@@ -1,13 +0,0 @@
-#! /usr/bin/env bash
-
-function test_blue_sandbox_microsoft_building_damage_assessment_ingest() {
-    local options=$1
-
-    abcli_eval ,$options \
-        blue_sandbox_microsoft_building_damage_assessment \
-        ingest \
-        event=Maui-Hawaii-fires-Aug-23,~upload,$options \
-        test_blue_sandbox_microsoft_building_damage_assessment_ingest-$(abcli_string_timestamp_short) \
-        --verbose 1 \
-        "${@:2}"
-}

blue_sandbox/.abcli/tests/microsoft_building_damage_assessment_ingest_list.sh

@@ -1,19 +0,0 @@
-#! /usr/bin/env bash
-
-function test_blue_sandbox_microsoft_building_damage_assessment_ingest_list() {
-    local options=$1
-
-    abcli_eval ,$options \
-        blue_sandbox_microsoft_building_damage_assessment_ingest list
-    [[ $? -ne 0 ]] && return 1
-
-    abcli_eval ,$options \
-        blue_sandbox_microsoft_building_damage_assessment_ingest list \
-        event=Maui-Hawaii-fires-Aug-23
-    [[ $? -ne 0 ]] && return 1
-
-    abcli_eval ,$options \
-        blue_sandbox_microsoft_building_damage_assessment_ingest list \
-        event=Maui-Hawaii-fires-Aug-23 \
-        04/
-}

blue_sandbox/.abcli/tests/microsoft_building_damage_assessment_label.sh

@@ -1,12 +0,0 @@
-#! /usr/bin/env bash
-
-function test_blue_sandbox_microsoft_building_damage_assessment_label() {
-    local options=$1
-
-    abcli_eval ,$options \
-        blue_sandbox_microsoft_building_damage_assessment \
-        label \
-        ~upload,$options \
-        $DAMAGES_TEST_DATASET_OBJECT_NAME \
-        "${@:2}"
-}

blue_sandbox/.abcli/tests/microsoft_building_damage_assessment_train.sh

@@ -1,20 +0,0 @@
-#! /usr/bin/env bash
-
-function test_blue_sandbox_microsoft_building_damage_assessment_train() {
-    local options=$1
-
-    abcli_log_warning "disabled."
-    return 0
-
-    abcli_eval ,$options \
-        blue_sandbox_microsoft_building_damage_assessment \
-        train \
-        ~upload,$options \
-        $DAMAGES_TEST_DATASET_OBJECT_NAME \
-        test_blue_sandbox_microsoft_building_damage_assessment_train-$(abcli_string_timestamp_short) \
-        --verbose 1 \
-        "${@:2}"
-
-    # ignore error - TODO: disable
-    return 0
-}

blue_sandbox/.abcli/tests/sagesemseg_train.sh

@@ -1,29 +0,0 @@
-#! /usr/bin/env bash
-
-function test_blue_sandbox_cemetery_sagesemseg_train() {
-    local options=$1
-    local do_dryrun=$(abcli_option_int "$options" dryrun 0)
-
-    abcli_log_warning "🚧 may incur cost 💰, disabled."
-    do_dryrun=1
-
-    local dataset_object_name=dataset-$(abcli_string_timestamp)
-
-    abcli_eval dryrun=$do_dryrun \
-        roofai_dataset_ingest \
-        source=AIRS,target=sagemaker,$2 \
-        $dataset_object_name \
-        --test_count 0 \
-        --train_count 16 \
-        --val_count 16
-
-    local model_object_name=model-$(abcli_string_timestamp)
-
-    abcli_eval dryrun=$do_dryrun \
-        blue_sandbox_cemetery_sagesemseg_train \
-        ,$3 \
-        $dataset_object_name \
-        $model_object_name \
-        --instance_type ml.g4dn.2xlarge \
-        "${@:4}"
-}

blue_sandbox/list.py

@@ -1,37 +0,0 @@
-list_of_experiments = {
-    "palisades": {
-        "ICON": "🧑🏽‍🚒",
-        "title": "Geospatial AI for Post-Disaster Damage Assessment using Maxar Open Data.",
-        "url": "https://github.com/kamangir/palisades",
-        "marquee": "https://github.com/kamangir/assets/blob/main/palisades/predict-datacube-maxar_open_data-WildFires-LosAngeles-Jan-2025-11-031311102213-103001010B9A1B00-2025-01-20-x54yb0/640.gif?raw=true",
-        "status": "🎓",
-    },
-    "sagesemseg": {
-        "ICON": "🌀",
-        "title": "A SemSeg (Semantic Segmenter) trained and deployed on AWS Sagemaker.",
-        "url": "https://github.com/kamangir/blue-sandbox/blob/main/blue_sandbox/sagesemseg/README.md",
-        "marquee": "https://github.com/kamangir/assets/blob/main/blue-sandbox/sagesemseg-predict.png?raw=true",
-        "status": "⏸️",
-    },
-    "`@damages`": {
-        "ICON": "🌐",
-        "title": "Satellite imagery damage assessment workflow",
-        "url": "https://github.com/kamangir/blue-sandbox/blob/main/blue_sandbox/microsoft_building_damage_assessment/README.md",
-        "marquee": "https://github.com/kamangir/assets/raw/main/blue-sandbox/Maui-Hawaii-fires-Aug-23-ingest-2025-01-10-qqJqhm.png?raw=true",
-        "status": "⏸️",
-    },
-    "cemetery": {
-        "ICON": "🪦",
-        "title": "An AI cemetery.",
-        "url": "https://github.com/kamangir/blue-sandbox/blob/main/blue_sandbox/cemetery/README.md",
-        "marquee": "https://github.com/kamangir/assets/raw/main/blue-plugin/marquee.png?raw=true",
-        "status": "🪦",
-    },
-    "template": {
-        "ICON": "",
-        "title": "",
-        "url": "",
-        "marquee": "https://github.com/kamangir/assets/raw/main/blue-plugin/marquee.png?raw=true",
-        "status": "🎰",
-    },
-}

blue_sandbox/microsoft_building_damage_assessment/README.py

@@ -1,45 +0,0 @@
-from typing import Dict
-
-from blue_sandbox.env import DAMAGES_TEST_DATASET_OBJECT_NAME
-
-list_of_steps: Dict[str, Dict] = {
-    "ingest": {
-        "object_name": DAMAGES_TEST_DATASET_OBJECT_NAME,
-        "image_name": "Maui-Hawaii-fires-Aug-23-damage-2025-01-09-GgnjQC",
-    },
-    "label": {
-        "object_name": "",
-        "image_name": DAMAGES_TEST_DATASET_OBJECT_NAME,
-    },
-    "train": {
-        "object_name": "",
-        "image_name": "Maui-Hawaii-fires-Aug-23-model-2025-01-10-NQb8IS",
-    },
-    "predict": {"object_name": "", "image_name": ""},
-    "summarize": {"object_name": "", "image_name": ""},
-}
-
-items = (
-    [f"`{step}`" for step in list_of_steps]
-    + [
-        (
-            "[`{}`](https://kamangir-public.s3.ca-central-1.amazonaws.com/{}.tar.gz)".format(
-                step["object_name"],
-                step["image_name"],
-            )
-            if step["object_name"]
-            else ""
-        )
-        for step in list_of_steps.values()
-    ]
-    + [
-        (
-            "![image](https://github.com/kamangir/assets/blob/main/blue-sandbox/{}.png?raw=true)".format(
-                step["image_name"],
-            )
-            if step["image_name"]
-            else ""
-        )
-        for step in list_of_steps.values()
-    ]
-)

blue_sandbox/microsoft_building_damage_assessment/__main__.py

@@ -1,82 +0,0 @@
-import argparse
-
-from blueness import module
-from blueness.argparse.generic import sys_exit
-
-from blue_sandbox import NAME
-from blue_sandbox.microsoft_building_damage_assessment.ingest import ingest
-from blue_sandbox.microsoft_building_damage_assessment.label import label
-from blue_sandbox.microsoft_building_damage_assessment.train import train
-from blue_sandbox.microsoft_building_damage_assessment.sas_token import (
-    decode_token,
-    encode_token,
-)
-from blue_sandbox.help.microsoft_building_damage_assessment import list_of_events
-from blue_sandbox.logger import logger
-
-NAME = module.name(__file__, NAME)
-
-parser = argparse.ArgumentParser(NAME)
-parser.add_argument(
-    "task",
-    type=str,
-    help="decode_token | encode_token | ingest | label | train",
-)
-parser.add_argument(
-    "--object_name",
-    type=str,
-)
-parser.add_argument(
-    "--dataset_object_name",
-    type=str,
-)
-parser.add_argument(
-    "--model_object_name",
-    type=str,
-)
-parser.add_argument(
-    "--event_name",
-    type=str,
-    default=list_of_events[0],
-    help=" | ".join(list_of_events),
-)
-parser.add_argument(
-    "--verbose",
-    type=bool,
-    default=0,
-    help="0|1",
-)
-parser.add_argument(
-    "--token",
-    type=str,
-)
-args = parser.parse_args()
-
-success = False
-if args.task == "decode_token":
-    success = True
-    print(decode_token(args.token))
-elif args.task == "encode_token":
-    success = True
-    print(encode_token(args.token))
-elif args.task == "ingest":
-    success = ingest(
-        object_name=args.object_name,
-        event_name=args.event_name,
-        verbose=args.verbose == 1,
-    )
-elif args.task == "label":
-    success = label(
-        object_name=args.object_name,
-        verbose=args.verbose == 1,
-    )
-elif args.task == "train":
-    success = train(
-        dataset_object_name=args.dataset_object_name,
-        model_object_name=args.model_object_name,
-        verbose=args.verbose == 1,
-    )
-else:
-    success = None
-
-sys_exit(logger, NAME, args.task, success)

blue_sandbox/microsoft_building_damage_assessment/ingest.py

@@ -1,31 +0,0 @@
-from blueness import module
-
-from blue_objects import mlflow, metadata
-
-from blue_sandbox import NAME
-from blue_sandbox.logger import logger
-
-
-NAME = module.name(__file__, NAME)
-
-
-def ingest(
-    event_name: str,
-    object_name: str,
-    verbose: bool = False,
-) -> bool:
-    logger.info(f"{NAME}.ingest({event_name}) -> {object_name}")
-
-    return all(
-        [
-            mlflow.set_tags(
-                object_name,
-                {"event": event_name},
-            ),
-            metadata.post_to_object(
-                object_name,
-                "ingest",
-                {"event": event_name},
-            ),
-        ]
-    )

blue_sandbox/microsoft_building_damage_assessment/label.py

@@ -1,38 +0,0 @@
-import os
-
-from blueness import module
-from blue_objects import metadata, file, objects
-from blue_objects.env import abcli_path_git
-
-from blue_sandbox import NAME
-from blue_sandbox.logger import logger
-
-
-NAME = module.name(__file__, NAME)
-
-
-def label(
-    object_name: str,
-    verbose: bool = False,
-) -> bool:
-    logger.info(f"{NAME}.label: {object_name}")
-
-    geojson_filename = os.path.join(
-        abcli_path_git,
-        "building-damage-assessment/data/demo/labels/Maui_Wildfires_August_0.geojson",
-    )
-
-    if not file.copy(
-        geojson_filename,
-        objects.path_of(
-            filename="label.geojson",
-            object_name=object_name,
-        ),
-    ):
-        return False
-
-    return metadata.post_to_object(
-        object_name,
-        "label",
-        {"geojson": geojson_filename},
-    )

blue_sandbox/microsoft_building_damage_assessment/sas_token.py

@@ -1,9 +0,0 @@
-import base64
-
-
-def encode_token(token: str) -> str:
-    return base64.b64encode(token.encode()).decode()
-
-
-def decode_token(encoded_token: str) -> str:
-    return base64.b64decode(encoded_token.encode()).decode()