Metadata-Version: 2.1
Name: pietunes
Version: 0.0.5
Summary: A library to aid in automating iTunes via ScriptingBridge.
Home-page: https://pypi.org/project/pietunes/
Author: Brian Farrell
Author-email: brian.farrell@me.com
License: AGPLv3
Keywords: modern development iTunes ScriptingBridge osx darwin
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Topic :: Multimedia :: Sound/Audio
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Software Development :: Libraries
Classifier: Environment :: Console
Classifier: Operating System :: MacOS
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: Implementation :: CPython
Requires-Python: >=3.6.0
Description-Content-Type: text/x-rst
Requires-Dist: pyobjc-core (>=6.1)
Requires-Dist: pyobjc-framework-AppleScriptObjC (>=6.1)
Requires-Dist: pyobjc-framework-Cocoa (>=6.1)
Requires-Dist: pyobjc-framework-iTunesLibrary (>=6.1)
Requires-Dist: pyobjc-framework-Quartz (>=6.1)
Requires-Dist: pyobjc-framework-ScriptingBridge (>=6.1)
Requires-Dist: pyobjc-framework-StoreKit (>=6.1)


============
Introduction
============

PieTunes is a Python library that creates an abstraction of
Apple's Scripting Bridge API for iTunes. This makes it much easier to
write Python scripts (or full python applications) that interact with
iTunes and the iTunes Store.

There are some caveats:
    * The only external dependency right now is
      `PyObjC <https://pyobjc.readthedocs.io/en/latest/>`_
    * Due to this dependency, this pietunes Python library is only available
      for MacOS [#f1]_
    * This is a modern Python library that requires ``Python>=3.6``


Objectives
----------
#. Create a modern, stable Python library with a clearly-defined API  
#. Provide as close to 100% Test Coverage as possible [#f2]_
#. Provide clear documentation with full coverage of the API and example code.



Installing
----------

Install and update using `pip`:

.. code-block:: bash

   pip install -U pietunes


A Simple Example
----------------

.. code-block:: python

   from pietunes import App

   app = App()

   movie_playlist = app.get_playlist("Movies")

   movies = list(app.get_tracks(movie_playlist))

   for movie in movies:
      print(movie.name())

Links
-----

* Website: https://pypi.org/project/pietunes/
* Documentation: https://brianfarrell.gitlab.io/pietunes/
* License: https://www.gnu.org/licenses/agpl.html
* Releases: https://pypi.org/project/pietunes/
* Code: https://gitlab.com/brianfarrell/pietunes/
* Issue tracker:
* Test status:
* Test coverage:

.. rubric:: Footnotes

.. [#f1] Once this is working correctly on MacOS, I will look into how
        I might possibly get it working for iTunes on Windows.

.. [#f2] | This project started-out as a Proof of Concept (POC).
       | At that point, no automated testing was involved.
       | Going forward, all new development and bug fixes will be test-driven.


