fut 0.0.20

fut is a simple library for managing Fifa Ultimate Team.

fut
=====

.. image:: https://travis-ci.org/oczkers/fut.png?branch=master
:target: https://travis-ci.org/oczkers/fut

fut is a simple library for managing Fifa Ultimate Team.
It is written entirely in Python.



Documentation
-------------
Documentation is available at http://fut.readthedocs.org/.

Players database: http://cdn.content.easports.com/fifa/fltOnlineAssets/8D941B48-51BB-4B87-960A-06A61A62EBC0/2015/fut/items/web/players.json



Usage
-----

.. code-block:: pycon

>>> import fut
>>> fut = fut.Core('email', 'password', 'secret answer', platform='xbox', emulate='and', debug=True, cookies='cookies.txt')
>>> # PLATFORM: pc / ps3 / xbox / and / ios (pc default)
>>> # EMULATE: and / ios (use this feature to avoid webapp errors [BE WARE IT'S HIGH RISK])
>>> # DEBUG: save http response to fut.log)
>>> # COOKIES: save cookies after every request and load it from given file when restaring app (just like browser)

>>> items = fut.searchAuctions('development', # search items
... level='gold', category='fitness', min_price=300, # optional parametrs
... max_price=600, min_buy=300, max_buy=400, # optional parametrs
... start=0, page_size=50) # optional parametrs

>>> for item in items:
... trade_id = item['tradeId']
... buy_now_price = item['buyNowPrice']
... trade_state = item['tradeState']
... bid_state = item['bidState']
... starting_bid = i['startingBid']
... item_id = i['id']
... timestamp = i['timestamp'] # auction start
... rating = i['rating']
... asset_id = i['assetId']
... resource_id = i['resourceId']
... item_state = i['itemState']
... rareflag = i['rareflag']
... formation = i['formation']
... injury_type = i['injuryType']
... suspension = i['suspension']
... contract = i['contract']
... playStyle = i['playStyle'] # used only for players
... discardValue = i['discardValue']
... itemType = i['itemType']
... owners = i['owners']
... offers = i['offers']
... current_bid = i['currentBid']
... expires = i['expires'] # seconds left

>>> fut.credits # returns credits amount
600

>>> fut.bid(items[0]['trade_id'], 600) # make a bid

>>> fut.credits # it's updated automatically on every request
0
>>> fut.tradepile_size # tradepile size (slots)
80
>> len(fut.tradepile()) # tradepile fulfilment (number of cards in tradepile)
20
>>> fut.watchlist_size # watchlist size (slots)
30
>> len(fut.watchlist()) # watchlist fulfilment (number of cards in watchlist)
10

>>> items = fut.tradepile() # get all items from trade pile
>>> items = fut.unassigned() # get all unassigned items

>>> for item in items:
... fut.sell(item['item_id'], 150, # put item on auction
... buy_now=0, duration=3600) # optional parametrs

>>> fut.sendToTradepile(trade_id, item_id) # add card to tradepile
>>> fut.sendToClub(trade_id, item_id) # add card to club
>>> fut.sendToWatchlist(trade_id) # add card to watchlist
>>> fut.tradepileDelete(trade_id) # removes item from tradepile
>>> fut.watchlistDelete(trade_id) # removes item from watch list
>>> fut.quickSell(item_id) # quicksell item
>>> fut.searchDefinition(asset_id, start=0, count=35) # returns stats and definition IDs for each card variation

>>> fut.relist() # relist all expired cards in tradepile

>>> fut.keepalive() # send keepalive ping to avoid timeout (send at least one request every ~10 minutes)

to be continued ;-)
...


CLI examples
------------
.. code-block:: bash

not yet
...


License
-------

GNU GPLv3


.. :changelog:

Changelog
---------


0.0.20 (2014-10-19)
++++++++++++++++++
* fix typo

0.0.19 (2014-10-19)
++++++++++++++++++
* core: update old fut14 urls
* core: add cookies feature (save cookies after every request and load it when restaring app like browser)
* core: add saveSession, searchDefinition
* core: log sendToPile action


0.0.18 (2014-10-01)
++++++++++++++++++
* core: add methods to list and delete available messages (thanks to jamslater)
* core: rework base id from resource id calculation, use new constant (thanks to jamslater)
* core: update android * ios clientVersion (9->11)


0.0.17 (2014-09-22)
++++++++++++++++++
* rename project (fut14->fut)
* fut15 (drop support for fifa 14)


0.0.16 (2014-08-31)
++++++++++++++++++
* #76 fix buying (thanks to arthurnn)


0.0.15 (2014-08-29)
++++++++++++++++++
* add new exceptions: doLoginFail, MaxSessions, Captcha
* add changelog
* NullHandler is default logging handler
* core: bump clientVersion (8->9)


0.0.14 (2014-07-06)
++++++++++++++++++

* core: relist returns number of delted/sold if clean parameter was set
* add new exception FeatureDisabled
* core: add emulate
* core: add stats
* core: add clubInfo


0.0.13 (2014-04-19)
++++++++++++++++++

* core: add sendToWatchlist


0.0.12 (2014-02-23)
++++++++++++++++++

* exceptions: add Unauthorized & MultipleSession
* fix quicksell


0.0.11 (2014-02-15)
++++++++++++++++++

* fix logger
* setup.py is now executable


0.0.10 (2014-02-15)
++++++++++++++++++

* core: add clean ability to relist (remove sold cards)
* core: keepalive returns credit amount


0.0.9 (2014-01-26)
++++++++++++++++++

* fix relist


0.0.8 (2014-01-26)
++++++++++++++++++

* add new exception Conflict
* init docs
* core: add relist
* core: add sendToClub


0.0.7 (2014-01-13)
++++++++++++++++++

* add few exceptions


0.0.6 (2013-12-30)
++++++++++++++++++

* core: add DEBUG feature
* add multiplatform support (xbox/ps3/and/ios)


0.0.5 (2013-12-23)
++++++++++++++++++

* core: add assetId param to searchAuction method
* core: add pileSize
* core: add leagueId to item data parser


0.0.4 (2013-11-10)
++++++++++++++++++

* convert lowercase function/method names to mixedCase (send_to_tradepile -> sendToTradepile)
* drop python-2.5 (requests)
* core: python 3 support


0.0.3 (2013-10-25)
++++++++++++++++++

* core: move requests session init & headers from login to init
* core: update credits on every request (only if it is avaible included in response)


0.0.2 (2013-10-17)
++++++++++++++++++

* core: add watchlist
* core: add card_info function
* core: add alias for base_id & card_info


0.0.1 (2013-10-15)
++++++++++++++++++

* init