Criando um aplicativo Web simples com Bottle, SQLAlchemy e a API do Twitter

1. Como clonar o repositório do projeto e configurar o aplicativo.
2. Como usar a API do Twitter por meio do módulo Tweepy para carregar os tweets.
3. Como usar o SQLAlchemy para armazenar e gerenciar os dados (dicas e hashtags).
4. Como criar um aplicativo da Web simples com o Bottle, um micro framework da Web semelhante ao Flask.
5. Como usar o framework pytest para adicionar testes.
6. Como a orientação do Better Code Hub levou a um código mais sustentável.

Configuração do projeto

$ virtualenv -p <path-to-python-to-use> ~/virtualenvs/pytip

$ psql
psql (9.6.5, server 9.6.2)
Type "help" for help.

# create database pytip;
CREATE DATABASE
# create database pytip_test;
CREATE DATABASE

export DATABASE_URL='postgres://postgres:password@localhost:5432/pytip'
# twitter
export CONSUMER_KEY='xyz'
export CONSUMER_SECRET='xyz'
export ACCESS_TOKEN='xyz'
export ACCESS_SECRET='xyz'
# if deploying it set this to 'heroku'
export APP_LOCATION=local

unset DATABASE_URL
unset CONSUMER_KEY
unset CONSUMER_SECRET
unset ACCESS_TOKEN
unset ACCESS_SECRET
unset APP_LOCATION

$ source ~/virtualenvs/pytip/bin/activate

$ git clone https://github.com/pybites/pytip && cd pytip
$ pip install -r requirements.txt

$ python tasks/import_tweets.py

$ psql

\c pytip

pytip=# \dt
          List of relations
 Schema |   Name   | Type  |  Owner
--------+----------+-------+----------
 public | hashtags | table | postgres
 public | tips     | table | postgres
(2 rows)

pytip=# select count(*) from tips;
 count
-------
   222
(1 row)

pytip=# select count(*) from hashtags;
 count
-------
    27
(1 row)

pytip=# \q

$ pytest
========================== test session starts ==========================
platform darwin -- Python 3.6.2, pytest-3.2.3, py-1.4.34, pluggy-0.4.0
rootdir: realpython/pytip, inifile:
collected 5 items

tests/test_tasks.py .
tests/test_tips.py ....

========================== 5 passed in 0.61 seconds ==========================

$ python app.py

O design eu fiz com o MUI - um framework CSS leve que segue as diretrizes de Material Design do Google.

Detalhes de implementação

O banco de dados e SQLAlchemy

from sqlalchemy import Column, Sequence, Integer, String, DateTime
from sqlalchemy.ext.declarative import declarative_base

Base = declarative_base()


class Hashtag(Base):
    __tablename__ = 'hashtags'
    id = Column(Integer, Sequence('id_seq'), primary_key=True)
    name = Column(String(20))
    count = Column(Integer)

    def __repr__(self):
        return "<Hashtag('%s', '%d')>" % (self.name, self.count)


class Tip(Base):
    __tablename__ = 'tips'
    id = Column(Integer, Sequence('id_seq'), primary_key=True)
    tweetid = Column(String(22))
    text = Column(String(300))
    created = Column(DateTime)
    likes = Column(Integer)
    retweets = Column(Integer)

    def __repr__(self):
        return "<Tip('%d', '%s')>" % (self.id, self.text)

def get_hashtags():
    return session.query(Hashtag).order_by(Hashtag.name.asc()).all()

def add_hashtags(hashtags_cnt):
    for tag, count in hashtags_cnt.items():
        session.add(Hashtag(name=tag, count=count))
    session.commit()

Consulte a API do Twitter

TAG = re.compile(r'#([a-z0-9]{3,})')

def get_hashtag_counter(tips):
    blob = ' '.join(t.text.lower() for t in tips)
    cnt = Counter(TAG.findall(blob))

    if EXCLUDE_PYTHON_HASHTAG:
        cnt.pop('python', None)

    return cnt

Criar um aplicativo web simples com Bottle

@route('/')
@route('/<tag>')
@view('index')
def index(tag=None):
    tag = tag or request.query.get('tag') or None
    tags = get_hashtags()
    tips = get_tips(tag)

    return {'search_tag': tag or '',
            'tags': tags,
            'tips': tips}

@route('/static/<filename:path>')
def send_static(filename):
    return static_file(filename, root='static')

if os.environ.get('APP_LOCATION') == 'heroku':
    run(host="0.0.0.0", port=int(os.environ.get("PORT", 5000)))
else:
    run(host='localhost', port=8080, debug=True, reloader=True)

Modelos de garrafa

% for tag in tags:
  <a style="font-size: {{ tag.count/10 + 1 }}em;" href="/{{ tag.name }}">#{{ tag.name }}</a>&nbsp;&nbsp;
% end

% for tip in tips:
  <div class='tip'>
    <pre>{{ !tip.text }}</pre>
    <div class="mui--text-dark-secondary"><strong>{{ tip.likes }}</strong> Likes / <strong>{{ tip.retweets }}</strong> RTs / {{ tip.created }} / <a href="https://twitter.com/python_tip/status/{{ tip.tweetid }}" target="_blank">Share</a></div>
  </div>
% end

Adicione testes com pytest

A qualidade do código é importante - Better Code Hub

1. 
   Aumentei para um 9 tornando o código mais modular, tirando a lógica do banco de dados do app.py (aplicativo web), colocando-o na pasta/pacote de dicas (refactorings 1 e 2)
   
2. 
   Então, com os testes em vigor, o projeto obteve nota 10:
   

Conclusão e Aprendizagem

1. Criei um aplicativo útil que pode ser expandido (quero adicionar uma API).
2. Usei alguns módulos interessantes que valem a pena explorar:Tweepy, SQLAlchemy e Bottle.
3. Aprendi mais pytest porque precisava de fixtures para testar a interação com o banco de dados.
4. Acima de tudo, tendo que tornar o código testável, o aplicativo ficou mais modular, o que facilitou a manutenção. O Better Code Hub foi de grande ajuda nesse processo.
5. Implantei o aplicativo no Heroku usando nosso guia passo a passo.

Desafiamos você