quickpub 4.0.0__tar.gz → 4.1.1__tar.gz

{quickpub-4.0.0 → quickpub-4.1.1}/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2022 danielnachumdev
-
-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
+MIT License
+
+Copyright (c) 2022 danielnachumdev
+
+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.

quickpub-4.1.1/PKG-INFO

@@ -0,0 +1,177 @@
+Metadata-Version: 2.4
+Name: quickpub
+Version: 4.1.1
+Summary: A local CI/CD simulation tool that runs quality checks, tests, and validations locally before publishing Python packages, ensuring higher build pass rates and faster feedback loops
+Author-email: danielnachumdev <danielnachumdev@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2022 danielnachumdev
+        
+        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/danielnachumdev/quickpub
+Project-URL: Bug Tracker, https://github.com/danielnachumdev/quickpub/issues
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: Microsoft :: Windows
+Requires-Python: >=3.8.0
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: danielutils>=1.1.23
+Requires-Dist: requests
+Requires-Dist: fire
+Requires-Dist: twine
+Dynamic: license-file
+
+# QuickPub
+
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+Run quality checks, tests, and packaging locally before you publish a Python package.
+
+QuickPub validates versions and project files, runs QA tools (mypy, pylint, pytest, unittest), builds the sdist, and uploads to PyPI/GitHub — so failures show up on your machine, not in CI.
+
+## Requirements
+
+- Python **3.8+**
+- Tested on **3.8, 3.9, 3.10, 3.11, 3.12, 3.13** (see [CI](.github/workflows/ci.yml))
+
+## Install
+
+[uv](https://docs.astral.sh/uv/) is the recommended workflow:
+
+```bash
+git clone https://github.com/danielnachumdev/quickpub.git
+cd quickpub
+uv sync
+```
+
+Runtime-only install:
+
+```bash
+uv sync --no-group dev --no-group test
+```
+
+Use as a CLI in another project:
+
+```bash
+uv add quickpub
+```
+
+## Usage
+
+### Publish this repo
+
+```bash
+uv run python publish.py
+```
+
+Requires a valid `.pypirc` for PyPI upload. Set `demo=True` in `publish.py` to run checks without building or uploading.
+
+### Publish your own package
+
+`publish()` runs enforcers, QA, file generation, build, and upload in one call:
+
+```python
+from quickpub import (
+    publish,
+    MypyRunner,
+    PylintRunner,
+    PytestRunner,
+    SetuptoolsBuildSchema,
+    PypircUploadTarget,
+    GithubUploadTarget,
+    PypircEnforcer,
+    ReadmeEnforcer,
+    LicenseEnforcer,
+    LocalVersionEnforcer,
+    PypiRemoteVersionEnforcer,
+)
+
+publish(
+    name="my-package",
+    version="1.0.0",
+    author="Your Name",
+    author_email="you@example.com",
+    description="My package",
+    homepage="https://github.com/you/my-package",
+    dependencies=["requests>=2.25.0"],
+    min_python="3.8.0",
+    enforcers=[
+        PypircEnforcer(),
+        ReadmeEnforcer(),
+        LicenseEnforcer(),
+        LocalVersionEnforcer(),
+        PypiRemoteVersionEnforcer(),
+    ],
+    global_quality_assurance_runners=[
+        MypyRunner(bound="<=20"),
+        PylintRunner(bound=">=0.8"),
+        PytestRunner(bound=">=0.95"),
+    ],
+    build_schemas=[SetuptoolsBuildSchema()],
+    upload_targets=[PypircUploadTarget(), GithubUploadTarget()],
+)
+```
+
+Omit `python_interpreter_provider` and `package_manager` to auto-detect the environment:
+
+| Project layout | Package manager | Python provider |
+|---|---|---|
+| `uv.lock` present | `UvPackageManager` | `UvPythonProvider` |
+| otherwise | `PipPackageManager` | `DefaultPythonProvider` |
+
+Override for conda or mixed setups:
+
+```python
+from quickpub import CondaPythonProvider, UnionProvider
+
+publish(
+    ...,
+    python_interpreter_provider=UnionProvider([
+        CondaPythonProvider(["base", "py39", "py38"]),
+    ]),
+)
+```
+
+Manual control: `resolve_publish_environment()` or explicit `package_manager` / `python_interpreter_provider` arguments.
+
+## What it does
+
+**Enforcers** — README, LICENSE, `.pypirc`, local/PyPI version checks.
+
+**QA runners** — mypy, pylint, pytest, unittest with configurable score bounds; runs in parallel across environments.
+
+**Build & upload** — generates `setup.py` / `pyproject.toml` / `MANIFEST.in`, builds sdist, uploads via twine and/or git push.
+
+**Environment providers** — `DefaultPythonProvider`, `UvPythonProvider`, `CondaPythonProvider`, or `UnionProvider` to combine them.
+
+## Development
+
+```bash
+uv run pytest          # full test suite
+uv run python publish.py  # publish quickpub itself
+```
+
+Tool config lives in `pyproject.toml` (`pytest`, `mypy`, `pylint`, `coverage`).
+
+## License
+
+MIT — see [LICENSE](LICENSE).

quickpub-4.1.1/README.md

@@ -0,0 +1,136 @@
+# QuickPub
+
+[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+
+Run quality checks, tests, and packaging locally before you publish a Python package.
+
+QuickPub validates versions and project files, runs QA tools (mypy, pylint, pytest, unittest), builds the sdist, and uploads to PyPI/GitHub — so failures show up on your machine, not in CI.
+
+## Requirements
+
+- Python **3.8+**
+- Tested on **3.8, 3.9, 3.10, 3.11, 3.12, 3.13** (see [CI](.github/workflows/ci.yml))
+
+## Install
+
+[uv](https://docs.astral.sh/uv/) is the recommended workflow:
+
+```bash
+git clone https://github.com/danielnachumdev/quickpub.git
+cd quickpub
+uv sync
+```
+
+Runtime-only install:
+
+```bash
+uv sync --no-group dev --no-group test
+```
+
+Use as a CLI in another project:
+
+```bash
+uv add quickpub
+```
+
+## Usage
+
+### Publish this repo
+
+```bash
+uv run python publish.py
+```
+
+Requires a valid `.pypirc` for PyPI upload. Set `demo=True` in `publish.py` to run checks without building or uploading.
+
+### Publish your own package
+
+`publish()` runs enforcers, QA, file generation, build, and upload in one call:
+
+```python
+from quickpub import (
+    publish,
+    MypyRunner,
+    PylintRunner,
+    PytestRunner,
+    SetuptoolsBuildSchema,
+    PypircUploadTarget,
+    GithubUploadTarget,
+    PypircEnforcer,
+    ReadmeEnforcer,
+    LicenseEnforcer,
+    LocalVersionEnforcer,
+    PypiRemoteVersionEnforcer,
+)
+
+publish(
+    name="my-package",
+    version="1.0.0",
+    author="Your Name",
+    author_email="you@example.com",
+    description="My package",
+    homepage="https://github.com/you/my-package",
+    dependencies=["requests>=2.25.0"],
+    min_python="3.8.0",
+    enforcers=[
+        PypircEnforcer(),
+        ReadmeEnforcer(),
+        LicenseEnforcer(),
+        LocalVersionEnforcer(),
+        PypiRemoteVersionEnforcer(),
+    ],
+    global_quality_assurance_runners=[
+        MypyRunner(bound="<=20"),
+        PylintRunner(bound=">=0.8"),
+        PytestRunner(bound=">=0.95"),
+    ],
+    build_schemas=[SetuptoolsBuildSchema()],
+    upload_targets=[PypircUploadTarget(), GithubUploadTarget()],
+)
+```
+
+Omit `python_interpreter_provider` and `package_manager` to auto-detect the environment:
+
+| Project layout | Package manager | Python provider |
+|---|---|---|
+| `uv.lock` present | `UvPackageManager` | `UvPythonProvider` |
+| otherwise | `PipPackageManager` | `DefaultPythonProvider` |
+
+Override for conda or mixed setups:
+
+```python
+from quickpub import CondaPythonProvider, UnionProvider
+
+publish(
+    ...,
+    python_interpreter_provider=UnionProvider([
+        CondaPythonProvider(["base", "py39", "py38"]),
+    ]),
+)
+```
+
+Manual control: `resolve_publish_environment()` or explicit `package_manager` / `python_interpreter_provider` arguments.
+
+## What it does
+
+**Enforcers** — README, LICENSE, `.pypirc`, local/PyPI version checks.
+
+**QA runners** — mypy, pylint, pytest, unittest with configurable score bounds; runs in parallel across environments.
+
+**Build & upload** — generates `setup.py` / `pyproject.toml` / `MANIFEST.in`, builds sdist, uploads via twine and/or git push.
+
+**Environment providers** — `DefaultPythonProvider`, `UvPythonProvider`, `CondaPythonProvider`, or `UnionProvider` to combine them.
+
+## Development
+
+```bash
+uv run pytest          # full test suite
+uv run python publish.py  # publish quickpub itself
+```
+
+Tool config lives in `pyproject.toml` (`pytest`, `mypy`, `pylint`, `coverage`).
+
+## License
+
+MIT — see [LICENSE](LICENSE).

{quickpub-4.0.0 → quickpub-4.1.1}/pyproject.toml

@@ -1,34 +1,34 @@
-[build-system]
-requires = ["setuptools>=61.0"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "quickpub"
-version = "4.0.0"
-authors = [
-    { name = "danielnachumdev", email = "danielnachumdev@gmail.com" },
-]
-dependencies = ['danielutils>=1.0.0', 'requests', 'fire']
-keywords = []
-license = { "file" = "./LICENSE" }
-description = "A local CI/CD simulation tool that runs quality checks, tests, and validations locally before publishing Python packages, ensuring higher build pass rates and faster feedback loops"
-readme = {file = "./README.md", content-type = "text/markdown"}
-requires-python = ">=3.8.0"
-classifiers = [
-	"Development Status :: 3 - Alpha",
-	"Intended Audience :: Developers",
-	"Programming Language :: Python :: 3",
-	"Operating System :: Microsoft :: Windows"
-]
-[project.scripts]
-    quickpub = "quickpub.__main__:main"
-
-[tool.setuptools]
-packages = ["quickpub"]
-
-[tool.setuptools.package-data]
-"quickpub" = ["py.typed"]
-
-[project.urls]
-"Homepage" = "https://github.com/danielnachumdev/quickpub"
-"Bug Tracker" = "https://github.com/danielnachumdev/quickpub/issues"
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "quickpub"
+version = "4.1.1"
+authors = [
+    { name = "danielnachumdev", email = "danielnachumdev@gmail.com" },
+]
+dependencies = ['danielutils>=1.1.23', 'requests', 'fire', 'twine']
+keywords = []
+license = { "file" = "./LICENSE" }
+description = "A local CI/CD simulation tool that runs quality checks, tests, and validations locally before publishing Python packages, ensuring higher build pass rates and faster feedback loops"
+readme = {file = "./README.md", content-type = "text/markdown"}
+requires-python = ">=3.8.0"
+classifiers = [
+	"Development Status :: 3 - Alpha",
+	"Intended Audience :: Developers",
+	"Programming Language :: Python :: 3",
+	"Operating System :: Microsoft :: Windows"
+]
+[project.scripts]
+    quickpub = "quickpub.__main__:main"
+
+[tool.setuptools]
+packages = ["quickpub"]
+
+[tool.setuptools.package-data]
+"quickpub" = ["py.typed"]
+
+[project.urls]
+"Homepage" = "https://github.com/danielnachumdev/quickpub"
+"Bug Tracker" = "https://github.com/danielnachumdev/quickpub/issues"

{quickpub-4.0.0 → quickpub-4.1.1}/quickpub/__init__.py

@@ -1,8 +1,9 @@
-from .structures import *
-from .strategies import *
-from .enforcers import ExitEarlyError
-from .qa import SupportsProgress
-from .logging_ import set_log_level
-from .__main__ import publish, main
-
-__version__ = "4.0.0"
+from .structures import *
+from .strategies import *
+from .enforcers import ExitEarlyError
+from .qa import SupportsProgress
+from .logging_ import set_log_level
+from .package_manager_detection import detect_package_manager, resolve_publish_environment
+from .__main__ import publish, main
+
+__version__ = "4.1.1"