Automated tests, session caching, place API, cleanup

    Testing & CI:
    - d78b16e working coverage (28% only for now)
    - c9b9d7b add more unit tests
    - 527b685 add pytest and coverage targets
    - a6d07c4 beef up GitHub action
    - 3bf4ae8 fix Windows encoding error
    - 0ff93da fix macOS runner
    - 92d4f98 add .envrc for direnv

    Linting:
    - 62e1cd0 add ruff, black; format code in CI
    - 78f1f38 isort & black agree

    Features:
    - dc77f9f CACHE: add cache-control opt (conditional requests)
    - 21fdb59 working headless automation for evading bot-detection
    - 2b8f110 add geocoder to requirements

    Other contributors' work included:
    - @jadsongmatos: requests_cache HTTP caching
    - @bsudy: FS IDs, request caching, Geonames place API, Gramps XML export [alpha]
    - @josemando: requests-ratelimiter (rate limiting)

Co-authored-by: jadsongmatos <jadsongmatos@users.noreply.github.com>
Co-authored-by: Barnabás Südy <bsudy@users.noreply.github.com>
Co-authored-by: Josemando Sobral <josemando@gmail.com>
Signed-off-by: Shane Jaroch <chown_tee@proton.me>

adding rate limit

    ORIGINAL COMMIT
    ~~~~~~~~~~~~~~~

    $ git show f6bb22e --stat
    commit f6bb22e6c3602d30e55fc9eeb140b964552b8d18
    Author: Josemando Sobral <josemando@gmail.com>
    Date:   Sun Feb 2 18:48:34 2025 -0300

        adding rate limit

     getmyancestors/classes/session.py | 8 ++++++++
     pyproject.toml                    | 2 +-
     requirements.txt                  | 1 +
     3 files changed, 10 insertions(+), 1 deletion(-)

Signed-off-by: Shane Jaroch <chown_tee@proton.me>

Added a main for easier testing

Fixed cache, date formatting and envet id

Retriveing place information from geonames

Added request cache

Using Familysearch ids instead of the counters

Added distance argument to download all people up until a distance.

Added exclude list parameter to be able to exclude people from the generation

update README

[FIX] fix GEDCOM version

fix memories

fix merge ordinances

Fix new authentification

Merge pull request #47 from melroy89/master-1

Update requirements.txt

Update pyproject.toml

Update fake-useragent to latest version (v1.2.1). Disclaimer: I'm the package maintainer.

Update requirements.txt

Upgrade fake-useragent to the latest version (v1.2.1). Disclaimer: I'm the maintainer.

update version

Merge pull request #46 from a2800276/main

added possibility to optionally save password in gui

added possibility to optionally save password in gui

Move version in package

Use pyproject.toml

API now need a fake user agent

Merge pull request #42 from changeling/abstract_classes_and_constants

Abstract classes, constants and related functions.

Add newline to class.gedcom and adjust imports

Add newline before class definition in gedcom.py
Add class import of Ordinance to gedcom.py
Add constant import of ORDINANCES to gedcompy
Remove unnecessary imports from getmyancestors.py

Split classes.py into separate modules.
Create gui.py, session.py, tree.py, gedcom.py.
Update version to 1.0.2-rc.2.
Add classes directory to setup.cfg.

Move classes.py into classes directory.

Increment package __version__ to 1.0.2-rc.1

Abstract classes, constants and related functions to shared modules.

Move classes and related functions to classes.py.
Move constants and related functions to constants.py.
Minor edits to comments.

TODO Check class and constant imports, and remove from imports where unused in primary modules.

Update dependency babelfish for python3.10

[ADD] Add packaging with setup.py

[ADD] Add github issue template

[FIX] Fix multi-individual ancestor download.

The 'todo' variable for the ancestor download needs to be a set,
not the original comma-separated string.

TESTED:
Downloads of multiple individuals now include ancestors when
appropriate.

[IMP] Direct informational messages to stderr.

This allows the GEDCOM output to be piped to another program without
polluting it with progress messages.

The usage text is now also directed to stderr, as is normal practice.

TESTED:
Piped output to an editor, with the progess messages still appearing
on the terminal.
Usage text now appears on the terminal, even with redirected stdout.

Fix requirements command in README

[FIX] update Accept header to get contributors

[IMP] fstogedcom : keep username in cache

[FIX] Add of the request header to ask for json format. Necessary fix since recent api update.

Add requirements.txt

Writes a partial gedcom file if an exception occur.

Merge branch 'fhgwright-fixes'

black format

Tolerate inability to write settings file.

It's questionable that the unsolicited write of the settings is
reasonable at all, but at the very least it shouldn't crash if it
can't, e.g., when outputting to /dev/null for testing.

TESTED:
Now prints message and continues on failed attempt to write
/dev/null.settings.  Writes settings successfully with real
output file specified.

Update ordinances following FamilySeacrch's update

Fix : unquote url-like Fact value

Update following FamilySearch's last update
Replace "father" key with "parent1" and "mother" with "parent2"

Merge pull request #22 from fhgwright/fixes

Adds execute permissions to fstogedcom.py.

