TROUBLESHOOTING_INSTALLS.md

It seems that sometimes installing from git has weird side effects with upgrading?

If you're having issues -- try doing the following

I'll use my promnesia modules (at https://github.com/purarue/promnesia) as an example.

Note: though the repository is promnesia, the module it installs is promnesia_pura. In python packages in general, its not necessary for the module name to match the repository (that's just where its hosted). To figure out what the name of the package is, use python3 -m pip list. For this HPI repository, it installs as HPI-purarue, so its possible to differentiate between this and upstream HPI.

These are directions for installing a package as non-editable (into your python site-packages), though it covers uninstalling editable packages -- in case your path is misconfigured in some way. If you want to install as editable, see reorder_editable and the install section of the README for issues you may run into, or see the editable section of this doc

Whenever there are directions to use pip to do something -- its safer to do python3 -m pip (unless you know exactly what you're doing with managing multiple python installs on your system). That makes sure the pip that is being used is the same version as when you use python3

Uninstall the package you're using:

python3 -m pip uninstall -y promnesia_pura

Make sure its actually uninstalled -- this should error:

$ python3 -c "import promnesia_pura"
Traceback (most recent call last):
  File "<string>", line 1, in <module>
ModuleNotFoundError: No module named 'promnesia_pura'

Note: For HPI in particular (since its a namespace package), if you're trying to uninstall my modules but leaves karlicoss's (the core) modules installed, import my won't error. Instead, try something like import my.trakt.export, since that would only appear in my modules.

If that still imports, you likely have files leftover in your site packages. To find that directory, you can use:

$ python3 -m site
sys.path = [
    '/home/username',
    '/usr/lib/python310.zip',
    '/usr/lib/python3.10',
    '/usr/lib/python3.10/lib-dynload',
    '/home/username/.local/lib/python3.10/site-packages',
    '/home/username/Repos/my_feed/src',
    '/home/username/Repos/albums',
    '/home/username/Repos/mint/budget',
    '/home/username/Repos/HPI-personal',
    '/home/username/Repos/HPI',
    '/home/username/Repos/HPI-karlicoss',
    '/home/username/Repos/promnesia-fork/src',
    '/usr/lib/python3.10/site-packages',
]
USER_BASE: '/home/username/.local' (exists)
USER_SITE: '/home/username/.local/lib/python3.10/site-packages' (exists)
ENABLE_USER_SITE: True

That should let you which directories python is scanning for imports. Check any of the site-packages directories, for files like:

promnesia_prua
promnesia_pura-0.0.0.dist-info

and remove those (this is essentially a 'manually uninstall' of a broken package)

If you've previously installed this as editable, review your editable installs to make sure its still not there:

python3 -m pip install reorder_editable
python3 -m reorder_editable locate  # should show you where which editable installs are placing .egg-link files
python3 -m reorder_editable cat

Refer to the reorder_editable README for more info on that.

You should now be able to confirm it errors, like:

$ python3 -c "import promnesia_pura"
Traceback (most recent call last):
  File "<string>", line 1, in <module>
ModuleNotFoundError: No module named 'promnesia_pura'

Now -- to install it again!

Instead of installing from git (since that can sometimes cache the result and run into other issues), clone it to some local directory:

git clone https://github.com/purarue/promnesia ./promnesia_pura

Then, you can install it by pointing it at the directory with includes the setup.py file, like: python3 -m pip install --user ./promnesia_pura

You should now be able to confirm it imports properly:

python3 -c "import promnesia_pura"

Editable

Alternatively, since you already have it locally, you can install it as editable:

python3 -m pip install --user -e ./promnesia_pura

That should modify your sys.path (run python3 -m site; and you'll see that directory appear on your path)

That has the added benefit that whenever you want to update promnesia_pura, you can just:

cd /path/to/promnesia_pura
git pull