cmon2lib 0.0.1__tar.gz

cmon2lib-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Simon Dorr
+
+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.

cmon2lib-0.0.1/PKG-INFO

@@ -0,0 +1,20 @@
+Metadata-Version: 2.3
+Name: cmon2lib
+Version: 0.0.1
+Summary: my personal python library for convenient personalized functionality
+Author: Simon Dorr
+Author-email: simon@ich-bin-simon.de
+Requires-Python: >=3.7
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Provides-Extra: test
+Requires-Dist: pytest ; extra == "test"
+Requires-Dist: pytest-cov ; extra == "test"
+Requires-Dist: python-taiga (>=1.3.2,<2.0.0)
+Project-URL: Homepage, https://github.com/cmon2/cmon2lib
+Description-Content-Type: text/markdown
+
+# cmon2lib
+my personal python library for convenient personalized functionality
+

cmon2lib-0.0.1/README.md

@@ -0,0 +1,2 @@
+# cmon2lib
+my personal python library for convenient personalized functionality

cmon2lib-0.0.1/cmon2lib/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.0.5"

cmon2lib-0.0.1/cmon2lib/taiga/taiga_project_functions.py

@@ -0,0 +1,46 @@
+from cmon2lib.taiga.taiga_user_functions import authenticate, get_authenticated_user_projects
+from cmon2lib.utils.cmon_logging import clog
+
+
+def cprint_project(project):
+    """
+    Return a styled string containing all user story statuses with their user stories as a sublist for the given project.
+
+    Format:
+        === Project: <id> | <name> ===
+          [<status1>]
+            • <story1>
+            • <story2>
+          [<status2>]
+            ...
+    Args:
+        project: The Taiga project object.
+    Returns:
+        str: A formatted string with statuses and their user stories.
+    """
+    clog('info', f"Formatting project {project.id} - {project.name}")
+    result = [f"\n=== Project: {project.id} | {project.name} ==="]
+    statuses = project.list_user_story_statuses()
+    user_stories = project.list_user_stories()
+    # Map status id to status name
+    status_map = {status.id: status.name for status in statuses}
+    # Group user stories by status
+    stories_by_status = {status.id: [] for status in statuses}
+    for story in user_stories:
+        stories_by_status.setdefault(story.status, []).append(story)
+    # Build output
+    for status in statuses:
+        result.append(f"  [{status.name}]")
+        stories = stories_by_status.get(status.id, [])
+        for story in stories:
+            result.append(f"    • {story.id}: {story.subject}")
+        if not stories:
+            clog('debug', f"No user stories for status '{status.name}' in project {project.id}")
+    return "\n".join(result)
+
+if __name__ == "__main__":
+    clog('info', "Fetching authenticated user projects...")
+    projects = get_authenticated_user_projects()
+    for project in projects:
+        print(cprint_project(project))
+        clog('info', f"Printed project {project.id} - {project.name}")

cmon2lib-0.0.1/cmon2lib/taiga/taiga_user_functions.py

