# python3.spark-cli

**Repository Path**: zinface/python3.spark-cli

## Basic Information

- **Project Name**: python3.spark-cli
- **Description**: spark 星火应用商店软件源分析脚本，兼 cli 工具
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-07-03
- **Last Updated**: 2023-07-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# python3.spark-cli

> spark 星火应用商店软件源分析脚本，兼 cli 工具

## 如何构建安装

1. 使用 setup.py 构建 whl 文件并安装
    ```
    $ python3 setup.py sdist bdist_wheel
    $ sudo python3 -m pip install ./dist/spark-0.1-py3-none-any.whl
    ```

2. 使用 setup.py 进行直接安装
    ```
    $ sudo python3 setup.py install
    ```

3. 使用 Makefile 脚本进行 make 安装
    ```shell
    # 安装到系统下 - 与使用 setup.py 直接安装一致
    $ sudo make install

    # 安装到当前用户下
    $ make install-user


    # 特殊：可分发再安装方式安装，使用 make 提前制作 whl 文件
    # 安装到系统下，以 whl 形式
    $ sudo make install-whl

    # 安装到当前用户下，以 whl 形式
    $ make install-whl-user
    ```

## 如何使用此工具

> spark.py [-hvlj] [-f \<Packages\>] [-s|--search \<search package\>]

1. 搜索并列出可用软件包信息
    ```
    $ ./spark.py -s kdenlive -l
    Package: kdenlive
    Package: org.kdenlive.spark
    Package: org.kdenlive.spark
    ```

2. 搜索并详细列出软件包信息
    ```
    $ ./spark.py -s spark-store-console -v
    Package: spark-store-console
        --> Architecture: all
        --> Version: 1.2.2
        --> Priority: optional
        --> Maintainer: gfdgd xi <3025613752@qq.com>
        --> Homepage: https://gitee.com/gfdgd-xi/spark-store-console
        --> Depends: python3, python3-pip, fbi, wget, apt, dpkg, python3-requests
        --> Filename: http://d.store.deepinos.org.cn/store/tools/spark-store-console/spark-store-console_1.2.2_all.deb
        --> Size: 11084
        --> MD5sum: ed05fce56b46cb100cb05490a9582e61
        --> SHA1: b6b1e484a80986ff74cc3993fc95f7671cdccc40
        --> SHA256: e789d0378a1f06135de1f309b60d4c2f35a1d6d75e93352aed497e53eb2b90c0
        --> SHA512: cb6ed9b3cf79d33368f21d870b51f7d8cfbec1f2045be026e4f2cfe5c2324046c5cca3f863672f36e3d69b4ef5dc9ed4ab57f6b871a3a7152c6c8bdab1ee9e30
        --> Description: 一个星火应用商店的第三方客户端，为的是可以在更多发行版运行（dtk 不能运行在很多发行版上）
    ```

3. 搜索并以json格式列出软件包信息

    ```
    $ ./spark.py -s spark-store-console -j
    {
    "Package": "spark-store-console",
    "Architecture": "all",
    "Version": "1.2.2",
    "Priority": "optional",
    "Maintainer": "gfdgd xi <3025613752@qq.com>",
    "Depends": "python3, python3-pip, fbi, wget, apt, dpkg, python3-requests",
    "Filename": "http://d.store.deepinos.org.cn/store/tools/spark-store-console/spark-store-console_1.2.2_all.deb",
    "Size": "11084",
    "MD5sum": "ed05fce56b46cb100cb05490a9582e61",
    "SHA1": "b6b1e484a80986ff74cc3993fc95f7671cdccc40",
    "SHA256": "e789d0378a1f06135de1f309b60d4c2f35a1d6d75e93352aed497e53eb2b90c0",
    "SHA512": "cb6ed9b3cf79d33368f21d870b51f7d8cfbec1f2045be026e4f2cfe5c2324046c5cca3f863672f36e3d69b4ef5dc9ed4ab57f6b871a3a7152c6c8bdab1ee9e30",
    "Homepage": "https://gitee.com/gfdgd-xi/spark-store-console",
    "Description": "一个星火应用商店的第三方客户端，为的是可以在更多发行版运行（dtk 不能运行在很多发行版上）",
    "LongDescription": ""
    }
    ```

## 安装预期情况

- 不同的安装方式的预期(使用 `setup.py` 直接安装与先制成 `whl` 再安装的区别)
    1. 在使用 `make install-user` 时
        执行的是 `python3 ./setup.py install --user`
        
        首先将当前项目直接制成一个 egg 文件(zip 压缩形式)，并安装在当前用户中
        ```
        /home/zinface/.local/lib/python3.7/site-packages/spark-0.1-py3.7.egg
        ```
    2. 在使用 `make install-whl-user` 时
        执行的是 `python3 -m pip install --user ./dist/spark-0.1-py3-none-any.whl`

        接着它将安装在当前用户中，以可直接查看的源代码目录结构形式
        ```
        /home/zinface/.local/lib/python3.7/site-packages/spark
        ```

        **ps:** 需要提前 `make` 一次执行 `python3 ./setup.py sdist bdist_wheel` 将项目制成 whl 文件

- 需要注意
    1. egg 在直接安装过程中生成， whl 则是专用于分发模块时制作
    2. egg 与 whl 均是一个已经 zip 压缩项目的文件，但仅 whl 是可进行分发再安装的发行模块。
    3. 不同场景下使用不同的安装方式：
        - 项目在安装为工具或程序时使用起来两者方式无异
        - 在基于模块开发时仍需要使用 `whl` 形式的分发包(可直接查看源代码目录形式)