new feature: CLI has been born

Author: alexbarcelo

README.md

@@ -33,6 +33,16 @@ source /path/to/venv/bin/activate
 Settings
 --------
 
+Extra CLI features
+------------------
+
+To force both the pull and the execution of commands without a deployment, you can use 
+the built-in `wh-git-trigger` command. Example usage:
+
+    wh-git-trigger /path/to/setings.yaml myrepoentry
+    
+This will force the git pull and execute the commands. Future versions of this tool will 
+include more fine-grain control --e.g. avoid fetch, dry-run, display status information...
 
 Implementation details
 ----------------------

setup.py

@@ -5,7 +5,7 @@
 
 setuptools.setup(
     name="webhooks_git_automata",
-    version="0.0.1",
+    version="0.0.2",
     author="Alex Barcelo",
     author_email="[email protected]",
     description="Webhook receiver for Git deployments",
@@ -17,6 +17,7 @@
     entry_points={
         'console_scripts': [
             'wh-gitd = webhooks_git_automata.webhooks:main_func',
+            'wh-git-trigger = webhooks_git_automata.webhooks:manual_trigger',
         ],
     },
     classifiers=[

webhooks_git_automata/automata.py

@@ -10,6 +10,9 @@ class MetaAutomata(type):
 
     When Automata[<repo>, <branch>] is called, the corresponding Automaton
     instance is returned ready to be used by the worker.
+
+    The alias Automata[<name_as_in_yaml>] is also stored, and used by the
+    manual trigger entrypoint. See also webhooks.manual_trigger
     """
     actions = dict()
 
@@ -23,7 +26,11 @@ def load_config(cls, actions):
             repo = automaton.pop("repo", name)
             branch = automaton.pop("branch", "master")
 
-            cls.actions[repo, branch] = cls(automaton, repo, branch)
+            instance = cls(automaton, repo, branch)
+
+            # Store both lookups
+            cls.actions[repo, branch] = instance
+            cls.actions[name] = instance
 
 
 class Automata(object, metaclass=MetaAutomata):

webhooks_git_automata/webhooks.py

@@ -7,6 +7,7 @@
 
 from .settings import Configuration
 from .worker import async_worker
+from .automata import Automata
 from . import providers
 
 
@@ -39,3 +40,18 @@ def main_func():
     app.add_url_rule('/webhook', 'webhook', webhook, methods=['POST'])
     app.run(host=Configuration.listen_ip,
             port=Configuration.listen_port)
+
+
+def manual_trigger():
+    if len(sys.argv) != 3:
+        raise RuntimeError("You should provide the path to the settings YAML file as first argument "
+                           "and the repository entry name (YAML key) that will be triggered")
+
+    Configuration.load(sys.argv[1])
+    try:
+        automaton = Automata[sys.argv[2]]
+    except KeyError:
+        raise RuntimeError("Unrecognized repository name '%s'" % sys.argv[2])
+
+    automaton.pull_sources()
+    automaton.perform_commands()