fitparse

library1.2.0pypypi✓ verified 85d ago

Python library to parse ANT/Garmin .FIT files. Current version 1.2.0 provides a high-level interface to read FIT files, including data messages, definitions, and developer fields. Release cadence is low, with no recent updates.

analytics

pip install fitparse

github ↗homepage ↗

INSTALL

IMPORT

SIG · FITPARSE

fitparse

analyticspythonv1.2.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

FitFile

✓ from fitparse import FitFile

Record

✓ from fitparse import Record

FitParseError

✓ from fitparse import FitParseError

Open a FIT file, iterate over 'record' messages, and print field names and values.

from fitparse import FitFile fitfile = FitFile('activity.fit') for record in fitfile.get_messages('record'): for data in record: print(f"{data.name}: {data.value}")

Debug

Known issues

gotchaThe library does not support writing or creating .FIT files. It is read-only.

fix

Use another library if write support is needed.

affects: all

deprecatedPython 2 support was dropped in version 1.0.0. Use Python 3.6+.

fix

Ensure Python 3.6 or newer is used.

affects: >=1.0.0

gotchaFIT files often use semicircles for latitude/longitude. The library returns raw values; you must convert manually.

fix

Convert: degrees = semicircles * (180.0 / 2**31)

affects: all

Errors

Common errors & fixes

AttributeError: 'NoneType' object has no attribute 'value'

Accessing .value on a field that is None (e.g., missing data).

fix

Check if field.value is not None before using.

fitparse.exceptions.FitParseError: Unsupported FIT file version

The FIT file uses a protocol version not yet supported by fitparse.

fix

Upgrade fitparse to the latest version or use a different parser.

Upgrade

Version history

1.2.0latest on PyPI · released Sep 7, 2020

Audit

Dependencies

No dependency data recorded yet.

Agent activity

44 hits · last 30 days

node

Perplexity

OpenAI (training)

Resources

githubhttps://www.github.com/dtcooper/python-fitparse ↗

homepagehttps://www.github.com/dtcooper/python-fitparse ↗