packing-packages 0.0.2__tar.gz

packing_packages-0.0.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 yu9824
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

packing_packages-0.0.2/PKG-INFO

@@ -0,0 +1,155 @@
+Metadata-Version: 2.4
+Name: packing-packages
+Version: 0.0.2
+Summary: This module provides functionality to pack conda environments and their dependencies into a specified directory.
+Author: yu9824
+Maintainer: yu9824
+License: MIT License
+        
+        Copyright (c) 2024 yu9824
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Project-URL: Homepage, https://github.com/yu9824/packing-packages
+Project-URL: Documentation, https://yu9824.github.io/packing-packages/
+Project-URL: PyPI, https://pypi.org/project/packing-packages/
+Project-URL: Source, https://github.com/yu9824/packing-packages
+Project-URL: Tracker, https://github.com/yu9824/packing-packages/issues
+Project-URL: Changelog, https://github.com/yu9824/packing-packages/blob/main/CHANGELOG.md
+Keywords: anaconda,conda
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: License :: OSI Approved :: MIT License
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Provides-Extra: dev
+Requires-Dist: build; extra == "dev"
+Provides-Extra: optional
+Requires-Dist: colorlog; extra == "optional"
+Requires-Dist: tqdm; extra == "optional"
+Provides-Extra: docs
+Requires-Dist: sphinx; extra == "docs"
+Requires-Dist: sphinx_rtd_theme; extra == "docs"
+Requires-Dist: sphinx-markdown-tables; extra == "docs"
+Requires-Dist: recommonmark; extra == "docs"
+Provides-Extra: gui
+Requires-Dist: TkEasyGUI; extra == "gui"
+Dynamic: license-file
+
+# PACKING-PACKAGES
+
+[![CI](https://github.com/yu9824/packing-packages/actions/workflows/CI.yml/badge.svg)](https://github.com/yu9824/packing-packages/actions/workflows/CI.yml)
+[![docs](https://github.com/yu9824/packing-packages/actions/workflows/docs.yml/badge.svg)](https://github.com/yu9824/packing-packages/actions/workflows/docs.yml)
+[![release-pypi](https://github.com/yu9824/packing-packages/actions/workflows/release-pypi.yml/badge.svg)](https://github.com/yu9824/packing-packages/actions/workflows/release-pypi.yml)
+
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![mypy](https://www.mypy-lang.org/static/mypy_badge.svg)](https://github.com/python/mypy)
+
+[![python_badge](https://img.shields.io/pypi/pyversions/packing-packages)](https://pypi.org/project/packing-packages/)
+[![license_badge](https://img.shields.io/pypi/l/packing-packages)](https://pypi.org/project/packing-packages/)
+[![PyPI version](https://badge.fury.io/py/packing-packages.svg)](https://pypi.org/project/packing-packages/)
+[![Downloads](https://static.pepy.tech/badge/packing-packages)](https://pepy.tech/project/packing-packages)
+
+<!-- [![Conda Version](https://img.shields.io/conda/vn/conda-forge/packing-packages.svg)](https://anaconda.org/conda-forge/packing-packages)
+[![Conda Platforms](https://img.shields.io/conda/pn/conda-forge/packing-packages.svg)](https://anaconda.org/conda-forge/packing-packages) -->
+
+This module provides functionality to pack conda environments and their dependencies into a specified directory.
+
+You can use this package to migrate a conda environment to another offline machine with the same operating system.
+
+
+## Install
+
+```bash
+# Need python, setuptools, pip package
+pip install packing-packages
+
+```
+
+## How to use
+
+see `--help`.
+
+### Pack
+
+```bash
+packing-package pack -d .
+
+```
+
+### Install
+
+```bash
+packing-package install .
+
+```
+
+## Example
+
+### Source device
+
+```bash
+conda activate <envname>
+python -m pip install packing-packages
+python -m packing_packages pack -d .
+
+```
+
+### Destination device (offline)
+
+```bash
+conda create -yn <envname> --offline
+conda activate <envname>
+conda install --use-local --offline ./conda/*
+python -m pip install --no-deps --no-build-isolation ./pypi/*
+
+```
+
+## Notes
+
+If you want to use pip to download from a source other than pypi.org (e.g. pytorch), the above will not completely collect. You will see packages that failed to download, so you will have to download them manually.
+This is very complicated and we do not plan to support it.
+
+```bash
+# install command
+pip install torch==2.5.1 --index-url https://download.pytorch.org/whl/cu124
+
+# download command
+# --no-deps: only target package
+# -d: destination directory to download
+pip download torch==2.5.1 --index-url https://download.pytorch.org/whl/cu124 --no-deps -d .
+```
+
+Some older packages may not install with `pip install`. In this case, you may succeed by installing only the failed packages with the `--use-pep517` option.
+Please perform this manually.
+
+There are two methods of installation: one is to use the standard functions of conda and pip, and the second is to use the `paciking-package install` command, which wraps them. The advantages of each are summarized in the table below.
+
+
+| Commands                          | Advantages                                      | Disadvantages                     |
+| --------------------------------- | ----------------------------------------------- | --------------------------------- |
+| `conda install`  or `pip install` | Fast                                            | Stop immediately when cause error |
+| `packing-package install`         | Skip when error occurs and tell you the package | Slow                              |

packing_packages-0.0.2/README.md

@@ -0,0 +1,94 @@
+# PACKING-PACKAGES
+
+[![CI](https://github.com/yu9824/packing-packages/actions/workflows/CI.yml/badge.svg)](https://github.com/yu9824/packing-packages/actions/workflows/CI.yml)
+[![docs](https://github.com/yu9824/packing-packages/actions/workflows/docs.yml/badge.svg)](https://github.com/yu9824/packing-packages/actions/workflows/docs.yml)
+[![release-pypi](https://github.com/yu9824/packing-packages/actions/workflows/release-pypi.yml/badge.svg)](https://github.com/yu9824/packing-packages/actions/workflows/release-pypi.yml)
+
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![mypy](https://www.mypy-lang.org/static/mypy_badge.svg)](https://github.com/python/mypy)
+
+[![python_badge](https://img.shields.io/pypi/pyversions/packing-packages)](https://pypi.org/project/packing-packages/)
+[![license_badge](https://img.shields.io/pypi/l/packing-packages)](https://pypi.org/project/packing-packages/)
+[![PyPI version](https://badge.fury.io/py/packing-packages.svg)](https://pypi.org/project/packing-packages/)
+[![Downloads](https://static.pepy.tech/badge/packing-packages)](https://pepy.tech/project/packing-packages)
+
+<!-- [![Conda Version](https://img.shields.io/conda/vn/conda-forge/packing-packages.svg)](https://anaconda.org/conda-forge/packing-packages)
+[![Conda Platforms](https://img.shields.io/conda/pn/conda-forge/packing-packages.svg)](https://anaconda.org/conda-forge/packing-packages) -->
+
+This module provides functionality to pack conda environments and their dependencies into a specified directory.
+
+You can use this package to migrate a conda environment to another offline machine with the same operating system.
+
+
+## Install
+
+```bash
+# Need python, setuptools, pip package
+pip install packing-packages
+
+```
+
+## How to use
+
+see `--help`.
+
+### Pack
+
+```bash
+packing-package pack -d .
+
+```
+
+### Install
+
+```bash
+packing-package install .
+
+```
+
+## Example
+
+### Source device
+
+```bash
+conda activate <envname>
+python -m pip install packing-packages
+python -m packing_packages pack -d .
+
+```
+
+### Destination device (offline)
+
+```bash
+conda create -yn <envname> --offline
+conda activate <envname>
+conda install --use-local --offline ./conda/*
+python -m pip install --no-deps --no-build-isolation ./pypi/*
+
+```
+
+## Notes
+
+If you want to use pip to download from a source other than pypi.org (e.g. pytorch), the above will not completely collect. You will see packages that failed to download, so you will have to download them manually.
+This is very complicated and we do not plan to support it.
+
+```bash
+# install command
+pip install torch==2.5.1 --index-url https://download.pytorch.org/whl/cu124
+
+# download command
+# --no-deps: only target package
+# -d: destination directory to download
+pip download torch==2.5.1 --index-url https://download.pytorch.org/whl/cu124 --no-deps -d .
+```
+
+Some older packages may not install with `pip install`. In this case, you may succeed by installing only the failed packages with the `--use-pep517` option.
+Please perform this manually.
+
+There are two methods of installation: one is to use the standard functions of conda and pip, and the second is to use the `paciking-package install` command, which wraps them. The advantages of each are summarized in the table below.
+
+
+| Commands                          | Advantages                                      | Disadvantages                     |
+| --------------------------------- | ----------------------------------------------- | --------------------------------- |
+| `conda install`  or `pip install` | Fast                                            | Stop immediately when cause error |
+| `packing-package install`         | Skip when error occurs and tell you the package | Slow                              |

packing_packages-0.0.2/pyproject.toml

@@ -0,0 +1,63 @@
+# https://packaging.python.org/ja/latest/guides/writing-pyproject-toml/
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "packing-packages"
+dynamic = ["version"]
+dependencies = []
+requires-python = ">= 3.9"
+authors = [{ name = "yu9824" }]
+maintainers = [{ name = "yu9824" }]
+description = "This module provides functionality to pack conda environments and their dependencies into a specified directory."
+readme = { file = "README.md", content-type = "text/markdown" }
+license = { file = "LICENSE" }
+keywords = ["anaconda", "conda"]
+# https://pypi.org/classifiers/
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "License :: OSI Approved :: MIT License",
+] # https://pypi.org/classifiers/
+
+[project.optional-dependencies]
+test = ["pytest"]
+dev = ["build"]
+optional = ["colorlog", "tqdm"]
+docs = ["sphinx", "sphinx_rtd_theme", "sphinx-markdown-tables", "recommonmark"]
+gui = ["TkEasyGUI"]
+
+[project.urls]
+Homepage = "https://github.com/yu9824/packing-packages"
+Documentation = "https://yu9824.github.io/packing-packages/"
+PyPI = "https://pypi.org/project/packing-packages/"
+Source = "https://github.com/yu9824/packing-packages"
+Tracker = "https://github.com/yu9824/packing-packages/issues"
+Changelog = "https://github.com/yu9824/packing-packages/blob/main/CHANGELOG.md"
+
+[project.scripts]
+packing-packages = "packing_packages.__main__:entrypoint"
+
+# [project.gui-scripts]
+# packing-packages-gui = "packing_packages:main_gui"
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+
+[tool.setuptools.dynamic]
+version = { attr = "packing_packages.__version__" }
+
+[tool.setuptools.packages.find]
+where = ["src/"]
+
+[tool.ruff]
+line-length = 79
+indent-width = 4
+
+[tool.ruff.lint]
+unfixable = ["F401"]

packing_packages-0.0.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

packing_packages-0.0.2/src/packing_packages/__init__.py

@@ -0,0 +1,24 @@
+"""Packing Packages
+
+Packing packages for distribution and installation.
+This module provides functionality to pack conda environments and their
+dependencies into a specified directory.
+
+.. code-block:: bash
+
+    $ python -m packing_packages pack --help
+    $ python -m packing_packages install --help
+
+    or
+
+    $ packing-packages pack --help
+    $ packing-packages install --help
+
+"""
+
+__version__ = "0.0.2"
+__license__ = "MIT"
+__author__ = "yu9824"
+__copyright__ = "Copyright © 2025 yu9824"
+
+# __all__ = ()

packing_packages-0.0.2/src/packing_packages/__main__.py

@@ -0,0 +1,84 @@
+import argparse
+import sys
+from typing import Optional
+
+if sys.version_info >= (3, 9):
+    from collections.abc import Sequence
+else:
+    from typing import Sequence
+
+from packing_packages import __version__
+from packing_packages.install.__main__ import install
+from packing_packages.pack.__main__ import pack
+
+__all__ = ("main",)
+
+
+def main(cli_args: Sequence[str], prog: Optional[str] = None) -> None:
+    parser = argparse.ArgumentParser(prog=prog, description="")
+    parser.add_argument(
+        "-v",
+        "--version",
+        action="version",
+        help="show current version",
+        version=f"%(prog)s: {__version__}",
+    )
+    subparsers = parser.add_subparsers()
+    parser_pack = subparsers.add_parser(
+        "pack",
+        help="pack conda environment",
+    )
+    parser_pack.add_argument(
+        "-e",
+        "-n",
+        "--env-name",
+        type=str,
+        default=None,
+        help="conda environment name",
+    )
+    parser_pack.add_argument(
+        "-d",
+        "--dirpath-target",
+        type=str,
+        default=".",
+        help="target directory path",
+    )
+    parser_pack.add_argument(
+        "-D",
+        "--dry-run",
+        action="store_true",
+        help="do not download files",
+    )
+    parser_pack.set_defaults(func=pack)
+
+    parser_install = subparsers.add_parser(
+        "install",
+        help="install packages in the conda environment",
+    )
+    parser_install.add_argument(
+        "-e",
+        "-n",
+        "--env-name",
+        type=str,
+        default=None,
+        help="conda environment name",
+    )
+    parser_install.add_argument(
+        type=str,
+        default=".",
+        help="directory path of packages",
+        metavar="DIRPATH_PACKAGES",
+        dest="dirpath_packages",
+    )
+    parser_install.set_defaults(func=install)
+
+    args = parser.parse_args(cli_args)
+    args.func(args)
+
+
+def entrypoint() -> None:
+    main(sys.argv[1:])
+
+
+if __name__ == "__main__":
+    main(sys.argv[1:], prog="packing-packages")

packing_packages-0.0.2/src/packing_packages/constants.py

@@ -0,0 +1,30 @@
+"""This module contains constants used throughout the packing_packages package.
+
+It includes constants for file extensions, encoding, and other configuration values.
+"""
+
+from typing import Literal
+
+EXTENSIONS_CONDA: tuple[Literal["tar.bz2"], Literal["conda"]] = (
+    "tar.bz2",
+    "conda",
+)
+"""Extensions for conda packages.
+
+These are the extensions used by conda packages.
+"""
+
+EXTENSIONS_PYPI: tuple[Literal["whl"], Literal["tar.gz"]] = (
+    "whl",
+    "tar.gz",
+)
+"""Extensions for PyPI packages.
+
+These are the extensions used by PyPI packages.
+"""
+
+ENCODING: Literal["utf-8"] = "utf-8"
+"""Encoding for file operations.
+This is the encoding used for file operations in the project.
+It is set to 'utf-8' to ensure compatibility with most text files.
+"""

packing_packages-0.0.2/src/packing_packages/install/__init__.py

@@ -0,0 +1,18 @@
+"""Install packages for the packing_packages project.
+
+This module provides a function to install packages from a specified
+directory into a conda environment.
+
+.. code-block:: bash
+
+    $ python -m packing_packages install --help
+
+    or
+
+    $ packing-packages install --help
+
+"""
+
+from ._core import install_packages
+
+__all__ = ("install_packages",)

packing_packages-0.0.2/src/packing_packages/install/__main__.py

@@ -0,0 +1,49 @@
+import argparse
+import os
+from collections.abc import Sequence
+from pathlib import Path
+from typing import Optional
+
+from packing_packages.install._core import install_packages
+
+
+def install(args: argparse.Namespace) -> None:
+    """Install packages in the conda environment."""
+    if args.env_name is None:
+        env_name = os.environ["CONDA_DEFAULT_ENV"]
+    else:
+        env_name = args.env_name
+
+    dirpath_packages = Path(args.dirpath_packages).resolve()
+    if not dirpath_packages.is_dir():
+        raise FileNotFoundError(dirpath_packages)
+
+    install_packages(
+        dirpath_packages=dirpath_packages,
+        env_name=env_name,
+    )
+
+
+def main(cli_args: Sequence[str], prog: Optional[str] = None) -> None:
+    """Main function to parse arguments and call the install function."""
+    parser = argparse.ArgumentParser(
+        prog=prog, description="Install packages in the conda environment"
+    )
+    parser.add_argument(
+        "dirpath-packages",
+        type=str,
+        default=".",
+        help="directory path of packages",
+        metavar="DIRPATH_PACKAGES",
+    )
+    parser.add_argument(
+        "-e",
+        "-n",
+        "--env-name",
+        type=str,
+        default=None,
+        help="conda environment name",
+    )
+    parser.set_defaults(func=install)
+    args = parser.parse_args(cli_args)
+    args.func(args)