synapse-sdk 1.0.0a11__py3-none-any.whl → 2026.1.1b2__py3-none-any.whl

synapse_sdk/plugins/categories/smart_tool/actions/auto_label.py

@@ -1,37 +0,0 @@
-from synapse_sdk.plugins.categories.base import Action
-from synapse_sdk.plugins.categories.decorators import register_action
-from synapse_sdk.plugins.enums import PluginCategory, RunMethod
-from synapse_sdk.plugins.exceptions import ActionError
-from synapse_sdk.plugins.utils import get_action
-
-
-@register_action
-class AutoLabelAction(Action):
-    name = 'auto_label'
-    category = PluginCategory.SMART_TOOL
-    method = RunMethod.TASK
-
-    def get_auto_label(self):
-        return self.entrypoint(**self.params)
-
-    def run_model(self, input_data):
-        try:
-            action = get_action(
-                'inference',
-                input_data,
-                config={
-                    'category': 'neural_net',
-                    'code': self.params['plugin'],
-                    'version': self.params['version'],
-                    'actions': {'inference': {'method': input_data['method']}},
-                },
-            )
-            return action.run_action()
-        except ActionError as e:
-            raise Exception(e.errors)
-
-    def start(self):
-        auto_label = self.get_auto_label()
-        input_data = auto_label.handle_input(self.params)
-        output_data = self.run_model(input_data)
-        return auto_label.handle_output(output_data)

synapse_sdk/plugins/categories/smart_tool/templates/config.yaml

@@ -1,7 +0,0 @@
-smart_tool: interactive_segmentation
-actions:
-  auto_label:
-    category: interactive_segmentation
-    entrypoint: plugin.auto_label.MyAutoLabel
-    model:
-      neural_nets: [sam2]

synapse_sdk/plugins/categories/smart_tool/templates/plugin/auto_label.py

@@ -1,11 +0,0 @@
-class MyAutoLabel:
-    def __init__(self, **kwargs):
-        pass
-
-    def handle_input(self, input_data):
-        """smart tool의 input을 model의 input 형태로 변환"""
-        return
-
-    def handle_output(self, output_data):
-        """model의 output을 smart tool의 output 형태로 변환"""
-        return

synapse_sdk/plugins/categories/templates.py

@@ -1,32 +0,0 @@
-import shutil
-from pathlib import Path
-
-import yaml
-
-
-def copy_project_category_template(category):
-    copy_plugin(category)
-    merge_config(category)
-
-
-def copy_plugin(category):
-    template_path = Path(__file__).parent / category / 'templates' / 'plugin'
-    if not template_path.exists():
-        return
-
-    output_path = Path('plugin')
-    shutil.copytree(template_path, output_path, dirs_exist_ok=True)
-
-
-def merge_config(category):
-    config_path = Path(__file__).parent / category / 'templates' / 'config.yaml'
-    if not config_path.exists():
-        return
-
-    config_base_path = Path('config.yaml')
-
-    config_base = yaml.safe_load(config_base_path.read_text(encoding='utf-8'))
-    config = yaml.safe_load(config_path.read_text(encoding='utf-8'))
-
-    config_base.update(config)
-    config_base_path.write_text(yaml.dump(config_base, sort_keys=False), encoding='utf-8')

synapse_sdk/plugins/cli/__init__.py

@@ -1,21 +0,0 @@
-import click
-
-from synapse_sdk.i18n import gettext as _
-
-from .publish import publish
-from .run import run
-
-
-@click.group()
-@click.option('--debug/--no-debug', default=False)
-@click.pass_context
-def cli(ctx, debug):
-    ctx.ensure_object(dict)
-    ctx.obj['DEBUG'] = debug
-
-    if debug:
-        click.echo(_('Debug mode is "on"'))
-
-
-cli.add_command(run)
-cli.add_command(publish)

synapse_sdk/plugins/cli/publish.py

