Skip to content

Commit

Permalink
Merge branch 'master' of github.com:jesseward/discogs-cli
Browse files Browse the repository at this point in the history
  • Loading branch information
jesseward committed Jun 9, 2016
2 parents 62264f6 + 3ec69ac commit 70fa7c1
Show file tree
Hide file tree
Showing 4 changed files with 48 additions and 3 deletions.
47 changes: 46 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,47 @@
![Imgur](http://i.imgur.com/iAXgnIj.gif)

# discogs-cli
View and search for artists, labels and releases in the Discogs.com library, from the command line.

discogs-cli bring the Discogs.com database to your terminal. Perform the following actions from your terminal

* Search artists, releases, labels
* View artist information and their releases
* View label details and its associated releases
* View a release in detail


## Access to search functionality

Discogs requires [authentication](https://www.discogs.com/developers/#page:authentication) when accessing the search APIs. If you wish to use the search functionality, you're required to generate a personal access token for your discogs.com account. You can do so at https://www.discogs.com/settings/developers by clicking generate new token.

Before starting your application set the `TOKEN` shell variable. where `sys64738` is your unique access token.

$ export TOKEN=sys64738

## Installation

To install from the github source, please ensure you've created a virtual environment.

$ virtualenv ~/.virtualenv/discogs-cli
$ source ~/.virtualenv/discogs-cli/bin/activate

Fetch and install the package from github

$ pip install git+https://github.com/jesseward/discogs-cli.git

Once installed, run `discogs-cli` to launch the interactive command prompt.

$ discogs-cli

To launch commands from the console

$ ogs <command> [params] [options]

## TODO
* Currently runs on a Unix like operating system only (Linux/OSX). If you can test and patch use for windows, please log a pull request.

## About
discogs-cli builds upon the following awesome Python libraries
* The python-prompt-toolkit https://github.com/jonathanslenders/python-prompt-toolkit
* Discogs.com api client https://github.com/discogs/discogs_client
* Haxor-news string completion library https://github.com/donnemartin/haxor-news
2 changes: 1 addition & 1 deletion discogs_cli/ext/utils.py
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@
import shlex
from prompt_toolkit.completion import Completion

from .completions import META_LOOKUP
from ..completions import META_LOOKUP


class TextUtils(object):
Expand Down
2 changes: 1 addition & 1 deletion discogs_cli/main.py
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@
from .ext.completer import Completer
from .discogs import Release, Artist, Label
from .pyglexer import DiscogsCliLexer
from .utils import TextUtils
from .ext.utils import TextUtils


import requests
Expand Down
Binary file added docs/discogs-cli.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 70fa7c1

Please sign in to comment.