Continuing the discussion from Please help add 5.2 Highlights to the wiki:
I’m running Gramps 5.2 on MacOS as a bundled install (.dmg)
The add-on GrampsWebSync uses keyring if installed.
Unfortunately keyring is missing.
Is there any way to install this module - a dirty hack is ok for me.
Does this 2015 osx keychain thread seem pertinent:
No, this just describes how to use keychain in python.
The GampsWebSync already has the code implemented, however the problem is the statement “import keyring” which returns an error because the module doesn’t exists in the installation. If ‘pip’ had been part of the Gramps package for MacOS, but pip is also missing.
What about the part saying he installed keyring with sudo easy_install keyring
easy_install was the predecessor of pip. I don’t think it has been in python for years.
prompted perplexity with : “As an expert in installing software for MacOS and the keyring software for use in python ; a 2015 posting suggested
sudo easy_install keyring… what is a modern method”
The modern method for installing the Python keyring library on macOS is to use pip, the Python package manager. Here’s how you can do it:
bash
pip3 install keyring
bash
python3 -m pip install keyring
This approach ensures compatibility with Python 3 and avoids potential issues with ambiguous pip commands that might default to Python 21410.
pip is up-to-date by running:bash
python3 -m pip install --upgrade pip
easy_install, as it is outdated and no longer recommended9.By following these steps, you will have the latest version of keyring installed and ready for use in your Python projects.
So I asked: “What if pip is not installed on the mac”
If pip is not installed on your Mac, you have several options to install it:
bash
python3 -m ensurepip
This will install pip without requiring an internet connection1.
2. Install via Homebrew:
If you have Homebrew installed, you can install Python (which includes pip) by running:
bash
brew install python
After installation, run:
bash
brew unlink python && brew link python
to ensure pip is in your path15.
3. Use the get-pip.py script:
Download the script and run it:
bash
curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
python3 get-pip.py
This method works for Python 3 or later1.
After installation, verify pip is installed by running:
bash
pip --version
or
bash
pip3 --version
If you encounter any issues, ensure you’re using the correct Python version and that your system PATH is properly configured35.
Do not use the HomeBrew Python with Gramps. It is missing some locale entry points that Gramps relies on. 6.0.0 rc1 on Mac - #3 by lsc
You can get ahead of the missing packages by installing for the local user with pip (pip3 install --user <package>). Cleaner than dumping into the system installation and does not require sudo.
Cheers
What I do when the Gramps dmg does not have a package I need is the following hack:
install using pip into the OS and then copy the installed folder (and all new dependencies) into EITHER the gramplet folder or Gramps.app/Contents/Resources/lib/python3.11
This should allow the new gramplet to work.
This is excellent information.
I was expecting that the “troubleshooting gramps paths and environmental variables” hack would have a path for the Python.
But the closest path was:
ROOT_DIR : /app/lib/python3.11/site-packages/gramps
@Nick-Hall could the Requires dialogs in Addon Manager list the 2 potential target paths for manual installs?
Anyone who is attempting to manually install python modules should know how to print the contents of sys.path.
Everyone has to start learning somewhere.
And cannot sys.path return different data if they have minimal Python bundled with Python application (like Gramps) and a more expansive developer environment installed?
Thanks @GaryGriffin
Here’s what I did:
brew install python@3.11
pip3.11 --verbose install keyring
GRAMPS_SITE=/Applications/Gramps.app/Contents/Resources/lib/python3.11/site-packages/.
cp -R /usr/local/lib/python3.11/site-packages/jaraco* $GRAMPS_SITE
cp -R /usr/local/lib/python3.11/site-packages/keyring* $GRAMPS_SITE
cp -R /usr/local/lib/python3.11/site-packages/setuptools $GRAMPS_SITE
cp -R /usr/local/lib/python3.11/site-packages/zipp* $GRAMPS_SITE
cp -R /usr/local/lib/python3.11/site-packages/backport* $GRAMPS_SITE
cp -R /usr/local/lib/python3.11/site-packages/more_itertool** $GRAMPS_SITE
The pip3.11 command with --verbose needed in order to see what was installed.
Running GrampsWebSync now picks up the last used password automatically.
Yes, it will depend on your environment. Gramps doesn’t actually have to know the location to check if the requirement is satisfied.
One problem I have experienced was that pip was installing GEDCOMX_v1 lib (needed by the FamilySearch addons by @jmichault ) to the general Python evironment and the Requires was evidently checking the Gramps bundled Python. It did not recognize the prerequisite was there until installing with the bundled pip in the Gramps path while in that location.
So knowing the preferred path for the bundled Python lib folder seems to be important. And checking ‘sys.path’ with a script from the command line was giving the other path.
I would check sys.path. It gives 7 different paths for me, but I can’t think of a better alternative.
Perhaps it could it use ROOT_DIR and go up 2 levels? Is the end of the ROOT_DIR always python3.11/site-packages/gramps in all 3 platforms?