CLight v2.4.3

Project: CLight
Version: 2.4.3
OS: Microsoft / Windows
Author: Irakli Gzirishvili
Mail: [email protected]

CLight is a Python command-line interface application. A lightweight Framework that simplifies CLI app development and the package distribution process, with automatic deployment strategies from Local, GitHub and GitLab environments.

Installation

To use CLight, follow these steps:

• Open CMD as administrator and run the following command to install pip install clight then restart your CMD
• To check if CLight is installed correctly, run the following command clight

Runn CMD as administrator

Commands

These are the available commands you can use:

• clight - To list available commands
• clight new - Create new project
• clight add - Add existing project to catalog
• clight module (name) - Create new module
• clight reform (-t) - Edit project params, (-t) to skip templates
• clight version - Upgrade semantic version number of the project
• clight all - List existing projects
• clight publish (-t) - Publish project on PyPI, (-t) to test locally
• clight remove (project) - Remove project
• clight pypidel - Delete PyPI credentials
• clight install - Test the installation process locally
• clight update - Update local installation test
• clight uninstall - Test the uninstallation process locally

Usage

It's easy to use this framework, just follow these simple steps:

• Navigate to your project's empty folder using CMD.
• Run clight new and fill out the simple CLI form.
• Once you complete the details, CLight will automatically create a basic setup.
• Now, you can build CLI commands by simply creating methods in the /.system/index.py file.
• To create a custom module, run clight module <name> and find it in the /.system/modules folder.
• To include some required pip modules for your project, specify them "only" in the /.system/imports.py file.
• You can include other file resources in the /.system/sources folder.

By specifying the required pip modules in /.system/imports.py file just once - you automatically include them across the index file and your custom modules, so you don't need to make your modules ugly and separated.

In case you need to import a module with a specific version, comment it at the top of the /.system/imports.py file like this: # import <module>==<major:minor:patch>, then import it as it used to be imported. Here is the example:

from clight.system.importer import cli  # DON'T REMOVE THIS LINE

# import openai==0:28

import os
import sys
import openai
...

In case you have to import a module with a different name than its importer hint, for example, in the case of soupsieve, if you import it like this from bs4 import BeautifulSoup, "bs4" is not a module and could not be processed for the installation of your project on other machines - You just need to add "soupsieve" as a commented line at the top of the file like this: # import soupsieve and then add # !install to the end of the actual import line like this: from bs4 import BeautifulSoup # !install. Here is the example:

from clight.system.importer import cli  # DON'T REMOVE THIS LINE

# import soupsieve

import os
import sys
from bs4 import BeautifulSoup  # !install
...

Rules

Don't remove these items from the project's .system folder:

• modules - Folder for your custom modules
• sources - Folder for system resources
• imports.py - File to import pip and your custom packages
• index.py - Index file, defining the main CLI commands that users will interact with

The index and module files are constructed with 3 sections of code:

1. Load - Section for initializing your project and running some scripts before executing required command
2. Main - CLI command methods with name, arguments and description
3. Helpers - Private methods used to support the Main methods

You don't need anything else, this is the simplest CLI application framework interface to save your time

Shared cli Methods

These are basic methods from the clight package class called cli that you can use in your index and module files:

• cli.error("message") - Print an error message in red
• cli.info("message") - Print an info message in blue
• cli.hint("message") - Print a hint in yellow
• cli.done("message") - Print a completion message in green
• cli.trace("message") - Print hidden developer message, activate dev mode with cli.dev = True
• cli.input("hint") - Define CLI input field
• cli.selection("hint", ["A", "B"]) - Define selection input field
• cli.selections("hint", ["A", "B"]) - Define multiple selection input field
• cli.confirmation("hint") - Define confirmation input field
• cli.value("key", {...}, "default") - Get value from data
• cli.sound("done") - Set system sound - start, ready, done, error, ask, set or unset
• cli.speak("text") - Read text with voice
• cli.listen() - Listen and convert speech to text
• cli.read("Folder/file.txt") - Read file and get content
• cli.write("Folder/file.txt", "content") - Write file with content
• cli.append("Folder/file.txt", "content") - Append content to the file
• cli.yaml("Folder/file.yaml") - Read and convert YAML file as dict
• cli.template("content", {...}) - Parse template content with given key-value pairs
• cli.chars(10) - Get random characters with given length
• cli.isValue(value) - Check if value exists
• cli.isPath(path) - Check if path exists
• cli.isFile(file) - Check if file exists
• cli.isFolder(folder) - Check if folder exists
• cli.command("cmd line") - Execute CMD command
• cli.encrypt("data", "key") - Encrypt data by key
• cli.decrypt("encrypted", "key") - Decrypt encrypted data by key
• cli.filter("text") - Filter user text before printing

Specifying Parameters

When creating your new project, you will be asked to fill a simple form just once, to specify your project's configuration parameters:

1. Name - Name of your project required
2. Version - Version of your project required
3. Description - Description of your project required
4. Link - Link to your project
5. CMD - CMD name alias for your project required
6. Author - Author of the project required
7. Mail - Mail of the project author required
8. Project Type - Type of the project required
9. Repository Type - Project repository type required
10. License - License for your project
11. Operating System - Required operating system for your project required

Project Type: Select App to develop a new CLI application, or select Module to develop a single pip module

Specifying Repository Type

At this stage, CLight works with 3 types of project repository environments:

• Local - Publishing projects from your local development Windows environment to PyPI
• GitHub - Automated deployment process to PyPI once you push changes to the main branch
• GitLab - Automated deployment process to PyPI once you push changes to the main branch

PyPI is the official third-party package repository for the Python programming language. It hosts and distributes software packages for developers to use. Developers can upload Python packages to PyPI, where they can be easily accessed by others. Anyone can then download them using the pip install <package> command

Specifying License

When creating a project with CLight, you can include one of the 8 OSI-Approved license types:

1. MIT License
2. BSD License
3. ISC License (ISCL)
4. Apache Software License
5. Mozilla Public License 2.0 (MPL 2.0)
6. GNU Affero General Public License v3
7. GNU General Public License v3 (GPLv3)
8. GNU Lesser General Public License v3 (LGPLv3)

Specifying Operating System

When creating a project with CLight, you should specify the OS environment for your project:

1. OS Independent
2. Microsoft / Windows
3. POSIX / Linux
4. MacOS

Deployment

Before publishing your updated project, according to PyPI rules, you must increase your project's version number:

Navigate to your project's root directory using CMD, run clight version and select type option of the changes. CLight will automatically increase the version number based on your selected option.

Based on your selected Repository Type, the project will be deployed to PyPI in the following ways:

• Local - Publishing projects from your local development Windows environment to PyPI

  • Navigate to your project's root directory using CMD and run clight publish
  • If this is your first time, provide your PyPI PYPI_USERNAME and PYPI_API_TOKEN
  • Then choose whether to save your credentials or not
  • If you choose to save your credentials, provide a Password Key to encrypt them
  • That's it. The next time, you will just be asked for the Password Key

• GitHub - Automated deployment process to PyPI once you push changes to the main branch

  • Nothing to do, just push the changes

• GitLab - Automated deployment process to PyPI once you push changes to the main branch

  • Nothing to do, just push the changes

Note: You must add PyPI credentials as repository secure variables in GitHub and GitLab with these names: PYPI_USERNAME and PYPI_API_TOKEN