scp-app-sdk 1.4.0

SCP APP SDK

SCP APP SDK

Software Development Kit for the SCP APP store. It provides schemas, functions, documentation and the CLI for the APP store.

You can find more documentation here: https://doc.chefhub.smartflowagent.net

Install SCP-APP SDK

Create a venv

mkdir scp-app
cd scp-app
python3 -m venv venv
source venv/bin/activate

Install from test pypi repository

You can install dev versions from test.pypi.org as follows:

pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple scp-app-sdk

To test a specific version you can proceed as follows:

pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple scp-app-sdk==1.3.0.dev1756813301

Install from pypi repository

To install the latest version from the pypi repository you can proceed as follows:

pip install scp-app-sdk

To install a specific version you can proceed as follows:

pip install scp-app-sdk==1.4.0

Use the scp-app cli tool

Discover the scp-app cli tool

When the package is installed, just type 'scp-app' to get the help menu of the CLI.

Usage: scp-app [OPTIONS] COMMAND [ARGS]...

  🚀 SCP APP CLI – Your assistant to create, build, test, and publish SCP Apps.

  Configure SCP APP CLI:
      scp-app configure               → Configure default value to use.

  Typical workflow:
      scp-app create                  → Start a new SCP App project.
      scp-app validate                → Verify your app meets SCP standards.
      scp-app run                     → Run your app locally for testing.
      scp-app build /your/app/dir     → Compile & bundle your app.
      scp-app publish /dir/app.sap    → Release your app to the SCP store.

  Get help:
      scp-app create help             → Get help on creating an app.
      scp-app validate help           → Get help on validating an app.
      scp-app build help              → Get help on building an app.
      scp-app run help                → Get help on running an app.
      scp-app publish help            → Get help on publishing an app.

  For more information, you can refer to the documentation at:
  👉 https://doc.chefhub.smartflowagent.net/apps/cli

Options:
  --help  Show this message and exit.

Commands:
  build      Build the SCP APP
  configure  Interactive configuration for SCP App.
  create     Create a new SCP APP
  publish    Publish your SCP APP build
  run        Execute and run apt script
  validate   Check if the SCP APP is valid

Configure the CLI

Create your application

Follow the prompts from the tool in order to create your app.

scp-app create

Your app will be generated in your chosen directory.

Validate your application

You can check if your app structure is valid by using the validate command and the path of your app.

scp-app validate /tmp/test

Run your application

You can check your app scripts are valid by using the run command.

# To run the install script
scp-app run install /tmp/test

# To run the uninstall script
scp-app run uninstall /tmp/test

# To run the migrate script
scp-app run migrate /tmp/test

Build your application

Once your application is validated and the scripts run without errors, you can create the build.

scp-app validate /tmp/test

It will build a '.sap' file in your app directory. For example, for /tmp/test directory, it will be something like: /tmp/test/build/test-0.1.0.sap

Publish your application

Once your application is built into a .sap file, you can publish the build on the SCP Appstore.

scp-app publish /tmp/test/build/test-0.1.0.sap

Changelog

All notable changes to this project will be documented here.

[1.4.0] - 2025-09-02

Improved

• Split library into scp-app-lib and scp-app-sdk, keeping only the SDK in this package (SFD-102)
• Improved SDK CLI code (SFD-99)

[1.3.0] - 2025-08-05

Added

• Support for UI plugins.

[1.2.1] - 2025-07-09

Fixed

• Script could not be executed (FMG-3876).

[1.2.0] - 2025-05-07

Improved

• Document the route that updates app configuration (FMG-3675).

[1.1.0] - 2025-04-18

Added

• env parameter in create CLI command (FMG-3376).
• Ability to set app version in manifest.
• Ability to add library in the app.

Improved

• Review source code of build rendering.
• Review manifest generation issue with CLI.
• Improve docs for non-Python developers.
• Update README with detailed app creation/configuration instructions.
• Add input parameter to run_uninstall function.

Fixed

• Issue retrieving template in CLI.
• Packaging issue with templating.
• API key not sent when publishing a new app.
• Git version check.
• Uninstall script execution by adding input parameter.

[1.0.0] - 2025-02-05

Added

• Validation schema for apps, builds, user apps, and app manifests (Marshmallow).
• API documentation of APP store (Tornado).
• CLI to manage apps — create, validate, build, and publish.
• Library to manage APP manifest.
• Library to manage CSFE.
• Library to validate manifest, apps, and runners.
• Library to manage builds.
• Icon support.