@@ -1,37 +0,0 @@
-import json
-from pathlib import Path
-
-import click
-
-from synapse_sdk.clients.backend import BackendClient
-from synapse_sdk.i18n import gettext as _
-from synapse_sdk.plugins.models import PluginRelease
-from synapse_sdk.plugins.upload import archive
-
-
-@click.command()
-@click.option('--host', required=True)
-@click.option('--user_token', required=True)
-@click.option('--tenant', required=True)
-@click.option('--debug_modules', default='', envvar='SYNAPSE_DEBUG_MODULES')
-@click.pass_context
-def publish(ctx, host, user_token, tenant, debug_modules):
-    debug = ctx.obj['DEBUG']
-
-    plugin_release = PluginRelease()
-
-    source_path = Path('./')
-    archive_path = source_path / 'dist' / 'archive.zip'
-    archive(source_path, archive_path)
-
-    data = {'plugin': plugin_release.plugin, 'file': str(archive_path), 'debug': debug}
-    if debug:
-        data['debug_meta'] = json.dumps({'modules': debug_modules.split(',')})
-
-    client = BackendClient(host, user_token, tenant=tenant)
-    client.create_plugin_release(data)
-    click.secho(
-        _('Successfully published "{}" ({}) to synapse backend!').format(plugin_release.name, plugin_release.code),
-        fg='green',
-        bold=True,
-    )

synapse_sdk/plugins/cli/run.py

@@ -1,67 +0,0 @@
-import os
-
-import click
-
-from synapse_sdk.clients.agent import AgentClient
-from synapse_sdk.clients.backend import BackendClient
-from synapse_sdk.plugins.models import PluginRelease
-from synapse_sdk.plugins.utils import get_action
-
-
-@click.command()
-@click.argument('action')
-@click.argument('params')
-@click.option('--job-id')
-@click.option('--direct/--no-direct', default=False)
-@click.option('--run-by', type=click.Choice(['script', 'agent', 'backend']), default='script')
-@click.option('--agent-host')
-@click.option('--agent-token')
-@click.option('--host')
-@click.option('--agent')
-@click.option('--user-token')
-@click.option('--tenant')
-@click.pass_context
-def run(ctx, action, params, job_id, direct, run_by, agent_host, agent_token, host, agent, user_token, tenant):
-    debug = ctx.obj['DEBUG']
-
-    if run_by == 'script':
-        run_by_script(action, params, job_id, direct, debug)
-    elif run_by == 'agent':
-        run_by_agent(action, params, job_id, agent_host, agent_token, user_token, tenant, debug)
-    elif run_by == 'backend':
-        run_by_backend(action, params, agent, host, user_token, tenant)
-
-
-def run_by_script(action, params, job_id, direct, debug):
-    action = get_action(action, params, job_id=job_id, direct=direct, debug=debug)
-    result = action.run_action()
-
-    if debug:
-        click.echo(result)
-
-
-def run_by_agent(action, params, job_id, agent_host, agent_token, user_token, tenant, debug):
-    client = AgentClient(agent_host, agent_token, user_token, tenant)
-    data = {'action': action, 'params': params}
-    if job_id:
-        data['job_id'] = job_id
-    if debug:
-        data.update({
-            'plugin_path': os.getcwd(),
-            'modules': os.getenv('SYNAPSE_DEBUG_MODULES', '').split(','),
-        })
-        result = client.run_debug_plugin_release(data=data)
-    else:
-        plugin_release = PluginRelease()
-        result = client.run_plugin_release(code=plugin_release.code, data=data)
-
-    click.echo(result)
-
-
-def run_by_backend(action, params, agent, host, user_token, tenant):
-    client = BackendClient(host, user_token, tenant=tenant)
-    plugin_release = PluginRelease()
-    data = {'agent': agent, 'version': plugin_release.version, 'action': action, 'params': params}
-    result = client.run_plugin(plugin_release.plugin, data=data)
-
-    click.echo(result)

synapse_sdk/plugins/exceptions.py

@@ -1,22 +0,0 @@
-class ActionError(Exception):
-    errors = None
-
-    def __init__(self, errors, *args):
-        if isinstance(errors, (str, dict)):
-            self.errors = errors
-        elif isinstance(errors, Exception) and len(errors.args) == 1:
-            self.errors = ActionError(errors.args[0]).errors
-        else:
-            self.errors = str(errors)
-        super().__init__(errors, *args)
-
-    def as_drf_error(self, data=None):
-        if data is None:
-            data = self.errors
-
-        if isinstance(data, list):
-            return data
-        elif isinstance(data, dict):
-            return {key: self.as_drf_error(value) for key, value in data.items()}
-
-        return [str(data)]

synapse_sdk/plugins/models.py

@@ -1,121 +0,0 @@
-import os
-from functools import cached_property
-from typing import Any, Dict
-
-from synapse_sdk.clients.backend import BackendClient
-from synapse_sdk.loggers import BackendLogger, ConsoleLogger
-from synapse_sdk.plugins.utils import read_plugin_config
-from synapse_sdk.shared.enums import Context
-from synapse_sdk.utils.storage import get_storage
-from synapse_sdk.utils.string import hash_text
-
-
-class PluginRelease:
-    config: Dict[str, Any]
-    envs = None
-
-    def __init__(self, config=None, plugin_path=None, envs=None):
-        if config:
-            self.config = config
-        else:
-            self.config = read_plugin_config(plugin_path=plugin_path)
-        self.envs = envs
-
-    @cached_property
-    def plugin(self):
-        return self.config['code']
-
-    @cached_property
-    def version(self):
-        return self.config['version']
-
-    @cached_property
-    def code(self):
-        return f'{self.plugin}@{self.version}'
-
-    @cached_property
-    def category(self):
-        return self.config['category']
-
-    @cached_property
-    def name(self):
-        return self.config['name']
-
-    @cached_property
-    def checksum(self):
-        return hash_text(self.code)
-
-    @cached_property
-    def actions(self):
-        return list(self.config['actions'].keys())
-
-    def setup_runtime_env(self):
-        import ray
-        from ray.util.scheduling_strategies import NodeAffinitySchedulingStrategy
-        from ray.util.state import list_nodes
-
-        @ray.remote
-        def warm_up():
-            pass
-
-        nodes = list_nodes(address=self.envs['RAY_DASHBOARD_URL'])
-        node_ids = [n['node_id'] for n in nodes]
-        for node_id in node_ids:
-            strategy = NodeAffinitySchedulingStrategy(node_id=node_id, soft=False)
-
-            warm_up.options(
-                runtime_env={
-                    'pip': ['-r ${RAY_RUNTIME_ENV_CREATE_WORKING_DIR}/requirements.txt'],
-                    'working_dir': self.get_url(self.envs['SYNAPSE_PLUGIN_STORAGE']),
-                },
-                scheduling_strategy=strategy,
-            ).remote()
-
-    def get_action_config(self, action):
-        return self.config['actions'][action]
-
-    def get_url(self, storage_url):
-        storage = get_storage(storage_url)
-        return storage.get_url(f'{self.checksum}.zip')
-
-    def get_serve_url(self, serve_address, path):
-        return os.path.join(serve_address, self.checksum, path)
-
-
-class Run:
-    logger = None
-    job_id = None
-    context = None
-
-    def __init__(self, job_id, context):
-        self.job_id = job_id
-        self.context = context
-        self.set_logger()
-
-    def set_logger(self):
-        kwargs = {'progress_categories': self.context['progress_categories']}
-        if self.job_id:
-            client = BackendClient(
-                self.context['envs']['SYNAPSE_PLUGIN_RUN_HOST'],
-                self.context['envs']['SYNAPSE_PLUGIN_RUN_USER_TOKEN'],
-                self.context['envs']['SYNAPSE_PLUGIN_RUN_TENANT'],
-            )
-            self.logger = BackendLogger(client, self.job_id, **kwargs)
-        else:
-            self.logger = ConsoleLogger(**kwargs)
-
-    @property
-    def client(self):
-        return getattr(self.logger, 'client', None)
-
-    def set_progress(self, current, total, category=''):
-        self.logger.set_progress(current, total, category)
-
-    def log(self, event, data):
-        self.logger.log(event, data)
-
-    def log_message(self, message, context=Context.INFO.value):
-        self.logger.log('message', {'context': context, 'content': message})
-
-    def end_log(self):
-        self.log_message('Plugin run is complete.')

