chore: refactor into standard python package

Author: undefinederror

.github/workflows/release.yml

@@ -34,7 +34,7 @@ jobs:
 
       - name: Get version
         id: get_version
-        run: echo "VERSION=$(cat VERSION)" >> $GITHUB_OUTPUT
+        run: echo "VERSION=$(cat upk/VERSION)" >> $GITHUB_OUTPUT
 
       - name: Create Release
         id: create_release

CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.2.1] - 2026-03-18
+
+### Refactored
+- **Project Structure**: Completely reorganized into a standard Python package format.
+- **Packaging**: Switched to `pyproject.toml` and declarative metadata.
+- **Infrastructure**: Simplified `setup.py`, `build.sh`, and `pacscript` logic.
+
 ## [1.2.0] - 2026-03-14
 
 ### Added

MANIFEST.in

@@ -1,4 +1,4 @@
 include README.md
 include LICENSE
-recursive-include backends *.py
-include VERSION
+recursive-include upk/backends *.py
+include upk/VERSION

VERSION

@@ -35,7 +35,7 @@ if [[ $EUID -eq 0 ]]; then
 fi
 
 # Read version from VERSION file
-VERSION=$(cat VERSION)
+VERSION=$(cat upk/VERSION)
 print_status "Building UPK version: $VERSION"
 
 # Create temporary directory for packaging
@@ -47,21 +47,14 @@ mkdir -p "$TEMP_DIR"/{DEBIAN,usr/bin,usr/share/doc/upk,usr/lib/python3/dist-pack
 
 # Copy source files to package structure
 print_status "Copying source files to package structure..."
-cp -r backends "$TEMP_DIR/usr/lib/python3/dist-packages/upk/"
-cp config.py "$TEMP_DIR/usr/lib/python3/dist-packages/upk/"
-cp display.py "$TEMP_DIR/usr/lib/python3/dist-packages/upk/"
-cp search.py "$TEMP_DIR/usr/lib/python3/dist-packages/upk/"
-cp utils.py "$TEMP_DIR/usr/lib/python3/dist-packages/upk/"
-cp upk.py "$TEMP_DIR/usr/lib/python3/dist-packages/upk/"
-cp VERSION "$TEMP_DIR/usr/lib/python3/dist-packages/upk/"
+cp -r upk/* "$TEMP_DIR/usr/lib/python3/dist-packages/upk/"
 
 # Create wrapper script
 print_status "Creating wrapper script..."
 cat > "$TEMP_DIR/usr/bin/upk" << 'EOF'
 #!/bin/bash
 # UPK wrapper script
-cd /usr/lib/python3/dist-packages/upk
-exec python3 upk.py "$@"
+exec python3 -m upk.upk "$@"
 EOF
 
 chmod +x "$TEMP_DIR/usr/bin/upk"
@@ -80,7 +73,7 @@ fi
 
 # Set PYTHONPATH to current directory to ensure backends can be imported
 export PYTHONPATH=$PYTHONPATH:.
-_UPK_COMPLETE=bash_source python3 upk.py > "$TEMP_DIR/usr/share/bash-completion/completions/upk"
+_UPK_COMPLETE=bash_source python3 -m upk.upk > "$TEMP_DIR/usr/share/bash-completion/completions/upk"
 print_success "Bash completion script created"
 
 # Create control file from template

build.sh

@@ -2,19 +2,44 @@
 name = "upk"
 dynamic = ["version"]
 description = "Ubuntu Package Kit - Universal package manager wrapper"
-authors = [{name = "undefinederror (Lorenzo Paci)"}]
+authors = [
+    { name = "undefinederror (Lorenzo Paci)", email = "github@object.ninja" }
+]
+readme = "README.md"
 requires-python = ">=3.10"
+keywords = ["package manager", "apt", "snap", "flatpak", "pacstall", "appimage"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: System :: Installation/Setup",
+    "Topic :: System :: Software Distribution",
+    "Topic :: Utilities",
+]
 dependencies = [
     "click>=8.1.0",
     "rich>=13.0.0",
 ]
 
+[project.urls]
+"Bug Reports" = "https://github.com/undefinederror/upk/issues"
+"Source" = "https://github.com/undefinederror/upk"
+
 [project.scripts]
-upk = "upk:cli"
+upk = "upk.upk:cli"
 
 [build-system]
 requires = ["setuptools>=61.0"]
 build-backend = "setuptools.build_meta"
 
 [tool.setuptools.dynamic]
-version = {file = "VERSION"}
+version = {file = "upk/VERSION"}
+
+[tool.setuptools]
+packages = ["upk", "upk.backends"]
+include-package-data = true

pyproject.toml

@@ -1,65 +1,6 @@
 #!/usr/bin/env python3
 """Setup script for UPK - Ubuntu Package Kit."""
 
-from setuptools import setup, find_packages
-from pathlib import Path
+from setuptools import setup
 
-# Read the README file
-this_directory = Path(__file__).parent
-long_description = (this_directory / "README.md").read_text()
-
-# Read requirements from pyproject.toml
-def get_requirements():
-    """Extract dependencies from pyproject.toml."""
-    import tomllib
-    pyproject_path = this_directory / "pyproject.toml"
-    if pyproject_path.exists():
-        with open(pyproject_path, "rb") as f:
-            pyproject_data = tomllib.load(f)
-        return pyproject_data.get("project", {}).get("dependencies", [])
-    return []
-
-def get_version():
-    """Read version from VERSION file."""
-    version_path = this_directory / "VERSION"
-    if version_path.exists():
-        return version_path.read_text().strip()
-    return "1.1.0"
-
-setup(
-    name="upk",
-    version=get_version(),
-    description="Ubuntu Package Kit - Universal package manager wrapper",
-    long_description=long_description,
-    long_description_content_type="text/markdown",
-    author="undefinederror (Lorenzo Paci)",
-    author_email="github@object.ninja",
-    url="https://github.com/undefinederror/upk",
-    packages=find_packages(),
-    include_package_data=True,
-    install_requires=get_requirements(),
-    entry_points={
-        "console_scripts": [
-            "upk=upk:cli",
-        ],
-    },
-    classifiers=[
-        "Development Status :: 4 - Beta",
-        "Intended Audience :: Developers",
-        "License :: OSI Approved :: MIT License",
-        "Operating System :: POSIX :: Linux",
-        "Programming Language :: Python :: 3",
-        "Programming Language :: Python :: 3.10",
-        "Programming Language :: Python :: 3.11",
-        "Programming Language :: Python :: 3.12",
-        "Topic :: System :: Installation/Setup",
-        "Topic :: System :: Software Distribution",
-        "Topic :: Utilities",
-    ],
-    python_requires=">=3.10",
-    keywords="package manager apt snap flatpak pacstall appimage",
-    project_urls={
-        "Bug Reports": "https://github.com/yourusername/upk/issues",
-        "Source": "https://github.com/yourusername/upk",
-    },
-)
+setup()

setup.py

@@ -0,0 +1 @@
+1.2.1