Merge pull request #44 from vicenteneto/dev

Dando suporte ao retorno de times no formato JSON

Author: vicenteneto

CHANGES

@@ -3,6 +3,15 @@ Changelog
 
 Aqui você pode ver a lista completa de modificações entre cada versão.
 
+Versão 0.6.18
+-------------
+
+Lançada em 18 de junho de 2017
+
+- Corrigindo bug no retorno de textos no formato unicode
+- Dando suporte à retornar os dados de um time no formato json
+
+
 Versão 0.5.30
 -------------
 

cartolafc/api.py

@@ -58,7 +58,7 @@ def __init__(self, email=None, password=None, attempts=1):
             email (str): O e-mail da sua conta no CartolaFC. Requerido se o password for informado.
             password (str): A senha da sua conta no CartolaFC. Requerido se o email for informado.
             attempts (int): Quantidade de tentativas que serão efetuadas se os servidores estiverem sobrecarregados.
-            
+
         Raises:
             cartolafc.CartolaFCError: Se as credenciais forem inválidas ou se apenas um dos 
             dois argumentos (email e password) for informado.
@@ -214,14 +214,15 @@ def pos_rodada_destaques(self):
 
         raise CartolaFCError('Os destaques de pós-rodada só ficam disponíveis com o mercado aberto.')
 
-    def time(self, id=None, nome=None, slug=None):
+    def time(self, id=None, nome=None, slug=None, as_json=False):
         """ Obtém um time específico, baseando-se no nome ou no slug utilizado.
         Ao menos um dos dois devem ser informado. 
 
         Args:
             id (int): Id to time que se deseja obter. *Este argumento sempre será utilizado primeiro*
             nome (str): Nome do time que se deseja obter. Requerido se o slug não for informado.
             slug (str): Slug do time que se deseja obter. *Este argumento tem prioridade sobre o nome*
+            as_json (bool): Se desejar obter o retorno no formato json.
 
         Returns:
             Uma instância de cartolafc.Time se o time foi encontrado.
@@ -236,6 +237,10 @@ def time(self, id=None, nome=None, slug=None):
         value = id if id else (slug if slug else convert_team_name_to_slug(nome))
         url = '{api_url}/time/{param}/{value}'.format(api_url=self._api_url, param=param, value=value)
         data = self._request(url)
+
+        if bool(as_json):
+            return data
+
         clubes = {clube['id']: Clube.from_dict(clube) for clube in data['clubes'].values()}
         return Time.from_dict(data, clubes=clubes)
 

docs/source/conf.py

@@ -57,9 +57,9 @@
 # built documents.
 #
 # The short X.Y version.
-version = u'0.5.30'
+version = u'0.6.18'
 # The full version, including alpha/beta/rc tags.
-release = u'0.5.30'
+release = u'0.6.18'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

examples.py

@@ -0,0 +1,25 @@
+import cartolafc
+
+api = cartolafc.Api(email='sneto.vicente@gmail.com', password='6esncj4m', attempts=5)
+
+print api.amigos()
+print api.clubes()
+print api.liga(nome='Virtus Premier League')
+print api.liga(nome='Nacional', page=2)
+print api.liga(nome='Nacional', page=3, order_by=cartolafc.RODADA)
+print api.liga(slug='virtus-premier-league')
+print api.ligas(query='Virtus')
+print api.ligas_patrocinadores()
+print api.mercado()
+print api.mercado_atletas()
+# print api.parciais()
+print api.pontuacao_atleta(81682)
+print api.pos_rodada_destaques()
+print api.time(id=471815)
+print api.time(nome='Falydos FC')
+print api.time(slug='falydos-fc')
+print api.time_logado()
+# print api.time_parcial(id=471815)
+# print api.time_parcial(nome='Falydos FC')
+# print api.time_parcial(slug='falydos-fc')
+print api.times(query='Faly')

examples/examples.py

@@ -16,8 +16,11 @@
 print api.pontuacao_atleta(81682)
 print api.pos_rodada_destaques()
 print api.time(id=471815)
+print api.time(id=471815, as_json=True)
 print api.time(nome='Falydos FC')
+print api.time(nome='Falydos FC', as_json=True)
 print api.time(slug='falydos-fc')
+print api.time(slug='falydos-fc', as_json=True)
 print api.time_logado()
 print api.time_parcial(id=471815)
 print api.time_parcial(nome='Falydos FC')

examples/requirements.txt

@@ -1 +1 @@
-Python-CartolaFC==0.5.30
+Python-CartolaFC==0.6.18

setup.py

@@ -14,7 +14,7 @@
 """
 from setuptools import setup
 
-version = '0.5.30'
+version = '0.6.18'
 packages = ['cartolafc']
 install_requires = ['requests']
 python_cartolafc_pkg_data = []

tests/test_api.py

@@ -477,6 +477,16 @@ def test_time_com_id_com_nome_e_com_slug(self):
             # Assert
             self.assertIsInstance(time, Time)
 
+    def test_time_com_json(self):
+        # Arrange and Act
+        with requests_mock.mock() as m:
+            url = '{api_url}/time/id/{id}'.format(api_url=self.api_url, id=471815)
+            m.get(url, text=self.TIME)
+            time = self.api.time(id=471815, as_json=True)
+
+            # Assert
+            self.assertIsInstance(time, dict)
+
     def test_time_parcial_mercado_aberto(self):
         # Arrange
         with requests_mock.mock() as m: