Code corresponding to the initial release.

HISTORY.rst

@@ -2,7 +2,7 @@
 History
 =======
 
-0.0.1 (2017-05-24)
+0.0.1 (2017-05-25)
 ------------------
 
 * First release on PyPI.

README.rst

@@ -28,7 +28,7 @@ Manage your labels.
 Features
 --------
 
-* TODO
+* Allows you to list all the labels on a repo, or all repos on an organization.
 
 Credits
 ---------

docs/installation.rst

@@ -14,7 +14,7 @@ To install Epithet, run this command in your terminal:
 
     $ pip install epithet
 
-This is the preferred method to install Epithet, as it will always install the most recent stable release. 
+This is the preferred method to install Epithet, as it will always install the most recent stable release.
 
 If you don't have `pip`_ installed, this `Python installation guide`_ can guide
 you through the process.

docs/usage.rst

@@ -2,6 +2,30 @@
 Usage
 =====
 
+These docs are a little lacking at the moment, and we'd love to see them
+improved!
+
 To use Epithet in a project::
 
-    import epithet
+    $ epithet
+
+    Usage: epithet [OPTIONS] COMMAND [ARGS]...
+
+    Options:
+      --dryrun  Don't actually change or create labels
+      --help    Show this message and exit.
+
+    Commands:
+      add
+      list
+
+    $ epithet add --help
+    Usage: epithet add [OPTIONS]
+
+    Options:
+      --name TEXT   Name of new label
+      --color TEXT  Color of new label
+      --key TEXT    OAuth Token
+      --org TEXT    Organization to get repos from
+      --repo TEXT   Optionally select a single repo
+      --help        Show this message and exit.

epithet/epithet.py

@@ -7,13 +7,7 @@
 def main():
     cli(obj={})
 
-
-@click.group()
-@click.option('--key', help="OAuth Token")
-@click.option('--org', help="Organization to get repos from")
-@click.option('--repo', help="Optionally select a single repo")
-@click.pass_context
-def cli(ctx, key, org, repo):
+def get_repos(key, org, repo):
     g = Github(key)
     if org:
         g_org = g.get_organization(login=org)
@@ -24,34 +18,58 @@ def cli(ctx, key, org, repo):
         repos = [g_org.get_repo(repo)]
     else:
         repos = g_org.get_repos()
-    ctx.obj['repos'] = repos
+    return repos
+
+
+@click.group()
+@click.option('--dryrun', is_flag=True, help="Don't actually change or create labels")
+@click.pass_context
+def cli(ctx, dryrun):
+    ctx.obj['dryrun'] = dryrun
 
 
 @cli.command()
+@click.option('--key', help="OAuth Token")
+@click.option('--org', help="Organization to get repos from")
+@click.option('--repo', help="Optionally select a single repo")
 @click.pass_context
-def list(ctx):
-    for repo in ctx.obj['repos']:
-        click.echo("{}labels:\n".format(repo.name))
+def list(ctx, key, org, repo):
+    for repo in get_repos(key, org, repo):
+        click.echo("\n * {}:\n".format(repo.name))
         for label in repo.get_labels():
-            click.echo("- {} ({})".format(label.name, label.color))
+            click.echo(" - {} ({})".format(label.name, label.color))
 
 
 @cli.command()
+@click.option('--name', help="Name of new label")
+@click.option('--color', help="Color of new label")
+@click.option('--key', help="OAuth Token")
+@click.option('--org', help="Organization to get repos from")
+@click.option('--repo', help="Optionally select a single repo")
 @click.pass_context
-def add(ctx, name, color):
+def add(ctx, name, color, key, org, repo):
     click.echo("name: {}, color: {}".format(name, color))
-    for repo in ctx.obj['repos']:
-        click.echo("Checking {}".format(repo.name))
+    for repo in get_repos(key, org, repo):
+        click.echo(" * Checking {}".format(repo.name))
         labels = {}
         for label in repo.get_labels():
             labels[label.name] = label
         if name in labels:
-            click.echo("Found {} on {}".format(labels[name].name, repo.name))
-            if labels[name].color != color:
+            click.echo(
+                " - Found {} on {} (Dryrun: {})".format(
+                    labels[name].name, repo.name, ctx.obj['dryrun']
+                )
+            )
+            if labels[name].color != color and not ctx.obj['dryrun']:
                 labels[name].edit(name=name, color=color)
         else:
-            click.echo("Creating {} on {}".format(name, repo.name))
-            repo.create_label(name=name, color=color)
+            click.echo(
+                " - Creating {} on {} (Dryrun: {})".format(
+                    name, repo.name, ctx.obj['dryrun']
+                )
+            )
+            if not ctx.obj['dryrun']:
+                repo.create_label(name=name, color=color)
 
 
 if __name__ == "__main__":

requirements_dev.txt

@@ -8,4 +8,6 @@ coverage==4.1
 Sphinx==1.4.8
 cryptography==1.7
 PyYAML==3.11
+Click>=6.0,
+PyGithub==1.34,