gpxity.backends.test package

define things that should be visible to the user.

gpxity.backends.test.basic module

Tests for gpxity.backends.

class gpxity.backends.test.basic.BasicTest(methodName='runTest')

Bases: unittest.case.TestCase

define some helpers.

assertEqualTracks(track1, track2, msg=None, xml: bool = False, with_category: bool = True)

both tracks must be identical. We test more than necessary for better test coverage.

Parameters:xml – if True, also compare to_xml()

assertNotEqualTracks(track1, track2, msg=None, with_category: bool = True)

both tracks must be different. We test more than necessary for better test coverage.

assertSameTracks(backend1, backend2, msg=None, with_category=True, with_last_time=None)

both backends must hold identical tracks.

assertTrackFileContains(track, string, msg=None)

Assert that string is in the physical file. Works only for Directory backend.

classmethod create_db_for_wptrackserver()

Create the mysql database for the WPTrackserver tests.

classmethod create_temp_mysqld()

Create a temporary mysql server and initialize it with test data for WPTrackserver.

classmethod create_test_track(count: int = 1, idx: int = 0, category: str = None, public: bool = False, start_time=None, end_time=None)

create a Track.

It starts off with test.gpx and appends a last track point, it also changes the time stamp of the last point. This is done using count and idx: The last point is set such that looking at the tracks, they all go in a different direction clockwise, with an angle in degrees of 360 * idx / count.

Parameters:

• count – See above. Using 1 as default if not given.
• idx – See above. Using 0 as default if not given.
• category – The wanted value for the track. Default: if count == len(Track.categories), the default value will be categories[idx]. Otherwise a random value will be applied.
• public – should the tracks be public or private?
• start_time – If given, assign it to the first point and adjust all following times
• end_time – explicit time for the last point. If None: See above.

Returns:

A new track not bound to a backend

Return type:

(Track)

classmethod find_mysql_docker() → bool

Find an already running docker.

Returns:the IP address

static lifetrackserver(directory)

Start and ends a server for lifetrack testing.

mysql_docker_name = 'gpxitytest_mysql'

mysql_ip_address = None

setUp()

define test specific Directory.prefix.

setup_backend(cls_, username: str = None, url: str = None, count: int = 0, cleanup: bool = None, clear_first: bool = None, category: str = None, public: bool = None)

set up an instance of a backend with count tracks.

If count == len(Track.categories), the list of tracks will always be identical. For an example see TestBackends.test_all_category.

Parameters:

• cls (Backend) – the class of the backend to be created
• username – use this to for a specific accout name. Default is ‘gpxitytest’. Special case WPTrackserver: pass the IP address of the mysql test server
• url – for the backend
• count – how many random tracks should be inserted?
• cleanup – If True, remove all tracks when done. Passed to the backend. None: do if the backend supports it.
• clear_first – if True, first remove all existing tracks. None: do if the backend supports it.
• category – The wanted category, one out of Track.categories. But this is a problem because we do the same call for all backend classes and they support different categories. So: If category is int, this is an index into Backend.supported_categories which will be decoded into Track.categories
• public – should the tracks be public or private? If None, use Backend default.

Returns:

the prepared Backend

start_mailserver()

Start an smptd server for mail testing.

stop_mailserver()

Stop the smtp server for mail testing.

tearDown()

Check if there are still /tmp/gpxitytest.* directories.

temp_backend(cls_, url=None, count=0, cleanup=None, clear_first=None, category=None, public: bool = None, username=None)

Just like setup_backend but usable as a context manager. which will call destroy() when done.

test_passwd = 'pwd'

tst_backend(backend_cls)

With pytest, subTest does not do much. At least print the name.

gpxity.backends.test.test_track module

implements test classes for Track.

They only use backend Directory, so there is no network traffic involved (unless Directory is a network file system, of course).

class gpxity.backends.test.test_track.TrackTests(methodName='runTest')

Bases: gpxity.backends.test.basic.BasicTest

track tests.

test_add_points()

test Track.add_points.

test_adjust_time()

adjust_time().

test_all_backend_classes()

Test Backend.all_backend_classes.

test_angle()

test Track.angle.

test_clone()

True if the clone is identical.

test_combine()

combine values in track with newly parsed.

test_duplicate_category()

try to add two categories to Track.

test_duplicate_public()

try to set public via its property and additionally with change_keywords.