@@ -0,0 +1,75 @@
+import os
+from taiga import TaigaAPI, exceptions
+from cmon2lib.utils.cmon_logging import clog
+
+# Use the base URL (no /api/v1/ at the end)
+TAIGA_API_URL = os.environ.get("TAIGA_API_URL", "https://api.taiga.io/")
+TAIGA_USERNAME = os.environ.get("TAIGA_USERNAME")
+TAIGA_PASSWORD = os.environ.get("TAIGA_PASSWORD")
+TAIGA_TOKEN = os.environ.get("TAIGA_TOKEN")
+
+def authenticate():
+    """Authenticate to Taiga and return the API object."""
+    api = TaigaAPI(host=TAIGA_API_URL)
+    try:
+        if TAIGA_TOKEN:
+            api.auth(token=TAIGA_TOKEN)
+        elif TAIGA_USERNAME and TAIGA_PASSWORD:
+            api.auth(username=TAIGA_USERNAME, password=TAIGA_PASSWORD)
+        else:
+            raise EnvironmentError("Set TAIGA_USERNAME and TAIGA_PASSWORD or TAIGA_TOKEN environment variables.")
+    except exceptions.TaigaRestException as e:
+        raise RuntimeError(f"Taiga authentication failed: {e}")
+    return api
+
+def get_authenticated_user():
+    """
+    Get the authenticated user's information and log the user ID.
+    Returns:
+        user: The authenticated Taiga user object.
+    Raises:
+        RuntimeError: If authentication fails or user cannot be fetched.
+    """
+    api = authenticate()
+    try:
+        user = api.me()
+        clog('info', f"Authenticated user ID: {user.id}")
+        return user
+    except exceptions.TaigaRestException as e:
+        clog('error', f"Failed to get authenticated user: {e}")
+        raise RuntimeError(f"Failed to get authenticated user: {e}")
+
+
+def get_authenticated_user_projects():
+    """
+    Get the authenticated user's projects using their user ID and log the project names.
+    Returns:
+        list: List of Taiga project objects the user is a member of.
+    Raises:
+        RuntimeError: If projects cannot be fetched.
+    """
+    api = authenticate()
+    try:
+        user = api.me()
+        page_size = 15  # Default Taiga API page size
+        projects = api.projects.list(page=1, member=user.id, page_size=page_size)
+        # Check if there might be more projects than fit on one page
+        if hasattr(projects, '__len__') and len(projects) == page_size:
+            clog('warning', f"Project list may be truncated: found {len(projects)} projects (page size limit). There may be more projects for user {user.id}.")
+        if projects:
+            clog('info', f"Found {len(projects)} projects for user {user.id}.")
+            for project in projects:
+                clog('debug', f"Project: {project.id}: {project.name}")
+        else:
+            clog('warning', f"No projects found for user {user.id}.")
+        return projects
+    except exceptions.TaigaRestException as e:
+        clog('error', f"Failed to get projects for user: {e}")
+        raise RuntimeError(f"Failed to get projects for user: {e}")
+
+if __name__ == "__main__":
+    try:
+        get_authenticated_user()
+        get_authenticated_user_projects()
+    except Exception as e:
+        clog('error', f"Error: {e}")

cmon2lib-0.0.1/cmon2lib/util.py

@@ -0,0 +1,11 @@
+def sum(a, b):
+    """Returns the sum of a and b."""
+    return a + b
+
+def subtract(a, b):
+    """Returns the difference of a and b."""
+    return a - b
+
+def multiply(a, b):
+    """Returns the product of a and b."""
+    return a * b

cmon2lib-0.0.1/cmon2lib/utils/cmon_logging.py

@@ -0,0 +1,17 @@
+import logging
+
+# Set up a harmonized logger for cmon2lib
+logger = logging.getLogger("cmon2lib")
+logger.setLevel(logging.INFO)  # Default level, can be changed by user
+handler = logging.StreamHandler()
+formatter = logging.Formatter('[cmon2lib] %(asctime)s %(levelname)s: %(message)s', datefmt='%Y-%m-%d %H:%M:%S')
+handler.setFormatter(formatter)
+if not logger.hasHandlers():
+    logger.addHandler(handler)
+
+def clog(level, msg, *args, **kwargs):
+    """Central logging gateway for cmon2lib. Usage: clog('info', 'message')"""
+    if hasattr(logger, level):
+        getattr(logger, level)(msg, *args, **kwargs)
+    else:
+        logger.info(msg, *args, **kwargs)

cmon2lib-0.0.1/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"
+
+[project]
+name = "cmon2lib"
+version = "0.0.1"
+authors = [
+    { name = "Simon Dorr", email = "simon@ich-bin-simon.de" }
+]
+description = "my personal python library for convenient personalized functionality"
+readme = "README.md"
+requires-python = ">=3.7"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = ["python-taiga (>=1.3.2,<2.0.0)"]
+
+[project.urls]
+"Homepage" = "https://github.com/cmon2/cmon2lib"
+
+[tool.setuptools.packages.find]
+include = ["cmon2lib", "cmon2lib.*"]
+
+[project.optional-dependencies]
+test = [
+    "pytest",
+    "pytest-cov"
+]
+
+[tool.pytest.ini_options]
+addopts = "--cov=cmon2lib --cov-report=xml --cov-report=term"
+testpaths = "tests"
+pythonpath = "."