synapse_sdk/plugins/templates/cookiecutter.json

@@ -1,11 +0,0 @@
-{
-  "category": null,
-  "plugin_name": null,
-  "plugin_code": "{{ cookiecutter.plugin_name.lower().replace(' ', '-') }}",
-  "version": "0.1.0",
-  "description": "This is {{ cookiecutter.plugin_name }} plugin",
-  "__prompts__": {
-    "project_name": "Plugin name",
-    "project_slug": "Unique identifier of your plugin. Lowercase letters, numbers, and hyphens only (e.g., 'my-plugin-name')"
-  }
-}

synapse_sdk/plugins/templates/hooks/post_gen_project.py

@@ -1,3 +0,0 @@
-from synapse_sdk.plugins.categories.templates import copy_project_category_template
-
-copy_project_category_template('{{ cookiecutter.category }}')

synapse_sdk/plugins/templates/hooks/pre_prompt.py

@@ -1,21 +0,0 @@
-import json
-from pathlib import Path
-
-from synapse_sdk.plugins.utils import get_plugin_categories
-from synapse_sdk.utils.file import get_dict_from_file
-
-
-def update_config(config):
-    config['category'] = get_plugin_categories()
-    return config
-
-
-def main():
-    cookiecutter_path = Path('cookiecutter.json')
-    config = get_dict_from_file(cookiecutter_path)
-    config = update_config(config)
-    cookiecutter_path.write_text(json.dumps(config, indent=4, ensure_ascii=False), encoding='utf-8')
-
-
-if __name__ == '__main__':
-    main()

synapse_sdk/plugins/templates/synapse-{{cookiecutter.plugin_code}}-plugin/.env

@@ -1,24 +0,0 @@
-# RAY 관련
-RAY_ADDRESS=
-RAY_DASHBOARD_ADDRESS=
-RAY_SERVE_ADDRESS=
-
-# 플러그인 관련
-SYNAPSE_PLUGIN_STORAGE=
-
-# 플러그인 디버그 관련
-SYNAPSE_DEBUG_PLUGIN_PATH=
-SYNAPSE_DEBUG_MODULES=
-
-# 플러그인 PUBLISH 관련
-SYNAPSE_PLUGIN_PUBLISH_HOST=https://synapse.datamaker.io
-SYNAPSE_PLUGIN_PUBLISH_USER_TOKEN=
-SYNAPSE_PLUGIN_PUBLISH_TENANT=
-
-# 플러그인 RUN 관련
-SYNAPSE_PLUGIN_RUN_HOST=
-SYNAPSE_PLUGIN_RUN_AGENT=
-SYNAPSE_PLUGIN_RUN_AGENT_HOST=
-SYNAPSE_PLUGIN_RUN_AGENT_TOKEN=
-SYNAPSE_PLUGIN_RUN_USER_TOKEN=
-SYNAPSE_PLUGIN_RUN_TENANT=

synapse_sdk/plugins/templates/synapse-{{cookiecutter.plugin_code}}-plugin/.env.dist