test_fences()

Test fences.

test_fs_encoding()

fs_encoding.

test_getitem()

backend[idx].

test_header_changes()

Only change things in _header_data. Assert that the full gpx is loaded before saving.

test_header_data()

Test usage of Track._header_data.

test_id()

id_in_backend must be str.

test_in()

x in backend.

test_init()

test initialisation.

test_key()

Track.key().

test_keyword_args()

‘Track.keywords’ must accept any variant of iterable.

test_last_time()

Track.last_time.

test_local_keywords()

Some keyword tests. More see in test_backends.

test_merge_partial_tracks()

Test Track.merge(partial_tracks=True).

test_no_category()

category must return default value if not present in gpx.keywords.

test_no_public()

public must return False if not present in gpx.keywords.

test_one_line_per_trkpt()

One line per trackpoint.

test_openrunner_point_encoding()

Test Openrunner encoding/decoding of points.

test_overlapping_times()

Track.overlapping_times(tracks).

test_parse()

check for Track parsing xml correctly.

test_parse_objectname_directory()

Test Backend.parse_objectname for directory.

test_parse_objectname_mmt()

Test Backend.parse_objectname for MMT.

test_parse_objectname_serverdirectory()

Test Backend.parse_objectname for serverdirectory.

test_points_equal()

test Track.points_equal.

test_remove_category()

remove category from Track.

test_remove_public()

remove and add public from Track using remove_keywords and change_keywords.

test_remove_track()

If a backend has several identical tracks, make sure we remove the right one.

test_repr()

test __str__.

test_save()

save locally.

test_save_dir()

Correct files?.

test_symlinks()

Directory symlinks.

test_track_list()

test list of tracks.

gpxity.backends.test.test_backends module

implements gpxity.backends.test.test_backends.TestBackends for all backends.

class gpxity.backends.test.test_backends.TestBackends(methodName='runTest')

Bases: gpxity.backends.test.basic.BasicTest

Are the supported_ attributes set correctly?.

test_all_backends()

Check if Backend.all_backend_classes works.

test_backend_dirty()

track1._dirty.

test_can_decode_all_categories()

Check if we can decode all backend categories.

test_can_encode_all_categories()

Check if we can encode all internal categories to a given backend value for all backends.

test_category_map()

Check if all backends can losslessly encode/decode all supported_categories.

This is done locally assuming that Backend.supported_categories is correct. test_legal_categories() tests Backend.supported_categories for correctness.

test_change_points()

Can we change the points of a track?.

For MMT this means re-uploading and removing the previous instance, so this

is not always as trivial as it should be.

test_directory()

directory creation/deletion.

test_directory_backend()

Manipulate backend.

test_directory_dirty()

test gpx._dirty where id_in_backend is not the default.

Currently track._dirty = ‘gpx’ changes the file name which is wrong.

test_download_many_from_mmt()

Download many tracks.

test_duplicate_title()

two tracks having the same title.

test_duplicate_tracks()

What happens if we save the same track twice?.

test_keywords() → None

Test arbitrary keyword changes.

Returns:None

test_legal_categories()

Check if our fixed list of categories still matches the online service.

test_lifetrack()

test life tracking against a local server.

test_long_description()

Test long descriptions.

test_match()

test backend match function.

Returns:None

test_merge_backends()

merge backends.

test_mmt_empty()

MMT refuses upload without a specific error message if there is no track point.

test_mmt_free_lifetrack()

test life tracking against a free account on mapmytracks.com.

test_no_username()

Some backends must fail if given no username.

test_open_wrong_password()

Open backends with wrong password.

test_open_wrong_username()

Open backends with username missing in auth.cfg.

test_private()

Up- and download private tracks.

test_save_empty()

Save empty track.

test_scan()

some tests about Backend.scan().

test_setters()

For all Track attributes with setters, test if we can change them without changing something else.

test_supported()

Check values in supported for all backends.

test_write_remoteattr()

If we change title, description, public, category in track, is the backend updated?.

test_z2_keywords()

save and load keywords.

For now, all test keywords start with uppercase, avoiding MMT problems

test_z9_create_backend()

Test creation of a backend.

test_z_unicode()

Can we up- and download unicode characters in all text attributes?.

xtest_gpsies_bug()

We have this bug only sometimes: title, category or time will be wrong in track2. Workaround is in GPSIES._edit.