repo for packages of ai, read more about ai system

and also read manual for more specific manual

default host is https://9r3i.github.io/aipkg/

first, we should check the current host set by typing a command:

$ ai config get PACKAGE_HOST

then set host to default with command:

$ ai pkg host 'https://9r3i.github.io/aipkg/'

the previous is the primary host, we can add secondary host with this command:

$ ai pkg add host <hostname>

$ ai pkg removehost <hostname>

the host must contain a file ai.package.json, it contains packages object information in array, such as:

• name (requires, lower-case unique name)
• version (requires)
• type (requires, lib or ext)
• contains (requires, array of files inside the package)
• authors (requires, array of authors)
• privilege (default: 1, means public use)
• requires (optional, array of require library or extension)
• file (requires, must be zip.crypto format)
• size (optional, int of exact size of the package file)
• xsize (optional, int of exact space needed/required)

key must be in lower-case unique name, and for extension package the key must be use prefix ext., this will be a conflict if the key is not unique or key has been taken by another package.

[
    "ext.zip": {
        "name": "zip",
        "version": "1.0.2",
        "type": "ext",
        "contains": [
            "zip.ai"
        ],
        "authors": [
            "9r3i"
        ],
        "privilege": 1,
        "requires": [
        ],
        "file": "ext\/zip.1.0.2.zip.crypto",
        "size": 2432,
        "xsize": 4280
    }
]

these privileges are set to close-source as long as they are compiled by ai itself

all either free or paid users can access and use it

only paid users have access and privilege to use it

only the users who has the private key can use it

only paid users can buy it, and only can be used by user who has bought it

default option is --all, example:

$ ai pkg ls

its equal to

$ ai pkg ls --all

to list all packages from the host

$ ai pkg ls --installed

or with another option

$ ai pkg installed

$ ai pkg ls --list

$ ai pkg ls --upgradable

to install a package or more it goes to use special direct command,

$ ai install <package_name>

$ ai install ext.zip

$ ai install ext.zip ext.gz lpclient ext.imagebam

the sample above will install 4 packages in one hit

$ ai pkg remove ext.zip

this will remove a package, unless its still bound as dependency to another package.

checking before upgrade all packages with listing upgradable

$ ai pkg ls --upgradable

$ ai pkg upgrade

or

$ ai pkg update

i include some of sample to be learned, so you can make one, put your file in directory src of ai, then ext for extension and libs for library. requirements are:

• class name must be the same with file name
• if using namespace, file must be inside of namespace directory
• namespace can be called by itself using dot as separation, sample: ai dummies.net help
• class must contain constant of class version
• class must contain constant of class info
• class must have public method of help
• method or option must be set as public
• dependency must be set first as requires constant array, before the package

as dummy sample, the contain must be completely done

create and ini file, such as dummy.ini contains:

name=dummy
version=0.1.0
type=ext
contains=dummy.php
authors="9r3i"
privilege=1

and execute in another directory to distribute it, with this command:

$ ai pkg build dummy

this command will generate crypto file and package info file ai.package.json

to distribute it, you can commit as git repo to github, gitlab or bitbucket.

$ ai pkg add repository <username>/<repository>/<branch>

• username is username of git host
• repository is repo name contains ai.package.json
• branch is branch name (optional), default: master

$ ai pkg add repository 9r3i/apk-builder

then install it

$ ai install ext.apk

read more about apk builder

dont forget to test your extension or library you just installed from your repo.

That's all there is to it. Alhamdulillaah...