@@ -1,24 +0,0 @@
-# RAY 관련
-RAY_ADDRESS=
-RAY_DASHBOARD_ADDRESS=
-RAY_SERVE_ADDRESS=
-
-# 플러그인 관련
-SYNAPSE_PLUGIN_STORAGE=
-
-# 플러그인 디버그 관련
-SYNAPSE_DEBUG_PLUGIN_PATH=
-SYNAPSE_DEBUG_MODULES=
-
-# 플러그인 PUBLISH 관련
-SYNAPSE_PLUGIN_PUBLISH_HOST=https://synapse.datamaker.io
-SYNAPSE_PLUGIN_PUBLISH_USER_TOKEN=
-SYNAPSE_PLUGIN_PUBLISH_TENANT=
-
-# 플러그인 RUN 관련
-SYNAPSE_PLUGIN_RUN_HOST=
-SYNAPSE_PLUGIN_RUN_AGENT=
-SYNAPSE_PLUGIN_RUN_AGENT_HOST=
-SYNAPSE_PLUGIN_RUN_AGENT_TOKEN=
-SYNAPSE_PLUGIN_RUN_USER_TOKEN=
-SYNAPSE_PLUGIN_RUN_TENANT=

synapse_sdk/plugins/templates/synapse-{{cookiecutter.plugin_code}}-plugin/.gitignore

@@ -1,27 +0,0 @@
-### Example user template template
-# virtualenv
-.venv
-
-# idea
-.DS_Store
-*.pyc
-.idea
-*.iml
-
-# http
-/http/
-
-# general things to ignore
-build/
-dist/
-*.egg-info/
-*.egg
-*.py[cod]
-__pycache__/
-*.so
-*~
-.env
-
-# due to using tox and pytest
-.tox
-.cache

synapse_sdk/plugins/templates/synapse-{{cookiecutter.plugin_code}}-plugin/.pre-commit-config.yaml

@@ -1,7 +0,0 @@
-repos:
-  - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.7.1
-    hooks:
-      - id: ruff
-        args: [ --fix ]
-      - id: ruff-format

synapse_sdk/plugins/templates/synapse-{{cookiecutter.plugin_code}}-plugin/README.md

@@ -1,5 +0,0 @@
-# 실행방법
-
-```bash
-$ python main.py run --help
-```

synapse_sdk/plugins/templates/synapse-{{cookiecutter.plugin_code}}-plugin/config.yaml

@@ -1,6 +0,0 @@
-name: {{ cookiecutter.plugin_name }}
-code: {{ cookiecutter.plugin_code }}
-version: {{ cookiecutter.version }}
-readme: README.md
-description: {{ cookiecutter.description }}
-category: {{ cookiecutter.category }}

synapse_sdk/plugins/templates/synapse-{{cookiecutter.plugin_code}}-plugin/main.py

@@ -1,4 +0,0 @@
-from synapse_sdk import plugins
-
-if __name__ == '__main__':
-    plugins.init()

synapse_sdk/plugins/templates/synapse-{{cookiecutter.plugin_code}}-plugin/pyproject.toml

@@ -1,13 +0,0 @@
-[tool.ruff]
-line-length = 120
-
-[tool.ruff.lint]
-select = ['E', 'F', 'I', 'Q']
-ignore = ['W191', 'E111', 'E114', 'E117', 'D206', 'D300', 'Q000', 'Q001', 'Q002', 'Q003', 'COM812', 'COM819', 'ISC001', 'ISC002']
-
-[tool.ruff.lint.pydocstyle]
-convention = 'google'
-
-[tool.ruff.format]
-quote-style = 'single'
-preview = true

synapse_sdk/plugins/templates/synapse-{{cookiecutter.plugin_code}}-plugin/requirements.txt

@@ -1 +0,0 @@
-synapse-sdk[all]

synapse_sdk/shared/enums.py

@@ -1,8 +0,0 @@
-from enum import Enum
-
-
-class Context(str, Enum):
-    INFO = 'info'
-    SUCCESS = 'success'
-    WARNING = 'warning'
-    DANGER = 'danger'

synapse_sdk/utils/debug.py

@@ -1,5 +0,0 @@
-from synapse_sdk.i18n import gettext as _
-
-
-def get_message():
-    return _('hello world from sdk')

synapse_sdk/utils/file.py

