├── .gitignore
├── .travis.yml
├── LICENSE
├── MANIFEST.in
├── Makefile
├── README.mkd
├── discogs_client
    ├── __init__.py
    ├── client.py
    ├── exceptions.py
    ├── fetchers.py
    ├── models.py
    ├── tests
    │   ├── __init__.py
    │   ├── make_symlinks.py
    │   ├── res
    │   │   ├── artists
    │   │   │   ├── 1
    │   │   │   │   ├── releases_per_page=50&page=1.json
    │   │   │   │   └── releases_per_page=50&page=2.json
    │   │   │   ├── 1.json
    │   │   │   ├── 2.json
    │   │   │   └── 3.json
    │   │   ├── database
    │   │   │   └── search_q=trash80&per_page=50&page=1.json
    │   │   ├── labels
    │   │   │   ├── 1.json
    │   │   │   └── 31405.json
    │   │   ├── marketplace
    │   │   │   └── fee
    │   │   │   │   └── 20.5000
    │   │   │   │       └── EUR.json
    │   │   ├── masters
    │   │   │   ├── 4242
    │   │   │   │   └── versions_per_page=50&page=1.json
    │   │   │   └── 4242.json
    │   │   ├── oauth
    │   │   │   └── identity.json
    │   │   ├── releases
    │   │   │   ├── 1.json
    │   │   │   ├── 2.json
    │   │   │   ├── 3.json
    │   │   │   ├── 3329867.json
    │   │   │   └── 79.json
    │   │   └── users
    │   │   │   ├── example.json
    │   │   │   └── example
    │   │   │       └── wants_per_page=50&page=1.json
    │   ├── test_core.py
    │   ├── test_fetchers.py
    │   ├── test_models.py
    │   └── test_utils.py
    └── utils.py
├── docs
    ├── authentication.md
    └── quickstart.md
├── requirements.txt
└── setup.py


/.gitignore:
--------------------------------------------------------------------------------
1 | *.pyc
2 | *.egg-info
3 | dist/
4 | 


--------------------------------------------------------------------------------
/.travis.yml:
--------------------------------------------------------------------------------
 1 | language: python
 2 | python:
 3 |     - "2.7"
 4 |     - "3.3"
 5 |     - "3.4"
 6 |     - "3.5"
 7 |     - "3.6"
 8 | install:
 9 |     - pip install -r requirements.txt
10 | script:
11 |     - nosetests --with-coverage --cover-package=discogs_client
12 | after_success:
13 |     - coveralls
14 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
 1 | Copyright © 2015 Discogs. All rights reserved.
 2 | 
 3 | Redistribution and use in source and binary forms, with or without modification,
 4 | are permitted provided that the following conditions are met:
 5 | 
 6 |   1. Redistributions of source code must retain the above copyright notice, this
 7 |   list of conditions and the following disclaimer.
 8 | 
 9 |   2. Redistributions in binary form must reproduce the above copyright notice,
10 |   this list of conditions and the following disclaimer in the documentation
11 |   and/or other materials provided with the distribution.
12 | 
13 | THIS SOFTWARE IS PROVIDED BY DISCOGS ''AS IS'' AND ANY EXPRESS OR IMPLIED
14 | WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
15 | MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT
16 | SHALL DISCOGS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
17 | SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
18 | PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
19 | BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
20 | CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
21 | IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
22 | OF SUCH DAMAGE.
23 | 
24 | The views and conclusions contained in the software and documentation are those
25 | of the authors and should not be interpreted as representing official policies,
26 | either expressed or implied, of Discogs.
27 | 


--------------------------------------------------------------------------------
/MANIFEST.in:
--------------------------------------------------------------------------------
1 | recursive-include discogs_client/tests *.py
2 | recursive-include discogs_client/tests/res *.json 
3 | recursive-exclude discogs_client/tests make_symlinks.py
4 | 


--------------------------------------------------------------------------------
/Makefile:
--------------------------------------------------------------------------------
1 | .PHONY: clean
2 | 
3 | clean:
4 | 	find . -name '*.pyc' -delete
5 | 	find . -name __pycache__ -delete
6 | 


