init apptoolkit

Author: 马飞

.gitignore

@@ -0,0 +1,93 @@
+# Created by .ignore support plugin (hsz.mobi)
+### Python template
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*,cover
+.hypothesis/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+
+# PyBuilder
+target/
+
+# IPython Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# dotenv
+.env
+
+# virtualenv
+venv/
+ENV/
+.venv/
+
+# Spyder project settings
+.spyderproject
+
+# Rope project settings
+.ropeproject
+.idea/
+/dump.rdb

CHANGES

@@ -0,0 +1,11 @@
+# Introduction
+
+## Design Philosophy
+
+This is a lightweight set of tools for obtaining information about Android devices in Python
+
+## Learn more
+
+You can read this [blog][mafei-blog] to learn more about the `apptoolkit`.
+
+[mafei-blog]: http://mafei.me/

LICENSE

@@ -0,0 +1,135 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+"""
+    apptoolkit
+    ~~~~~~~~~~~~
+
+    This module is the main config.
+
+    :copyright: (c) 2017 by Ma Fei.
+"""
+
+import os
+
+import subprocess
+
+__version__ = '0.0.2'
+
+
+class Shell:
+    def __init__(self):
+        pass
+
+    @staticmethod
+    def invoke(cmd):
+        output, errors = subprocess.Popen(cmd, shell=True, stdout=subprocess.PIPE, stderr=subprocess.PIPE).communicate()
+        o = output.decode("utf-8")
+        return o
+
+
+# 判断是否设置环境变量ANDROID_HOME
+if "ANDROID_HOME" in os.environ:
+    command = os.path.join(
+        os.environ["ANDROID_HOME"],
+        "platform-tools",
+        "adb")
+else:
+    raise EnvironmentError(
+        "Adb not found in $ANDROID_HOME path: %s." %
+        os.environ["ANDROID_HOME"])
+
+
+class ADB(object):
+    """
+      参数:  device_id
+    """
+
+    def __init__(self, device_id=""):
+
+        if device_id == "":
+            self.device_id = ""
+        else:
+            self.device_id = "-s %s" % device_id
+
+    def adb(self, args):
+        cmd = "%s %s %s" % (command, self.device_id, str(args))
+        return Shell.invoke(cmd)
+
+    def shell(self, args):
+        cmd = "%s %s shell %s" % (command, self.device_id, str(args),)
+        return Shell.invoke(cmd)
+
+    def get_device_state(self):
+        """
+        获取设备状态： offline | bootloader | device
+        """
+        return self.adb("get-state").stdout.read().strip()
+
+    def get_device_id(self):
+        """
+        获取设备id号，return serialNo
+        """
+        return self.adb("get-serialno").stdout.read().strip()
+
+    def get_android_version(self):
+        """
+        获取设备中的Android版本号，如4.2.2
+        """
+        return self.shell(
+            "getprop ro.build.version.release").strip()
+
+    def get_sdk_version(self):
+        """
+        获取设备SDK版本号，如：24
+        """
+        return self.shell("getprop ro.build.version.sdk").strip()
+
+    def get_product_brand(self):
+        """
+        获取设备品牌，如：HUAWEI
+        """
+        return self.shell("getprop ro.product.brand").strip()
+
+    def get_product_model(self):
+        """
+        获取设备型号，如：MHA-AL00
+        """
+        return self.shell("getprop ro.product.model").strip()
+
+    def get_product_rom(self):
+        """
+        获取设备ROM名，如：MHA-AL00C00B213
+        """
+        return self.shell("getprop ro.build.display.id").strip()
+
+
+class DeviceInfo:
+    def __init__(self, uid, os_type, os_version, sdk_version, brand, model, rom_version):
+        self.uid = uid
+        self.os_type = os_type
+        self.os_version = os_version
+        self.sdk_version = sdk_version
+        self.brand = brand
+        self.model = model
+        self.rom_version = rom_version
+
+
+class Device:
+    def __init__(self):
+        pass
+
+    @staticmethod
+    def get_android_devices():
+        android_devices_list = []
+        android_devices_infos = []
+        for device in Shell.invoke('adb devices').splitlines():
+            if 'device' in device and 'devices' not in device:
+                device = device.split('\t')[0]
+                android_devices_list.append(device)
+        for device_uid in android_devices_list:
+            device_info = DeviceInfo(device_uid, "Android", ADB(device_uid).get_android_version(),
+                                     ADB(device_uid).get_sdk_version(),
+                                     ADB(device_uid).get_product_brand(), ADB(device_uid).get_product_model(),
+                                     ADB(device_uid).get_product_rom())
+            android_devices_infos.append(device_info.__dict__)
+        return android_devices_infos

MANIFEST.in

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+
+# 指定脚本版本,然后进行部署.
+source venv/bin/activate
+rm -rf dist/*
+python setup.py bdist_wheel --universal
+twine upload dist/apptoolkit*

README.md

@@ -0,0 +1,31 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+#############################################
+# File Name: setup.py
+# Author: mafei
+# Mail: [email protected]
+# Created Time:  2017-06-26 01:25:34 AM
+#############################################
+
+from setuptools import setup, find_packages
+
+import apptoolkit
+
+setup(
+    name="apptoolkit",
+    version=apptoolkit.__version__,
+    description="apptoolkit",
+    long_description=open("README.md").read(),
+    license="MIT Licence",
+
+    author="mafei",
+    author_email="[email protected]",
+    url="https://github.com/logan62334/python-apptoolkit.git",
+
+    packages=find_packages(),
+    include_package_data=True,
+    zip_safe=True,
+    platforms="any",
+    install_requires=[]
+)