Fix custom json encoder in pydantic+fastapi

See merge request !300

Pydantic v1's json module contain[s|ed] a dictionary called `ENCODERS_BY_TYPE`
that was commonly used to overide default json encoders. Pydantic v2 is moving
away from this to a "better" system. FastAPI attempted to stay compatible with
both v1 and v2 by pulling ENCODERS_BY_TYPE into their own codebase, but this
broke our custom type `UTCDateTime`, at least for anything using fastapi.

We thought we fixed this with a recent MR, but it turns out all we did was
fix the validator. We did not fix the encoder itself. So, validation steps
would pass, but we continued to server malformed json for UTCDateTimes. This
commit reverts to the earlier version of pydantic_utcdatetime.py, and adds a
small kluge that modifies `ENCODERS_BY_TYPE` in both pydantic and fastapi.

Update .gitlab-ci.yml file

See merge request !299

Documentation Update Feb2024

See merge request !297

...but don't actually update (`poetry lock --no-update`).

Python version >=3.10 don't need to use the typing module types imported
(e.g., `from typing import List, Tuple`), but if we continue to stick with
these, geomag-algorithms should be backward compatible to py3.8. Some day
we'll have to bump up our minimum python version, but not today.

- update advice on 'forking workflow' since this is only valid for
  those with a code.usgs.gov account
- emphsize `pyproject.toml` and `poetry` as dependency tracking tools
- update `Developer Tools` section to describe how `poetry` and
  poetthepoet are used to run linting, unit tests, and audits

- some old links still pointed to email lists, or worse, user email addresses
- some old links pointed to github or waffle.io
- added new Gitlab "service desk" email.
- removed link to docs/example/ folder, which never existed

The file is entirely about command line interface anyway.

Remove extra disclaimer

See merge request !298

Updating the version to v1.9.1

See merge request !296

Swap GUA/GUT metadata

See merge request !295

Updating the version to 1.9.0

See merge request !294

Swap HON and HOT metadata

See merge request !293

Committing two new files, FDSNSNCL and FDSNFactory. The factory is modeled...

See merge request !291

Updated the fastapi package which required a few changes to the file pydantic_utcdatetime.py module. The module now contains a workaround to deal with the way pydantic manages the UTCDateTime string. This is a new issue that was caused by updating to fastapi version 0.109.2.

I have reomved what I considered unnecessary functionality from the new FDSN_Factory. This has greatly condensed the length of the factory. I have left a few lines of code commented out because I am not sure if they warrant concern. These pertain to the stdout and stderr variable and comments Payton made regarding how Obspy factories write to stdout rather than stderr.

Committing two new files, FDSNSNCL and FDSNFactory. The factory is modeled after the MiniseedFactory with the additional functions that retrive azimuth and dip. The Factory also relies on the get_waveforms method of obspy instead of get_timeseries. The instrument response is also attached and then that response is altered using the remove_response method in Obspy. This returns the response in nT, but we may have to change this depending on whether there are variometers with a frequency response. The __init__.py file was also edited to incooporate the FDSNSNCL and FDSNFactory.

Migrating to new edge config - stage 01

See merge request !289

Made docstring consistent with code wrt snclMapper option.

Allow EdgeFactory to change which mappings will be used from common channels
(i.e., X, Y, Z, etc), to SEED SNCLs (station, network, channel, location)
codes. For now we default to "legacy", for backward compatibility, but we
can specify snclMapper="geomag" to use the modern SNCLs used by the USGS
Geomagnetism Program.