Adds execute permissions to fstogedcom.py.

This program has a shebang line to permit it to be run directly as a
program, but lacks the necessary execute permissions.

Also removes the superfluous shebang line from translation.py.

TESTED:
Running ./fstogedcom.py now works.

Merge pull request #20 from sebdu66/patch-1

Add initiatory ordinance (WAC) since it's supported by some software like Rootsmagic.

Add initiatory ordinance

This update add the ordinance initiatory and add the WAC tag to the gedcom file

Update argument parser :
  -u <STR>, --username <STR>
                        FamilySearch username
  -p <STR>, --password <STR>
                        FamilySearch password
  -i <STR> [<STR> ...], --individuals <STR> [<STR> ...]
                        List of individual FamilySearch IDs for whom to
                        retrieve ancestors
  -a <INT>, --ascend <INT>
                        Number of generations to ascend [4]
  -d <INT>, --descend <INT>
                        Number of generations to descend [0]
  -m, --marriage        Add spouses and couples information [False]
  -r, --get-contributors
                        Add list of contributors in notes [False]
  -c, --get_ordinances  Add LDS ordinances (need LDS account) [False]
  -v, --verbose         Increase output verbosity [False]
  -t <INT>, --timeout <INT>
                        Timeout in seconds [60]
  --show-password       Show password in .settings file [False]
  -o <FILE>, --outfile <FILE>
                        output GEDCOM file [stdout]
  -l <FILE>, --logfile <FILE>
                        output log file [stderr]

fstogedcom: replace get_userid call with fid attribute

Fix duplicate lines FAMS

Fix mergemyancestors with new Gedcom header

