/commandman

Cross-platform console command manager.

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

commandman

Console command manager.

GitHub top language PyPI - Downloads GitHub release (latest by date) GitHub PyPI PyPI - Format GitHub Repo stars GitHub watchers GitHub forks

Author and developer: A.A. Suvorov.

Supported:

  • Linux: All.
  • Windows: 7/8/10.
  • Termux (Android).

Images:

commandman image

What's new?

commandman v0.5.1

Description:

commandman - Cli command manager.

pip install commandman

The utility uses the package: commandex. The utility uses the package: smartcliapp. The utility uses the package: click by license.

Store your commands in one place for automatic or manual launch and execution at any time.

It is convenient to store and run many commands for automatic execution after system installation.

Recommended for use on *nix systems.

Possibilities:

  • Storing named packages of commands in one file.
  • Launching the execution of a batch or batch of commands from a file in automatic or manual mode.
  • Add and run only certain packages.
  • Exclusion of certain command packages from launch.
  • Ability to run and skip command packets and individual commands in manual mode.

File - a file in format 1 or 2 with the correct structure.

A command package - name for grouping commands in a file.

Command - a command to be executed in the console or terminal.

Create one or several files and store the necessary commands in them under names (in packages).
The file must have the correct structure. At the moment, the simplest *.cfg and *.json are supported.

The file must have the correct structure.

*.cfg - The simplest file with command packages:

[package name 1]
command 1
command 2
command N
[package name 2]
command 1
command 2
command N

*.json - The simplest file with command packages:

{
    "pack1":
      [
        "command1",
        "command2"
      ],
    "pack2":
      [
        "command1",
        "command2"
      ]
}

Packages:

Package names are placed in square brackets, below the name are the commands included in this package.

Commands:

The commands are grouped under the desired names in packages.

To run the file use the command:

python commandmanager.py [arguments] [file]

A warning! If the file name contains spaces or invalid characters, when typing a terminal, enclose it in quotation marks.

Arguments:

Using the -a option when starting the utility, you can specify which command package to run using the existing package name from the file. Use the option multiple times to add multiple packages:

python commandmanager.py -a name1 -a name2 -a name3 file.cfg

Using the -e parameter, you can specify which command package to exclude using the existing package name from the file. Use the option multiple times to exclude multiple packages:

python commandmanager.py -e name1 -e name2 -e name3 file.cfg

A warning! If the command package name contains spaces or invalid characters, when typing a terminal, enclose it in quotation marks.

The --no-auto option will cancel autorun of commands from the package.

Before executing each package and each command the utility will ask for permission to execute.

The default is to autorun packages and commands --auto.

Help:

Install and Use:

Install:

  • pip install commandman

Use:

  • commandman [options] [path to the file with command packages]

Build your command packages using example files:

A warning! If the command package name or file name contains spaces or invalid characters, when typing a terminal, enclose it in quotation marks.

Try to name your packages and files with short, meaningful names.

Variant 1:

  • Go to the project folder
  • python setup.py install
  • commandman -h

Variant 2:

  • Go to the project folder
  • pip install -r requirements.txt
  • python3 commandmanager.py [options] [path to the file]

Termux support:

Variant 1:

  • Install Termux
  • apt update
  • pkg install python
  • Go to the project folder
  • python setup.py install
  • commandman -h or
  • pip3 install -r requirements.txt
  • python3 commandmanager.py [options] [path to the file]

Disclaimer of liability:

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Copyright:

--------------------------------------------------------
Licensed under the terms of the BSD 3-Clause License
(see LICENSE for details).
Copyright © 2018-2024, A.A. Suvorov
All rights reserved.
--------------------------------------------------------