--------------------------------------------------------------------------------
/README.mkd:
--------------------------------------------------------------------------------
  1 | # :warning: DEPRECATED
  2 | 
  3 | This repository is no longer maintained. You can still use a REST client like
  4 | [Requests](https://pypi.org/project/requests/) or other third-party Python
  5 | library to access the [Discogs REST API](https://www.discogs.com/developers).
  6 | 
  7 | ---
  8 | ---
  9 | ---
 10 | 
 11 | # Discogs API Client
 12 | 
 13 | This is the official Discogs API client for Python. It enables you to query the Discogs database for information on artists, releases, labels, users, Marketplace listings, and more. It also supports OAuth 1.0a authorization, which allows you to change user data such as profile information, collections and wantlists, inventory, and orders.
 14 | 
 15 | [![Build Status](https://travis-ci.org/discogs/discogs_client.png?branch=master)](https://travis-ci.org/discogs/discogs_client)
 16 | [![Coverage Status](https://coveralls.io/repos/discogs/discogs_client/badge.png)](https://coveralls.io/r/discogs/discogs_client)
 17 | 
 18 | ## Installation
 19 | 
 20 | Install the client from PyPI using your favorite package manager.
 21 | 
 22 | ```sh
 23 | $ pip install discogs_client
 24 | ```
 25 | 
 26 | ## Quickstart
 27 | 
 28 | ### Instantiating the client object
 29 | 
 30 | ```python
 31 | >>> import discogs_client
 32 | >>> d = discogs_client.Client('ExampleApplication/0.1')
 33 | ```
 34 | 
 35 | ### Authorization (optional)
 36 | 
 37 | There are a couple of different authorization methods you can choose from depending on your requirements.
 38 | 
 39 | #### OAuth authentication ####
 40 | 
 41 | This method will allow your application to make requests on behalf of any user who logs in.
 42 | 
 43 | For this, specify your app's consumer key and secret:
 44 | 
 45 | ```python
 46 | >>> d.set_consumer_key('key-here', 'secret-here')
 47 | >>> # Or you can do this when you instantiate the Client
 48 | ```
 49 | 
 50 | Then go through the OAuth 1.0a process. In a web app, we'd specify a `callback_url`. In this example, we'll use the OOB flow.
 51 | 
 52 | ```python
 53 | >>> d.get_authorize_url()
 54 | ('request-token', 'request-secret', 'authorize-url-here')
 55 | ```
 56 |     
 57 | The client will hang on to the access token and secret, but in a web app, you'd want to persist those and pass them into a new `Client` instance on the next request.
 58 | 
 59 | Next, visit the authorize URL, authenticate as a Discogs user, and get the verifier:
 60 | 
 61 | ```python
 62 | >>> d.get_access_token('verifier-here')
 63 | ('access-token-here', 'access-secret-here')
 64 | ```
 65 | 
 66 | Now you can make requests on behalf of the user.
 67 | 
 68 | ```python
 69 | >>> me = d.identity()
 70 | >>> "I'm {0} ({1}) from {2}.".format(me.name, me.username, me.location)
 71 | u"I'm Joe Bloggs (example) from Portland, Oregon."
 72 | >>> len(me.wantlist)
 73 | 3
 74 | >>> me.wantlist.add(d.release(5))
 75 | >>> len(me.wantlist)
 76 | 4
 77 | ```
 78 | 
 79 | #### User-token authentication ####
 80 | 
 81 | This is one of the simplest ways to authenticate and become able to perform requests requiring authentication, such as search (see below). The downside is that you'll be limited to the information only your user account can see (i.e., no requests on behalf of other users).
 82 | 
 83 | For this, you'll need to generate a user-token from your developer settings on the Discogs website.
 84 | 
 85 | ```python
 86 | >>> d = discogs_client.Client('ExampleApplication/0.1', user_token="my_user_token")
 87 | ```
 88 | 
 89 | ### Fetching data
 90 | 
 91 | Use methods on the client to fetch objects. You can search for objects:
 92 | 
 93 | ```python
 94 | >>> results = d.search('Stockholm By Night', type='release')
 95 | >>> results.pages
 96 | 1
 97 | >>> artist = results[0].artists[0]
 98 | >>> artist.name
 99 | u'Persuader, The'
100 | ```
101 | 
102 | Or fetch them by ID:
103 | 
104 | ```python
105 | >>> artist.id
106 | 1
107 | >>> artist == d.artist(1)
108 | True
109 | ```
110 | 
111 | You can drill down as far as you like.
112 | 
113 | ```python
114 | >>> releases = d.search('Bit Shifter', type='artist')[0].releases[1].\
115 | ...     versions[0].labels[0].releases
116 | >>> len(releases)
117 | 134
118 | ```
119 | 
120 | ## Artist
121 | 
122 | Query for an artist using the artist's name:
123 | 
124 |     >>> artist = d.artist(956139)
125 |     >>> print artist
126 |     <Artist "...">
127 |     >>> 'name' in artist.data.keys()
128 |     True
129 | 
130 | ### Special properties
131 | 
132 | Get a list of `Artist`s representing this artist's aliases:
133 | 
134 |     >>> artist.aliases
135 |     [...]
136 | 
137 | Get a list of `Release`s by this artist by page number:
138 | 
139 |     >>> artist.releases.page(1)
140 |     [...]
141 | 
142 | ## Release
143 | 
144 | Query for a release using its Discogs ID:
145 | 
146 |     >>> release = d.release(221824)
147 | 
148 | ### Special properties
149 | 
150 | Get the title of this `Release`:
151 | 
152 |     >>> release.title
153 |     u'...'
154 | 
155 | Get a list of all `Artist`s associated with this `Release`:
156 | 
157 |     >>> release.artists
158 |     [<Artist "...">]
159 | 
160 | Get the tracklist for this `Release`:
161 | 
162 |     >>> release.tracklist
163 |     [...]
164 | 
165 | Get the `MasterRelease` for this `Release`:
166 | 
167 |     >>> release.master
168 |     <MasterRelease "...">
169 | 
170 | Get a list of all `Label`s for this `Release`:
171 | 
172 |     >>> release.labels
173 |     [...]
174 | 
175 | ## MasterRelease
176 | 
177 | Query for a master release using its Discogs ID:
178 | 
179 |     >>> master_release = d.master(120735)
180 | 
181 | ### Special properties
182 | 
183 | Get the key `Release` for this `MasterRelease`:
184 | 
185 |     >>> master_release.main_release
186 |     <Release "...">
187 | 
188 | Get the title of this `MasterRelease`:
189 | 
190 |     >>> master_release.title
191 |     u'...'
192 |     >>> master_release.title == master_release.main_release.title
193 |     True
194 | 
195 | Get a list of `Release`s representing other versions of this `MasterRelease` by page number:
196 | 
197 |     >>> master_release.versions.page(1)
198 |     [...]
199 | 
200 | Get the tracklist for this `MasterRelease`:
201 | 
202 |     >>> master_release.tracklist
203 |     [...]
204 | 
205 | ## Label
206 | 
207 | Query for a label using the label's name:
208 | 
209 |     >>> label = d.label(6170)
210 | 
211 | ### Special properties
212 | 
213 | Get a list of `Release`s from this `Label` by page number:
214 | 
215 |     >>> label.releases.page(1)
216 |     [...]
217 | 
218 | Get a list of `Label`s representing sublabels associated with this `Label`:
219 | 
220 |     >>> label.sublabels
221 |     [...]
222 | 
223 | Get the `Label`'s parent label, if it exists:
224 | 
225 |     >>> label.parent_label
226 |     <Label "Warp Records Limited">
227 | 
228 | 
229 | ## Contributing
230 | 1. Fork this repo
231 | 2. Create a feature branch
232 | 3. Open a pull-request
233 | 
234 | ### For more information
235 | 
236 | Check the included documentation, or just spin up a REPL and use `dir()` on things :)
237 | 


--------------------------------------------------------------------------------
/discogs_client/__init__.py:
--------------------------------------------------------------------------------
1 | from __future__ import absolute_import, division, print_function, unicode_literals
2 | 
3 | __version_info__ = 2, 2, 2
4 | __version__ = '2.2.2'
5 | 
6 | from discogs_client.client import Client
7 | from discogs_client.models import Artist, Release, Master, Label, User, \
8 |     Listing, Track, Price, Video
9 | 


--------------------------------------------------------------------------------
/discogs_client/client.py:
--------------------------------------------------------------------------------
  1 | from __future__ import absolute_import, division, print_function, unicode_literals
  2 | 
  3 | import warnings
  4 | import json
  5 | try:
  6 |     # python2
  7 |     from urllib import urlencode
  8 | except ImportError:
  9 |     # python3
 10 |     from urllib.parse import urlencode
 11 | 
 12 | from discogs_client import models
 13 | from discogs_client.exceptions import ConfigurationError, HTTPError, AuthorizationError
 14 | from discogs_client.utils import update_qs
 15 | from discogs_client.fetchers import RequestsFetcher, OAuth2Fetcher, UserTokenRequestsFetcher
 16 | 
 17 | 
 18 | class Client(object):
 19 |     _base_url = 'https://api.discogs.com'
 20 |     _request_token_url = 'https://api.discogs.com/oauth/request_token'
 21 |     _authorize_url = 'https://www.discogs.com/oauth/authorize'
 22 |     _access_token_url = 'https://api.discogs.com/oauth/access_token'
 23 | 
 24 |     def __init__(self, user_agent, consumer_key=None, consumer_secret=None, token=None, secret=None, user_token=None):
 25 |         """An interface to the Discogs API."""
 26 |         self.user_agent = user_agent
 27 |         self.verbose = False
 28 |         self._fetcher = RequestsFetcher()
 29 | 
 30 |         if consumer_key and consumer_secret:
 31 |             self.set_consumer_key(consumer_key, consumer_secret)
 32 |             if token and secret:
 33 |                 self.set_token(token, secret)
 34 |         elif user_token is not None:
 35 |             self._fetcher = UserTokenRequestsFetcher(user_token)
 36 | 
 37 |     def set_consumer_key(self, consumer_key, consumer_secret):
 38 |         self._fetcher = OAuth2Fetcher(consumer_key, consumer_secret)
 39 | 
 40 |     def set_token(self, token, secret):
 41 |         try:
 42 |             self._fetcher.store_token(token, secret)
 43 |         except AttributeError:
 44 |             raise ConfigurationError('You must first set the consumer key and secret.')
 45 | 
 46 |     def get_authorize_url(self, callback_url=None):
 47 |         """
 48 |         Returns a tuple of (<access_token>, <access_secret>, <authorize_url>).
 49 |         Send a Discogs user to the authorize URL to get the verifier for the access token.
 50 |         """
 51 |         # Forget existing tokens
 52 |         self._fetcher.forget_token()
 53 | 
 54 |         params = {}
 55 |         params['User-Agent'] = self.user_agent
 56 |         params['Content-Type'] = 'application/x-www-form-urlencoded'
 57 |         if callback_url:
 58 |             params['oauth_callback'] = callback_url
 59 |         postdata = urlencode(params)
 60 | 
 61 |         content, status_code = self._fetcher.fetch(self, 'POST', self._request_token_url, data=postdata, headers=params)
 62 |         if status_code != 200:
 63 |             raise AuthorizationError('Could not get request token.', status_code, content)
 64 | 
 65 |         token, secret = self._fetcher.store_token_from_qs(content)
 66 | 
 67 |         params = {'oauth_token': token}
 68 |         query_string = urlencode(params)
 69 | 
 70 |         return (token, secret, '?'.join((self._authorize_url, query_string)))
 71 | 
 72 |     def get_access_token(self, verifier):
 73 |         """
 74 |         Uses the verifier to exchange a request token for an access token.
 75 |         """
 76 |         if isinstance(verifier, bytes):
 77 |             verifier = verifier.decode('utf8')
 78 | 
 79 |         self._fetcher.set_verifier(verifier)
 80 | 
 81 |         params = {}
 82 |         params['User-Agent'] = self.user_agent
 83 | 
 84 |         content, status_code = self._fetcher.fetch(self, 'POST', self._access_token_url, headers=params)
 85 |         if status_code != 200:
 86 |             raise HTTPError('Invalid response from access token URL.', status_code)
 87 | 
 88 |         token, secret = self._fetcher.store_token_from_qs(content)
 89 | 
 90 |         return token, secret
 91 | 
 92 |     def _check_user_agent(self):
 93 |         if not self.user_agent:
 94 |             raise ConfigurationError('Invalid or no User-Agent set.')
 95 | 
 96 |     def _request(self, method, url, data=None):
 97 |         if self.verbose:
 98 |             print(' '.join((method, url)))
 99 | 
100 |         self._check_user_agent()
101 | 
102 |         headers = {
103 |             'Accept-Encoding': 'gzip',
104 |             'User-Agent': self.user_agent,
105 |         }
106 | 
107 |         if data:
108 |             headers['Content-Type'] = 'application/x-www-form-urlencoded'
109 | 
110 |         content, status_code = self._fetcher.fetch(self, method, url, data=data, headers=headers)
111 | 
112 |         if status_code == 204:
113 |             return None
114 | 
115 |         body = json.loads(content.decode('utf8'))
116 | 
117 |         if 200 <= status_code < 300:
118 |             return body
119 |         else:
120 |             raise HTTPError(body['message'], status_code)
121 | 
122 |     def _get(self, url):
123 |         return self._request('GET', url)
124 | 
125 |     def _delete(self, url):
126 |         return self._request('DELETE', url)
127 | 
128 |     def _post(self, url, data):
129 |         return self._request('POST', url, data)
130 | 
131 |     def _patch(self, url, data):
132 |         return self._request('PATCH', url, data)
133 | 
134 |     def _put(self, url, data):
135 |         return self._request('PUT', url, data)
136 | 
137 |     def search(self, *query, **fields):
138 |         """
139 |         Search the Discogs database. Returns a paginated list of objects
140 |         (Artists, Releases, Masters, and Labels). The keyword arguments to this
141 |         function are serialized into the request's query string.
142 |         """
143 |         if query:
144 |             unicode_query = []
145 |             for q in query:
146 |                 try:
147 |                     unicode_q = q.decode('utf8')
148 |                 except (UnicodeDecodeError, UnicodeEncodeError, AttributeError):
149 |                     unicode_q = q
150 |                 unicode_query.append(unicode_q)
151 |             fields['q'] = ' '.join(unicode_query)
152 |         return models.MixedPaginatedList(
153 |             self,
154 |             update_qs(self._base_url + '/database/search', fields),
155 |             'results'
156 |         )
157 | 
158 |     def artist(self, id):
159 |         """Fetch an Artist by ID."""
160 |         return models.Artist(self, {'id': id})
161 | 
162 |     def release(self, id):
163 |         """Fetch a Release by ID."""
164 |         return models.Release(self, {'id': id})
165 | 
166 |     def master(self, id):
167 |         """Fetch a Master by ID."""
168 |         return models.Master(self, {'id': id})
169 | 
170 |     def label(self, id):
171 |         """Fetch a Label by ID."""
172 |         return models.Label(self, {'id': id})
173 | 
174 |     def user(self, username):
175 |         """Fetch a User by username."""
176 |         return models.User(self, {'username': username})
177 | 
178 |     def listing(self, id):
179 |         """Fetch a Marketplace Listing by ID."""
180 |         return models.Listing(self, {'id': id})
181 | 
182 |     def order(self, id):
183 |         """Fetch an Order by ID."""
184 |         return models.Order(self, {'id': id})
185 | 
186 |     def fee_for(self, price, currency='USD'):
187 |         """Calculate the fee for selling an item on the Marketplace."""
188 |         resp = self._get('{0}/marketplace/fee/{1:.4f}/{2}'.format(self._base_url, price, currency))
189 |         return models.Price(self, {'value': resp['value'], 'currency': resp['currency']})
190 | 
191 |     def identity(self):
192 |         """Return a User object representing the OAuth-authorized user."""
193 |         resp = self._get(self._base_url + '/oauth/identity')
194 |         return models.User(self, resp)
195 | 


--------------------------------------------------------------------------------
/discogs_client/exceptions.py:
--------------------------------------------------------------------------------
 1 | from __future__ import absolute_import, division, print_function, unicode_literals
 2 | 
 3 | 
 4 | class DiscogsAPIError(Exception):
 5 |     """Root Exception class for Discogs API errors."""
 6 |     pass
 7 | 
 8 | 
 9 | class ConfigurationError(DiscogsAPIError):
10 |     """Exception class for problems with the configuration of this client."""
11 |     def __init__(self, msg):
12 |         self.msg = msg
13 | 
14 |     def __str__(self):
15 |         return self.msg
16 | 
17 | 
18 | class HTTPError(DiscogsAPIError):
19 |     """Exception class for HTTP errors."""
20 |     def __init__(self, message, code):
21 |         self.status_code = code
22 |         self.msg = '{0}: {1}'.format(code, message)
23 | 
24 |     def __str__(self):
25 |         return self.msg
26 | 
27 | 
28 | class AuthorizationError(HTTPError):
29 |     """The server rejected the client's credentials."""
30 |     def __init__(self, message, code, response):
31 |         super(AuthorizationError, self).__init__(message, code)
32 |         self.msg = '{0} Response: {1!r}'.format(self.msg, response)
33 | 


--------------------------------------------------------------------------------
/discogs_client/fetchers.py:
--------------------------------------------------------------------------------
  1 | from __future__ import absolute_import, division, print_function, unicode_literals
  2 | import requests
  3 | from requests.api import request
  4 | from oauthlib import oauth1
  5 | import json
  6 | import os
  7 | import re
  8 | try:
  9 |     # python2
 10 |     from urlparse import parse_qsl
 11 | except ImportError:
 12 |     # python3
 13 |     from urllib.parse import parse_qsl
 14 | 
 15 | 
 16 | class Fetcher(object):
 17 |     """
 18 |     Base class for Fetchers, which wrap and normalize the APIs of various HTTP
 19 |     libraries.
 20 | 
 21 |     (It's a slightly leaky abstraction designed to make testing easier.)
 22 |     """
 23 |     def fetch(self, client, method, url, data=None, headers=None, json=True):
 24 |         """Fetch the given request
 25 | 
 26 |         Returns
 27 |         -------
 28 |         content : str (python2) or bytes (python3)
 29 |         status_code : int
 30 |         """
 31 |         raise NotImplementedError()
 32 | 
 33 | 
 34 | class LoggingDelegator(object):
 35 |     """Wraps a fetcher and logs all requests."""
 36 |     def __init__(self, fetcher):
 37 |         self.fetcher = fetcher
 38 |         self.requests = []
 39 | 
 40 |     @property
 41 |     def last_request(self):
 42 |         return self.requests[-1] if self.requests else None
 43 | 
 44 |     def fetch(self, client, method, url, data=None, headers=None, json=True):
 45 |         self.requests.append((method, url, data, headers))
 46 |         return self.fetcher.fetch(client, method, url, data, headers, json)
 47 | 
 48 | 
 49 | class RequestsFetcher(Fetcher):
 50 |     """Fetches via HTTP from the Discogs API."""
 51 |     def fetch(self, client, method, url, data=None, headers=None, json=True):
 52 |         resp = requests.request(method, url, data=data, headers=headers)
 53 |         return resp.content, resp.status_code
 54 | 
 55 | 
 56 | class UserTokenRequestsFetcher(Fetcher):
 57 |     """Fetches via HTTP from the Discogs API using user_token authentication"""
 58 |     def __init__(self, user_token):
 59 |         self.user_token = user_token
 60 | 
 61 |     def fetch(self, client, method, url, data=None, headers=None, json=True):
 62 |         resp = requests.request(method, url, params={'token':self.user_token},
 63 |                                 data=data, headers=headers)
 64 |         return resp.content, resp.status_code
 65 | 
 66 | 
 67 | class OAuth2Fetcher(Fetcher):
 68 |     """Fetches via HTTP + OAuth 1.0a from the Discogs API."""
 69 |     def __init__(self, consumer_key, consumer_secret, token=None, secret=None):
 70 |         self.client = oauth1.Client(consumer_key, client_secret=consumer_secret)
 71 |         self.store_token(token, secret)
 72 | 
 73 |     def store_token_from_qs(self, query_string):
 74 |         token_dict = dict(parse_qsl(query_string))
 75 |         token = token_dict[b'oauth_token'].decode('utf8')
 76 |         secret = token_dict[b'oauth_token_secret'].decode('utf8')
 77 |         self.store_token(token, secret)
 78 |         return token, secret
 79 | 
 80 |     def forget_token(self):
 81 |         self.store_token(None, None)
 82 | 
 83 |     def store_token(self, token, secret):
 84 |         self.client.resource_owner_key = token
 85 |         self.client.resource_owner_secret = secret
 86 | 
 87 |     def set_verifier(self, verifier):
 88 |         self.client.verifier = verifier
 89 | 
 90 |     def fetch(self, client, method, url, data=None, headers=None, json_format=True):
 91 |         body = json.dumps(data) if json_format and data else data
 92 |         uri, headers, body = self.client.sign(url, http_method=method,
 93 |                                               body=data, headers=headers)
 94 | 
 95 |         resp = request(method, uri, headers=headers, data=body)
 96 |         return resp.content, resp.status_code
 97 | 
 98 | 
 99 | class FilesystemFetcher(Fetcher):
100 |     """Fetches from a directory of files."""
101 |     default_response = json.dumps({'message': 'Resource not found.'}).encode('utf8'), 404
102 |     path_with_params = re.compile('(?P<dir>(\w+/)+)(?P<query>\w+)\?(?P<params>.*)')
103 | 
104 |     def __init__(self, base_path):
105 |         self.base_path = base_path
106 | 
107 |     def fetch(self, client, method, url, data=None, headers=None, json=True):
108 |         url = url.replace(client._base_url, '')
109 | 
110 |         if json:
111 |             base_name = ''.join((url[1:], '.json'))
112 |         else:
113 |             base_name = url[1:]
114 | 
115 |         path = os.path.join(self.base_path, base_name)
116 | 
117 |         # The exact path might not exist, but check for files with different
118 |         # permutations of query parameters.
119 |         if not os.path.exists(path):
120 |             base_name = self.check_alternate_params(base_name, json)
121 |             path = os.path.join(self.base_path, base_name)
122 | 
123 |         try:
124 |             path = path.replace('?', '_')  # '?' is illegal in file names on Windows
125 |             with open(path, 'r') as f:
126 |                 content = f.read().encode('utf8')  # return bytes not unicode
127 |             return content, 200
128 |         except:
129 |             return self.default_response
130 | 
131 |     def check_alternate_params(self, base_name, json):
132 |         """
133 |         parse_qs() result is non-deterministic - a different file might be
134 |         requested, making the tests fail randomly, depending on the order of parameters in the query.
135 |         This fixes it by checking for matching file names with a different permutations of the parameters.
136 |         """
137 |         match = self.path_with_params.match(base_name)
138 | 
139 |         # No parameters in query - no match. Nothing to do.
140 |         if not match:
141 |             return base_name
142 | 
143 |         ext = '.json' if json else ''
144 | 
145 |         # The base name consists of one or more path elements (directories),
146 |         # a query (discogs.com endpoint), query parameters, and possibly an extension like 'json'.
147 |         # Extract these.
148 |         base_dir = os.path.join(self.base_path, match.group('dir'))
149 |         query = match.group('query')  # we'll need this to only check relevant filenames
150 |         params_str = match.group('params')[:-len(ext)]  # strip extension if any
151 |         params = set(params_str.split('&'))
152 | 
153 |         # List files that match the same query, possibly with different parameters
154 |         filenames = [f for f in os.listdir(base_dir) if f.startswith(query)]
155 |         for f in filenames:
156 |             # Strip the query, the '?' sign (or its replacement) and the extension, if any
157 |             params2_str = f[len(query) + 1:-len(ext)]
158 |             params2 = set(params2_str.split('&'))
159 |             if params == params2:
160 |                 return base_name.replace(params_str, params2_str)
161 | 
162 |         # No matching alternatives found - revert to original.
163 |         return base_name
164 | 
165 | 
166 | class MemoryFetcher(Fetcher):
167 |     """Fetches from a dict of URL -> (content, status_code)."""
168 |     default_response = json.dumps({'message': 'Resource not found.'}).encode('utf8'), 404
169 | 
170 |     def __init__(self, responses):
171 |         self.responses = responses
172 | 
173 |     def fetch(self, client, method, url, data=None, headers=None, json=True):
174 |         return self.responses.get(url, self.default_response)
175 | 


--------------------------------------------------------------------------------
/discogs_client/models.py:
--------------------------------------------------------------------------------
  1 | from __future__ import absolute_import, division, print_function, unicode_literals
  2 | import sys
  3 | 
  4 | from six import with_metaclass
  5 | 
  6 | from discogs_client.exceptions import HTTPError
  7 | from discogs_client.utils import parse_timestamp, update_qs, omit_none
  8 | 
  9 | 
 10 | class SimpleFieldDescriptor(object):
 11 |     """
 12 |     An attribute that determines its value using the object's fetch() method.
 13 | 
 14 |     If transform is a callable, the value will be passed through transform when
 15 |     read. Useful for strings that should be ints, parsing timestamps, etc.
 16 | 
 17 |     Shorthand for:
 18 | 
 19 |         @property
 20 |         def foo(self):
 21 |             return self.fetch('foo')
 22 |     """
 23 |     def __init__(self, name, writable=False, transform=None):
 24 |         self.name = name
 25 |         self.writable = writable
 26 |         self.transform = transform
 27 | 
 28 |     def __get__(self, instance, owner):
 29 |         if instance is None:
 30 |             return self
 31 |         value = instance.fetch(self.name)
 32 |         if self.transform:
 33 |             value = self.transform(value)
 34 |         return value
 35 | 
 36 |     def __set__(self, instance, value):
 37 |         if self.writable:
 38 |             instance.changes[self.name] = value
 39 |             return
 40 |         raise AttributeError("can't set attribute")
 41 | 
 42 | 
 43 | class ObjectFieldDescriptor(object):
 44 |     """
 45 |     An attribute that determines its value using the object's fetch() method,
 46 |     and passes the resulting value through an APIObject.
 47 | 
 48 |     If optional = True, the value will be None (rather than an APIObject
 49 |     instance) if the key is missing from the response.
 50 | 
 51 |     If as_id = True, the value is treated as an ID for the new APIObject rather
 52 |     than a partial dict of the APIObject.
 53 | 
 54 |     Shorthand for:
 55 | 
 56 |         @property
 57 |         def baz(self):
 58 |             return BazClass(self.client, self.fetch('baz'))
 59 |     """
 60 |     def __init__(self, name, class_name, optional=False, as_id=False):
 61 |         self.name = name
 62 |         self.class_name = class_name
 63 |         self.optional = optional
 64 |         self.as_id = as_id
 65 | 
 66 |     def __get__(self, instance, owner):
 67 |         if instance is None:
 68 |             return self
 69 |         wrapper_class = CLASS_MAP[self.class_name.lower()]
 70 |         response_dict = instance.fetch(self.name)
 71 |         if self.optional and not response_dict:
 72 |             return None
 73 |         if self.as_id:
 74 |             # Response_dict wasn't really a dict. Make it so.
 75 |             response_dict = {'id': response_dict}
 76 |         return wrapper_class(instance.client, response_dict)
 77 | 
 78 |     def __set__(self, instance, value):
 79 |         raise AttributeError("can't set attribute")
 80 | 
 81 | 
 82 | class ListFieldDescriptor(object):
 83 |     """
 84 |     An attribute that determines its value using the object's fetch() method,
 85 |     and passes each item in the resulting list through an APIObject.
 86 | 
 87 |     Shorthand for:
 88 | 
 89 |         @property
 90 |         def bar(self):
 91 |             return [BarClass(self.client, d) for d in self.fetch('bar', [])]
 92 |     """
 93 |     def __init__(self, name, class_name):
 94 |         self.name = name
 95 |         self.class_name = class_name
 96 | 
 97 |     def __get__(self, instance, owner):
 98 |         if instance is None:
 99 |             return self
100 |         wrapper_class = CLASS_MAP[self.class_name.lower()]
101 |         return [wrapper_class(instance.client, d) for d in instance.fetch(self.name, [])]
102 | 
103 |     def __set__(self, instance, value):
104 |         raise AttributeError("can't set attribute")
105 | 
106 | 
107 | class ObjectCollectionDescriptor(object):
108 |     """
109 |     An attribute that determines its value by fetching a URL to a paginated
110 |     list of related objects, and passes each item in the resulting list through
111 |     an APIObject.
112 | 
113 |     Shorthand for:
114 | 
115 |         @property
116 |         def frozzes(self):
117 |             return PaginatedList(self.client, self.fetch('frozzes_url'), 'frozzes', FrozClass)
118 |     """
119 |     def __init__(self, name, class_name, url_key=None, list_class=None):
120 |         self.name = name
121 |         self.class_name = class_name
122 | 
123 |         if url_key is None:
124 |             url_key = name + '_url'
125 |         self.url_key = url_key
126 | 
127 |         if list_class is None:
128 |             list_class = PaginatedList
129 |         self.list_class = list_class
130 | 
131 |     def __get__(self, instance, owner):
132 |         if instance is None:
133 |             return self
134 |         wrapper_class = CLASS_MAP[self.class_name.lower()]
135 |         return self.list_class(instance.client, instance.fetch(self.url_key), self.name, wrapper_class)
136 | 
137 |     def __set__(self, instance, value):
138 |         raise AttributeError("can't set attribute")
139 | 
140 | 
141 | class Field(object):
142 |     """
143 |     A placeholder for a descriptor. Is transformed into a descriptor by the
144 |     APIObjectMeta metaclass when the APIObject classes are created.
145 |     """
146 |     _descriptor_class = None
147 | 
148 |     def __init__(self, *args, **kwargs):
149 |         self.key = kwargs.pop('key', None)
150 |         self.args = args
151 |         self.kwargs = kwargs
152 | 
153 |     def to_descriptor(self, attr_name):
154 |         return self._descriptor_class(self.key or attr_name, *self.args, **self.kwargs)
155 | 
156 | 
157 | class SimpleField(Field):
158 |     """A field that just returns the value of a given JSON key."""
159 |     _descriptor_class = SimpleFieldDescriptor
160 | 
161 | 
162 | class ListField(Field):
163 |     """A field that returns a list of APIObjects."""
164 |     _descriptor_class = ListFieldDescriptor
165 | 
166 | 
167 | class ObjectField(Field):
168 |     """A field that returns a single APIObject."""
169 |     _descriptor_class = ObjectFieldDescriptor
170 | 
171 | 
172 | class ObjectCollection(Field):
173 |     """A field that returns a paginated list of APIObjects."""
174 |     _descriptor_class = ObjectCollectionDescriptor
175 | 
176 | 
177 | class APIObjectMeta(type):
178 |     def __new__(cls, name, bases, dict_):
179 |         for k, v in dict_.items():
180 |             if isinstance(v, Field):
181 |                 dict_[k] = v.to_descriptor(k)
182 |         return super(APIObjectMeta, cls).__new__(cls, name, bases, dict_)
183 | 
184 | 
185 | class APIObject(with_metaclass(APIObjectMeta, object)):
186 |     def repr_str(self, string):
187 |         if sys.version_info < (3,):
188 |             return string.encode('utf-8')
189 |         return string
190 | 
191 | 
192 | class PrimaryAPIObject(APIObject):
193 |     """A first-order API object that has a canonical endpoint of its own."""
194 |     def __init__(self, client, dict_):
195 |         self.data = dict_
196 |         self.client = client
197 |         self._known_invalid_keys = []
198 |         self.changes = {}
199 | 
200 |     def __eq__(self, other):
201 |         if isinstance(other, self.__class__):
202 |             return self.id == other.id
203 |         return NotImplemented
204 | 
205 |     def __ne__(self, other):
206 |         equal = self.__eq__(other)
207 |         return NotImplemented if equal is NotImplemented else not equal
208 | 
209 |     def refresh(self):
210 |         if self.data.get('resource_url'):
211 |             data = self.client._get(self.data['resource_url'])
212 |             self.data.update(data)
213 |             self.changes = {}
214 | 
215 |     def save(self):
216 |         if self.data.get('resource_url'):
217 |             # TODO: This should be PATCH
218 |             self.client._post(self.data['resource_url'], self.changes)
219 | 
220 |             # Refresh the object, in case there were side-effects
221 |             self.refresh()
222 | 
223 |     def delete(self):
224 |         if self.data.get('resource_url'):
225 |             self.client._delete(self.data['resource_url'])
226 | 
227 |     def fetch(self, key, default=None):
228 |         if key in self._known_invalid_keys:
229 |             return default
230 | 
231 |         try:
232 |             # First, look in the cache of pending changes
233 |             return self.changes[key]
234 |         except KeyError:
235 |             pass
236 | 
237 |         try:
238 |             # Next, look in the potentially incomplete local cache
239 |             return self.data[key]
240 |         except KeyError:
241 |             pass
242 | 
243 |         # Now refresh the object from its resource_url.
244 |         # The key might exist but not be in our cache.
245 |         self.refresh()
246 | 
247 |         try:
248 |             return self.data[key]
249 |         except:
250 |             self._known_invalid_keys.append(key)
251 |             return default
252 | 
253 | 
254 | # This is terribly cheesy, but makes the client API more consistent
255 | class SecondaryAPIObject(APIObject):
256 |     """
257 |     An object that wraps parts of a response and doesn't have its own
258 |     endpoint.
259 |     """
260 |     def __init__(self, client, dict_):
261 |         self.client = client
262 |         self.data = dict_
263 | 
264 |     def fetch(self, key, default=None):
265 |         return self.data.get(key, default)
266 | 
267 | 
268 | class BasePaginatedResponse(object):
269 |     """Base class for lists of objects spread across many URLs."""
270 |     def __init__(self, client, url):
271 |         self.client = client
272 |         self.url = url
273 |         self._num_pages = None
274 |         self._num_items = None
275 |         self._pages = {}
276 |         self._per_page = 50
277 |         self._list_key = 'items'
278 |         self._sort_key = None
279 |         self._sort_order = 'asc'
280 |         self._filters = {}
281 | 
282 |     @property
283 |     def per_page(self):
284 |         return self._per_page
285 | 
286 |     @per_page.setter
287 |     def per_page(self, value):
288 |         self._per_page = value
289 |         self._invalidate()
290 | 
291 |     def _invalidate(self):
292 |         self._pages = {}
293 |         self._num_pages = None
294 |         self._num_items = None
295 | 
296 |     def _load_pagination_info(self):
297 |         data = self.client._get(self._url_for_page(1))
298 |         self._pages[1] = [
299 |             self._transform(item) for item in data[self._list_key]
300 |         ]
301 |         self._num_pages = data['pagination']['pages']
302 |         self._num_items = data['pagination']['items']
303 | 
304 |     def _url_for_page(self, page):
305 |         base_qs = {
306 |             'page': page,
307 |             'per_page': self._per_page,
308 |         }
309 | 
310 |         if self._sort_key is not None:
311 |             base_qs.update({
312 |                 'sort': self._sort_key,
313 |                 'sort_order': self._sort_order,
314 |             })
315 | 
316 |         base_qs.update(self._filters)
317 | 
318 |         return update_qs(self.url, base_qs)
319 | 
320 |     def sort(self, key, order='asc'):
321 |         if order not in ('asc', 'desc'):
322 |             raise ValueError("Order must be one of 'asc', 'desc'")
323 |         self._sort_key = key
324 |         self._sort_order = order
325 |         self._invalidate()
326 |         return self
327 | 
328 |     def filter(self, **kwargs):
329 |         self._filters = kwargs
330 |         self._invalidate()
331 |         return self
332 | 
333 |     @property
334 |     def pages(self):
335 |         if self._num_pages is None:
336 |             self._load_pagination_info()
337 |         return self._num_pages
338 | 
339 |     @property
340 |     def count(self):
341 |         if self._num_items is None:
342 |             self._load_pagination_info()
343 |         return self._num_items
344 | 
345 |     def page(self, index):
346 |         if index not in self._pages:
347 |             data = self.client._get(self._url_for_page(index))
348 |             self._pages[index] = [
349 |                 self._transform(item) for item in data[self._list_key]
350 |             ]
351 |         return self._pages[index]
352 | 
353 |     def _transform(self, item):
354 |         return item
355 | 
356 |     def __getitem__(self, index):
357 |         page_index = index // self.per_page + 1
358 |         offset = index % self.per_page
359 | 
360 |         try:
361 |             page = self.page(page_index)
362 |         except HTTPError as e:
363 |             if e.status_code == 404:
364 |                 raise IndexError(e.msg)
365 |             else:
366 |                 raise
367 | 
368 |         return page[offset]
369 | 
370 |     def __len__(self):
371 |         return self.count
372 | 
373 |     def __iter__(self):
374 |         for i in range(1, self.pages + 1):
375 |             page = self.page(i)
376 |             for item in page:
377 |                 yield item
378 | 
379 | 
380 | class PaginatedList(BasePaginatedResponse):
381 |     """A paginated list of objects of a particular class."""
382 |     def __init__(self, client, url, key, class_):
383 |         super(PaginatedList, self).__init__(client, url)
384 |         self._list_key = key
385 |         self.class_ = class_
386 | 
387 |     def _transform(self, item):
388 |         return self.class_(self.client, item)
389 | 
390 | 
391 | class Wantlist(PaginatedList):
392 |     def add(self, release, notes=None, notes_public=None, rating=None):
393 |         release_id = release.id if isinstance(release, Release) else release
394 |         data = {
395 |             'release_id': str(release_id),
396 |             'notes': notes,
397 |             'notes_public': notes_public,
398 |             'rating': rating,
399 |         }
400 |         self.client._put(self.url + '/' + str(release_id), omit_none(data))
401 |         self._invalidate()
402 | 
403 |     def remove(self, release):
404 |         release_id = release.id if isinstance(release, Release) else release
405 |         self.client._delete(self.url + '/' + str(release_id))
406 |         self._invalidate()
407 | 
408 | 
409 | class OrderMessagesList(PaginatedList):
410 |     def add(self, message=None, status=None, email_buyer=True, email_seller=False):
411 |         data = {
412 |             'message': message,
413 |             'status': status,
414 |             'email_buyer': email_buyer,
415 |             'email_seller': email_seller,
416 |         }
417 |         self.client._post(self.url, omit_none(data))
418 |         self._invalidate()
419 | 
420 | 
421 | class MixedPaginatedList(BasePaginatedResponse):
422 |     """A paginated list of objects identified by their type parameter."""
423 |     def __init__(self, client, url, key):
424 |         super(MixedPaginatedList, self).__init__(client, url)
425 |         self._list_key = key
426 | 
427 |     def _transform(self, item):
428 |         # In some cases, we want to map the 'title' key we get back in search
429 |         # results to 'name'. This way, you can repr() a page of search results
430 |         # without making 50 requests.
431 |         if item['type'] in ('label', 'artist'):
432 |             item['name'] = item['title']
433 | 
434 |         return CLASS_MAP[item['type']](self.client, item)
435 | 
436 | 
437 | class Artist(PrimaryAPIObject):
438 |     id = SimpleField()
439 |     name = SimpleField()
440 |     real_name = SimpleField(key='realname')
441 |     images = SimpleField()
442 |     profile = SimpleField()
443 |     data_quality = SimpleField()
444 |     name_variations = SimpleField(key='namevariations')
445 |     url = SimpleField(key='uri')
446 |     urls = SimpleField()
447 |     aliases = ListField('Artist')
448 |     members = ListField('Artist')
449 |     groups = ListField('Artist')
450 | 
451 |     def __init__(self, client, dict_):
452 |         super(Artist, self).__init__(client, dict_)
453 |         self.data['resource_url'] = '{0}/artists/{1}'.format(client._base_url, dict_['id'])
454 | 
455 |     @property
456 |     def releases(self):
457 |         return MixedPaginatedList(self.client, self.fetch('releases_url'), 'releases')
458 | 
459 |     def __repr__(self):
460 |         return self.repr_str('<Artist {0!r} {1!r}>'.format(self.id, self.name))
461 | 
462 | 
463 | class Release(PrimaryAPIObject):
464 |     id = SimpleField()
465 |     title = SimpleField()
466 |     year = SimpleField()
467 |     thumb = SimpleField()
468 |     data_quality = SimpleField()
469 |     status = SimpleField()
470 |     genres = SimpleField()
471 |     images = SimpleField()
472 |     country = SimpleField()
473 |     notes = SimpleField()
474 |     formats = SimpleField()
475 |     styles = SimpleField()
476 |     url = SimpleField(key='uri')
477 |     videos = ListField('Video')
478 |     tracklist = ListField('Track')
479 |     artists = ListField('Artist')
480 |     credits = ListField('Artist', key='extraartists')
481 |     labels = ListField('Label')
482 |     companies = ListField('Label')
483 | 
484 |     def __init__(self, client, dict_):
485 |         super(Release, self).__init__(client, dict_)
486 |         self.data['resource_url'] = '{0}/releases/{1}'.format(client._base_url, dict_['id'])
487 | 
488 |     @property
489 |     def master(self):
490 |         master_id = self.fetch('master_id')
491 |         if master_id:
492 |             return Master(self.client, {'id': master_id})
493 |         else:
494 |             return None
495 | 
496 |     def __repr__(self):
497 |         return self.repr_str('<Release {0!r} {1!r}>'.format(self.id, self.title))
498 | 
499 | 
500 | class Master(PrimaryAPIObject):
501 |     id = SimpleField()
502 |     title = SimpleField()
503 |     data_quality = SimpleField()
504 |     styles = SimpleField()
505 |     genres = SimpleField()
506 |     images = SimpleField()
507 |     url = SimpleField(key='uri')
508 |     videos = ListField('Video')
509 |     tracklist = ListField('Track')
510 |     main_release = ObjectField('Release', as_id=True)
511 |     versions = ObjectCollection('Release')
512 | 
513 |     def __init__(self, client, dict_):
514 |         super(Master, self).__init__(client, dict_)
515 |         self.data['resource_url'] = '{0}/masters/{1}'.format(client._base_url, dict_['id'])
516 | 
517 |     def __repr__(self):
518 |         return self.repr_str('<Master {0!r} {1!r}>'.format(self.id, self.title))
519 | 
520 | 
521 | class Label(PrimaryAPIObject):
522 |     id = SimpleField()
523 |     name = SimpleField()
524 |     profile = SimpleField()
525 |     urls = SimpleField()
526 |     images = SimpleField()
527 |     contact_info = SimpleField()
528 |     data_quality = SimpleField()
529 |     url = SimpleField(key='uri')
530 |     sublabels = ListField('Label')
531 |     parent_label = ObjectField('Label', optional=True)
532 |     releases = ObjectCollection('Release')
533 | 
534 |     def __init__(self, client, dict_):
535 |         super(Label, self).__init__(client, dict_)
536 |         self.data['resource_url'] = '{0}/labels/{1}'.format(client._base_url, dict_['id'])
537 | 
538 |     def __repr__(self):
539 |         return self.repr_str('<Label {0!r} {1!r}>'.format(self.id, self.name))
540 | 
541 | 
542 | class User(PrimaryAPIObject):
543 |     id = SimpleField()
544 |     username = SimpleField()
545 |     releases_contributed = SimpleField()
546 |     num_collection = SimpleField()
547 |     num_wantlist = SimpleField()
548 |     num_lists = SimpleField()
549 |     rank = SimpleField()
550 |     rating_avg = SimpleField()
551 |     url = SimpleField(key='uri')
552 |     name = SimpleField(writable=True)
553 |     profile = SimpleField(writable=True)
554 |     location = SimpleField(writable=True)
555 |     home_page = SimpleField(writable=True)
556 |     registered = SimpleField(transform=parse_timestamp)
557 |     inventory = ObjectCollection('Listing', key='listings', url_key='inventory_url')
558 |     wantlist = ObjectCollection('WantlistItem', key='wants', url_key='wantlist_url', list_class=Wantlist)
559 | 
560 |     def __init__(self, client, dict_):
561 |         super(User, self).__init__(client, dict_)
562 |         self.data['resource_url'] = '{0}/users/{1}'.format(client._base_url, dict_['username'])
563 | 
564 |     @property
565 |     def orders(self):
566 |         return PaginatedList(self.client, self.client._base_url + '/marketplace/orders', 'orders', Order)
567 | 
568 |     @property
569 |     def collection_folders(self):
570 |         resp = self.client._get(self.fetch('collection_folders_url'))
571 |         return [CollectionFolder(self.client, d) for d in resp['folders']]
572 | 
573 |     def __repr__(self):
574 |         return self.repr_str('<User {0!r} {1!r}>'.format(self.id, self.username))
575 | 
576 | 
577 | class WantlistItem(PrimaryAPIObject):
578 |     id = SimpleField()
579 |     rating = SimpleField(writable=True)
580 |     notes = SimpleField(writable=True)
581 |     notes_public = SimpleField(writable=True)
582 |     release = ObjectField('Release', key='basic_information')
583 | 
584 |     def __init__(self, client, dict_):
585 |         super(WantlistItem, self).__init__(client, dict_)
586 | 
587 |     def __repr__(self):
588 |         return self.repr_str('<WantlistItem {0!r} {1!r}>'.format(self.id, self.release.title))
589 | 
590 | 
591 | # TODO: folder_id should be a Folder object; needs folder_url
592 | # TODO: notes should be first-order (somehow); needs resource_url
593 | class CollectionItemInstance(PrimaryAPIObject):
594 |     id = SimpleField()
595 |     rating = SimpleField()
596 |     folder_id = SimpleField()
597 |     notes = SimpleField()
598 |     release = ObjectField('Release', key='basic_information')
599 | 
600 |     def __init__(self, client, dict_):
601 |         super(CollectionItemInstance, self).__init__(client, dict_)
602 | 
603 |     def __repr__(self):
604 |         return self.repr_str('<CollectionItemInstance {0!r} {1!r}>'.format(self.id, self.release.title))
605 | 
606 | 
607 | class CollectionFolder(PrimaryAPIObject):
608 |     id = SimpleField()
609 |     name = SimpleField()
610 |     count = SimpleField()
611 | 
612 |     def __init__(self, client, dict_):
613 |         super(CollectionFolder, self).__init__(client, dict_)
614 | 
615 |     @property
616 |     def releases(self):
617 |         # TODO: Needs releases_url
618 |         return PaginatedList(self.client, self.fetch('resource_url') + '/releases', 'releases', CollectionItemInstance)
619 | 
620 |     def __repr__(self):
621 |         return self.repr_str('<CollectionFolder {0!r} {1!r}>'.format(self.id, self.name))
622 | 
623 | 
624 | class Listing(PrimaryAPIObject):
625 |     id = SimpleField()
626 |     status = SimpleField()
627 |     allow_offers = SimpleField()
628 |     condition = SimpleField()
629 |     sleeve_condition = SimpleField()
630 |     ships_from = SimpleField()
631 |     comments = SimpleField()
632 |     audio = SimpleField()
633 |     url = SimpleField(key='uri')
634 |     price = ObjectField('Price')
635 |     release = ObjectField('Release')
636 |     seller = ObjectField('User')
637 |     posted = SimpleField(transform=parse_timestamp)
638 | 
639 |     def __init__(self, client, dict_):
640 |         super(Listing, self).__init__(client, dict_)
641 |         self.data['resource_url'] = '{0}/marketplace/listings/{1}'.format(client._base_url, dict_['id'])
642 | 
643 |     def __repr__(self):
644 |         return self.repr_str('<Listing {0!r} {1!r}>'.format(self.id, self.release.data['description']))
645 | 
646 | 
647 | class Order(PrimaryAPIObject):
648 |     id = SimpleField()
649 |     next_status = SimpleField()
650 |     shipping_address = SimpleField()
651 |     additional_instructions = SimpleField()
652 |     url = SimpleField(key='uri')
653 |     status = SimpleField(writable=True)
654 |     fee = ObjectField('Price')
655 |     buyer = ObjectField('User')
656 |     seller = ObjectField('User')
657 |     created = SimpleField(transform=parse_timestamp)
658 |     last_activity = SimpleField(transform=parse_timestamp)
659 |     messages = ObjectCollection('OrderMessage', list_class=OrderMessagesList)
660 |     items = ListField('Listing')
661 | 
662 |     def __init__(self, client, dict_):
663 |         super(Order, self).__init__(client, dict_)
664 |         self.data['resource_url'] = '{0}/marketplace/orders/{1}'.format(client._base_url, dict_['id'])
665 | 
666 |     # Setting shipping is a little weird -- you can't change the
667 |     # currency, and you use the 'shipping' key instead of 'value'
668 |     @property
669 |     def shipping(self):
670 |         return Price(self.client, self.fetch('shipping'))
671 | 
672 |     @shipping.setter
673 |     def shipping(self, value):
674 |         self.changes['shipping'] = value
675 | 
676 |     def __repr__(self):
677 |         return self.repr_str('<Order {0!r}>'.format(self.id))
678 | 
679 | 
680 | class OrderMessage(SecondaryAPIObject):
681 |     subject = SimpleField()
682 |     message = SimpleField()
683 |     to = ObjectField('User')
684 |     order = ObjectField('Order')
685 |     timestamp = SimpleField(transform=parse_timestamp)
686 | 
687 |     def __repr__(self):
688 |         return self.repr_str('<OrderMessage to:{0!r}>'.format(self.to.username))
689 | 
690 | 
691 | class Track(SecondaryAPIObject):
692 |     duration = SimpleField()
693 |     position = SimpleField()
694 |     title = SimpleField()
695 |     artists = ListField('Artist')
696 |     credits = ListField('Artist', key='extraartists')
697 | 
698 |     def __repr__(self):
699 |         return self.repr_str('<Track {0!r} {1!r}>'.format(self.position, self.title))
700 | 
701 | 
702 | class Price(SecondaryAPIObject):
703 |     currency = SimpleField()
704 |     value = SimpleField()
705 | 
706 |     def __repr__(self):
707 |         return self.repr_str('<Price {0!r} {1!r}>'.format(self.value, self.currency))
708 | 
709 | 
710 | class Video(SecondaryAPIObject):
711 |     duration = SimpleField()
712 |     embed = SimpleField()
713 |     title = SimpleField()
714 |     description = SimpleField()
715 |     url = SimpleField(key='uri')
716 | 
717 |     def __repr__(self):
718 |         return self.repr_str('<Video {0!r}>'.format(self.title))
719 | 
720 | CLASS_MAP = {
721 |     'artist': Artist,
722 |     'release': Release,
723 |     'master': Master,
724 |     'label': Label,
725 |     'price': Price,
726 |     'video': Video,
727 |     'track': Track,
728 |     'user': User,
729 |     'order': Order,
730 |     'listing': Listing,
731 |     'wantlistitem': WantlistItem,
732 |     'ordermessage': OrderMessage,
733 | }
734 | 


--------------------------------------------------------------------------------
/discogs_client/tests/__init__.py:
--------------------------------------------------------------------------------
 1 | import unittest
 2 | import json
 3 | import os
 4 | from discogs_client import Client
 5 | from discogs_client.fetchers import LoggingDelegator, FilesystemFetcher, \
 6 |     MemoryFetcher
 7 | 
 8 | 
 9 | class DiscogsClientTestCase(unittest.TestCase):
10 |     def setUp(self):
11 | 
12 |         # Filesystem client
13 |         self.d = Client('test_client/0.1 +http://example.org')
14 |         self.d._base_url = ''
15 |         self.d._fetcher = LoggingDelegator(
16 |             FilesystemFetcher(os.path.dirname(os.path.abspath(__file__)) + '/res')
17 |         )
18 |         self.d._verbose = True
19 | 
20 |         # Memory client
21 |         responses = {
22 |             '/artists/1': (b'{"id": 1, "name": "Badger"}', 200),
23 |             '/500': (b'{"message": "mushroom"}', 500),
24 |             '/204': (b'', 204),
25 |         }
26 |         self.m = Client('ua')
27 |         self.m._base_url = ''
28 |         self.m._fetcher = LoggingDelegator(MemoryFetcher(responses))
29 | 
30 |     def tearDown(self):
31 |         pass
32 | 
33 |     def assertGot(self, assert_url):
34 |         method, url, data, headers = self.d._fetcher.last_request
35 |         self.assertEqual(method, 'GET')
36 |         self.assertEqual(url, assert_url)
37 | 
38 |     def assertPosted(self, assert_url, assert_data):
39 |         method, url, data, headers = self.d._fetcher.last_request
40 |         self.assertEqual(method, 'POST')
41 |         self.assertEqual(url, assert_url)
42 |         self.assertEqual(data, json.dumps(assert_data))
43 | 
44 | 
45 | def suite():
46 |     from discogs_client.tests import test_core, test_models, test_fetchers
47 |     suite = unittest.TestSuite(test_core.suite())
48 |     suite = unittest.TestSuite(test_models.suite())
49 |     suite = unittest.TestSuite(test_fetchers.suite())
50 |     return suite
51 | 


--------------------------------------------------------------------------------
/discogs_client/tests/make_symlinks.py:
--------------------------------------------------------------------------------
 1 | #!/usr/bin/env python
 2 | import os
 3 | import sys
 4 | from itertools import permutations
 5 | 
 6 | for name in sys.argv[1:]:
 7 |     print("doing {}".format(name))
 8 |     root, next = name.split('?')
 9 |     data, ext = next.split('.')
10 |     elems = data.split('&')
11 |     for permut in permutations(elems):
12 |         link_name = "{}?{}.{}".format(root, '&'.join(permut), ext)
13 |         if link_name == name:
14 |             continue
15 |         os.symlink(name, link_name)
16 |         print("wrote {}".format(link_name))
17 | 


--------------------------------------------------------------------------------
/discogs_client/tests/res/artists/1.json:
--------------------------------------------------------------------------------
1 | {"releases_url": "/artists/1/releases", "name": "Persuader, The", "namevariations": ["Persuader", "Presuader, The"], "images": [{"uri": "/image/A-1-1138987958.jpeg", "height": 450, "width": 600, "resource_url": "/image/A-1-1138987958.jpeg", "type": "secondary", "uri150": "/image/A-150-1-1138987958.jpeg"}], "resource_url": "/artists/1", "aliases": [{"resource_url": "/artists/19541", "id": 19541, "name": "Dick Track"}, {"resource_url": "/artists/278760", "id": 278760, "name": "Faxid"}, {"resource_url": "/artists/16055", "id": 16055, "name": "Groove Machine"}, {"resource_url": "/artists/196957", "id": 196957, "name": "Janne Me' Amazonen"}, {"resource_url": "/artists/239", "id": 239, "name": "Jesper Dahlb\u00e4ck"}, {"resource_url": "/artists/25227", "id": 25227, "name": "Lenk"}, {"resource_url": "/artists/439150", "id": 439150, "name": "Pinguin Man, The"}], "id": 1, "data_quality": "Correct", "realname": "Jesper Dahlb\u00e4ck"}
2 | 


--------------------------------------------------------------------------------
/discogs_client/tests/res/artists/1/releases_per_page=50&page=1.json:
--------------------------------------------------------------------------------
1 | {"pagination": {"per_page": 50, "pages": 2, "page": 1, "urls": {"last": "/artists/1/releases?per_page=50&page=2", "next": "/artists/1/releases?per_page=50&page=2"}, "items": 57}, "releases": [{"status": "Accepted", "thumb": "/image/R-150-20209-001.jpg", "format": "10\"", "title": "Kaos", "label": "Svek", "role": "Main", "year": 1997, "resource_url": "/releases/20209", "type": "release", "id": 20209}, {"status": "Accepted", "thumb": "/image/R-150-62584-1105012368.jpg", "format": "12\"", "title": "Snorkelmannen \u00d8 Hans V\u00e4nner", "label": "Svek", "role": "Main", "year": 1997, "resource_url": "/releases/62584", "type": "release", "id": 62584}, {"thumb": "/image/R-150-4664-1159918161.jpeg", "title": "Stockholm By Night", "main_release": 4664, "role": "Main", "year": 1997, "resource_url": "/masters/321212", "type": "master", "id": 321212}, {"status": "Accepted", "thumb": "/image/R-150-400-1318378296.jpeg", "format": "12\"", "title": "A View From Slussen", "label": "Svek", "role": "Main", "year": 1998, "resource_url": "/releases/400", "type": "release", "id": 400}, {"thumb": "/image/R-150-79-1104723687.jpg", "title": "City Of Islands", "main_release": 79, "role": "Main", "year": 1998, "resource_url": "/masters/4242", "type": "master", "id": 4242}, {"thumb": "/image/R-150-101-1171945084.jpeg", "title": "Morgon Sol", "main_release": 101, "role": "Main", "year": 1998, "resource_url": "/masters/374577", "type": "master", "id": 374577}, {"thumb": "/image/R-150-401-1194210100.jpeg", "title": "Pleasure", "main_release": 401, "role": "Main", "year": 1998, "resource_url": "/masters/4250", "type": "master", "id": 4250}, {"thumb": "/image/R-150-1-1193812031.jpeg", "title": "Stockholm", "main_release": 1, "role": "Main", "year": 1999, "resource_url": "/masters/5427", "type": "master", "id": 5427}, {"status": "Accepted", "thumb": "/image/R-150-12362-001.jpg", "format": "12\"", "title": "Central Bron", "label": "Svek, Svek", "role": "Main", "year": 2001, "resource_url": "/releases/12362", "type": "release", "id": 12362}, {"status": "Accepted", "thumb": "/image/R-150-88892-1293887012.jpeg", "format": "12\"", "title": "Loves You All Night And Day", "label": "Raw Elements", "role": "Remix", "year": 1997, "trackinfo": "All Night (Stephan Gri...", "resource_url": "/releases/88892", "type": "release", "id": 88892}, {"thumb": "/image/R-150-119-1323136113.jpeg", "title": "The Big Bang Theory", "main_release": 119, "role": "Remix", "year": 1997, "resource_url": "/masters/169563", "type": "master", "id": 169563}, {"status": "Accepted", "thumb": "/image/R-150-15542-1164893602.jpeg", "format": "2x12\"", "title": "Diskophrenia Remixes", "label": "Svek", "role": "Remix", "year": 1998, "trackinfo": "Diskophrenia (The Pers...", "resource_url": "/releases/15542", "type": "release", "id": 15542}, {"status": "Accepted", "thumb": "/image/R-150-5955-1280004683.jpeg", "format": "CD, Comp", "title": "The Lords Of Svek Vol. 4", "label": "Svek", "role": "Remix", "year": 1998, "trackinfo": "Discophrenia (The Pers...", "resource_url": "/releases/5955", "type": "release", "id": 5955}, {"status": "Accepted", "thumb": "/image/R-150-229135-1077485555.jpg", "format": "2xCD, Mixed, Comp", "title": "Chill On Kaos Volume Two", "label": "Kaos Records", "role": "Remix", "year": 2001, "trackinfo": "Diskophrenia (The Pers...", "resource_url": "/releases/229135", "type": "release", "id": 229135}, {"status": "Accepted", "thumb": "/image/R-150-2629499-1294052369.jpeg", "format": "2xCDr, Comp, Promo", "title": "Raw Essentials", "label": "Raw Elements", "role": "Remix", "year": 2008, "trackinfo": "All Night ( Stephan Gr...", "resource_url": "/releases/2629499", "type": "release", "id": 2629499}, {"status": "Accepted", "thumb": "/image/R-150-2116649-1318194487.jpeg", "format": "CD, Mixed, Comp", "title": "Live At Robert Johnson", "label": "Live At Robert Johnson", "role": "Remix", "year": 2010, "trackinfo": "The Big Bang Theory (R...", "resource_url": "/releases/2116649", "type": "release", "id": 2116649}, {"status": "Accepted", "thumb": "/image/R-150-2219613-1270601189.jpeg", "format": "4xCD, Comp, Mixed + Box, Ltd, Art", "title": "Volume 1-4 - Live At Robert Johnson", "label": "Live At Robert Johnson", "role": "Remix", "year": 2010, "trackinfo": "The Big Bang Theory (R...", "resource_url": "/releases/2219613", "type": "release", "id": 2219613}, {"status": "Accepted", "thumb": "/image/R-150-20207-1136661115.jpeg", "format": "12\"", "title": "Untitled", "label": "Svek", "role": "Appearance", "year": 1997, "resource_url": "/releases/20207", "type": "release", "id": 20207}, {"thumb": "/image/R-150-125192-1221907175.jpeg", "title": "Sun Trip Fifth", "main_release": 125192, "role": "Appearance", "year": 1998, "resource_url": "/masters/44004", "type": "master", "id": 44004}, {"status": "Accepted", "thumb": "/image/R-150-17087-1282665287.jpeg", "format": "CD, Comp", "title": "The Lords Of Svek Vol. 2", "label": "Svek", "role": "TrackAppearance", "year": 1997, "trackinfo": "Bottle Up!, What Is Th...", "resource_url": "/releases/17087", "type": "release", "id": 17087}, {"thumb": "/image/R-150-336682-1098045779.jpg", "title": "Bor\u00e9alis", "main_release": 336682, "role": "TrackAppearance", "year": 1998, "resource_url": "/masters/393267", "type": "master", "id": 393267}, {"thumb": "/image/R-150-893403-1220171221.jpeg", "title": "DJ Excursions Vol. 5", "main_release": 893403, "role": "TrackAppearance", "year": 1998, "resource_url": "/masters/89174", "type": "master", "id": 89174}, {"status": "Accepted", "thumb": "/image/R-150-1795441-1294674275.jpeg", "format": "CD, Mixed, Promo, 4-f", "title": "DeeperDimensions", "label": "Not On Label", "role": "TrackAppearance", "year": 1998, "trackinfo": "I'm Glad You're Mine", "resource_url": "/releases/1795441", "type": "release", "id": 1795441}, {"thumb": "/image/R-150-186191-1264283210.jpeg", "title": "Groove - The Compilation Volume 3", "main_release": 186191, "role": "TrackAppearance", "year": 1998, "resource_url": "/masters/99684", "type": "master", "id": 99684}, {"status": "Accepted", "thumb": "/image/R-150-100650-1215061226.jpeg", "format": "2x12\"", "title": "J\u00e9r\u00f4me Pacman's House Caf\u00e9", "label": "Music Garden, Music Garden", "role": "TrackAppearance", "year": 1998, "trackinfo": "Naked Woman", "resource_url": "/releases/100650", "type": "release", "id": 100650}, {"status": "Accepted", "thumb": "/image/R-150-703264-1149629630.jpeg", "format": "CD, Mixed, Comp", "title": "J\u00e9r\u00f4me Pacman's House Caf\u00e9", "label": "Music Garden", "role": "TrackAppearance", "year": 1998, "trackinfo": "Naked Woman", "resource_url": "/releases/703264", "type": "release", "id": 703264}, {"status": "Accepted", "thumb": "/image/R-150-564791-1132090427.jpeg", "format": "CD", "title": "Le Nord Digital - Volume 2", "label": "Not On Label", "role": "TrackAppearance", "year": 1998, "trackinfo": "Funk Seven", "resource_url": "/releases/564791", "type": "release", "id": 564791}, {"status": "Accepted", "thumb": "/image/R-150-399-1164938233.jpeg", "format": "12\"", "title": "The Lords Of Svek - Unreleased", "label": "Svek", "role": "TrackAppearance", "year": 1998, "trackinfo": "Funk Seven, Tandori Funk", "resource_url": "/releases/399", "type": "release", "id": 399}, {"status": "Accepted", "thumb": "/image/R-150-17088-1272577277.jpeg", "format": "CD, Comp", "title": "The Lords Of Svek Vol. 3", "label": "Svek", "role": "TrackAppearance", "year": 1998, "trackinfo": "Stockholm By Night, Fu...", "resource_url": "/releases/17088", "type": "release", "id": 17088}, {"status": "Accepted", "thumb": "/image/R-150-5955-1280004683.jpeg", "format": "CD, Comp", "title": "The Lords Of Svek Vol. 4", "label": "Svek", "role": "TrackAppearance", "year": 1998, "trackinfo": "Naked Woman, From West...", "resource_url": "/releases/5955", "type": "release", "id": 5955}, {"status": "Accepted", "thumb": "/image/R-150-27535-1229968603.jpeg", "format": "2xCD, Comp, Mixed", "title": "hr3 Clubnight Volume 3", "label": "Epidrome", "role": "TrackAppearance", "year": 1998, "trackinfo": "Naked Woman", "resource_url": "/releases/27535", "type": "release", "id": 27535}, {"status": "Accepted", "thumb": "/image/R-150-1878188-1277474268.jpeg", "format": "CD, Mixed", "title": "Every Woman Have To Drive A Car", "label": "Not On Label", "role": "TrackAppearance", "year": 1999, "trackinfo": "From West To South, \u00d6...", "resource_url": "/releases/1878188", "type": "release", "id": 1878188}, {"status": "Accepted", "thumb": "/image/R-150-2387641-1281604069.jpeg", "format": "CD, Smplr, Promo", "title": "Goldhead Music Dance Sampler Spring 99", "label": "Goldhead Music", "role": "TrackAppearance", "year": 1999, "trackinfo": "S\u00f6dermalm", "resource_url": "/releases/2387641", "type": "release", "id": 2387641}, {"status": "Accepted", "thumb": "/image/R-150-49823-1198920037.jpeg", "format": "CD", "title": "Moving House At Food Club", "label": "SSR Records", "role": "TrackAppearance", "year": 1999, "trackinfo": "Slussen (Erot Go Dub R...", "resource_url": "/releases/49823", "type": "release", "id": 49823}, {"thumb": "/image/R-150-782872-1158295444.jpeg", "title": "Profound Sounds Vol. 1", "main_release": 782872, "role": "TrackAppearance", "year": 1999, "resource_url": "/masters/66526", "type": "master", "id": 66526}, {"status": "Accepted", "thumb": "/image/R-150-195166-001.jpg", "format": "2xCD, Comp, Mixed", "title": "Rocks - The Real Dance Club", "label": "Kaos Records", "role": "TrackAppearance", "year": 1999, "trackinfo": "Slussen (Go Dub Mix)", "resource_url": "/releases/195166", "type": "release", "id": 195166}, {"thumb": "/image/R-150-1220-1231620321.jpeg", "title": "Stockholm Mix Sessions", "main_release": 1220, "role": "TrackAppearance", "year": 1999, "resource_url": "/masters/4207", "type": "master", "id": 4207}, {"status": "Accepted", "thumb": "/image/R-150-17089-1221689193.jpeg", "format": "CD, Comp", "title": "The Lords Of Svek - Galaxy", "label": "Svek", "role": "TrackAppearance", "year": 1999, "trackinfo": "Gamla Stan, Slussen (G...", "resource_url": "/releases/17089", "type": "release", "id": 17089}, {"thumb": "/image/R-150-1222-1231620791.jpeg", "title": "Helsinki Mix Sessions", "main_release": 1222, "role": "TrackAppearance", "year": 2000, "resource_url": "/masters/53892", "type": "master", "id": 53892}, {"status": "Accepted", "thumb": "/image/R-150-873142-1167841584.jpeg", "format": "CD", "title": "Helsinki Mix Sessions Vol. 2", "label": "Not On Label", "role": "TrackAppearance", "year": 2000, "trackinfo": "From West To South", "resource_url": "/releases/873142", "type": "release", "id": 873142}, {"thumb": "/image/R-150-66978-1197498609.jpeg", "title": "Transatlantic Audio", "main_release": 66978, "role": "TrackAppearance", "year": 2000, "resource_url": "/masters/35961", "type": "master", "id": 35961}, {"status": "Accepted", "thumb": "/image/R-150-45799-1324409617.jpeg", "format": "CD, Comp, Mixed", "title": "Skansen Music", "label": "Glasgow Underground", "role": "TrackAppearance", "year": 2001, "trackinfo": "Slussen (Go Dub Mix)", "resource_url": "/releases/45799", "type": "release", "id": 45799}, {"status": "Accepted", "thumb": "/image/R-150-92419-1302423552.jpeg", "format": "CD, Mixed", "title": "Soundcolors 4", "label": "X:treme Records", "role": "TrackAppearance", "year": 2001, "trackinfo": "Gamla Stan", "resource_url": "/releases/92419", "type": "release", "id": 92419}, {"status": "Accepted", "format": "CD, Comp, Mixed", "title": "Straight To DAT", "label": "Blended Music", "role": "TrackAppearance", "year": 2001, "trackinfo": "Playing Your Game", "resource_url": "/releases/118402", "type": "release", "id": 118402}, {"status": "Accepted", "thumb": "/image/R-150-45094-001.gif", "format": "CD, Comp", "title": "Defender", "label": "Svek", "role": "TrackAppearance", "year": 2002, "trackinfo": "Central Bron (Birdy Re...", "resource_url": "/releases/45094", "type": "release", "id": 45094}, {"status": "Accepted", "thumb": "/image/R-150-73804-001.jpg", "format": "CD, Comp, Mixed", "title": "Moon Harbour Flights Volume One", "label": "Moon Harbour Recordings", "role": "TrackAppearance", "year": 2002, "trackinfo": "Str\u00f6msbron", "resource_url": "/releases/73804", "type": "release", "id": 73804}, {"status": "Accepted", "thumb": "/image/R-150-167072-001.jpg", "format": "CD, Comp", "title": "Seven Years Of Svek Collection One", "label": "Svek", "role": "TrackAppearance", "year": 2003, "trackinfo": "Central Bron, Kaos", "resource_url": "/releases/167072", "type": "release", "id": 167072}, {"status": "Accepted", "thumb": "/image/R-150-777443-1158753680.jpeg", "format": "CD, Mixed", "title": "She's A Dancing Machine", "label": "M_nus", "role": "TrackAppearance", "year": 2006, "trackinfo": "Centralbron, Centralbron", "resource_url": "/releases/777443", "type": "release", "id": 777443}, {"thumb": "/image/R-150-1584766-1304303959.jpeg", "title": "Carry On - Pretend We Are Not In The Room", "main_release": 1584766, "role": "TrackAppearance", "year": 2008, "resource_url": "/masters/48841", "type": "master", "id": 48841}, {"status": "Accepted", "thumb": "/image/R-150-1600427-1231356335.jpeg", "format": "File, MP3, Mixed, Comp, 192", "title": "LWE Podcast 03", "label": "Little White Earbuds", "role": "TrackAppearance", "year": 2008, "trackinfo": "What Is The Time, Mr. ...", "resource_url": "/releases/1600427", "type": "release", "id": 1600427}]}
2 | 


--------------------------------------------------------------------------------
/discogs_client/tests/res/artists/1/releases_per_page=50&page=2.json:
--------------------------------------------------------------------------------
1 | {"pagination": {"per_page": 50, "items": 57, "page": 2, "urls": {"prev": "/artists/1/releases?per_page=50&page=1", "first": "/artists/1/releases?per_page=50&page=1"}, "pages": 2}, "releases": [{"status": "Accepted", "thumb": "/image/R-150-3244318-1322087916.jpeg", "title": "RA.113", "format": "File, MP3, Mixed, 160", "label": "Resident Advisor", "role": "TrackAppearance", "year": 2008, "trackinfo": "What Is The Time, Mr. ...", "resource_url": "/releases/3244318", "type": "release", "id": 3244318}, {"status": "Accepted", "thumb": "/image/R-150-1642564-1234063013.jpeg", "title": "RA.116", "format": "File, MP3, Mixed, Pod", "label": "Resident Advisor", "role": "TrackAppearance", "year": 2008, "trackinfo": "A View From Slussen (G...", "resource_url": "/releases/1642564", "type": "release", "id": 1642564}, {"status": "Accepted", "thumb": "/image/R-150-2562307-1290561180.jpeg", "title": "Seeing Colors : Ghostly Influences", "format": "File, MP3, Mixed, 320", "label": "Ghostly International", "role": "TrackAppearance", "year": 2009, "trackinfo": "What Is The Time, Mr. ...", "resource_url": "/releases/2562307", "type": "release", "id": 2562307}, {"status": "Accepted", "thumb": "/image/R-150-1637849-1233766204.jpeg", "title": "The Empty Foxhole", "format": "CD, Comp, Mixed", "label": "Mule Electronic", "role": "TrackAppearance", "year": 2009, "trackinfo": "Kaos", "resource_url": "/releases/1637849", "type": "release", "id": 1637849}, {"status": "Accepted", "thumb": "/image/R-150-2894432-1306081588.jpeg", "title": "House Party Mix", "format": "File, MP3, Mixed, Comp, Promo, 320", "label": "Ed Banger Records", "role": "TrackAppearance", "year": 2010, "trackinfo": "Bottle Up", "resource_url": "/releases/2894432", "type": "release", "id": 2894432}, {"thumb": "/image/R-150-2911949-1311921995.jpeg", "title": "Dan Ghenacia's Sound Of The City - Paris", "main_release": 2911949, "role": "TrackAppearance", "year": 2011, "resource_url": "/masters/340995", "type": "master", "id": 340995}, {"status": "Accepted", "thumb": "/image/R-150-1692004-1237256913.jpeg", "title": "SMUT", "format": "CD, Mixed, Comp", "label": ":6:6:6 ZipCode Town Rekkids", "role": "TrackAppearance", "trackinfo": "Snorkelmannen 0 Hans V...", "resource_url": "/releases/1692004", "type": "release", "id": 1692004}]}
2 | 


--------------------------------------------------------------------------------
/discogs_client/tests/res/artists/2.json:
--------------------------------------------------------------------------------
1 | {"releases_url": "/artists/2/releases", "namevariations": ["Mr Barth & A.D.", "Mr. Barth & A.D."], "data_quality": "Correct", "members": [{"resource_url": "/artists/26", "id": 26, "name": "Alexi Delano"}, {"resource_url": "/artists/27", "id": 27, "name": "Cari Lekebusch"}], "resource_url": "/artists/2", "aliases": [{"resource_url": "/artists/384581", "id": 384581, "name": "ADCL"}, {"resource_url": "/artists/1779857", "id": 1779857, "name": "Alexi Delano & Cari Lekebusch"}, {"resource_url": "/artists/103709", "id": 103709, "name": "Crushed Insect & The Sick Puppy"}, {"resource_url": "/artists/2470", "id": 2470, "name": "Puente Latino"}, {"resource_url": "/artists/19536", "id": 19536, "name": "Yakari & Delano"}], "id": 2, "realname": "Cari Lekebusch & Alexi Delano", "name": "Mr. James Barth & A.D."}
2 | 


--------------------------------------------------------------------------------
/discogs_client/tests/res/artists/3.json:
--------------------------------------------------------------------------------
1 | {"profile": "After forming [l=Ovum Recordings] as an independent label in October 1994 with former partner [a=King Britt], Josh recorded the cult classic 'Liquid Summer'. He went on to release singles for a wide variety of revered European labels ranging from Belgium's [l=R & S Records] to England's [l=XL Recordings]. In 1995, Wink became one of the first DJ-producers to translate his hard work into mainstream success when he unleashed a string of classics including 'Don't Laugh'\u00b8 'I'm Ready' and 'Higher State of Consciousness' that topped charts worldwide. More recently he has had massive club hits such as 'How's Your Evening So Far' and 'Superfreak' but he has also gained a lot of attention trough his remixes for [a=FC Kahuna], [a=Paul Oakenfold], [a=Ladytron], [a=Clint Mansell], [a=Sting] and [a=Depeche Mode], among others.", "releases_url": "/artists/3/releases", "name": "Josh Wink", "groups": [{"resource_url": "/artists/55692", "id": 55692, "name": "Abundance Of Cups"}, {"resource_url": "/artists/34803", "id": 34803, "name": "E-Culture"}, {"resource_url": "/artists/1642275", "id": 1642275, "name": "Force, The (23)"}, {"resource_url": "/artists/579249", "id": 579249, "name": "Jack Jones (4)"}, {"resource_url": "/artists/844878", "id": 844878, "name": "Just King And Wink"}], "namevariations": ["DJ Josh Wink", "DJ Wink", "J Wink", "J. Wink", "J. Wink (DJ  Wink)", "J. Winkelman", "J. Winkelmann", "J.Wink", "J.Winkelman", "Josh", "Josh Wink (DJ Wink)", "Josh Wink Aka Winx", "Josh Winkelman", "Josh Winkelmann", "Josh Winx", "JW", "Winc", "Wink", "Wink (Feat The Interpreters)", "Winks", "Winx", "Winxs"], "urls": ["http://www.joshwink.com/", "http://www.ovum-rec.com/", "http://www.myspace.com/joshwink", "http://www.myspace.com/ovumrecordings", "http://www.deejaybooking.com/joshwink", "http://twitter.com/joshwink1"], "images": [{"uri": "/image/A-3-1105100757.jpg", "height": 370, "width": 399, "resource_url": "/image/A-3-1105100757.jpg", "type": "secondary", "uri150": "/image/A-150-3-1105100757.jpg"}, {"uri": "/image/A-3-1105100775.gif", "height": 199, "width": 200, "resource_url": "/image/A-3-1105100775.gif", "type": "secondary", "uri150": "/image/A-150-3-1105100775.gif"}, {"uri": "/image/A-3-1197950724.jpeg", "height": 436, "width": 550, "resource_url": "/image/A-3-1197950724.jpeg", "type": "secondary", "uri150": "/image/A-150-3-1197950724.jpeg"}, {"uri": "/image/A-3-1222848084.jpeg", "height": 280, "width": 380, "resource_url": "/image/A-3-1222848084.jpeg", "type": "secondary", "uri150": "/image/A-150-3-1222848084.jpeg"}, {"uri": "/image/A-3-1222848102.jpeg", "height": 661, "width": 600, "resource_url": "/image/A-3-1222848102.jpeg", "type": "secondary", "uri150": "/image/A-150-3-1222848102.jpeg"}, {"uri": "/image/A-3-1222848119.jpeg", "height": 630, "width": 500, "resource_url": "/image/A-3-1222848119.jpeg", "type": "secondary", "uri150": "/image/A-150-3-1222848119.jpeg"}, {"uri": "/image/A-3-1237576157.jpeg", "height": 288, "width": 219, "resource_url": "/image/A-3-1237576157.jpeg", "type": "primary", "uri150": "/image/A-150-3-1237576157.jpeg"}], "resource_url": "/artists/3", "aliases": [{"resource_url": "/artists/370936", "id": 370936, "name": "Accent (3)"}, {"resource_url": "/artists/95949", "id": 95949, "name": "Crusher, The"}, {"resource_url": "/artists/284057", "id": 284057, "name": "Dinky Dog"}, {"resource_url": "/artists/870371", "id": 870371, "name": "J. Dawg"}, {"resource_url": "/artists/11217", "id": 11217, "name": "Size 9"}], "id": 3, "data_quality": "Correct", "realname": "Joshua Winkelman"}
2 | 


--------------------------------------------------------------------------------
/discogs_client/tests/res/database/search_q=trash80&per_page=50&page=1.json:
--------------------------------------------------------------------------------
1 | {"pagination": {"per_page": 50, "pages": 1, "page": 1, "urls": {}, "items": 13}, "results": [{"thumb": null, "title": "Trash80", "uri": "/artist/Trash80", "resource_url": "/artists/95780", "type": "artist", "id": 95780}, {"style": ["Electro", "Chiptune"], "thumb": "/image/R-90-1743771-1272253277.gif", "title": "Trash80 - Icarus", "country": "US", "format": ["CDr"], "uri": "/Trash80-Icarus/release/1743771", "label": "8bitpeoples", "catno": "8BP086", "year": "2008", "genre": ["Electronic"], "resource_url": "/releases/1743771", "type": "release", "id": 1743771}, {"style": ["Electro", "Chiptune"], "thumb": "/image/R-90-1346442-1211545307.gif", "title": "Trash80 - Icarus", "country": "US", "format": ["File"], "uri": "/Trash80-Icarus/release/1346442", "label": "8bitpeoples", "catno": "8BP086", "year": "2008", "genre": ["Electronic"], "resource_url": "/releases/1346442", "type": "release", "id": 1346442}, {"style": ["Chiptune"], "thumb": "/image/R-90-480740-1149028432.gif", "title": "Trash80 - Hologram", "country": "US", "format": ["File"], "uri": "/Trash80-Hologram/release/480740", "label": "8bitpeoples", "catno": "8BP037", "year": "2003", "genre": ["Electronic"], "resource_url": "/releases/480740", "type": "release", "id": 480740}, {"style": ["Modern Classical", "Chiptune", "Breaks", "Ambient"], "thumb": "/image/R-90-3329867-1326034108.jpeg", "title": "Trash80 & Dma-Sc - Darwinia Soundtrack", "country": "UK", "format": ["File"], "uri": "/Trash80-Dma-Sc-Darwinia-Soundtrack/release/3329867", "label": "Not On Label", "catno": "none", "year": "2005", "genre": ["Electronic"], "resource_url": "/releases/3329867", "type": "release", "id": 3329867}, {"style": ["Chiptune"], "thumb": "/image/R-90-1554401-1227991910.gif", "title": "Nullsleep - Unconditional Acceleration", "country": "US", "format": ["File"], "uri": "/Nullsleep-Unconditional-Acceleration/release/1554401", "label": "8bitpeoples", "catno": "8BP088", "year": "2008", "genre": ["Electronic"], "resource_url": "/releases/1554401", "type": "release", "id": 1554401}, {"style": ["Chiptune"], "thumb": "/image/R-90-2634760-1294296299.gif", "title": "Sievert - Chips, Dips And Facerips", "country": "US", "format": ["File"], "uri": "/Sievert-Chips-Dips-And-Facerips/release/2634760", "label": "8bitpeoples", "catno": "8BP113", "year": "2011", "genre": ["Electronic"], "resource_url": "/releases/2634760", "type": "release", "id": 2634760}, {"style": ["Chiptune"], "thumb": "/image/R-90-1554411-1228435569.jpeg", "title": "Minusbaby - Saudade For Beginners", "country": "US", "format": ["File", "CD"], "uri": "/Minusbaby-Saudade-For-Beginners/release/1554411", "label": "8bitpeoples", "catno": "8BP089", "year": "2008", "genre": ["Electronic"], "resource_url": "/releases/1554411", "type": "release", "id": 1554411}, {"style": ["Abstract", "Musique Concr\u00e8te", "Experimental"], "thumb": null, "title": "Larry Wendt - Sound Poems For An Era Of Reduced Expectations", "country": "US", "format": ["Cassette"], "uri": "/Larry-Wendt-Sound-Poems-For-An-Era-Of-Reduced-Expectations/release/2674683", "label": "Underwhich Audiographics", "catno": "5", "genre": ["Electronic", "Non-Music"], "resource_url": "/releases/2674683", "type": "release", "id": 2674683}, {"style": ["Breakbeat", "Interview", "Techno", "IDM", "Minimal"], "thumb": null, "title": "Datamat - Interjamp Realaudio Special", "country": "Germany", "format": ["File"], "uri": "/Datamat-Interjamp-Realaudio-Special/release/1994383", "label": "Interjamp Radio", "catno": "inter004", "year": "2004", "genre": ["Electronic", "Non-Music"], "resource_url": "/releases/1994383", "type": "release", "id": 1994383}, {"style": ["IDM", "Noise", "Experimental"], "thumb": "/image/R-90-132406-1177641432.jpeg", "title": "Various - One Minute Massacre Volume 1", "country": "", "format": ["CD"], "uri": "/Various-One-Minute-Massacre-Volume-1/release/132406", "label": "Soulseek Records", "catno": "SLSK002", "year": "2003", "genre": ["Electronic"], "resource_url": "/releases/132406", "type": "release", "id": 132406}, {"style": ["Chiptune", "Experimental"], "thumb": "/image/R-90-915735-1229262615.jpeg", "title": "Various - 8BP050", "country": "US", "format": ["CD", "File"], "uri": "/Various-8BP050/release/915735", "label": "8bitpeoples", "catno": "8BP050", "year": "2006", "genre": ["Electronic"], "resource_url": "/releases/915735", "type": "release", "id": 915735}, {"style": ["Electro", "Chiptune"], "thumb": "/image/R-90-1903567-1251600832.jpeg", "title": "Various - Blip Festival 2008: 32 Live Recordings", "country": "US", "format": ["CD"], "uri": "/Various-Blip-Festival-2008-32-Live-Recordings/release/1903567", "label": "8bitpeoples", "catno": "8BP100", "year": "2009", "genre": ["Electronic"], "resource_url": "/releases/1903567", "type": "release", "id": 1903567}]}
2 | 


--------------------------------------------------------------------------------
/discogs_client/tests/res/labels/1.json:
--------------------------------------------------------------------------------
1 | {"profile": "Classic Techno label from Detroit, USA.\r\n[b]Label owner:[/b] [a=Carl Craig].\r\n", "releases_url": "/labels/1/releases", "name": "Planet E", "contact_info": "Planet E Communications\r\nP.O. Box 27218\r\nDetroit, 48227, USA\r\n\r\np: 313.874.8729 \r\nf: 313.874.8732\r\n\r\nemail: info AT Planet-e DOT net\r\n", "sublabels": [{"resource_url": "/labels/86537", "id": 86537, "name": "Antidote (4)"}, {"resource_url": "/labels/41841", "id": 41841, "name": "Community Projects"}, {"resource_url": "/labels/153760", "id": 153760, "name": "Guilty Pleasures"}, {"resource_url": "/labels/31405", "id": 31405, "name": "I Ner Zon Sounds"}], "urls": ["http://www.planet-e.net/", "http://www.myspace.com/planetecom", "http://www.facebook.com/planetedetroit ", "http://twitter.com/planetedetroit", "http://soundcloud.com/planetedetroit"], "images": [{"uri": "/image/L-1-1111053865.png", "height": 24, "width": 132, "resource_url": "/image/L-1-1111053865.png", "type": "primary", "uri150": "/image/L-150-1-1111053865.png"}, {"uri": "/image/L-1-1139403654.gif", "height": 126, "width": 587, "resource_url": "/image/L-1-1139403654.gif", "type": "secondary", "uri150": "/image/L-150-1-1139403654.gif"}, {"uri": "/image/L-1-1200165078.gif", "height": 196, "width": 600, "resource_url": "/image/L-1-1200165078.gif", "type": "secondary", "uri150": "/image/L-150-1-1200165078.gif"}, {"uri": "/image/L-1-1258998163.png", "height": 121, "width": 275, "resource_url": "/image/L-1-1258998163.png", "type": "secondary", "uri150": "/image/L-150-1-1258998163.png"}, {"uri": "/image/L-1-1279985473.jpeg", "height": 204, "width": 600, "resource_url": "/image/L-1-1279985473.jpeg", "type": "secondary", "uri150": "/image/L-150-1-1279985473.jpeg"}], "resource_url": "/labels/1", "id": 1, "data_quality": "Needs Vote"}
2 | 


--------------------------------------------------------------------------------
/discogs_client/tests/res/labels/31405.json:
--------------------------------------------------------------------------------
1 | {"profile": "I Ner Zon Sounds was a sublabel of [l=Planet E], only used by [a=Carl Craig] for the Naomi Daniel project.", "releases_url": "/labels/31405/releases", "name": "I Ner Zon Sounds", "parent_label": {"resource_url": "/labels/1", "id": 1, "name": "Planet E"}, "resource_url": "/labels/31405", "id": 31405, "data_quality": "Correct"}
2 | 


--------------------------------------------------------------------------------
/discogs_client/tests/res/marketplace/fee/20.5000/EUR.json:
--------------------------------------------------------------------------------
1 | {"currency": "USD", "value": 1.5700000000000001}
2 | 


--------------------------------------------------------------------------------
/discogs_client/tests/res/masters/4242.json:
--------------------------------------------------------------------------------
1 | {"styles": ["Deep House", "Tech House"], "genres": ["Electronic"], "videos": [{"duration": 328, "embed": true, "title": "The Persuader - Djurgardsbron - Svek Records", "description": "The Persuader - Djurgardsbron - Svek Records", "uri": "http://www.youtube.com/watch?v=QLgJ1E7COnM"}, {"duration": 299, "embed": true, "title": "The Persuader - Stromsbron - Svek Records", "description": "The Persuader - Stromsbron - Svek Records", "uri": "http://www.youtube.com/watch?v=FUsihJaFmkE"}, {"duration": 264, "embed": true, "title": "The Persuader - Centralbron", "description": "The Persuader - Centralbron", "uri": "http://www.youtube.com/watch?v=ta5KOlw-dOk"}], "title": "City Of Islands", "main_release": 79, "main_release_url": "/releases/79", "year": 1998, "versions_url": "/masters/4242/versions", "artists": [{"join": "", "name": "Persuader, The", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/1", "id": 1}], "images": [{"uri": "/image/R-79-1104723687.jpg", "height": 150, "width": 150, "resource_url": "/image/R-79-1104723687.jpg", "type": "secondary", "uri150": "/image/R-150-79-1104723687.jpg"}], "resource_url": "/masters/4242", "tracklist": [{"duration": "5:12", "position": "A1", "title": "Djurg\u00e5rdsbron"}, {"duration": "4:20", "position": "A2", "title": "Centralbron"}, {"duration": "4:47", "position": "B1", "title": "Str\u00f6msbron"}, {"duration": "4:42", "position": "B2", "title": "Kungsbron"}], "id": 4242, "data_quality": "Correct"}
2 | 


--------------------------------------------------------------------------------
/discogs_client/tests/res/masters/4242/versions_per_page=50&page=1.json:
--------------------------------------------------------------------------------
1 | {"pagination": {"per_page": 50, "pages": 1, "page": 1, "urls": {}, "items": 2}, "versions": [{"status": "Accepted", "thumb": "/image/R-150-79-1104723687.jpg", "format": "12\"", "country": "Sweden", "title": "City Of Islands", "label": "Svek", "released": "1998-12-00", "catno": "SK029", "resource_url": "/releases/79", "id": 79}, {"status": "Accepted", "format": "12\", W/Lbl", "country": "Sweden", "title": "City Of Islands", "label": "Svek", "released": "1998-12-00", "catno": "SK029", "resource_url": "/releases/1657054", "id": 1657054}]}
2 | 


--------------------------------------------------------------------------------
/discogs_client/tests/res/oauth/identity.json:
--------------------------------------------------------------------------------
1 | {"username": "example", "id": 1, "resource_url": "/users/example", "consumer_name": "Test Client"}
2 | 


--------------------------------------------------------------------------------
/discogs_client/tests/res/releases/1.json:
--------------------------------------------------------------------------------
1 | {"status": "Accepted", "videos": [{"duration": 334, "embed": true, "title": "The Persuader-Stockholm-Sodermalm", "description": "The Persuader-Stockholm-Sodermalm", "uri": "http://www.youtube.com/watch?v=QVdDhOnoR8k"}, {"duration": 290, "embed": true, "title": "The Persuader (Jesper Dahlb\u00e4ck) - \u00d6stermalm", "description": "The Persuader (Jesper Dahlb\u00e4ck) - \u00d6stermalm", "uri": "http://www.youtube.com/watch?v=AHuQWcylaU4"}], "series": [], "labels": [{"name": "Svek", "entity_type": "1", "catno": "SK032", "resource_url": "/labels/5", "id": 5, "entity_type_name": "Label"}], "year": 1999, "images": [{"uri": "/image/R-1-1193812031.jpeg", "height": 600, "width": 600, "resource_url": "/image/R-1-1193812031.jpeg", "type": "primary", "uri150": "/image/R-150-1-1193812031.jpeg"}, {"uri": "/image/R-1-1193812053.jpeg", "height": 600, "width": 600, "resource_url": "/image/R-1-1193812053.jpeg", "type": "secondary", "uri150": "/image/R-150-1-1193812053.jpeg"}, {"uri": "/image/R-1-1193812072.jpeg", "height": 600, "width": 600, "resource_url": "/image/R-1-1193812072.jpeg", "type": "secondary", "uri150": "/image/R-150-1-1193812072.jpeg"}, {"uri": "/image/R-1-1193812091.jpeg", "height": 600, "width": 600, "resource_url": "/image/R-1-1193812091.jpeg", "type": "secondary", "uri150": "/image/R-150-1-1193812091.jpeg"}], "id": 1, "genres": ["Electronic"], "thumb": "/image/R-150-1-1193812031.jpeg", "extraartists": [{"join": "", "name": "Jesper Dahlb\u00e4ck", "anv": "", "tracks": "", "role": "Music By [All Tracks By]", "resource_url": "/artists/239", "id": 239}], "title": "Stockholm", "artists": [{"join": "", "name": "Persuader, The", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/1", "id": 1}], "master_id": 5427, "tracklist": [{"duration": "4:45", "position": "A", "title": "\u00d6stermalm"}, {"duration": "6:11", "position": "B1", "title": "Vasastaden"}, {"duration": "2:49", "position": "B2", "title": "Kungsholmen"}, {"duration": "5:38", "position": "C1", "title": "S\u00f6dermalm"}, {"duration": "4:52", "position": "C2", "title": "Norrmalm"}, {"duration": "5:16", "position": "D", "title": "Gamla Stan"}], "styles": ["Deep House"], "released_formatted": "Mar 1999", "master_url": "/masters/5427", "released": "1999-03-00", "country": "Sweden", "notes": "Recorded at the Globe studio in Stockholm. \r\nThe titles are the names of Stockholm's districts.\r\n", "companies": [{"name": "The Globe Studios", "entity_type": "23", "catno": "", "resource_url": "/labels/271046", "id": 271046, "entity_type_name": "Recorded At"}], "formats": [{"qty": "2", "descriptions": ["12\""], "name": "Vinyl"}], "resource_url": "/releases/1", "data_quality": "Correct"}
2 | 


--------------------------------------------------------------------------------
/discogs_client/tests/res/releases/2.json:
--------------------------------------------------------------------------------
1 | {"styles": ["Broken Beat", "Techno", "Tech House"], "videos": [{"duration": 302, "description": "Mr James Barth & A D    Above the Skyline", "embed": true, "uri": "http://www.youtube.com/watch?v=evmVOtBhIp0", "title": "Mr James Barth & A D    Above the Skyline"}, {"duration": 292, "description": "Mr. James Barth & A.D. - Yeah Kid!", "embed": true, "uri": "http://www.youtube.com/watch?v=n46f_3EbFTg", "title": "Mr. James Barth & A.D. - Yeah Kid!"}], "series": [], "labels": [{"id": 5, "resource_url": "/labels/5", "catno": "SK 026", "name": "Svek", "entity_type": ""}, {"id": 5, "resource_url": "/labels/5", "catno": "SK026", "name": "Svek", "entity_type": ""}], "year": 1998, "artists": [{"join": "", "name": "Mr. James Barth & A.D.", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/2", "id": 2}], "images": [{"uri": "/image/R-2-1151006967.jpeg", "height": 394, "width": 400, "resource_url": "/image/R-2-1151006967.jpeg", "type": "primary", "uri150": "/image/R-150-2-1151006967.jpeg"}, {"uri": "/image/R-2-1193657839.jpeg", "height": 600, "width": 600, "resource_url": "/image/R-2-1193657839.jpeg", "type": "secondary", "uri150": "/image/R-150-2-1193657839.jpeg"}, {"uri": "/image/R-2-1193657861.jpeg", "height": 600, "width": 600, "resource_url": "/image/R-2-1193657861.jpeg", "type": "secondary", "uri150": "/image/R-150-2-1193657861.jpeg"}], "id": 2, "genres": ["Electronic"], "thumb": "/image/R-150-2-1151006967.jpeg", "extraartists": [{"join": "", "name": "Alexi Delano", "anv": "", "tracks": "", "role": "Producer, Recorded By", "resource_url": "/artists/26", "id": 26}, {"join": "", "name": "Cari Lekebusch", "anv": "", "tracks": "", "role": "Producer, Recorded By", "resource_url": "/artists/27", "id": 27}, {"join": "", "name": "Alexi Delano", "anv": "A. Delano", "tracks": "", "role": "Written-By", "resource_url": "/artists/26", "id": 26}, {"join": "", "name": "Cari Lekebusch", "anv": "C. Lekebusch", "tracks": "", "role": "Written-By", "resource_url": "/artists/27", "id": 27}], "title": "Knockin' Boots Vol 2 Of 2", "master_id": 248927, "tracklist": [{"duration": "5:08", "position": "A1", "title": "A Sea Apart"}, {"duration": "4:21", "position": "A2", "title": "Dutchmaster"}, {"duration": "4:22", "position": "B1", "title": "Inner City Lullaby"}, {"duration": "4:46", "position": "B2", "title": "Yeah Kid!"}], "status": "Accepted", "released_formatted": "Jun 1998", "master_url": "/masters/248927", "released": "1998-06-00", "country": "Sweden", "notes": "All joints recorded in NYC (Dec.97).", "identifiers": [{"type": "Matrix / Runout", "description": "Side A Runout Etching", "value": "MPO SK026-A -J.T.S.-"}, {"type": "Matrix / Runout", "description": "Side B Runout Etching", "value": "MPO SK026-B -J.T.S.-"}], "companies": [], "formats": [{"descriptions": ["12\"", "33 \u2153 RPM"], "name": "Vinyl", "qty": "1"}], "resource_url": "/releases/2", "data_quality": "Correct"}
2 | 


--------------------------------------------------------------------------------
/discogs_client/tests/res/releases/3.json:
--------------------------------------------------------------------------------
1 | {"status": "Accepted", "videos": [{"duration": 337, "embed": true, "title": "Profound Sounds Vol.1 - Josh Wink", "description": "Profound Sounds Vol.1 - Josh Wink", "uri": "http://www.youtube.com/watch?v=poF7kq2m-Ko"}], "series": [], "labels": [{"name": "Ruffhouse Records", "entity_type": "1", "catno": "CK 63628", "resource_url": "/labels/6", "id": 6, "entity_type_name": "Label"}], "year": 1999, "images": [{"uri": "/image/R-3-1287135004.jpeg", "height": 600, "width": 593, "resource_url": "/image/R-3-1287135004.jpeg", "type": "primary", "uri150": "/image/R-150-3-1287135004.jpeg"}], "id": 3, "genres": ["Electronic"], "thumb": "/image/R-150-3-1287135004.jpeg", "extraartists": [{"join": "", "name": "Josh Wink", "anv": "", "tracks": "", "role": "DJ Mix", "resource_url": "/artists/3", "id": 3}], "title": "Profound Sounds Vol. 1", "artists": [{"join": "", "name": "Josh Wink", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/3", "id": 3}], "master_id": 66526, "tracklist": [{"duration": "7:00", "position": "1", "artists": [{"join": "&", "name": "Heiko Laux", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/5", "id": 5}, {"join": "", "name": "Johannes Heil", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/4", "id": 4}], "title": "Untitled 8"}, {"duration": "5:28", "position": "2", "artists": [{"join": "", "name": "Karl Axel Bissler", "anv": "K.A.B.", "tracks": "", "role": "", "resource_url": "/artists/15525", "id": 15525}], "title": "Anjua (Sneaky 3)"}, {"duration": "5:25", "position": "3", "artists": [{"join": "", "name": "Sylk 130", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/7", "id": 7}], "extraartists": [{"join": "", "name": "Mood II Swing", "anv": "", "tracks": "", "role": "Remix", "resource_url": "/artists/8", "id": 8}], "title": "When The Funk Hits The Fan (Mood II Swing When The Dub Hits The Fan)"}, {"duration": "4:27", "position": "4", "artists": [{"join": "", "name": "Persuader, The", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/1", "id": 1}], "title": "What's The Time, Mr. Templar"}, {"duration": "5:36", "position": "5", "artists": [{"join": "", "name": "Care Company (2)", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/267132", "id": 267132}], "title": "Vol. 2"}, {"duration": "3:37", "position": "6", "artists": [{"join": "", "name": "Gez Varley", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/6981", "id": 6981}], "title": "Political Prisoner"}, {"duration": "5:03", "position": "7", "artists": [{"join": "", "name": "DJ Dozia", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/11", "id": 11}], "title": "Pop Kulture"}, {"duration": "5:42", "position": "8", "artists": [{"join": "Meets", "name": "Nerio's Dubwork", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/10702", "id": 10702}, {"join": "", "name": "Kathy Lee", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/233190", "id": 233190}], "extraartists": [{"join": "", "name": "Alex Hi-Fi", "anv": "", "tracks": "", "role": "Remix", "resource_url": "/artists/23", "id": 23}], "title": "K-Mart Shopping (Hi-Fi Mix)"}, {"duration": "5:47", "position": "9", "artists": [{"join": "", "name": "Blaze", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/13", "id": 13}], "extraartists": [{"join": "", "name": "Eight Miles High", "anv": "", "tracks": "", "role": "Remix", "resource_url": "/artists/14", "id": 14}], "title": "Lovelee Dae (Eight Miles High Mix)"}, {"duration": "6:06", "position": "10", "artists": [{"join": "Presents", "name": "Stacey Pullen", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/67226", "id": 67226}, {"join": "", "name": "Black Odyssey", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/7554", "id": 7554}], "extraartists": [{"join": "", "name": "Stacey Pullen", "anv": "", "tracks": "", "role": "Presenter", "resource_url": "/artists/67226", "id": 67226}], "title": "Sweat"}, {"duration": "3:16", "position": "11", "artists": [{"join": "", "name": "Christian Smith & John Selway", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/3906", "id": 3906}], "title": "Silver"}, {"duration": "2:46", "position": "12", "artists": [{"join": "", "name": "Josh Wink", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/3", "id": 3}], "title": "Untitled"}, {"duration": "3:41", "position": "13", "artists": [{"join": "", "name": "Sound Associates", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/19", "id": 19}], "title": "Boom Box"}, {"duration": "3:39", "position": "14", "artists": [{"join": "", "name": "Percy X", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/20", "id": 20}], "title": "Track 2"}], "styles": ["Techno", "Tech House"], "released_formatted": "13 Jul 1999", "master_url": "/masters/66526", "released": "1999-07-13", "country": "US", "notes": "1: Track title is given as \"D2\" (which is the side of record on the vinyl version of i220-010 release). This was also released on CD where this track is listed on 8th position. On both version no titles are given (only writing/producing credits). You can see both versions of i220-010 <a href=\"http://www.discogs.com/Heiko-Laux-The-Oldschoolstreet/master/27265\">here.</a> Additionally this track contains female vocals that aren't present on original i220-010 release. \r\n4: Credited as J. Dahlb\u00e4ck. \r\n5: Track title wrongly given as \"Vol. 1\". \r\n6: Credited as Gez Varley presents Tony Montana. \r\n12: Track exclusive to Profound Sounds Vol. 1.\n", "identifiers": [{"type": "Barcode", "value": "074646362822"}], "companies": [{"name": "Columbia Records", "entity_type": "10", "catno": "", "resource_url": "/labels/93330", "id": 93330, "entity_type_name": "Manufactured By"}, {"name": "Columbia Records", "entity_type": "9", "catno": "", "resource_url": "/labels/93330", "id": 93330, "entity_type_name": "Distributed By"}], "formats": [{"qty": "1", "descriptions": ["Compilation", "Mixed"], "name": "CD"}], "resource_url": "/releases/3", "data_quality": "Correct"}
2 | 


--------------------------------------------------------------------------------
/discogs_client/tests/res/releases/3329867.json:
--------------------------------------------------------------------------------
1 | {"status": "Accepted", "styles": ["Modern Classical", "Chiptune", "Breaks", "Ambient"], "genres": ["Electronic"], "formats": [{"text": "320 kbps", "qty": "6", "descriptions": ["MP3", "Album"], "name": "File"}], "thumb": "/image/R-150-3329867-1326034108.jpeg", "extraartists": [], "title": "Darwinia Soundtrack", "series": [], "released_formatted": "2005", "labels": [{"name": "Not On Label", "entity_type": "1", "catno": "none", "resource_url": "/labels/1818", "id": 1818, "entity_type_name": "Label"}], "companies": [], "artists": [{"join": "&", "name": "Trash80", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/95780", "id": 95780}, {"join": "", "name": "Dma-Sc", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/216524", "id": 216524}], "released": "2005", "images": [{"uri": "/image/R-3329867-1326034108.jpeg", "height": 339, "width": 342, "resource_url": "/image/R-3329867-1326034108.jpeg", "type": "primary", "uri150": "/image/R-150-3329867-1326034108.jpeg"}, {"uri": "/image/R-3329867-1326034115.jpeg", "height": 334, "width": 428, "resource_url": "/image/R-3329867-1326034115.jpeg", "type": "secondary", "uri150": "/image/R-150-3329867-1326034115.jpeg"}], "country": "UK", "year": 2005, "resource_url": "/releases/3329867", "tracklist": [{"duration": "5:30", "position": "1", "artists": [{"join": "", "name": "Dma-Sc", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/216524", "id": 216524}], "title": "Visitors From Dreams"}, {"duration": "5:46", "position": "2", "artists": [{"join": "", "name": "Trash80", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/95780", "id": 95780}], "title": "Excuses"}, {"duration": "3:42", "position": "3", "artists": [{"join": "", "name": "Trash80", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/95780", "id": 95780}], "title": "Schroeder's Failure"}, {"duration": "3:36", "position": "4", "artists": [{"join": "", "name": "Trash80", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/95780", "id": 95780}], "title": "Pain Fade Down"}, {"duration": "3:41", "position": "5", "artists": [{"join": "", "name": "Trash80", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/95780", "id": 95780}], "title": "Impact Of Silence"}, {"duration": "4:38", "position": "6", "artists": [{"join": "", "name": "Trash80", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/95780", "id": 95780}], "title": "Faces Of A Fashion"}], "id": 3329867, "data_quality": "Needs Vote"}
2 | 


--------------------------------------------------------------------------------
/discogs_client/tests/res/releases/79.json:
--------------------------------------------------------------------------------
1 | {"styles": ["Deep House", "Tech House"], "videos": [{"duration": 328, "description": "The Persuader - Djurgardsbron - Svek Records", "embed": true, "uri": "http://www.youtube.com/watch?v=QLgJ1E7COnM", "title": "The Persuader - Djurgardsbron - Svek Records"}, {"duration": 299, "description": "The Persuader - Stromsbron - Svek Records", "embed": true, "uri": "http://www.youtube.com/watch?v=FUsihJaFmkE", "title": "The Persuader - Stromsbron - Svek Records"}, {"duration": 264, "description": "The Persuader - Centralbron", "embed": true, "uri": "http://www.youtube.com/watch?v=ta5KOlw-dOk", "title": "The Persuader - Centralbron"}], "series": [], "labels": [{"id": 5, "resource_url": "/labels/5", "catno": "SK029", "name": "Svek", "entity_type": ""}], "year": 1998, "artists": [{"join": "", "name": "Persuader, The", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/1", "id": 1}], "images": [{"uri": "/image/R-79-1104723687.jpg", "height": 150, "width": 150, "resource_url": "/image/R-79-1104723687.jpg", "type": "secondary", "uri150": "/image/R-150-79-1104723687.jpg"}], "id": 79, "genres": ["Electronic"], "thumb": "/image/R-150-79-1104723687.jpg", "extraartists": [{"join": "", "name": "Jesper Dahlb\u00e4ck", "anv": "", "tracks": "", "role": "Producer, Written-By", "resource_url": "/artists/239", "id": 239}], "title": "City Of Islands", "master_id": 4242, "tracklist": [{"duration": "5:12", "position": "A1", "title": "Djurg\u00e5rdsbron"}, {"duration": "4:20", "position": "A2", "title": "Centralbron"}, {"duration": "4:47", "position": "B1", "title": "Str\u00f6msbron"}, {"duration": "4:42", "position": "B2", "title": "Kungsbron"}], "status": "Accepted", "released_formatted": "Dec 1998", "master_url": "/masters/4242", "released": "1998-12-00", "country": "Sweden", "notes": "Recorded at the Globe Studio, Stockholm.", "companies": [], "formats": [{"descriptions": ["12\""], "name": "Vinyl", "qty": "1"}], "resource_url": "/releases/79", "data_quality": "Correct"}
2 | 


--------------------------------------------------------------------------------
/discogs_client/tests/res/users/example.json:
--------------------------------------------------------------------------------
1 | {"username": "example", "profile": "I'm an example user!", "num_lists": 0, "name": "Example Sampleman", "num_for_sale": 3, "collection_fields_url": "/users/example/collection/fields", "home_page": "http://www.example.com/", "wantlist_url": "/users/example/wants", "registered": "2011-01-01T00:00:42", "inventory_url": "/users/example/inventory", "rating_avg": 3.14, "num_collection": 14, "rank": 1.0, "releases_rated": 8, "releases_contributed": 0, "location": "Example Town, Exampland", "num_pending": 0, "collection_folders_url": "/users/example/collection/folders", "resource_url": "/users/example", "num_wantlist": 3, "id": 1}
2 | 


--------------------------------------------------------------------------------
/discogs_client/tests/res/users/example/wants_per_page=50&page=1.json:
--------------------------------------------------------------------------------
1 | {"wants": [{"rating": 4, "basic_information": {"labels": [{"id": 2311, "resource_url": "/labels/2311", "catno": "B0008764-02", "name": "Interscope Records", "entity_type": ""}], "formats": [{"descriptions": ["Album"], "text": "Digipak", "name": "CD", "qty": "1"}], "thumb": "/image/R-150-1867708-1248886216.jpeg", "title": "Year Zero", "artists": [{"join": "", "name": "Nine Inch Nails", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/3857", "id": 3857}], "resource_url": "/releases/1867708", "year": 2007, "id": 1867708}, "notes": "Sample public notes.", "notes_public": true, "resource_url": "/users/example/wants/1867708", "id": 1867708}, {"rating": 3, "resource_url": "/users/example/wants/1675174", "basic_information": {"labels": [{"id": 141550, "resource_url": "/labels/141550", "catno": "NORM007", "name": "Normative", "entity_type": ""}], "formats": [{"descriptions": ["Album"], "name": "CDr", "qty": "1"}], "thumb": "/image/R-150-1675174-1236118359.jpeg", "title": "Dawn Metropolis", "artists": [{"join": "", "name": "Anamanaguchi", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/667233", "id": 667233}], "resource_url": "/releases/1675174", "year": 2009, "id": 1675174}, "id": 1675174, "notes_public": false}, {"rating": 0, "resource_url": "/users/example/wants/1", "basic_information": {"labels": [{"name": "Svek", "entity_type": "1", "catno": "SK032", "resource_url": "/labels/5", "id": 5, "entity_type_name": "Label"}], "formats": [{"descriptions": ["12\""], "name": "Vinyl", "qty": "2"}], "thumb": "/image/R-150-1-1193812031.jpeg", "title": "Stockholm", "artists": [{"join": "", "name": "Persuader, The", "anv": "", "tracks": "", "role": "", "resource_url": "/artists/1", "id": 1}], "resource_url": "/releases/1", "year": 1999, "id": 1}, "id": 1, "notes_public": false}], "pagination": {"per_page": 50, "items": 3, "page": 1, "urls": {}, "pages": 1}}
2 | 


--------------------------------------------------------------------------------
/discogs_client/tests/test_core.py:
--------------------------------------------------------------------------------
  1 | from __future__ import absolute_import, division, print_function, unicode_literals
  2 | 
  3 | import unittest
  4 | from discogs_client import Client
  5 | from discogs_client.tests import DiscogsClientTestCase
  6 | from discogs_client.exceptions import ConfigurationError, HTTPError
  7 | from datetime import datetime
  8 | 
  9 | 
 10 | class CoreTestCase(DiscogsClientTestCase):
 11 |     def test_user_agent(self):
 12 |         """User-Agent should be properly set"""
 13 |         self.d.artist(1).name
 14 | 
 15 |         bad_client = Client('')
 16 | 
 17 |         self.assertRaises(ConfigurationError, lambda: bad_client.artist(1).name)
 18 | 
 19 |         try:
 20 |             bad_client.artist(1).name
 21 |         except ConfigurationError as e:
 22 |             self.assertTrue('User-Agent' in str(e))
 23 | 
 24 |     def test_caching(self):
 25 |         """Only perform a fetch when requesting missing data"""
 26 |         a = self.d.artist(1)
 27 | 
 28 |         self.assertEqual(a.id, 1)
 29 |         self.assertTrue(self.d._fetcher.last_request is None)
 30 | 
 31 |         self.assertEqual(a.name, 'Persuader, The')
 32 |         self.assertGot('/artists/1')
 33 | 
 34 |         self.assertEqual(a.real_name, 'Jesper Dahlb\u00e4ck')
 35 |         self.assertEqual(len(self.d._fetcher.requests), 1)
 36 | 
 37 |         # Get a key that's not in our cache
 38 |         a.fetch('blorf')
 39 |         self.assertEqual(len(self.d._fetcher.requests), 2)
 40 |         self.assertTrue('blorf' in a._known_invalid_keys)
 41 | 
 42 |         # Now we know artists don't have blorves
 43 |         a.fetch('blorf')
 44 |         self.assertEqual(len(self.d._fetcher.requests), 2)
 45 | 
 46 |     def test_equality(self):
 47 |         """APIObjects of the same class are equal if their IDs are"""
 48 |         a1 = self.d.artist(1)
 49 |         a1_ = self.d.artist(1)
 50 |         self.d.artist(2)
 51 | 
 52 |         r1 = self.d.release(1)
 53 | 
 54 |         self.assertEqual(a1, a1_)
 55 |         self.assertEqual(a1, r1.artists[0])
 56 |         self.assertNotEqual(a1, r1)
 57 |         self.assertNotEqual(r1, ':D')
 58 | 
 59 |     def test_transform_datetime(self):
 60 |         """String timestamps are converted to datetimes"""
 61 |         registered = self.d.user('example').registered
 62 |         self.assertTrue(isinstance(registered, datetime))
 63 | 
 64 |     def test_object_field(self):
 65 |         """APIObjects can have APIObjects as properties"""
 66 |         self.assertEqual(self.d.master(4242).main_release, self.d.release(79))
 67 | 
 68 |     def test_read_only_simple_field(self):
 69 |         """Can't write to a SimpleField when writable=False"""
 70 |         u = self.d.user('example')
 71 | 
 72 |         def fail():
 73 |             u.rank = 9001
 74 |         self.assertRaises(AttributeError, fail)
 75 | 
 76 |     def test_read_only_object_field(self):
 77 |         """Can't write to an ObjectField"""
 78 |         m = self.d.master(4242)
 79 | 
 80 |         def fail():
 81 |             m.main_release = 'lol!'
 82 |         self.assertRaises(AttributeError, fail)
 83 | 
 84 |     def test_pagination(self):
 85 |         """PaginatedLists are parsed correctly, indexable, and iterable"""
 86 |         results = self.d.artist(1).releases
 87 | 
 88 |         self.assertEqual(results.per_page, 50)
 89 |         self.assertEqual(results.pages, 2)
 90 |         self.assertEqual(results.count, 57)
 91 | 
 92 |         self.assertEqual(len(results), 57)
 93 |         self.assertEqual(len(results.page(1)), 50)
 94 | 
 95 |         self.assertRaises(HTTPError, lambda: results.page(42))
 96 | 
 97 |         try:
 98 |             results.page(42)
 99 |         except HTTPError as e:
100 |             self.assertEqual(e.status_code, 404)
101 | 
102 |         self.assertRaises(IndexError, lambda: results[3141592])
103 | 
104 |         self.assertEqual(results[0].id, 20209)
105 |         self.assertTrue(self.d.release(20209) in results)
106 | 
107 |         # Changing pagination settings invalidates the cache
108 |         results.per_page = 10
109 |         self.assertTrue(results._num_pages is None)
110 | 
111 | 
112 | def suite():
113 |     suite = unittest.TestSuite()
114 |     suite = unittest.TestLoader().loadTestsFromTestCase(CoreTestCase)
115 |     return suite
116 | 
117 | if __name__ == '__main__':
118 |     unittest.main(defaultTest='suite')
119 | 


--------------------------------------------------------------------------------
/discogs_client/tests/test_fetchers.py:
--------------------------------------------------------------------------------
 1 | from __future__ import absolute_import, division, print_function, unicode_literals
 2 | 
 3 | import unittest
 4 | from discogs_client.tests import DiscogsClientTestCase
 5 | from discogs_client.exceptions import HTTPError
 6 | 
 7 | 
 8 | class FetcherTestCase(DiscogsClientTestCase):
 9 |     def test_memory_fetcher(self):
10 |         """Client can fetch responses with MemoryFetcher"""
11 |         self.m.artist(1)
12 | 
13 |         self.assertRaises(HTTPError, lambda: self.m._get('/500'))
14 | 
15 |         try:
16 |             self.m._get('/500')
17 |         except HTTPError as e:
18 |             self.assertEqual(e.status_code, 500)
19 | 
20 |         self.assertRaises(HTTPError, lambda: self.m.release(1).title)
21 |         self.assertTrue(self.m._get('/204') is None)
22 | 
23 | 
24 | def suite():
25 |     suite = unittest.TestSuite()
26 |     suite = unittest.TestLoader().loadTestsFromTestCase(FetcherTestCase)
27 |     return suite
28 | 
29 | if __name__ == '__main__':
30 |     unittest.main(defaultTest='suite')
31 | 


--------------------------------------------------------------------------------
/discogs_client/tests/test_models.py:
--------------------------------------------------------------------------------
  1 | from __future__ import absolute_import, division, print_function, unicode_literals
  2 | 
  3 | import unittest
  4 | from discogs_client.models import Artist, Release
  5 | from discogs_client.tests import DiscogsClientTestCase
  6 | from discogs_client.exceptions import HTTPError
  7 | 
  8 | 
  9 | class ModelsTestCase(DiscogsClientTestCase):
 10 |     def test_artist(self):
 11 |         """Artists can be fetched and parsed"""
 12 |         a = self.d.artist(1)
 13 |         self.assertEqual(a.name, 'Persuader, The')
 14 | 
 15 |     def test_release(self):
 16 |         """Releases can be fetched and parsed"""
 17 |         r = self.d.release(1)
 18 |         self.assertEqual(r.title, 'Stockholm')
 19 | 
 20 |     def test_master(self):
 21 |         """Masters can be fetched and parsed"""
 22 |         m = self.d.master(4242)
 23 |         self.assertEqual(len(m.tracklist), 4)
 24 | 
 25 |     def test_user(self):
 26 |         """Users can be fetched and parsed"""
 27 |         u = self.d.user('example')
 28 |         self.assertEqual(u.username, 'example')
 29 |         self.assertEqual(u.name, 'Example Sampleman')
 30 | 
 31 |     def test_search(self):
 32 |         results = self.d.search('trash80')
 33 |         self.assertEqual(len(results), 13)
 34 |         self.assertTrue(isinstance(results[0], Artist))
 35 |         self.assertTrue(isinstance(results[1], Release))
 36 | 
 37 |     def test_utf8_search(self):
 38 |         uni_string = 'caf\xe9'.encode('utf8')
 39 |         try:
 40 |             results = self.d.search(uni_string)
 41 |         except Exception as e:
 42 |             self.fail('exception {} was raised'.format(e))
 43 | 
 44 |     def test_fee(self):
 45 |         fee = self.d.fee_for(20.5, currency='EUR')
 46 |         self.assertEqual(fee.currency, 'USD')
 47 |         self.assertAlmostEqual(fee.value, 1.57)
 48 | 
 49 |     def test_invalid_artist(self):
 50 |         """Invalid artist raises HTTPError"""
 51 |         self.assertRaises(HTTPError, lambda: self.d.artist(0).name)
 52 | 
 53 |     def test_invalid_release(self):
 54 |         """Invalid release raises HTTPError"""
 55 |         self.assertRaises(HTTPError, lambda: self.d.release(0).title)
 56 | 
 57 |     def test_http_error(self):
 58 |         """HTTPError provides useful information"""
 59 |         self.assertRaises(HTTPError, lambda: self.d.artist(0).name)
 60 | 
 61 |         try:
 62 |             self.d.artist(0).name
 63 |         except HTTPError as e:
 64 |             self.assertEqual(e.status_code, 404)
 65 |             self.assertEqual('404: Resource not found.', str(e))
 66 | 
 67 |     def test_parent_label(self):
 68 |         """Test parent_label / sublabels relationship"""
 69 |         l = self.d.label(1)
 70 |         l2 = self.d.label(31405)
 71 | 
 72 |         self.assertTrue(l.parent_label is None)
 73 |         self.assertTrue(l2 in l.sublabels)
 74 |         self.assertEqual(l2.parent_label, l)
 75 | 
 76 |     def test_master_versions(self):
 77 |         """Test main_release / versions relationship"""
 78 |         m = self.d.master(4242)
 79 |         r = self.d.release(79)
 80 |         v = m.versions
 81 | 
 82 |         self.assertEqual(len(v), 2)
 83 |         self.assertTrue(r in v)
 84 |         self.assertEqual(r.master, m)
 85 | 
 86 |         r2 = self.d.release(3329867)
 87 |         self.assertTrue(r2.master is None)
 88 | 
 89 |     def test_user_writable(self):
 90 |         """User profile can be updated"""
 91 |         u = self.d.user('example')
 92 |         u.name  # Trigger a fetch
 93 | 
 94 |         method, url, data, headers = self.d._fetcher.requests[0]
 95 |         self.assertEqual(method, 'GET')
 96 |         self.assertEqual(url, '/users/example')
 97 | 
 98 |         new_home_page = 'http://www.discogs.com'
 99 |         u.home_page = new_home_page
100 |         self.assertTrue('home_page' in u.changes)
101 |         self.assertFalse('profile' in u.changes)
102 | 
103 |         u.save()
104 | 
105 |         # Save
106 |         method, url, data, headers = self.d._fetcher.requests[1]
107 |         self.assertEqual(method, 'POST')
108 |         self.assertEqual(url, '/users/example')
109 |         self.assertEqual(data, {'home_page': new_home_page})
110 | 
111 |         # Refresh
112 |         method, url, data, headers = self.d._fetcher.requests[2]
113 |         self.assertEqual(method, 'GET')
114 |         self.assertEqual(url, '/users/example')
115 | 
116 |     def test_wantlist(self):
117 |         """Wantlists can be manipulated"""
118 |         # Fetch the user/wantlist from the filesystem
119 |         u = self.d.user('example')
120 |         self.assertEqual(len(u.wantlist), 3)
121 | 
122 |         # Stub out expected responses
123 |         self.m._fetcher.fetcher.responses = {
124 |             '/users/example/wants/5': (b'{"id": 5}', 201),
125 |             '/users/example/wants/1': (b'', 204),
126 |         }
127 | 
128 |         # Now bind the user to the memory client
129 |         u.client = self.m
130 | 
131 |         u.wantlist.add(5)
132 |         method, url, data, headers = self.m._fetcher.last_request
133 |         self.assertEqual(method, 'PUT')
134 |         self.assertEqual(url, '/users/example/wants/5')
135 | 
136 |         u.wantlist.remove(1)
137 |         method, url, data, headers = self.m._fetcher.last_request
138 |         self.assertEqual(method, 'DELETE')
139 |         self.assertEqual(url, '/users/example/wants/1')
140 | 
141 |     def test_delete_object(self):
142 |         """Can request DELETE on an APIObject"""
143 |         u = self.d.user('example')
144 |         u.delete()
145 | 
146 |         method, url, data, headers = self.d._fetcher.last_request
147 |         self.assertEqual(method, 'DELETE')
148 |         self.assertEqual(url, '/users/example')
149 | 
150 |     def test_identity(self):
151 |         """OAuth identity returns a User"""
152 |         me = self.d.identity()
153 |         self.assertEqual(me.data['consumer_name'], 'Test Client')
154 |         self.assertEqual(me, self.d.user('example'))
155 | 
156 | 
157 | def suite():
158 |     suite = unittest.TestSuite()
159 |     suite = unittest.TestLoader().loadTestsFromTestCase(ModelsTestCase)
160 |     return suite
161 | 
162 | if __name__ == '__main__':
163 |     unittest.main(defaultTest='suite')
164 | 


--------------------------------------------------------------------------------
/discogs_client/tests/test_utils.py:
--------------------------------------------------------------------------------
 1 | from __future__ import absolute_import, division, print_function, unicode_literals
 2 | 
 3 | import unittest
 4 | from datetime import datetime
 5 | from discogs_client.tests import DiscogsClientTestCase
 6 | from discogs_client import utils
 7 | 
 8 | 
 9 | class UtilsTestCase(DiscogsClientTestCase):
10 |     def test_update_qs(self):
11 |         """update_qs helper works as intended"""
12 |         u = utils.update_qs
13 |         self.assertEqual(u('http://example.com', {'foo': 'bar'}), 'http://example.com?foo=bar')
14 |         self.assertEqual(u('http://example.com?foo=bar', {'foo': 'baz'}), 'http://example.com?foo=bar&foo=baz')
15 |         # be careful for dict iteration order is not deterministic
16 |         result = u('http://example.com?c=3&a=yep', {'a': 1, 'b': '1'})
17 |         try:
18 |             self.assertEqual(result, 'http://example.com?c=3&a=yep&a=1&b=1')
19 |         except AssertionError:
20 |             self.assertEqual(result, 'http://example.com?c=3&a=yep&b=1&a=1')
21 | 
22 |         self.assertEqual(u('http://example.com', {'a': 't\xe9st'}),
23 |                          'http://example.com?a=t%C3%A9st')
24 | 
25 |     def test_omit_none(self):
26 |         o = utils.omit_none
27 |         self.assertEqual(o({
28 |             'foo': None,
29 |             'baz': 'bat',
30 |             'qux': None,
31 |             'flan': 0,
32 |         }), {
33 |             'baz': 'bat',
34 |             'flan': 0,
35 |         })
36 | 
37 |         self.assertEqual(o(dict((k, None) for k in ('qux', 'quux', 'quuux'))), {})
38 |         self.assertEqual(o({'nope': 'yep'}), {'nope': 'yep'})
39 |         self.assertEqual(o({}), {})
40 | 
41 |     def test_parse_timestamp(self):
42 |         p = utils.parse_timestamp
43 |         self.assertEqual(p('2012-01-01T00:00:00'), datetime(2012, 1, 1, 0, 0, 0))
44 |         self.assertEqual(p('2001-05-25T00:00:42'), datetime(2001, 5, 25, 0, 0, 42))
45 | 
46 | 
47 | def suite():
48 |     suite = unittest.TestSuite()
49 |     suite = unittest.TestLoader().loadTestsFromTestCase(UtilsTestCase)
50 |     return suite
51 | 
52 | if __name__ == '__main__':
53 |     unittest.main(defaultTest='suite')
54 | 


--------------------------------------------------------------------------------
/discogs_client/utils.py:
--------------------------------------------------------------------------------
 1 | from __future__ import unicode_literals
 2 | 
 3 | from datetime import datetime
 4 | try:
 5 |     # python2
 6 |     from urllib2 import quote
 7 |     to_str = unicode
 8 | except ImportError:
 9 |     # python3
10 |     from urllib.parse import quote
11 |     to_str = str
12 | 
13 | 
14 | def parse_timestamp(timestamp):
15 |     """Convert an ISO 8601 timestamp into a datetime."""
16 |     return datetime.strptime(timestamp, '%Y-%m-%dT%H:%M:%S')
17 | 
18 | 
19 | def update_qs(url, params):
20 |     """A not-very-intelligent function to glom parameters onto a query string."""
21 |     joined_qs = '&'.join('='.join((str(k), quote(to_str(v).encode('utf8'))))
22 |                          for k, v in params.items())
23 |     separator = '&' if '?' in url else '?'
24 |     return url + separator + joined_qs
25 | 
26 | 
27 | def omit_none(dict_):
28 |     """Removes any key from a dict that has a value of None."""
29 |     return dict((k, v) for k, v in dict_.items() if v is not None)
30 | 


--------------------------------------------------------------------------------
/docs/authentication.md:
--------------------------------------------------------------------------------
 1 | ## Authentication
 2 | 
 3 | There are two forms of authentication the Discogs API allows: OAuth and
 4 | Discogs Auth
 5 | 
 6 | OAuth is useful if you want to create an application where a user uses your app
 7 | as a proxy to make requests and change information about their Discogs account.
 8 | This includes profile information, collection and wantlist information, and
 9 | marketplace changes.
10 | 
11 | Discogs Auth is great as a simple solution for scripts that just want to use
12 | endpoint that require authentication, or for users who are writing apps that
13 | only represent a single user (e.g., writing a store-front for your Discogs
14 | seller account).
15 | 
16 | We will cover both forms of authentication below.
17 | 
18 | ### Discogs Authentication
19 | 
20 | This is the more simple of the two methods of authenticating. Assuming you have generated a Discogs User Token in your Discogs developer settings, you can simply supply your token to the `Client` class:
21 | 
22 | ```python
23 | import discogs_client as dc
24 | ds = dc.Client('my_user_agent/1.0', user_token='my_user_token')
25 | ```
26 | 
27 | That's it! You are now free to make authenticated requests.
28 | 
29 | ### OAuth Authentication
30 | 
31 | OAuth is an open protocol commonly used for authorization (and in this case, authentication as well). For more information on the OAuth specification, please visit the OAuth website: http://oauth.net/
32 | 
33 | A Discogs consumer key and consumer secret are required for OAuth, and we can supply these credentials in two ways:
34 | 
35 | Begin by importing the client library:
36 | ```python
37 | import discogs_client as dc
38 | ```
39 | 
40 | 1. Instantiating the `Client` class with the consumer key and secret:
41 | 
42 |     ```python
43 |     ds = dc.Client(
44 |         'my_user_agent/1.0',
45 |         consumer_key='my_consumer_key',
46 |         consumer_secret='my_consumer_secret'
47 |     )
48 |     ```
49 | 
50 |     You can also supply your OAuth token and token secret if you already have them saved, as so:
51 | 
52 |     ```python
53 |     ds = dc.Client(
54 |         'my_user_agent/1.0',
55 |         consumer_key='my_consumer_key',
56 |         consumer_secret='my_consumer_secret',
57 |         token=u'my_token',
58 |         secret=u'my_token_secret'
59 |     )
60 |     ```
61 | 
62 | 2. Calling the `set_consumer_key()` method
63 | 
64 |     ```python
65 |     ds = dc.Client('my_user_agent/1.0')
66 |     ds.set_consumer_key('my_consumer_key', 'my_consumer_secret')
67 |     ```
68 | 
69 | These two methods do the same thing; their use is up to your preference. 
70 | 
71 | From here, we need to finish the OAuth process.
72 | 
73 | * Get authorization URL
74 | 
75 |     ```python
76 |     ds.get_authorize_url()
77 |     ```
78 | 
79 |     This will return a tuple with the request token, request secret, and the authorization URL that your user needs to visit to accept your app's request to sign in on their behalf.
80 | 
81 |     If you are writing a web application, you can specify a `callback_url` string to this method to receive the request token and request secret in the HTTP response.
82 | 
83 | * Get OAuth access token
84 | 
85 |     Pass the OAuth verifier that you received after the user authorizes your app into this method. This will return a tuple with the access token and access token secret that finalizes the OAuth process.
86 | 
87 |     ```python
88 |     d.get_access_token('verifier-here')
89 |     ```
90 | 
91 | From here, you are free to make OAuth-based requests. A smoke-test to verify everything is working is to call the `identity()` method:
92 | 
93 | ```python
94 | me = ds.identity()
95 | ```
96 | 
97 | This will return a `User` object if everything is okay.
98 | 


--------------------------------------------------------------------------------
/docs/quickstart.md:
--------------------------------------------------------------------------------
 1 | ## Quickstart
 2 | 
 3 | ### Instantiating the client object
 4 | 
 5 | ```python
 6 | >>> import discogs_client
 7 | >>> ds = discogs_client.Client('ExampleApplication/0.1')
 8 | ```
 9 | 
10 | The string passed into the `Client` class is your User-Agent. A User-Agent is
11 | required for Discogs API requests, as it identifies your application to the
12 | Discogs servers.
13 | 
14 | There are more parameters the `Client` class accepts on instantiation; please
15 | refer to the `Authorization` file for more details.
16 | 
17 | Once instantiated, you can either start making requests to endpoints that do not
18 | require authentication, or you can authenticate and make requests to a wider
19 | range of endpoints.
20 | 
21 | ```python
22 | release = ds.release(1293022)
23 | print(release.title)
24 | artists = release.artists
25 | ```
26 | 
27 | As you can see, once you fetch data from an endpoint, you can call various
28 | properties and methods on those objects.
29 | 
30 | ### Searching
31 | 
32 | Simple example:
33 | 
34 | ```python
35 | results = ds.search('Can I borrow a feeling?')
36 | ```
37 | 
38 | The search method allows for all of the parameters that the raw Discogs API allows. A full list of allowable parameters are listed here: http://www.discogs.com/developers/#page:database,header:database-search
39 | 
40 | Example usage:
41 | 
42 | ```python
43 | results = ds.search('Can I borrow a feeling?', type='release')
44 | results = ds.search('Can I borrow a feeling?', type='release,master')
45 | results = ds.search('Can I borrow a feeling?', artist='Kirk', type='release')
46 | results = ds.search('Can I borrow a feeling?', genre='Hip Hop')
47 | ```
48 | 
49 | The `results` object is a paginated list, so you need to specify which page of results to view, like so:
50 | 
51 | ```python
52 | # show list of first page results
53 | print(results.page(1))
54 | ```
55 | 
56 | 
57 | ### Most other objects
58 | 
59 | Objects contain many callable properties. For a full list of properties, call the Python `dir()` function with the object as a parameter.
60 | 
61 | Not all information available in the API response is mapped out, so if you need more information, you can look in the `data` property of the Release object:
62 | 
63 | ```python
64 | release = ds.release(1)
65 | release.data.keys()
66 | ```
67 | 


--------------------------------------------------------------------------------
/requirements.txt:
--------------------------------------------------------------------------------
1 | six
2 | PyYAML==4.2b1
3 | coverage==3.6
4 | coveralls==0.2
5 | docopt==0.6.1
6 | requests==2.20.0
7 | oauthlib==0.7.2
8 | sh==1.08
9 | 


--------------------------------------------------------------------------------
/setup.py:
--------------------------------------------------------------------------------
 1 | #!/usr/bin/env python
 2 | 
 3 | from setuptools import setup
 4 | 
 5 | setup(
 6 |         name='discogs-client',
 7 |         version='2.3.0',
 8 |         description='Official Python API client for Discogs',
 9 |         url='https://github.com/discogs/discogs_client',
10 |         author='Discogs',
11 |         author_email='api@discogsinc.com',
12 |         test_suite='discogs_client.tests',
13 |         classifiers=[
14 |             'Development Status :: 7 - Inactive',
15 |             'Environment :: Console',
16 |             'License :: OSI Approved :: BSD License',
17 |             'Natural Language :: English',
18 |             'Operating System :: OS Independent',
19 |             'Programming Language :: Python',
20 |             'Topic :: Communications',
21 |             'Topic :: Utilities',
22 |             ],
23 |         install_requires=[
24 |             'requests',
25 |             'six',
26 |             'oauthlib',
27 |             ],
28 |         packages=[
29 |             'discogs_client',
30 |             ],
31 |         )
32 | 


--------------------------------------------------------------------------------