@@ -1,87 +0,0 @@
-import hashlib
-import json
-import operator
-import zipfile
-from functools import reduce
-from pathlib import Path
-from urllib.parse import urlparse
-
-import requests
-import yaml
-
-
-def download_file(url, path_download, name=None, coerce=None):
-    if name:
-        name += Path(url).suffix
-    else:
-        name = Path(url).name
-
-    name = urlparse(name).path
-    path = Path(path_download) / name
-    if not path.is_file():
-        r = requests.get(url, allow_redirects=True)
-        open(str(path), 'wb').write(r.content)
-
-    if coerce:
-        path = coerce(path)
-
-    return path
-
-
-def files_url_to_path(files, coerce=None):
-    path_download = Path('/tmp/datamaker') / 'media'
-    path_download.mkdir(parents=True, exist_ok=True)
-    for file_name in files:
-        if isinstance(files[file_name], str):
-            files[file_name] = download_file(files[file_name], path_download, coerce=coerce)
-        else:
-            files[file_name]['path'] = download_file(files[file_name].pop('url'), path_download, coerce=coerce)
-
-
-def files_url_to_path_from_objs(objs, files_fields, coerce=None, is_list=False):
-    if not is_list:
-        objs = [objs]
-
-    for obj in objs:
-        for files_field in files_fields:
-            try:
-                files = reduce(operator.getitem, files_field.split('.'), obj)
-                files_url_to_path(files, coerce=coerce)
-            except KeyError:
-                pass
-
-
-def get_dict_from_file(file_path):
-    if isinstance(file_path, str):
-        file_path = Path(file_path)
-
-    with open(file_path) as f:
-        if file_path.suffix == '.yaml':
-            return yaml.safe_load(f)
-        else:
-            return json.load(f)
-
-
-def calculate_checksum(file_path, prefix=''):
-    md5_hash = hashlib.md5()
-    with open(file_path, 'rb') as f:
-        for byte_block in iter(lambda: f.read(4096), b''):
-            md5_hash.update(byte_block)
-    checksum = md5_hash.hexdigest()
-    if prefix:
-        return f'dev-{checksum}'
-    return checksum
-
-
-def archive(input_path, output_path):
-    input_path = Path(input_path)
-    output_path = Path(output_path)
-
-    with zipfile.ZipFile(output_path, mode='w', compression=zipfile.ZIP_DEFLATED) as zipf:
-        if input_path.is_file():
-            zipf.write(input_path, input_path.name)
-        else:
-            for file_path in input_path.rglob('*'):
-                if file_path.is_file():  # Only add files, skip directories
-                    arcname = file_path.relative_to(input_path.parent)
-                    zipf.write(file_path, arcname)

synapse_sdk/utils/module_loading.py

@@ -1,29 +0,0 @@
-import sys
-from importlib import import_module
-
-
-def cached_import(module_path, class_name):
-    # Check whether module is loaded and fully initialized.
-    if not (
-        (module := sys.modules.get(module_path))
-        and (spec := getattr(module, '__spec__', None))
-        and getattr(spec, '_initializing', False) is False
-    ):
-        module = import_module(module_path)
-    return getattr(module, class_name)
-
-
-def import_string(dotted_path):
-    """
-    Import a dotted module path and return the attribute/class designated by the
-    last name in the path. Raise ImportError if the import failed.
-    """
-    try:
-        module_path, class_name = dotted_path.rsplit('.', 1)
-    except ValueError as err:
-        raise ImportError("%s doesn't look like a module path" % dotted_path) from err
-
-    try:
-        return cached_import(module_path, class_name)
-    except AttributeError as err:
-        raise ImportError('Module "%s" does not define a "%s" attribute/class' % (module_path, class_name)) from err

synapse_sdk/utils/pydantic/config.py

@@ -1,4 +0,0 @@
-ERROR_MESSAGES = {
-    'missing': '필수 값을 확인해주세요.',
-    'blank': '필수 값을 확인해주세요.',
-}