- Add black formating (see https://github.com/python/black)
- Add docstrings

Merge pull request #14 from changeling/logging_and_reports

Change `redact-password` to `show-password`.

Change `redact-password` to `show-password`.

Default is to hide password in `.settings` file.

Reverse argument --redact-password : print passwords in settings if set

Merge pull request #13 from changeling/logging_and_reports

Added reporting for configuration used when executing `getmyancestors…

Update .settings file handling and defaults.

Handle non-argparse `username` and `password`.
Removed printing of settings to stdout.
Remove `redact_password = True` line.
Add `--redact-password` argument, defaulting to `False`.
Removed `.settings` file creation when output is directed to stdout.

Merge remote-tracking branch 'upstream/master' into logging_and_reports

Update GEDCOM Header in getmyancestors.py for 5.5.1 compliance. (#11)

* Update GEDCOM Header in getmyancestors.py for 5.5.1 compliance.

getmyancestors.py: Add SOUR, SUBM ref and SUBM entry. Update VERS to 5.5.1.
(UTF-8 is only in GEDCOM 5.5.1 and not 5.5, but getmyancestors creates header with VERS 5.5 and encoding UTF-8.)

* Fix Notes: set the text attribute before adding to Tree

* Updated to render correct ordinals in Download progress counts.

fstogedcom.py:
Lines 34-45: Implemented ordinal() function.
Line 441: Yield correct ordinal for ancestor generations.
Line 450: Yield correct ordinal for descendant generations.

getmyancestors.py
Lines 107-118: Implemented ordinal() function.
Line: 960: Yield correct ordinal for ancestor generations.
Line 970: Yield correct ordinal for descendant generations.

translation.py
Lines 104-115: Translate ordinal suffixes.
Lines 116-120: Translate updated ancestor and descendant generation strings.

Fixed string slice in ordinal() to correctly handle 11, 12, 13.

Fixed string slice in ordinal() to correctly handle 11, 12, 13 in fstogedcom.py and getmyancestors.py.

* Replaced ordinal() function and calls with num2word module and calls.

Replaced ordinal() function and calls with num2word module and calls in fstogedcom.py and getmyancestors.py.

Removed ordinal suffixes from translation.py.

* Update README.md to reference num2words and github repository.

Added num2words requirement to README.md.
Add references for github repository to README.md.

* Update getmyancestors.py to add more 5.5.1 HEAD entries.

Add display_name to Session().
Assign display_name from current.json ['users'][0]['displayName'].
Add 'getmyancestors' value for HEAD.SOUR, HEAD.SOUR.NAME, HEAD.DEST. See:
https://www.tamurajones.net/GEDCOMSOURandDEST.xhtml for discussion.
Add HEAD.SOUR.VERS with placeholder value for version.
Add HEAD.DATE and HEAD.TIME.
Add SUBM.NAME from Family Search displayName for current user.
Add SUBM.LANG from Family Search displayName for current user. NOTE: This value is invalid.
TODO: Fix 2-char lang value to full language name for legal GEDCOM.

* Update getmyancestors.py to correct SUBM.LANG format.

Added import of babelfish to handle language formats.
Added babelfish conversion to SUBM.LANG to convert alpha2 language code (i.e. `en`) from Family Search to legal GEDCOM language code (i.e. `ENGLISH`).
Updated README.md to include reference to babelfish module.

* Revert "Merge pull request #9 from changeling/handle_ordinals"

This reverts commit 88e724d1b6d590af7dd4f7d91dbe4997bfd6a0a6, reversing
changes made to 0a0a1035f9f4c4a985069f2a914851e630e84b50.

* Change information text about downloading generations

* Update GEDCOM Header in getmyancestors.py for 5.5.1 compliance.

getmyancestors.py: Add SOUR, SUBM ref and SUBM entry. Update VERS to 5.5.1.
(UTF-8 is only in GEDCOM 5.5.1 and not 5.5, but getmyancestors creates header with VERS 5.5 and encoding UTF-8.)

* Update getmyancestors.py to add more 5.5.1 HEAD entries.

Add display_name to Session().
Assign display_name from current.json ['users'][0]['displayName'].
Add 'getmyancestors' value for HEAD.SOUR, HEAD.SOUR.NAME, HEAD.DEST. See:
https://www.tamurajones.net/GEDCOMSOURandDEST.xhtml for discussion.
Add HEAD.SOUR.VERS with placeholder value for version.
Add HEAD.DATE and HEAD.TIME.
Add SUBM.NAME from Family Search displayName for current user.
Add SUBM.LANG from Family Search displayName for current user. NOTE: This value is invalid.
TODO: Fix 2-char lang value to full language name for legal GEDCOM.

* Update getmyancestors.py to correct SUBM.LANG format.

Added import of babelfish to handle language formats.
Added babelfish conversion to SUBM.LANG to convert alpha2 language code (i.e. `en`) from Family Search to legal GEDCOM language code (i.e. `ENGLISH`).
Updated README.md to include reference to babelfish module.

* Updated `README.md` and `getmyancestors.py` re  5.5.1.

`getmyancestors.py`:
Remove `DEST` tag.
Set `SOUR.VERS` to 1.0.
Implement `babelfish` module to correct FamilySearch `LANG` to match iso639 full language for 5.5.1 compliance.
`README.md`.:
Add babelfish.
Modify requirement install instruction for readability and line length re PEP 8.
Add github Issues link.

* Revert "Merge branch '551_compliance' of https://github.com/changeling/getmyancestors into 551_compliance"

This reverts commit 94b9fda218fdb316e1479c1661a1956f9ef4f2fb, reversing
changes made to ec42301fcbbef74d60a3c79f6e13885215ac47c8.

Merge branch 'logging_and_reports' of https://github.com/changeling/getmyancestors into logging_and_reports

Added reporting for configuration used when executing `getmyancestors.py`.

Added reporting for configuration used when executing `getmyancestors.py`.
Added `.vscode/` and `scratchpad.py` to .gitignore.

Change information text about downloading generations

Revert "Merge pull request #9 from changeling/handle_ordinals"

This reverts commit 88e724d1b6d590af7dd4f7d91dbe4997bfd6a0a6, reversing
changes made to 0a0a1035f9f4c4a985069f2a914851e630e84b50.

Added reporting for configuration used when executing `getmyancestors.py`.

Added reporting for configuration used when executing `getmyancestors.py`.
Added `.vscode/` and `scratchpad.py` to .gitignore.

Merge pull request #9 from changeling/handle_ordinals

Updated to render correct ordinals in Download progress counts.

Fix Notes: set the text attribute before adding to Tree

Update README.md to reference num2words and github repository.

Added num2words requirement to README.md.
Add references for github repository to README.md.

Replaced ordinal() function and calls with num2word module and calls.

Replaced ordinal() function and calls with num2word module and calls in fstogedcom.py and getmyancestors.py.

Removed ordinal suffixes from translation.py.

Updated to render correct ordinals in Download progress counts.

fstogedcom.py:
Lines 34-45: Implemented ordinal() function.
Line 441: Yield correct ordinal for ancestor generations.
Line 450: Yield correct ordinal for descendant generations.

getmyancestors.py
Lines 107-118: Implemented ordinal() function.
Line: 960: Yield correct ordinal for ancestor generations.
Line 970: Yield correct ordinal for descendant generations.

translation.py
Lines 104-115: Translate ordinal suffixes.
Lines 116-120: Translate updated ancestor and descendant generation strings.

Fixed string slice in ordinal() to correctly handle 11, 12, 13.

Fixed string slice in ordinal() to correctly handle 11, 12, 13 in fstogedcom.py and getmyancestors.py.

Update readme

Fix an error when changes.json doesn't return datas (status code 204)

Memories: now accept all types of file. Plain text memories are stored as Notes

Temporary fix because familysearch made change on Memorie's features

GUI: Remove button"Add Temple informations" for user without LDS account

Use CONT and CONC on DATA, FILE and NAME tags

update readme

Cut long lines with  CONC tag

Merge branch 'more_informations'

Update Readme

Merge branch 'more_informations'

Fix CONT level under Memorie title (OBJE, TITL) and Source page (SOUR PAGE)

Merge branch 'more_informations'

Fix: remove iconphoto on Mac OS platforms

Merge branch 'more_informations'

Fix icon for linux platform

Merge branch 'more_informations'

Add icon

Merge branch 'more_informations'

Session: remove unused methods get_key and oldlogin

fix translation

Don't try to login without credentials

fix translation

update informations during download

fix translation

Don't try to login without credentials

fix translation

update informations during download