automatic import of python-import-deps

1 files changed, 456 insertions, 0 deletions

diff --git a/python-import-deps.spec b/python-import-deps.spec
new file mode 100644
index 0000000..18064a8
--- /dev/null
+++ b/python-import-deps.spec
@@ -0,0 +1,456 @@
+%global _empty_manifest_terminate_build 0
+Name:		python-import-deps
+Version:	0.2.0
+Release:	1
+Summary:	find python module imports
+License:	MIT License
+URL:		https://github.com/schettino72/import-deps
+Source0:	https://mirrors.nju.edu.cn/pypi/web/packages/61/b3/67ecaed610e6f333a318482def6c5f0f1bd502e2a136a03bf3ebb58c6aa4/import_deps-0.2.0.tar.gz
+BuildArch:	noarch
+
+
+%description
+# import_deps
+
+[![PyPI version](https://img.shields.io/pypi/v/import-deps.svg)](https://pypi.org/project/import-deps/)
+[![Python versions](https://img.shields.io/pypi/pyversions/import-deps.svg)](https://pypi.org/project/import-deps/)
+[![CI Github actions](https://github.com/schettino72/import-deps/actions/workflows/test.yml/badge.svg?branch=master)](https://github.com/schettino72/import-deps/actions/workflows/test.yml?query=branch%3Amaster)
+
+Find python module's import dependencies.
+
+`import_deps` is based on [ast module](https://docs.python.org/3/library/ast.html) from standard library,
+so the modules being analysed are *not* executed.
+
+
+## Install
+
+```
+pip install import_deps
+```
+
+## Usage
+
+
+`import_deps` is designed to track only imports within a known set of package and modules.
+
+Given a package with the modules:
+
+- `foo/__init__.py`
+- `foo/foo_a.py`
+- `foo/foo_b.py`
+- `foo/foo_c.py`
+
+Where `foo_a.py` has the following imports:
+
+```python3
+from . import foo_b
+from .foo_c import obj_c
+```
+
+
+```python3
+import pathlib
+from import_deps import ModuleSet
+
+# First initialise a ModuleSet instance with a list str of modules to track
+pkg_paths = pathlib.Path('foo').glob('**/*.py')
+module_set = ModuleSet([str(p) for p in pkg_paths])
+
+# then you can get the set of imports
+for imported in module_set.mod_imports('foo.foo_a'):
+    print(imported)
+
+# foo.foo_c
+# foo.foo_b
+```
+
+### ModuleSet
+
+You can get a list of  all modules in a `ModuleSet` by path or module's full qualified name.
+
+`by_path`
+
+Note that key for `by_path` must be exactly the as provided on ModuleSet initialization.
+
+```python3
+for mod in sorted(module_set.by_path.keys()):
+    print(mod)
+
+# results in:
+# foo/__init__.py
+# foo/foo_a.py
+# foo/foo_b.py
+# foo/foo_c.py
+```
+
+`by_name`
+
+```python3
+for mod in sorted(module_set.by_name.keys()):
+    print(mod)
+
+# results in:
+# foo.__init__
+# foo.foo_a
+# foo.foo_b
+# foo.foo_c
+```
+
+
+
+### ast_imports(file_path)
+
+`ast_imports` is a low level function that returns a list of entries for import statement in the module.
+The parameter `file_path` can be a string or `pathlib.Path` instance.
+
+The return value is a list of 4-tuple items with values:
+ - module name (of the "from" statement, `None` if a plain `import`)
+ - object name
+ - as name
+ - level of relative import (number of parent, `None` if plain `import`)
+
+
+```python3
+from import_deps import ast_imports
+
+ast_imports('foo.py')
+```
+
+
+```python3
+# import datetime
+(None, 'datetime', None, None)
+
+# from datetime import time
+('datetime', 'time', None, 0)
+
+# from datetime import datetime as dt
+('datetime', 'datetime', 'dt', 0)
+
+# from .. import bar
+(None, 'bar', None, 2)
+
+# from .acme import baz
+('acme', 'baz', None, 1)
+
+
+# note that a single statement will contain one entry per imported "name"
+# from datetime import time, timedelta
+('datetime', 'time', None, 0)
+('datetime', 'timedelta', None, 0)
+```
+
+%package -n python3-import-deps
+Summary:	find python module imports
+Provides:	python-import-deps
+BuildRequires:	python3-devel
+BuildRequires:	python3-setuptools
+BuildRequires:	python3-pip
+%description -n python3-import-deps
+# import_deps
+
+[![PyPI version](https://img.shields.io/pypi/v/import-deps.svg)](https://pypi.org/project/import-deps/)
+[![Python versions](https://img.shields.io/pypi/pyversions/import-deps.svg)](https://pypi.org/project/import-deps/)
+[![CI Github actions](https://github.com/schettino72/import-deps/actions/workflows/test.yml/badge.svg?branch=master)](https://github.com/schettino72/import-deps/actions/workflows/test.yml?query=branch%3Amaster)
+
+Find python module's import dependencies.
+
+`import_deps` is based on [ast module](https://docs.python.org/3/library/ast.html) from standard library,
+so the modules being analysed are *not* executed.
+
+
+## Install
+
+```
+pip install import_deps
+```
+
+## Usage
+
+
+`import_deps` is designed to track only imports within a known set of package and modules.
+
+Given a package with the modules:
+
+- `foo/__init__.py`
+- `foo/foo_a.py`
+- `foo/foo_b.py`
+- `foo/foo_c.py`
+
+Where `foo_a.py` has the following imports:
+
+```python3
+from . import foo_b
+from .foo_c import obj_c
+```
+
+
+```python3
+import pathlib
+from import_deps import ModuleSet
+
+# First initialise a ModuleSet instance with a list str of modules to track
+pkg_paths = pathlib.Path('foo').glob('**/*.py')
+module_set = ModuleSet([str(p) for p in pkg_paths])
+
+# then you can get the set of imports
+for imported in module_set.mod_imports('foo.foo_a'):
+    print(imported)
+
+# foo.foo_c
+# foo.foo_b
+```
+
+### ModuleSet
+
+You can get a list of  all modules in a `ModuleSet` by path or module's full qualified name.
+
+`by_path`
+
+Note that key for `by_path` must be exactly the as provided on ModuleSet initialization.
+
+```python3
+for mod in sorted(module_set.by_path.keys()):
+    print(mod)
+
+# results in:
+# foo/__init__.py
+# foo/foo_a.py
+# foo/foo_b.py
+# foo/foo_c.py
+```
+
+`by_name`
+
+```python3
+for mod in sorted(module_set.by_name.keys()):
+    print(mod)
+
+# results in:
+# foo.__init__
+# foo.foo_a
+# foo.foo_b
+# foo.foo_c
+```
+
+
+
+### ast_imports(file_path)
+
+`ast_imports` is a low level function that returns a list of entries for import statement in the module.
+The parameter `file_path` can be a string or `pathlib.Path` instance.
+
+The return value is a list of 4-tuple items with values:
+ - module name (of the "from" statement, `None` if a plain `import`)
+ - object name
+ - as name
+ - level of relative import (number of parent, `None` if plain `import`)
+
+
+```python3
+from import_deps import ast_imports
+
+ast_imports('foo.py')
+```
+
+
+```python3
+# import datetime
+(None, 'datetime', None, None)
+
+# from datetime import time
+('datetime', 'time', None, 0)
+
+# from datetime import datetime as dt
+('datetime', 'datetime', 'dt', 0)
+
+# from .. import bar
+(None, 'bar', None, 2)
+
+# from .acme import baz
+('acme', 'baz', None, 1)
+
+
+# note that a single statement will contain one entry per imported "name"
+# from datetime import time, timedelta
+('datetime', 'time', None, 0)
+('datetime', 'timedelta', None, 0)
+```
+
+%package help
+Summary:	Development documents and examples for import-deps
+Provides:	python3-import-deps-doc
+%description help
+# import_deps
+
+[![PyPI version](https://img.shields.io/pypi/v/import-deps.svg)](https://pypi.org/project/import-deps/)
+[![Python versions](https://img.shields.io/pypi/pyversions/import-deps.svg)](https://pypi.org/project/import-deps/)
+[![CI Github actions](https://github.com/schettino72/import-deps/actions/workflows/test.yml/badge.svg?branch=master)](https://github.com/schettino72/import-deps/actions/workflows/test.yml?query=branch%3Amaster)
+
+Find python module's import dependencies.
+
+`import_deps` is based on [ast module](https://docs.python.org/3/library/ast.html) from standard library,
+so the modules being analysed are *not* executed.
+
+
+## Install
+
+```
+pip install import_deps
+```
+
+## Usage
+
+
+`import_deps` is designed to track only imports within a known set of package and modules.
+
+Given a package with the modules:
+
+- `foo/__init__.py`
+- `foo/foo_a.py`
+- `foo/foo_b.py`
+- `foo/foo_c.py`
+
+Where `foo_a.py` has the following imports:
+
+```python3
+from . import foo_b
+from .foo_c import obj_c
+```
+
+
+```python3
+import pathlib
+from import_deps import ModuleSet
+
+# First initialise a ModuleSet instance with a list str of modules to track
+pkg_paths = pathlib.Path('foo').glob('**/*.py')
+module_set = ModuleSet([str(p) for p in pkg_paths])
+
+# then you can get the set of imports
+for imported in module_set.mod_imports('foo.foo_a'):
+    print(imported)
+
+# foo.foo_c
+# foo.foo_b
+```
+
+### ModuleSet
+
+You can get a list of  all modules in a `ModuleSet` by path or module's full qualified name.
+
+`by_path`
+
+Note that key for `by_path` must be exactly the as provided on ModuleSet initialization.
+
+```python3
+for mod in sorted(module_set.by_path.keys()):
+    print(mod)
+
+# results in:
+# foo/__init__.py
+# foo/foo_a.py
+# foo/foo_b.py
+# foo/foo_c.py
+```
+
+`by_name`
+
+```python3
+for mod in sorted(module_set.by_name.keys()):
+    print(mod)
+
+# results in:
+# foo.__init__
+# foo.foo_a
+# foo.foo_b
+# foo.foo_c
+```
+
+
+
+### ast_imports(file_path)
+
+`ast_imports` is a low level function that returns a list of entries for import statement in the module.
+The parameter `file_path` can be a string or `pathlib.Path` instance.
+
+The return value is a list of 4-tuple items with values:
+ - module name (of the "from" statement, `None` if a plain `import`)
+ - object name
+ - as name
+ - level of relative import (number of parent, `None` if plain `import`)
+
+
+```python3
+from import_deps import ast_imports
+
+ast_imports('foo.py')
+```
+
+
+```python3
+# import datetime
+(None, 'datetime', None, None)
+
+# from datetime import time
+('datetime', 'time', None, 0)
+
+# from datetime import datetime as dt
+('datetime', 'datetime', 'dt', 0)
+
+# from .. import bar
+(None, 'bar', None, 2)
+
+# from .acme import baz
+('acme', 'baz', None, 1)
+
+
+# note that a single statement will contain one entry per imported "name"
+# from datetime import time, timedelta
+('datetime', 'time', None, 0)
+('datetime', 'timedelta', None, 0)
+```
+
+%prep
+%autosetup -n import-deps-0.2.0
+
+%build
+%py3_build
+
+%install
+%py3_install
+install -d -m755 %{buildroot}/%{_pkgdocdir}
+if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi
+if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
+if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
+if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
+pushd %{buildroot}
+if [ -d usr/lib ]; then
+	find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/lib64 ]; then
+	find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/bin ]; then
+	find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+if [ -d usr/sbin ]; then
+	find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst
+fi
+touch doclist.lst
+if [ -d usr/share/man ]; then
+	find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst
+fi
+popd
+mv %{buildroot}/filelist.lst .
+mv %{buildroot}/doclist.lst .
+
+%files -n python3-import-deps -f filelist.lst
+%dir %{python3_sitelib}/*
+
+%files help -f doclist.lst
+%{_docdir}/*
+
+%changelog
+* Tue Apr 11 2023 Python_Bot <Python_Bot@openeuler.org> - 0.2.0-1
+- Package Spec generated