Permanently adding a file path to sys.path in Python

Question

I had a file called example_file.py, which I wanted to use from various other files, so I decided to add example_file.py to sys.path and import this file in another file to use the file. To do so, I ran the following in IPython.

import sys
sys.path
sys.path.append('/path/to/the/example_file.py')
print(sys.path)

I could see the path I had just added, and when I tried to import this file from another directory path like this:

import example_file

it worked just fine, but once I came out of IPython, entered it again, and checked the sys.path, I saw that the path which I had added was not present, so how do I add a path to sys.path permanently in Python?

Make your code a proper package, make it easy_installable and be happy for the rest of your life (instead of tinkering). Apart from that: every documentation tells you CLEARLY that sys.path.append() accepts a directory containing file AND NOT SINGLE PATH TO A FILE. — user2665694
– user2665694, Commented Sep 4, 2012 at 6:17
possible duplicate of Adding folder to Python's path permanently — DhruvPathak
– DhruvPathak, Commented Sep 4, 2012 at 6:17

tuomassalo · Accepted Answer · 2016-03-14 12:47:07Z

147

There are a few ways. One of the simplest is to create a my-paths.pth file (as described here). This is just a file with the extension .pth that you put into your system site-packages directory. On each line of the file you put one directory name, so you can put a line in there with /path/to/the/ and it will add that directory to the path.

You could also use the PYTHONPATH environment variable, which is like the system PATH variable but contains directories that will be added to sys.path. See the documentation.

Note that no matter what you do, sys.path contains directories not files. You can't "add a file to sys.path". You always add its directory and then you can import the file.

edited Mar 14, 2016 at 12:47

tuomassalo

9,1616 gold badges50 silver badges50 bronze badges

answered Sep 4, 2012 at 6:20

BrenBarn

253k39 gold badges421 silver badges392 bronze badges

Sign up to request clarification or add additional context in comments.

8 Comments

Shiva Krishna Bavandla Over a year ago

ok thanks thats fine i have added my directory which consists of file and its working when i imported the file from another location, bu the problem when i came out of ipython and again looed in to check my path, it does n't appear, i dont want to do it each time when i entered the code, i want to add the directory path to sys.path permanatly, how to do this

BrenBarn Over a year ago

@Kouripm: Your comment suggests you did not actually follow my suggestion, nor the suggestions in the duplicate post linked above.

Zeinab Abbasimazar Over a year ago

The site package was perfect.

tylerlindell Over a year ago

fixed my issue with sys.path.append('C:\\python34\\lib\\site-packages') thank you!

Minh Tran Over a year ago

For posterity: the .pth file is what the site-module documentation calls a path configuration file. Of note about the path configuration file:

no check is made that the item refers to a directory rather than a file. No item is added to sys.path more than once. Blank lines and lines beginning with # are skipped. Lines starting with import (followed by space or tab) are executed.

|

Tonechas · Accepted Answer · 2020-05-01 13:36:22Z

12

This way worked for me:

adding the path that you like:

export PYTHONPATH=$PYTHONPATH:/path/you/want/to/add

checking: you can run 'export' cmd and check the output or you can check it using this cmd:

python -c "import sys; print(sys.path)"

edited May 1, 2020 at 13:36

Tonechas

13.8k16 gold badges52 silver badges85 bronze badges

answered May 1, 2020 at 11:32

Pandous

1211 silver badge2 bronze badges

1 Comment

CryptoFool Over a year ago

Add where? I know the answer, but it seems that many readers might not. If they did know, they probably wouldn't need to ask or seek the answer to this question in the first place, right?

SBUK-Tech · Accepted Answer · 2021-11-19 08:56:25Z

1

Another way to approach this is by installing the file as a single module.

Create an installer file as below (named pysetup.py):

import setuptools

module_name = input("Enter module name: ")
setuptools.setup(
    name=module_name,
    py_modules=[module_name],
)

You can then install this installer using itself with python pysetup.py install Then when prompted enter pysetup.

Now to install any file you can type python -m pysetup install then enter the name of the file. You can also replace install with develop to install in development mode and continue editing the file.

answered Nov 19, 2021 at 8:56

SBUK-Tech

1,4251 gold badge16 silver badges33 bronze badges

Comments

Patrik Staron · Accepted Answer · 2021-05-02 23:37:31Z

In one windows distribution in the following file: <python_root_installation_directory>/python38._pth

there are the following lines:

python38.zip
.
./lib
./lib/site-packages

# Uncomment to run site.main() automatically
#import site

Thus, with this content there the following yields:

Python 3.8.2 (tags/v3.8.2:7b3ab59, Feb 25 2020, 23:03:10) [MSC v.1916 64 bit (AMD64)] on win32
>>> import sys
>>> sys.path
['C:\\Program Files\\Applications\\python_3_8_2\\python38.zip', 'C:\\Program Files\\Applications\\python_3_8_2', 'C:\\Program Files\\Applications\\python_3_8_2\\./lib', 'C:\\Program Files\\Applications\\python_3_8_2\\./lib/site-packages']

So After adding this line into the file: ./lib/site-packages/win32ctypes it is present in the path:

Python 3.8.2 (tags/v3.8.2:7b3ab59, Feb 25 2020, 23:03:10) [MSC v.1916 64 bit (AMD64)] on win32
>>> import sys
>>> sys.path
['C:\\Program Files\\Applications\\python_3_8_2\\python38.zip', 'C:\\Program Files\\Applications\\python_3_8_2', 'C:\\Program Files\\Applications\\python_3_8_2\\./lib', 'C:\\Program Files\\Applications\\python_3_8_2\\./lib/site-packages', 'C:\\Program Files\\Applications\\python_3_8_2\\./lib/site-packages/win32ctypes']

This way, you don't need to have PYTHONPATH variable present on the system and you can still have the functionality. Disadvantage would be that this is installation specific, so if you have 3 different distributions on your system, this will affect only the chosen installation, while PYTHONPATH will affect all of them simultaneously.

madhanmaaz · Accepted Answer · 2023-12-25 16:08:07Z

0

FILE python-3.12.1-embed-win32/python38._pth

python312.zip
.

# Uncomment to run site.main() automatically
import site

uncomment the import site

answered Dec 25, 2023 at 16:08

madhanmaaz

12 bronze badges

Collectives™ on Stack Overflow

Permanently adding a file path to sys.path in Python

5 Answers 5

8 Comments

1 Comment

Comments

Comments

Comments

Your Answer

Linked

Hot Network Questions

Collectives™ on Stack Overflow

5 Answers 5

8 Comments

1 Comment

Comments

Comments

Comments

Your Answer

Sign up or log in

Post as a guest

Linked

Related