insoundz-cli


Nameinsoundz-cli JSON
Version 0.1.21 PyPI version JSON
download
home_pagehttps://github.com/InSoundz/insoundz-api
SummaryA simple CLI which is used to give the client an easy and fast access to insoundz API.
upload_time2024-03-28 13:29:35
maintainerNone
docs_urlNone
authorNone
requires_python>=3.7
licenseMIT
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <h1><img align="center" height="90" src="https://drive.google.com/uc?export=view&id=1b1DHDNsl_XGjtU_AK1QR9q_lSo3iLQ4x"> &nbsp; insoundz-cli Package</h1>
A simple CLI which is used to give the client an easy and fast access to insoundz API.
<br />
<br />

![PyPI](https://img.shields.io/pypi/v/insoundz-cli)
![PyPI - License](https://img.shields.io/pypi/l/insoundz-cli)
![PyPI - OS](https://img.shields.io/badge/Operating%20System-OS%20Independent-green)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/insoundz-cli)

## Installation
To enable the auto-complete support, you will have to pip install from source and not from wheel.
```console
pip install --no-binary insoundz-cli insoundz-cli
```
Otherwise, you can just run:
```console
pip install insoundz-cli
```
NOTE: Please make sure you are running python3.7 or later.

## Help
| Command       | Description                   |
|---------------|:------------------------------|
| config        | Set or view config variables. |
| enhance-file  | Enhance audio file.           |

### Command: config

| Sub-command | Description              |
|-------------|:-------------------------|
| get         | Echo config variables.   |
| set         | Update config variables. |

### Sub-command: config get

| Argument | Description | Required | Default |
|--------- |:------------|:---------|:--------|
| None     | None        | None     | None    |

### Sub-command: config set

| Argument    | Description | Required | Default |
|-------------|:------------|:---------|:--------|
| --client-id | Client ID for insoundz API services. If not set, the CLI uses the permanently configured client ID. If set, the CLI will use this client ID only for this session. | None | None |
| --secret    | Secret key to access insoundz API services. If not set, the CLI uses the permanently configured secret key. If set, the CLI will use this secret key only for this session. | None | None |
| --url       | Use an alternative endpoint URL (without the 'http://' prefix). If not set, the CLI uses the permanently configured url. If set, the CLI will use this url only for this session. If not set and not permanently configured, the CLI will use the default url. | None | api.insoundz.io |

### Command: enhance-file 

| Argument        | Description | Required | Default |
|-----------------|:------------|:---------|:--------|
| --client-id       | Client ID for insoundz API services. If not set, the CLI uses the permanently configured client ID. If set, the CLI will use this client ID only for this session. | If not set with config command | None |
| --secret          | Secret key to access insoundz API services. If not set, the CLI uses the permanently configured secret key. If set, the CLI will use this secret key only for this session. | If not set with config command | None |
| --url             | Use an alternative endpoint URL (without the 'http://' prefix). If not set, the CLI uses the permanently configured url. If set, the CLI will use this url only for this session. If not set and not permanently configured, the CLI will use the default url. | No | api.insoundz.io |
| --src             | A local path of the original audio file. | Yes | None |
| --no-download     | If set, the enhanced file won't be downloaded to the local machine (we'll get only the URL of the enhanced file). | No | False|
| --dst             | A local path or file to download the enhanced file. | No | <current_path>/<original_filename>_enhanced.<original_suffix> |
| --retention       | URL Retention duration [minutes]. | No | None |
| --status-interval | Check the enhancement process every <status_interval> [seconds]. | No | 0.5 |
| --no-progress-bar | If set, progress-bar won't be displayed. | No | False |

## Getting started
```console
insoundz_cli <command> <arg1> <arg2> ...
```

### Example #1:
Permanently set client ID and secret key.
```console
insoundz_cli config set --client-id XXXX-XXXX-XXXX-XXXX --secret XXXX-XXXX-XXXX-XXXX
```

### Example #2:
Upload an audio file from our local machine and at the end of the audio enhancement process download the enhanced file to our local machine (to "<current_path>/example_enhanced.wav").
```console
insoundz_cli enhance-file --src="/home/example_user/my_audio_files/example.wav"
```

### Example #3:
Upload an audio file from our local machine and at the end of the audio enhancement process download the enhanced file to our local machine (to "/home/example_user/my_enhanced_files_dir/new_file.wav").
```console
insoundz_cli enhance-file --src="/home/example_user/my_audio_files/example.wav" --dst="/home/example_user/my_enhanced_files_dir/new_file.wav"
```

### Example #4:
Upload an audio file from our local machine and at the end of the audio enhancement process don't download the enhanced files and request to keep the URL of the enhanced file valid for 8 hours.
```console
insoundz_cli enhance-file --src="/home/example_user/my_audio_files/example.wav" --no-download --retention=480
```

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/InSoundz/insoundz-api",
    "name": "insoundz-cli",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.7",
    "maintainer_email": null,
    "keywords": null,
    "author": null,
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/42/44/4364092933bbfaa22e98560aa4e2b93078af00dd18ed14bafd6cdbe5bfab/insoundz_cli-0.1.21.tar.gz",
    "platform": null,
    "description": "<h1><img align=\"center\" height=\"90\" src=\"https://drive.google.com/uc?export=view&id=1b1DHDNsl_XGjtU_AK1QR9q_lSo3iLQ4x\"> &nbsp; insoundz-cli Package</h1>\nA simple CLI which is used to give the client an easy and fast access to insoundz API.\n<br />\n<br />\n\n![PyPI](https://img.shields.io/pypi/v/insoundz-cli)\n![PyPI - License](https://img.shields.io/pypi/l/insoundz-cli)\n![PyPI - OS](https://img.shields.io/badge/Operating%20System-OS%20Independent-green)\n![PyPI - Python Version](https://img.shields.io/pypi/pyversions/insoundz-cli)\n\n## Installation\nTo enable the auto-complete support, you will have to pip install from source and not from wheel.\n```console\npip install --no-binary insoundz-cli insoundz-cli\n```\nOtherwise, you can just run:\n```console\npip install insoundz-cli\n```\nNOTE: Please make sure you are running\u00a0python3.7 or later.\n\n## Help\n| Command       | Description                   |\n|---------------|:------------------------------|\n| config        | Set or view config variables. |\n| enhance-file  | Enhance audio file.           |\n\n### Command: config\n\n| Sub-command | Description              |\n|-------------|:-------------------------|\n| get         | Echo config variables.   |\n| set         | Update config variables. |\n\n### Sub-command: config get\n\n| Argument | Description | Required | Default |\n|--------- |:------------|:---------|:--------|\n| None     | None        | None     | None    |\n\n### Sub-command: config set\n\n| Argument    | Description | Required | Default |\n|-------------|:------------|:---------|:--------|\n| --client-id | Client ID for insoundz API services. If not set, the CLI uses the permanently configured client ID. If set, the CLI will use this client ID only for this session. | None | None |\n| --secret    | Secret key to access insoundz API services. If not set, the CLI uses the permanently configured secret key. If set, the CLI will use this secret key only for this session. | None | None |\n| --url       | Use an alternative endpoint URL (without the 'http://' prefix). If not set, the CLI uses the permanently configured url. If set, the CLI will use this url only for this session. If not set and not permanently configured, the CLI will use the default url. | None | api.insoundz.io |\n\n### Command: enhance-file \n\n| Argument        | Description | Required | Default |\n|-----------------|:------------|:---------|:--------|\n| --client-id       | Client ID for insoundz API services. If not set, the CLI uses the permanently configured client ID. If set, the CLI will use this client ID only for this session. | If not set with config command | None |\n| --secret          | Secret key to access insoundz API services. If not set, the CLI uses the permanently configured secret key. If set, the CLI will use this secret key only for this session. | If not set with config command | None |\n| --url             | Use an alternative endpoint URL (without the 'http://' prefix). If not set, the CLI uses the permanently configured url. If set, the CLI will use this url only for this session. If not set and not permanently configured, the CLI will use the default url. | No | api.insoundz.io |\n| --src             | A local path of the original audio file. | Yes | None |\n| --no-download     | If set, the enhanced file won't be downloaded to the local machine (we'll get only the URL of the enhanced file). | No | False|\n| --dst             | A local path or file to download the enhanced file. | No | <current_path>/<original_filename>_enhanced.<original_suffix> |\n| --retention       | URL Retention duration [minutes]. | No | None |\n| --status-interval | Check the enhancement process every <status_interval> [seconds]. | No | 0.5 |\n| --no-progress-bar | If set, progress-bar won't be displayed. | No | False |\n\n## Getting started\n```console\ninsoundz_cli <command> <arg1> <arg2> ...\n```\n\n### Example #1:\nPermanently set client ID and secret key.\n```console\ninsoundz_cli config set --client-id XXXX-XXXX-XXXX-XXXX --secret XXXX-XXXX-XXXX-XXXX\n```\n\n### Example #2:\nUpload an audio file from our local machine and at the end of the audio enhancement process download the enhanced file to our local machine (to \"<current_path>/example_enhanced.wav\").\n```console\ninsoundz_cli enhance-file --src=\"/home/example_user/my_audio_files/example.wav\"\n```\n\n### Example #3:\nUpload an audio file from our local machine and at the end of the audio enhancement process download the enhanced file to our local machine (to \"/home/example_user/my_enhanced_files_dir/new_file.wav\").\n```console\ninsoundz_cli enhance-file --src=\"/home/example_user/my_audio_files/example.wav\" --dst=\"/home/example_user/my_enhanced_files_dir/new_file.wav\"\n```\n\n### Example #4:\nUpload an audio file from our local machine and at the end of the audio enhancement process don't download the enhanced files and request to keep the URL of the enhanced file valid for 8 hours.\n```console\ninsoundz_cli enhance-file --src=\"/home/example_user/my_audio_files/example.wav\" --no-download --retention=480\n```\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A simple CLI which is used to give the client an easy         and fast access to insoundz API.",
    "version": "0.1.21",
    "project_urls": {
        "Homepage": "https://github.com/InSoundz/insoundz-api",
        "Source Code": "https://github.com/InSoundz/insoundz-api/tree/main/insoundz_cli"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "265613fed1ecff9c56988fc299ab7ced103ff856000be5a8235d0a1f2a08e786",
                "md5": "bb21091d5ed4630e3bf76679169d64ed",
                "sha256": "b847945bad7c2f18318de628d925af49cfaeea49a18044c418d339f22f84d0a9"
            },
            "downloads": -1,
            "filename": "insoundz_cli-0.1.21-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "bb21091d5ed4630e3bf76679169d64ed",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7",
            "size": 6344,
            "upload_time": "2024-03-28T13:29:34",
            "upload_time_iso_8601": "2024-03-28T13:29:34.339791Z",
            "url": "https://files.pythonhosted.org/packages/26/56/13fed1ecff9c56988fc299ab7ced103ff856000be5a8235d0a1f2a08e786/insoundz_cli-0.1.21-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "42444364092933bbfaa22e98560aa4e2b93078af00dd18ed14bafd6cdbe5bfab",
                "md5": "748a80a7f79829608df4e54276499053",
                "sha256": "25d39cb698dfadb3b7ab24e33936936bd463ef596ae94a16d821315cef979bb2"
            },
            "downloads": -1,
            "filename": "insoundz_cli-0.1.21.tar.gz",
            "has_sig": false,
            "md5_digest": "748a80a7f79829608df4e54276499053",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7",
            "size": 6054,
            "upload_time": "2024-03-28T13:29:35",
            "upload_time_iso_8601": "2024-03-28T13:29:35.923468Z",
            "url": "https://files.pythonhosted.org/packages/42/44/4364092933bbfaa22e98560aa4e2b93078af00dd18ed14bafd6cdbe5bfab/insoundz_cli-0.1.21.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-03-28 13:29:35",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "InSoundz",
    "github_project": "insoundz-api",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "insoundz-cli"
}
        
Elapsed time: 0.19404s