Metadata-Version: 2.1
Name: pietunes
Version: 0.0.2
Summary: A library to aid in automating iTunes via ScriptingBridge.
Home-page: https://pypi.org/project/pietunes/
Author: Brian Farrell
Author-email: one.chillindude@me.com
License: AGPLv3
Description: ============
        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://pythonhosted.org/pyobjc/index.html>`_
            * 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()
        
           def _get_all_playlists():
               return app.playlists
        
        
        Links
        -----
        
        * Website:
        * Documentation:
        * License: https://www.gnu.org/licenses/agpl.html
        * Releases: https://pypi.org/project/pietunes/
        * Code: _To be released soon..._
        * 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.
        
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
