Merge branch 'v0.4.0-test' into v0.4.0

CHANGES

@@ -1,4 +1,4 @@
-Version 0.4.0 -- released 05//17
+Version 0.4.0 -- released 05/17/17
 ==================================
  - Improve coverage code
  - Remove deprecated files (mod-host auto connect)

README.rst

@@ -115,14 +115,18 @@ Add effects in the pedalboard
     # or
     # pedalboard.effects.append(reverb2)
 
-For obtains automatically the sound card inputs and outputs, use `SystemEffectBuilder`. It requires `JACK-Client`_.
+For obtains automatically the sound card inputs and outputs, use `SystemEffectBuilder`.
+It requires a `JackClient` instance, that uses `JACK-Client`_.
 
 .. _JACK-Client: https://jackclient-python.readthedocs.io/
 
 .. code-block:: python
 
+    from pluginsmanager.jack.jack_client import JackClient
+    client = JackClient()
+
     from pluginsmanager.model.system.system_effect_builder import SystemEffectBuilder
-    sys_effect = SystemEffectBuilder()
+    sys_effect = SystemEffectBuilder(client)
 
 For manual input and output sound card definition, use:
 

docs/source/index.rst

@@ -8,6 +8,7 @@ Contents:
 .. toctree::
    :maxdepth: 2
 
+   jack
    mod_host
    model
    model_lv2

docs/source/jack.rst

@@ -0,0 +1,9 @@
+PedalPi - PluginsManager - Jack
+===============================
+
+pluginsmanager.jack.jack_client.JackClient
+------------------------------------------
+
+.. autoclass:: pluginsmanager.jack.jack_client.JackClient
+   :members:
+   :special-members:

pluginsmanager/jack/jack_client.py

@@ -27,6 +27,10 @@ class JackClient(object):
         >>> client.xrun_callback = lambda delay: print('x-run', delay)
         >>> client.shutdown_callback = lambda status, reason: print('shutdown: ', status, reason)
 
+    When you don't use anymore, close it::
+
+        >>> client.close()
+
     :param bool no_start_server: False if starts a new JACK server
                                  True if uses a already started jack (ex: using `jackdump`)
     :param name: Jack client name. Default: `JackClient`
@@ -58,3 +62,9 @@ def shutdown(status, reason):
 
         self.client.activate()
 
+    def close(self):
+        """
+        Deactive and closes the jack client
+        """
+        self.client.deactivate()
+        self.client.close()

setup.py

@@ -24,7 +24,7 @@ def readme():
 
 setup(
     name='PedalPi-PluginsManager',
-    version='0.3.2',
+    version='0.4.0',
 
     description='Pythonic management of LV2 audio plugins with mod-host.',
     long_description=readme(),

test/util/persistence_decoder_test.py

@@ -96,16 +96,18 @@ def test_read_unknown_technology(self):
         with self.assertRaises(PersistenceDecoderError):
             PersistenceDecoder(system_effect).read(bank_data)
 
-    @unittest.skip
     @unittest.skipIf('TRAVIS' in os.environ, 'Travis not contains audio interface')
     def test_read_system_builder(self):
         from pluginsmanager.model.system.system_effect_builder import SystemEffectBuilder
+        from pluginsmanager.jack.jack_client import JackClient
 
-        system_effect = SystemEffectBuilder(False).build()
+        client = JackClient(no_start_server=False)
+        system_effect = SystemEffectBuilder(client).build()
 
         util = PersistenceDecoder(system_effect)
 
         bank = self.bank
         bank_readed = util.read(bank.json)
 
         self.assertEqual(bank.json, bank_readed.json)
+        client.close()