appintel 1.0.2__tar.gz → 1.0.4__tar.gz

appintel-1.0.4/.gitignore

@@ -0,0 +1,105 @@
+# 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/
+wheels/
+*.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
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# dotenv
+.env
+
+# virtualenv
+.venv
+venv/
+ENV/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+
+# outputfiles
+*.json
+/itunizer/*.json

{appintel-1.0.2 → appintel-1.0.4}/PKG-INFO

@@ -1,25 +1,33 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.5
 Name: appintel
-Version: 1.0.2
+Version: 1.0.4
 Summary: A command line tool to search and compare prices of apps and music on the Apple Store
-Author: James Campbell
-Author-email: james@jamescampbell.us
-Requires-Python: >=3.11,<4.0
-Classifier: Programming Language :: Python :: 3
+Project-URL: Homepage, https://github.com/james-see/appintel
+Project-URL: Repository, https://github.com/james-see/appintel
+Project-URL: Issues, https://github.com/james-see/appintel/issues
+Author-email: James Campbell <james@jamescampbell.us>
+Maintainer-email: James Campbell <james@jamescampbell.us>
+License-Expression: GPL-3.0-or-later
+License-File: LICENSE
+Keywords: api,apple-store,data-analysis,itunes,market-research,pricing
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Requires-Dist: argparse (>=1.4.0,<2.0.0)
-Requires-Dist: black (>=24.4.2,<25.0.0)
-Requires-Dist: certifi (>=2024.2.2,<2025.0.0)
-Requires-Dist: chardet (>=5.2.0,<6.0.0)
-Requires-Dist: idna (>=3.7,<4.0)
-Requires-Dist: numpy (>=1.26.4,<2.0.0)
-Requires-Dist: pandas (>=2.2.2,<3.0.0)
-Requires-Dist: python-dateutil (>=2.9.0.post0,<3.0.0)
-Requires-Dist: pytz (>=2024.1,<2025.0)
-Requires-Dist: requests (>=2.31.0,<3.0.0)
-Requires-Dist: six (>=1.16.0,<2.0.0)
-Requires-Dist: urllib3 (>=2.2.1,<3.0.0)
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: requests>=2.31.0
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
 Description-Content-Type: text/markdown
 
 # appintel
@@ -68,4 +76,3 @@ It is difficult to get nice structured data from Apple. This helps with that.
 ## Example search
 
 !['example'](https://user-images.githubusercontent.com/616585/35492868-5dcf0e90-047d-11e8-974f-0dd7a0f33311.png)
-

appintel-1.0.4/appintel/__init__.py

@@ -0,0 +1,3 @@
+from .appintel import __version__, main
+
+__all__ = ["__version__", "main"]

appintel-1.0.4/appintel/appintel.py

@@ -0,0 +1,206 @@
+"""A command line tool to search and compare prices of apps and music on the Apple Store."""
+
+from __future__ import annotations
+
+import argparse
+import json
+from pprint import pprint
+from statistics import mean, median
+
+import requests
+
+__version__ = "1.0.4"
+
+logo = """
++-------------------------------------+
+|                         --\\         |
+|                        /   -\\       |
+|                       /      -\\     |
+|                      /         -    |
+|    \\                /               |
+|     \\              /                |
+|      \\           -/                 |
+|       -\\        /                   |
+|         \\      /                    |
+|          \\    /       AppIntel      |
+|           \\  /                      |
+|            -/                       |
++-------------------------------------+
+"""
+
+ITUNES_URL_ENDPOINT = "https://itunes.apple.com/search?term={}&country={}&entity={}"
+
+
+def get_content(
+    search_term: str, store_country: str = "us", category: str = "software"
+) -> requests.Response:
+    """Fetch data from the iTunes search endpoint."""
+    url = (
+        f"https://itunes.apple.com/search?"
+        f"term={search_term}&country={store_country}&entity={category}"
+    )
+    return requests.get(url, timeout=10)
+
+
+def _prices(jsondata: dict) -> list[float]:
+    return [float(item.get("price")) for item in jsondata.get("results", []) if "price" in item]
+
+
+def get_mean(jsondata: dict) -> float:
+    prices = _prices(jsondata)
+    if not prices:
+        return 0.0
+    if len(prices) > 1:
+        return mean(prices)
+    return prices[0]
+
+
+def get_max(jsondata: dict) -> float:
+    prices = _prices(jsondata)
+    if not prices:
+        return 0.0
+    if len(prices) > 1:
+        return max(prices)
+    return prices[0]
+
+
+def get_min(jsondata: dict) -> float:
+    prices = _prices(jsondata)
+    if not prices:
+        return 0.0
+    if len(prices) > 1:
+        return min(prices)
+    return prices[0]
+
+
+def get_median(jsondata: dict) -> float:
+    prices = _prices(jsondata)
+    if not prices:
+        return 0.0
+    if len(prices) > 1:
+        return median(prices)
+    return prices[0]
+
+
+def format_table(results: list[dict]) -> str:
+    if not results:
+        return "(no results)"
+    values = [
+        (str(item.get("price")), str(item.get("artistName")), str(item.get("trackName")))
+        for item in results
+    ]
+    header = ("price", "artistName", "trackName")
+    rows = [header, *values]
+    widths = [max(len(row[index]) for row in rows) for index in range(3)]
+    lines = [" | ".join(field.ljust(widths[index]) for index, field in enumerate(header))]
+    lines.append("-+-".join("-" * widths[index] for index in range(3)))
+    lines.extend(
+        " | ".join(field.ljust(widths[index]) for index, field in enumerate(row)) for row in values
+    )
+    return "\n".join(lines)
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        description="Collect and summarize data from the Apple iTunes Store",
+        formatter_class=argparse.ArgumentDefaultsHelpFormatter,
+    )
+    parser.add_argument(
+        "-s",
+        "--search",
+        dest="search_term",
+        default="nginx",
+        help="search term for the iTunes store",
+    )
+    parser.add_argument(
+        "-c",
+        "--category",
+        dest="category_location",
+        default="software",
+        help="store category to search",
+    )
+    parser.add_argument(
+        "-p",
+        "--print",
+        dest="print_me",
+        action="store_true",
+        default=False,
+        help="print raw search results",
+    )
+    parser.add_argument(
+        "-n",
+        "--no-logo",
+        dest="logo_off",
+        action="store_true",
+        default=False,
+        help="disable the AppIntel logo",
+    )
+    parser.add_argument(
+        "-t",
+        "--table",
+        dest="output_table",
+        action="store_true",
+        default=False,
+        help="print a compact table instead of JSON",
+    )
+    parser.add_argument(
+        "--country",
+        dest="store_country",
+        default="us",
+        help="store country to search",
+    )
+    parser.add_argument(
+        "--version",
+        "-v",
+        dest="app_version",
+        action="store_true",
+        default=False,
+        help="print the AppIntel version",
+    )
+    return parser
+
+
+def main(argv: list[str] | None = None) -> int:
+    args = build_parser().parse_args(argv)
+
+    if not args.logo_off:
+        print(logo)
+    if args.app_version:
+        print(f"Current version: {__version__}")
+        return 0
+
+    response = get_content(args.search_term, args.store_country, args.category_location)
+    jsondata = response.json()
+
+    if args.print_me:
+        pprint(jsondata)
+        for key in jsondata.get("results", [{}])[0]:
+            print(f"{key}:")
+        return 0
+
+    average_price = get_mean(jsondata)
+    max_price = get_max(jsondata)
+    min_price = get_min(jsondata)
+    median_price = get_median(jsondata)
+
+    print("Results of the query")
+    print("*****" * 5)
+    print(
+        f"The average price of the \033[94m{jsondata.get('resultCount', 0)}\033[0m items matching search term "
+        f"\033[92m{args.search_term}\033[0m: ${average_price:.2f}, the median is \033[94m{median_price:.2f}\033[0m, "
+        f"the min is \033[94m{min_price:.2f}\033[0m, and the max is \033[94m{max_price:.2f}\033[0m"
+    )
+    print("")
+
+    if args.output_table:
+        print(format_table(jsondata.get("results", [])))
+    else:
+        filename = f"{args.search_term}.json"
+        with open(filename, "w", encoding="utf-8") as file:
+            json.dump(response.json(), file, indent=2)
+        print(f"file saved as {filename}")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

appintel-1.0.4/classes.dot

@@ -0,0 +1,4 @@
+digraph "classes" {
+charset="utf-8"
+rankdir=BT
+}