Metadata-Version: 2.1
Name: PYPATHER
Version: 0.0.3
Summary: a Personal package for me.  automatically append paths to sys.path.  mange sys.path package.
Home-page: UNKNOWN
Author: Alawi Hussein Adnan Al Sayegh
Author-email: programming.laboratorys@gmail.com
License: MIT
Keywords: PYPATHER
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Operating System :: Microsoft :: Windows :: Windows 10
Classifier: Operating System :: POSIX
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Description-Content-Type: text/markdown

# `PYPATHER`
a Personal package for me

automatically append paths to sys.path

mange sys.path package
## info
when installing and setuping. no need to import it


# installation

Run the following to install:
```cmd
pip install PYPATHER
```
### or
```cmd
python -m pip install PYPATHER
```
if that didn't work, try replacing `pip` with `pip3`.
need help? my discord: [lab](https://discord.gg/vzEZnC7CM8)

## start
when python starts it import some modules. so we're going to inject code
### you need to add this code to one of the modules
i am going to add it to the site.py module at line 90
```py
def initPaths():
    # this func is not part of site.py module this func been added by The User
    sys.modules["PYPATHER"] = __import__("PYPATHER")
    sys.modules["_traceback"] = __import__("traceback")
    PYPATHER = sys.modules["PYPATHER"]
    if PYPATHER.settings.auto():
        PYPATHER.__start__()
    if PYPATHER.settings.exex() and PYPATHER.settings.execit():
        try:
            PYPATHER.exec_globals = {'__builtins__': __builtins__}
            PYPATHER.exec_locals  = {'__builtins__': __builtins__}
            exec(PYPATHER.settings.load()["exec"],
                PYPATHER.exec_globals,PYPATHER.exec_locals)
        except Exception:
            sys.modules["_traceback"].print_exc()

initPaths()
```

## append path to sys.paths
```py
>>> import PYPATHER
>>> PYPATHER.append(["E:\\projects\\packages"]) # append paths to sys.path
```
> **Note**
> this must be use every time. if you want to auto append use DumpPaths and set the setting to auto
## dump a path to `_packages_.json`
```py
>>> import PYPATHER
>>> PYPATHER.DumpPaths(["E:\\projects\\packages"])
>>> PYPATHER.settings.init(auto=True) # now it will always add the paths to sys.path
```
### or 
```py
>>> import PYPATHER
>>> PYPATHER.DumpPaths(["E:\\projects\\packages"])
>>> PYPATHER.__start__() # this will replace sys.path with _packages_.json paths
```


## add exec code
```py
import PYPATHER
code = """
print("i see starting the file :)")
import json
import os
print("import everything :O")
"""
PYPATHER.settings.init(exec=code,execit=True,auto=True) # when python imports X. this code will be exec
```
## get exec code locals
```R
E:\projects>python -q
i see starting the file :)
import everything :O
>>> import PYPATHER
>>> import sys
>>> locals().update(sys.modules["PYPATHER"].exec_locals) # update locals with the exec code locals. 
>>> json # you may get an error if you didnt set the setting to exec=code or the exec code was empty
<module 'json' from 'E:\\python\\Python39\\lib\\json\\__init__.py'>
```


