RegScale-CLI


NameRegScale-CLI JSON
Version 5.33.1 PyPI version JSON
download
home_pagehttps://github.com/RegScale/regscale-cli
SummaryCommand Line Interface (CLI) for bulk processing/loading data into RegScale
upload_time2024-03-08 00:48:30
maintainer
docs_urlNone
authorTravis Howerton
requires_python>=3.9, <4
licenseMIT
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # RegScale Command Line Interface (CLI)

This CLI application is for supporting advanced automation and bulk data processing related to the [RegScale Compliance Automation Platform](https://www.regscale.com).  This application is intended to run as a "side car" that be scheduled via CRON job or serverless function to perform sophisticated data processing.  The CLI includes multiple libraries for processing data, connecting to RegScale Application Programming Interfaces (APIs), and commercial integrations.  This software may be packaged and included in other commercial software to lower the level of effort associated with building RegScale integrations to other commercial tools.

See [full documentation on regscale.readme.io](https://regscale.readme.io/docs/overview).


## Installation

Create a virtual environment and install required Python libraries.

### Shell
```shell
# create and activate python virtual environment
python -m venv venv

# initialize environment
source venv/bin/activate

# upgrade pip
pip install --upgrade pip

# install RegScale CLI
pip install regscale-cli

# optional: install application with "server" packages
pip install "regscale-cli[server]"
```

### PowerShell
```PowerShell
# create and activate python virtual environment
python -m venv venv

# initialize environment
.\venv\Scripts\Activate.ps1

# upgrade pip
pip install --upgrade pip

# install RegScale CLI
pip install regscale-cli

# optional: install application with "server" packages
pip install "regscale-cli[server]"
```

## Initialization

Initialize your CLI environment with the `init` command:

```shell
# initialize RegScale CLI environment
regscale init
```

The CLI will generate a default init.yaml file and prompt you for RegScale domain and to log in:

```shell
Initializing your RegScale CLI environment...
Would you like to change your RegScale domain from https://regscale.yourcompany.com/? (Y/n): y

Please enter your RegScale domain.
Example: https://mydomain.regscale.com/
Domain: https://regscale.mycomapny.com
[2023/01/20 04:32;41] INFO     [2023/01/20 04:32;41] [INFO ]  Valid URL provided, regscale.py:349
                               init.yaml has been updated.                                       
Would you like to log in to your RegScale instance? (Y/n): y
Please enter your username: rross
Please enter your password:
```

## Leaving the Virtual Environment

When you are done working with the CLI, you can leave the virtual environment with the `deactivate` command. This will return you to your system's default Python environment and this will work on PowerShell or shell.


## Use Cases

- Sidecar for bulk processing compliance data such as vulnerability scans or continuous monitoring logs
- Processing and ingest of data such as National Institute of Standards and Technology (NIST) Open Security Control Assessment Language (OSCAL)
- Running CRON jobs to bulk-process data
- Managing users and identities from external sources
- Threat intelligence feeds

## Specific Integrations

- See the [RegScale Documentation](https://regscale.readme.io/docs/overview) for details.




            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/RegScale/regscale-cli",
    "name": "RegScale-CLI",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.9, <4",
    "maintainer_email": "",
    "keywords": "",
    "author": "Travis Howerton",
    "author_email": "thowerton@regscale.com",
    "download_url": "",
    "platform": null,
    "description": "# RegScale Command Line Interface (CLI)\n\nThis CLI application is for supporting advanced automation and bulk data processing related to the [RegScale Compliance Automation Platform](https://www.regscale.com).  This application is intended to run as a \"side car\" that be scheduled via CRON job or serverless function to perform sophisticated data processing.  The CLI includes multiple libraries for processing data, connecting to RegScale Application Programming Interfaces (APIs), and commercial integrations.  This software may be packaged and included in other commercial software to lower the level of effort associated with building RegScale integrations to other commercial tools.\n\nSee [full documentation on regscale.readme.io](https://regscale.readme.io/docs/overview).\n\n\n## Installation\n\nCreate a virtual environment and install required Python libraries.\n\n### Shell\n```shell\n# create and activate python virtual environment\npython -m venv venv\n\n# initialize environment\nsource venv/bin/activate\n\n# upgrade pip\npip install --upgrade pip\n\n# install RegScale CLI\npip install regscale-cli\n\n# optional: install application with \"server\" packages\npip install \"regscale-cli[server]\"\n```\n\n### PowerShell\n```PowerShell\n# create and activate python virtual environment\npython -m venv venv\n\n# initialize environment\n.\\venv\\Scripts\\Activate.ps1\n\n# upgrade pip\npip install --upgrade pip\n\n# install RegScale CLI\npip install regscale-cli\n\n# optional: install application with \"server\" packages\npip install \"regscale-cli[server]\"\n```\n\n## Initialization\n\nInitialize your CLI environment with the `init` command:\n\n```shell\n# initialize RegScale CLI environment\nregscale init\n```\n\nThe CLI will generate a default init.yaml file and prompt you for RegScale domain and to log in:\n\n```shell\nInitializing your RegScale CLI environment...\nWould you like to change your RegScale domain from https://regscale.yourcompany.com/? (Y/n): y\n\nPlease enter your RegScale domain.\nExample: https://mydomain.regscale.com/\nDomain: https://regscale.mycomapny.com\n[2023/01/20 04:32;41] INFO     [2023/01/20 04:32;41] [INFO ]  Valid URL provided, regscale.py:349\n                               init.yaml has been updated.                                       \nWould you like to log in to your RegScale instance? (Y/n): y\nPlease enter your username: rross\nPlease enter your password:\n```\n\n## Leaving the Virtual Environment\n\nWhen you are done working with the CLI, you can leave the virtual environment with the `deactivate` command. This will return you to your system's default Python environment and this will work on PowerShell or shell.\n\n\n## Use Cases\n\n- Sidecar for bulk processing compliance data such as vulnerability scans or continuous monitoring logs\n- Processing and ingest of data such as National Institute of Standards and Technology (NIST) Open Security Control Assessment Language (OSCAL)\n- Running CRON jobs to bulk-process data\n- Managing users and identities from external sources\n- Threat intelligence feeds\n\n## Specific Integrations\n\n- See the [RegScale Documentation](https://regscale.readme.io/docs/overview) for details.\n\n\n\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Command Line Interface (CLI) for bulk processing/loading data into RegScale",
    "version": "5.33.1",
    "project_urls": {
        "Homepage": "https://github.com/RegScale/regscale-cli"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "f74c9715bd8a084d1b100af0b43328ac5bf09038caec5e7015da4e8f8c220807",
                "md5": "ba74182a7462d330fbb1400456d5e6a0",
                "sha256": "093126187164bea4c99a267221eb6b3aee24c4eb1494c1e5a9dbcd8214c4e98d"
            },
            "downloads": -1,
            "filename": "RegScale_CLI-5.33.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "ba74182a7462d330fbb1400456d5e6a0",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9, <4",
            "size": 637992,
            "upload_time": "2024-03-08T00:48:30",
            "upload_time_iso_8601": "2024-03-08T00:48:30.524707Z",
            "url": "https://files.pythonhosted.org/packages/f7/4c/9715bd8a084d1b100af0b43328ac5bf09038caec5e7015da4e8f8c220807/RegScale_CLI-5.33.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-03-08 00:48:30",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "RegScale",
    "github_project": "regscale-cli",
    "github_not_found": true,
    "lcname": "regscale-cli"
}
        
Elapsed time: 0.22726s