https://github.com/halworsen/fflogsapi
A Python client for the FF Logs API
https://github.com/halworsen/fflogsapi
api api-client caching fflogs fflogs-api ffxiv graphql lazy
Last synced: 3 months ago
JSON representation
A Python client for the FF Logs API
- Host: GitHub
- URL: https://github.com/halworsen/fflogsapi
- Owner: halworsen
- License: gpl-3.0
- Created: 2022-04-22T19:40:50.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-11-16T14:40:40.000Z (11 months ago)
- Last Synced: 2025-03-05T09:42:17.208Z (7 months ago)
- Topics: api, api-client, caching, fflogs, fflogs-api, ffxiv, graphql, lazy
- Language: Python
- Homepage: https://fflogsapi.readthedocs.io
- Size: 275 KB
- Stars: 9
- Watchers: 3
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# fflogsapi
fflogsapi is a lazy Python 3 client for [FF Logs](https://www.fflogs.com/)' v2 GraphQL API with query caching functionality.
[](https://github.com/halworsen/fflogsapi/actions/workflows/test.yml)
[](https://github.com/halworsen/fflogsapi/actions/workflows/lint.yml)
[](https://codecov.io/gh/halworsen/fflogsapi)
[](https://fflogsapi.readthedocs.io/en/latest/?badge=latest)
[](https://pypi.org/project/fflogsapi/)
---
## Installation
fflogsapi is available as a [PyPI package](https://pypi.org/project/fflogsapi/) and
can be installed with pip:
```shell
pip install fflogsapi
```
If you want to contribute, you can install fflogsapi with the following command
to install development and test tools as well:
```shell
pip install fflogsapi[dev,test]
```
## Example usage
Calculating damage done under pots:
```python
from config import CLIENT_ID, CLIENT_SECRET
from fflogsapi import FFLogsClient
client = FFLogsClient(CLIENT_ID, CLIENT_SECRET)
report = client.get_report('rGARYmQwTKbahXz9')
for fight in report:
print(f'Fight #{fight.id}:', fight.name(), f'- Kill: {fight.is_kill()}')
pot_table = fight.table(filters={'sourceAurasPresent': 'Medicated'})
potted_damage = 0
for damage in pot_table['damageDone']:
potted_damage += damage['total']
print(f'Damage done under pots: {potted_damage}')
if not fight.is_kill():
print(f'Percentage reached: {fight.percentage()}')
client.close()
client.save_cache()
```
Listing reports and durations for a specific guild:
```python
from config import CLIENT_ID, CLIENT_SECRET
from fflogsapi import FFLogsClient
client = FFLogsClient(CLIENT_ID, CLIENT_SECRET)
for page in client.reports(filters={ 'guildID': 80551 }):
print(f'Reports in page: {page.count()}')
for report in page:
print(report.title(), f'Duration: {report.duration()}')
client.close()
client.save_cache()
```
Listing a character's RDPS & All stars rank for Abyssos Savage in 6.28:
```python
from config import CLIENT_ID, CLIENT_SECRET
from fflogsapi import FFLogsClient, GQLEnum, FightDifficulty
client = FFLogsClient(CLIENT_ID, CLIENT_SECRET)
character = client.get_character(id=19181640)
abyssos = client.get_zone(id=49)
partition_628 = next(filter(
lambda p: '6.28' in p.name,
abyssos.partitions()
))
rankings = character.zone_rankings(filters={
'specName': 'Reaper',
'metric': GQLEnum('rdps'),
'zoneID': abyssos.id,
'difficulty': FightDifficulty.SAVAGE.value,
'partition': partition_628.id,
})
print('6.28 All Star points: '
f'{rankings.all_stars[0].points} (rank {rankings.all_stars[0].rank})')
for rank in rankings.encounter_ranks:
print(f'{rank.encounter.name()}: {rank.best_amount}rdps (rank {rank.all_stars.rank})')
client.close()
client.save_cache()
```
## User mode
The default access mode of the client is 'client' mode, which uses the public API. This is by far the most
convenient method to use the client, and usually provides access to enough data for the majority of
use cases.
If you need to access private information, you can configure the client to use user mode,
granting access to private information such as private reports.
To use user mode, you must first specify `https://localhost:4433` as the redirect URL in your API
client on FF Logs. Then provide the `mode='user'` kwarg to the client when instantiating it:
```python
client = FFLogsClient(CLIENT_ID, CLIENT_SECRET, mode='user')
```
This will have the client popup a browser window for you to log in. When logged in, the client gets
access to the user API. Note that the client will generate a self-signed certificate to serve
the redirect. Your browser will likely produce a warning about this, although it is safe to ignore.
If you wish to handle the user authentication flow yourself, you can still use the API client in
user mode by calling `set_auth_response` on the client **before using it**:
```python
# Your implementation of the user authentication flow here
...
client = FFLogsClient(CLIENT_ID, CLIENT_SECRET, mode='user')
client.set_auth_response(response)
# Start using the client
...
```