mawac 0.1

安装

简单：

$ pip install wac

或者如果您愿意：

$ easy_install wac

要求

• Python>；=2.6，<；3.0
• Requests>；=0.11.1

用法

我们来举个例子。这个例子的代码在example.py中。

• 首先导入wac:

  import wac
  

• 接下来定义客户端的版本：

  __version__ = '1.0'
  

• 同时定义默认情况下所有Clients将使用的配置：

  default_config = wac.Config(None)
  

• 现在请友好地定义一个更新配置的函数：

  def configure(root_url, **kwargs):
      default = kwargs.pop('default', True)
      kwargs['client_agent'] = 'example-client/' + __version__
      if 'headers' not in kwargs:
          kwargs['headers'] = {}
      kwargs['headers']['Accept-Type'] = 'application/json'
      if default:
          default_config.reset(root_url, **kwargs)
      else:
          Client.config = wac.Config(root_url, **kwargs
  

• 现在，大的一个，定义您的Client，这是用来与之交谈的 服务器：

  class Client(wac.Client):
  
      config = default_config
  
      def _serialize(self, data):
          data = json.dumps(data, default=self._default_serialize)
          return 'application/json', data
  
      def _deserialize(self, response):
          if response.headers['Content-Type'] != 'application/json':
              raise Exception("Unsupported content-type '{}'"
                  .format(response.headers['Content-Type']))
          data = json.loads(response.content)
          return data
  

• 然后定义基Resource：

  class Resource(wac.Resource):
  
      client = Client()
      registry = wac.ResourceRegistry()
  

• 最后是你的实际资源：

  class Playlist(Resource):
  
      uri_spec = wac.URISpec('playlists', 'guid', root='/v1')
  
  
  class Song(Resource):
  
      uri_spec = wac.URISpec('songs', 'guid')
  

• 完成！现在你可以做这样疯狂的事情：

  import example
  
  example.configure('https://api.example.com', auth=('user', 'passwd'))
  
  q = (example.Playlist.query()
      .filter(Playlist.f.tags.contains('nuti'))
      .filter(~Playlist.f.tags.contains('sober'))
      .sort(Playlist.f.created_at.desc()))
  for playlist in q:
      song = playlist.songs.create(
          name='Flutes',
          length=1234,
          tags=['nuti', 'fluti'])
      song.length += 101
      song.save()
  

贡献

1. 叉开它
2. 创建您的功能分支（git checkout-b my new feature）
3. 编写代码并测试
4. 确保所有测试仍然通过（nosetests-svx tests）
5. 提交更改（git commit-am'add some feature'）
6. 推到分支（git push origin my new feature）
7. 创建新的拉取请求

历史记录