pyOpenSourceProjects 0.1.2__tar.gz → 0.2.0__tar.gz

{pyopensourceprojects-0.1.2 → pyopensourceprojects-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pyOpenSourceProjects
-Version: 0.1.2
+Version: 0.2.0
 Dynamic: Summary
 Project-URL: Home, https://github.com/WolfgangFahl/pyOpenSourceProjects
 Project-URL: Documentation, http://wiki.bitplan.com/index.php/pyOpenSourceProjects
@@ -25,10 +25,11 @@ Description-Content-Type: text/markdown
 Helper Library to organize open source Projects
 
 [![pypi](https://img.shields.io/pypi/pyversions/pyOpenSourceProjects)](https://pypi.org/project/pyOpenSourceProjects/)
-[![Github Actions Build](https://github.com/WolfgangFahl/pyOpenSourceProjects/workflows/Build/badge.svg?branch=main)](https://github.com/WolfgangFahl/pyOpenSourceProjects/actions?query=workflow%3ABuild+branch%3Amain)
+[![Github Actions Build](https://github.com/WolfgangFahl/pyOpenSourceProjects/actions/workflows/build.yml/badge.svg)](https://github.com/WolfgangFahl/pyOpenSourceProjects/actions/workflows/build.yml)
 [![PyPI Status](https://img.shields.io/pypi/v/pyOpenSourceProjects.svg)](https://pypi.python.org/pypi/pyOpenSourceProjects/)
 [![GitHub issues](https://img.shields.io/github/issues/WolfgangFahl/pyOpenSourceProjects.svg)](https://github.com/WolfgangFahl/pyOpenSourceProjects/issues)
 [![GitHub closed issues](https://img.shields.io/github/issues-closed/WolfgangFahl/pyOpenSourceProjects.svg)](https://github.com/WolfgangFahl/pyOpenSourceProjects/issues/?q=is%3Aissue+is%3Aclosed)
+[![API Docs](https://img.shields.io/badge/API-Documentation-blue)](https://WolfgangFahl.github.io/pyOpenSourceProjects/)
 [![License](https://img.shields.io/github/license/WolfgangFahl/pyOpenSourceProjects.svg)](https://www.apache.org/licenses/LICENSE-2.0)
 
 

{pyopensourceprojects-0.1.2 → pyopensourceprojects-0.2.0}/README.md

@@ -2,10 +2,11 @@
 Helper Library to organize open source Projects
 
 [![pypi](https://img.shields.io/pypi/pyversions/pyOpenSourceProjects)](https://pypi.org/project/pyOpenSourceProjects/)
-[![Github Actions Build](https://github.com/WolfgangFahl/pyOpenSourceProjects/workflows/Build/badge.svg?branch=main)](https://github.com/WolfgangFahl/pyOpenSourceProjects/actions?query=workflow%3ABuild+branch%3Amain)
+[![Github Actions Build](https://github.com/WolfgangFahl/pyOpenSourceProjects/actions/workflows/build.yml/badge.svg)](https://github.com/WolfgangFahl/pyOpenSourceProjects/actions/workflows/build.yml)
 [![PyPI Status](https://img.shields.io/pypi/v/pyOpenSourceProjects.svg)](https://pypi.python.org/pypi/pyOpenSourceProjects/)
 [![GitHub issues](https://img.shields.io/github/issues/WolfgangFahl/pyOpenSourceProjects.svg)](https://github.com/WolfgangFahl/pyOpenSourceProjects/issues)
 [![GitHub closed issues](https://img.shields.io/github/issues-closed/WolfgangFahl/pyOpenSourceProjects.svg)](https://github.com/WolfgangFahl/pyOpenSourceProjects/issues/?q=is%3Aissue+is%3Aclosed)
+[![API Docs](https://img.shields.io/badge/API-Documentation-blue)](https://WolfgangFahl.github.io/pyOpenSourceProjects/)
 [![License](https://img.shields.io/github/license/WolfgangFahl/pyOpenSourceProjects.svg)](https://www.apache.org/licenses/LICENSE-2.0)
 
 

pyopensourceprojects-0.2.0/mkdocs.yml

@@ -0,0 +1,18 @@
+site_name: pyOpenSourceProjects API Documentation
+theme:
+  name: material
+plugins:
+  - search
+  - mkdocstrings:
+      handlers:
+        python:
+          setup_commands:
+            - import sys
+            - import os
+            - sys.path.insert(0, os.path.abspath("."))
+          selection:
+            docstring_style: google
+          rendering:
+            show_source: true
+nav:
+  - API: index.md

pyopensourceprojects-0.2.0/osprojects/__init__.py

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

pyopensourceprojects-0.2.0/osprojects/checkos.py

@@ -0,0 +1,138 @@
+#!/usr/bin/env python
+"""
+Created on 2024-07-30
+
+@author: wf
+"""
+from dataclasses import dataclass
+import argparse
+from argparse import Namespace
+import os
+from typing import List
+
+from osprojects.osproject import GitHub, OsProject
+
+@dataclass
+class Check:
+    ok: bool=False
+    msg: str=""
+
+    @property
+    def marker(self) -> str:
+        return f"✅" if self.ok else f"❌"
+
+class CheckOS:
+    """
+    check the open source projects
+    """
+
+    def __init__(self, args:Namespace,project:OsProject):
+        self.args=args
+        self.verbose= args.verbose
+        self.workspace = args.workspace
+        self.project=project
+        self.project_path = os.path.join(self.workspace, project.id)
+
+
+    def check_local(self)->Check:
+        local=Check(ok=os.path.exists(self.project_path),msg=f"{self.project_path}")
+        return local
+
+    def check_readme(self) -> List[Check]:
+        checks=[]
+        readme_path = os.path.join(self.project_path, "README.md")
+        readme_exists=Check(ok=os.path.exists(readme_path),msg=readme_path)
+        checks.append(readme_exists)
+        if readme_exists.ok:
+            with open(readme_path, "r") as readme_file:
+                readme_content = readme_file.read()
+                badge_lines = [
+                "[![pypi](https://img.shields.io/pypi/pyversions/{self.project.id})](https://pypi.org/project/{self.project.id}/)",
+                "[![Github Actions Build](https://github.com/{self.project.fqid}/actions/workflows/build.yml/badge.svg)](https://github.com/{self.project.fqid}/actions/workflows/build.yml)",
+                "[![PyPI Status](https://img.shields.io/pypi/v/{self.project.id}.svg)](https://pypi.python.org/pypi/{self.project.id}/)",
+                "[![GitHub issues](https://img.shields.io/github/issues/{self.project.fqid}.svg)](https://github.com/{self.project.fqid}/issues)",
+                "[![GitHub closed issues](https://img.shields.io/github/issues-closed/{self.project.fqid}.svg)](https://github.com/{self.project.fqid}/issues/?q=is%3Aissue+is%3Aclosed)",
+                "[![API Docs](https://img.shields.io/badge/API-Documentation-blue)](https://{self.project.owner}.github.io/{self.project.id}/)",
+                "[![License](https://img.shields.io/github/license/{self.project.fqid}.svg)](https://www.apache.org/licenses/LICENSE-2.0)"
+            ]
+            for line in badge_lines:
+                formatted_line = line.format(self=self)
+                checks.append(Check(ok=formatted_line in readme_content, msg=formatted_line))
+
+
+        return checks
+
+    def check(self) -> List[Check]:
+        """
+        Check the given project and print results
+        """
+        checks = []
+        checks.append(self.check_local())
+        checks.extend(self.check_readme())
+        total=len(checks)
+        ok_checks = [check for check in checks if check.ok]
+        failed_checks = [check for check in checks if not check.ok]
+        #ok_count=len(ok_checks)
+        failed_count=len(failed_checks)
+        summary=f"❌ {failed_count}/{total}" if failed_count>0 else "✅"
+        print(f"{self.project} {summary}: {self.project.url}")
+        if failed_count>0:
+            sorted_checks = ok_checks + failed_checks if self.verbose else failed_checks
+
+            for i,check in enumerate(sorted_checks):
+                print(f"    {i+1:3}{check.marker}:{check.msg}")
+            return checks
+
+def main(_argv=None):
+    """
+    main command line entry point
+    """
+    parser = argparse.ArgumentParser(description="Check open source projects")
+    parser.add_argument(
+        "-o", "--owner", help="project owner or organization", required=True
+    )
+    parser.add_argument("-p", "--project", help="name of the project")
+    parser.add_argument("-l", "--language", help="filter projects by language")
+    parser.add_argument(
+        "--local", action="store_true", help="check only locally available projects"
+    )
+    parser.add_argument(
+        "-v","--verbose", action="store_true", help="show verbose output"
+    )
+    parser.add_argument(
+        "-ws",
+        "--workspace",
+        help="(Eclipse) workspace directory",
+        default=os.path.expanduser("~/py-workspace"),
+    )
+
+    args = parser.parse_args(args=_argv)
+
+    github = GitHub()
+    if args.project:
+        # Check specific project
+        projects = [
+            github.list_projects_as_os_projects(args.owner, project_name=args.project)
+        ]
+    else:
+        # Check all projects
+        projects = github.list_projects_as_os_projects(args.owner)
+
+    if args.language:
+        projects = [p for p in projects if p.language == args.language]
+
+    if args.local:
+        local_projects = []
+        for project in projects:
+            checker = CheckOS(args=args,project=project)
+            if checker.check_local().ok:
+                local_projects.append(project)
+        projects=local_projects
+
+
+    for project in projects:
+        checker = CheckOS(args=args,project=project)
+        checker.check()
+
+if __name__ == "__main__":
+    main()

{pyopensourceprojects-0.1.2 → pyopensourceprojects-0.2.0}/osprojects/osproject.py

@@ -3,15 +3,17 @@ Created on 2022-01-24
 
 @author: wf
 """
+
 from __future__ import annotations
-import os
+
 import argparse
 import datetime
 import json
+import os
 import re
 import subprocess
 import sys
-from typing import List, Type
+from typing import List, Optional, Type
 
 import requests
 from dateutil.parser import parse
@@ -55,23 +57,26 @@ class GitHub(TicketSystem):
     """
     wrapper for the GitHub api
     """
+
     @classmethod
-    def load_access_token(cls)->str:
+    def load_access_token(cls) -> str:
         """
         if $HOME/.github/access_token.json exists read the token from there
         """
         # Specify the path to the access token file
-        token_file_path = os.path.join(os.getenv('HOME'), '.github', 'access_token.json')
-        
+        token_file_path = os.path.join(
+            os.getenv("HOME"), ".github", "access_token.json"
+        )
+
         # Check if the file exists and read the token
         if os.path.exists(token_file_path):
-            with open(token_file_path, 'r') as token_file:
+            with open(token_file_path, "r") as token_file:
                 token_data = json.load(token_file)
-                return token_data.get('access_token')
-        
+                return token_data.get("access_token")
+
         # Return None if no token file is found
         return None
-    
+
     @classmethod
     def prepare_headers(cls, access_token: str = None) -> dict:
         """
@@ -80,15 +85,108 @@ class GitHub(TicketSystem):
         if access_token is None:
             access_token = cls.load_access_token()
 
-        headers = {'Authorization': f'token {access_token}'} if access_token else {}
+        headers = {"Authorization": f"token {access_token}"} if access_token else {}
         return headers
 
     @classmethod
-    def getIssues(cls, 
-        project: OsProject, 
-        access_token:str=None,
-        limit: int = None,
-        **params) -> List[Ticket]:
+    def list_projects_as_os_projects(
+        cls, owner: str, access_token: str = None, project_name: Optional[str] = None
+    ) -> List[OsProject]:
+        """
+        List all public repositories for a given owner and return them as OsProject instances.
+
+        Args:
+            owner (str): The GitHub username or organization name.
+            access_token (str, optional): GitHub personal access token for authentication.
+            project_name (str, optional): If provided, return only this specific project.
+
+        Returns:
+            List[OsProject]: A list of OsProject instances representing the repositories.
+        """
+        headers = cls.prepare_headers(access_token)
+
+        if project_name:
+            url = f"https://api.github.com/repos/{owner}/{project_name}"
+            response = requests.get(url, headers=headers)
+            if response.status_code != 200:
+                raise Exception(
+                    f"Failed to fetch repository: {response.status_code} - {response.text}"
+                )
+            repos = [response.json()]
+        else:
+            url = f"https://api.github.com/users/{owner}/repos"
+            params = {
+                "type": "all",
+                "per_page": 100,
+            }  # Include all repo types, 100 per page
+            all_repos = []
+            page = 1
+
+            while True:
+                params["page"] = page
+                response = requests.get(url, headers=headers, params=params)
+
+                if response.status_code != 200:
+                    raise Exception(
+                        f"Failed to fetch repositories: {response.status_code} - {response.text}"
+                    )
+
+                repos = response.json()
+                if not repos:
+                    break  # No more repositories to fetch
+
+                all_repos.extend(repos)
+                page += 1
+
+            repos = all_repos
+
+        return [
+            OsProject(
+                owner=owner,
+                id=repo["name"],
+                ticketSystem=cls,
+                title=repo["name"],
+                url=repo["html_url"],
+                description=repo["description"],
+                language=repo["language"],
+                created_at=datetime.datetime.fromisoformat(
+                    repo["created_at"].rstrip("Z")
+                ),
+                updated_at=datetime.datetime.fromisoformat(
+                    repo["updated_at"].rstrip("Z")
+                ),
+                stars=repo["stargazers_count"],
+                forks=repo["forks_count"],
+            )
+            for repo in repos
+        ]
+
+    @classmethod
+    def get_project(
+        cls, owner: str, project_id: str, access_token: str = None
+    ) -> OsProject:
+        """
+        Get a specific project as an OsProject instance.
+
+        Args:
+            owner (str): The GitHub username or organization name.
+            project_id (str): The name of the project.
+            access_token (str, optional): GitHub personal access token for authentication.
+
+        Returns:
+            OsProject: An OsProject instance representing the repository.
+        """
+        projects = cls.list_projects_as_os_projects(
+            owner, access_token, project_name=project_id
+        )
+        if projects:
+            return projects[0]
+        raise Exception(f"Project {owner}/{project_id} not found")
+
+    @classmethod
+    def getIssues(
+        cls, project: OsProject, access_token: str = None, limit: int = None, **params
+    ) -> List[Ticket]:
         payload = {}
         headers = cls.prepare_headers(access_token)
         issues = []
@@ -104,20 +202,24 @@ class GitHub(TicketSystem):
                 data=payload,
                 params=params,
             )
-            if response.status_code == 403 and 'rate limit' in response.text:
+            if response.status_code == 403 and "rate limit" in response.text:
                 raise Exception("rate limit - you might want to use an access token")
             issue_records = json.loads(response.text)
             for record in issue_records:
                 tr = {
                     "project": project,
                     "title": record.get("title"),
-                    "body": record.get("body", ""),  
-                    "createdAt": parse(record.get("created_at"))
-                    if record.get("created_at")
-                    else "",
-                    "closedAt": parse(record.get("closed_at"))
-                    if record.get("closed_at")
-                    else "",
+                    "body": record.get("body", ""),
+                    "createdAt": (
+                        parse(record.get("created_at"))
+                        if record.get("created_at")
+                        else ""
+                    ),
+                    "closedAt": (
+                        parse(record.get("closed_at"))
+                        if record.get("closed_at")
+                        else ""
+                    ),
                     "state": record.get("state"),
                     "number": record.get("number"),
                     "url": f"{cls.projectUrl(project)}/issues/{record.get('number')}",
@@ -126,7 +228,7 @@ class GitHub(TicketSystem):
                 fetched_count += 1
                 # Check if we have reached the limit
                 if limit is not None and fetched_count >= limit:
-                    nextResults=False
+                    nextResults = False
                     break
 
             if len(issue_records) < 100:
@@ -134,9 +236,11 @@ class GitHub(TicketSystem):
             else:
                 params["page"] += 1
         return issues
-    
+
     @classmethod
-    def getComments(cls, project: OsProject, issue_number: int, access_token: str = None) -> List[dict]:
+    def getComments(
+        cls, project: OsProject, issue_number: int, access_token: str = None
+    ) -> List[dict]:
         """
         Fetch all comments for a specific issue number from GitHub.
         """
@@ -146,7 +250,9 @@ class GitHub(TicketSystem):
         if response.status_code == 200:
             return response.json()
         else:
-            raise Exception(f"Failed to fetch comments: {response.status_code} - {response.text}")
+            raise Exception(
+                f"Failed to fetch comments: {response.status_code} - {response.text}"
+            )
         return []
 
     @staticmethod
@@ -160,7 +266,7 @@ class GitHub(TicketSystem):
     @staticmethod
     def commitUrl(project: OsProject, id: str):
         return f"{GitHub.projectUrl(project)}/commit/{id}"
-    
+
     @staticmethod
     def commentUrl(project: OsProject, issue_number: int):
         """
@@ -168,7 +274,6 @@ class GitHub(TicketSystem):
         """
         return f"https://api.github.com/repos/{project.owner}/{project.id}/issues/{issue_number}/comments"
 
-
     @staticmethod
     def resolveProjectUrl(url: str) -> (str, str):
         """
@@ -201,29 +306,53 @@ class OsProject(object):
         self,
         owner: str = None,
         id: str = None,
-        ticketSystem: Type[TicketSystem] = GitHub,
+        ticketSystem: Type[TicketSystem] = None,
+        title: str = None,
+        url: str = None,
+        description: str = None,
+        language: str = None,
+        created_at: datetime.datetime = None,
+        updated_at: datetime.datetime = None,
+        stars: int = 0,
+        forks: int = 0,
     ):
         """
         Constructor
         """
         self.owner = owner
         self.id = id
-        self.ticketSystem = ticketSystem
+        self.ticketSystem = ticketSystem or GitHub
+        self.title = title
+        self.url = url
+        self.description = description
+        self.language = language
+        self.created_at = created_at
+        self.updated_at = updated_at
+        self.stars = stars
+        self.forks = forks
+
+    @property
+    def fqid(self):
+        fqid=f"{self.owner}/{self.id}"
+        return fqid
+
+    def __str__(self):
+        return self.fqid
 
     @staticmethod
     def getSamples():
         samples = [
             {
                 "id": "pyOpenSourceProjects",
-                "state": "",
                 "owner": "WolfgangFahl",
                 "title": "pyOpenSourceProjects",
                 "url": "https://github.com/WolfgangFahl/pyOpenSourceProjects",
-                "version": "",
-                "desciption": "Helper Library to organize open source Projects",
-                "date": datetime.datetime(year=2022, month=1, day=24),
-                "since": "",
-                "until": "",
+                "description": "Helper Library to organize open source Projects",
+                "language": "Python",
+                "created_at": datetime.datetime(year=2022, month=1, day=24),
+                "updated_at": datetime.datetime(year=2022, month=1, day=24),
+                "stars": 5,
+                "forks": 2,
             }
         ]
         return samples
@@ -235,8 +364,7 @@ class OsProject(object):
         """
         url = subprocess.check_output(["git", "config", "--get", "remote.origin.url"])
         url = url.decode().strip("\n")
-        osProject = cls.fromUrl(url)
-        return osProject
+        return cls.fromUrl(url)
 
     @classmethod
     def fromUrl(cls, url: str) -> OsProject:
@@ -244,9 +372,11 @@ class OsProject(object):
         Init OsProject from given url
         """
         if "github.com" in url:
-            owner, project = GitHub.resolveProjectUrl(url)
-            if owner and project:
-                return OsProject(owner=owner, id=project, ticketSystem=GitHub)
+            owner, project_id = GitHub.resolveProjectUrl(url)
+            if owner and project_id:
+                github = GitHub()
+                project = github.get_project(owner, project_id)
+                return project
         raise Exception(f"Could not resolve the url '{url}' to a OsProject object")
 
     def getIssues(self, **params) -> list:
@@ -254,14 +384,14 @@ class OsProject(object):
         tickets.sort(key=lambda r: getattr(r, "number"), reverse=True)
         return tickets
 
-    def getAllTickets(self, limit:int=None,**params):
+    def getAllTickets(self, limit: int = None, **params):
         """
         Get all Tickets of the project -  closed and open ones
-        
+
         Args:
             limit(int): if set limit the number of tickets retrieved
         """
-        issues= self.getIssues(state="all",limit=limit, **params)
+        issues = self.getIssues(state="all", limit=limit, **params)
         return issues
 
     def getCommits(self) -> List[Commit]:

{pyopensourceprojects-0.1.2 → pyopensourceprojects-0.2.0}/pyproject.toml

@@ -44,10 +44,13 @@ path = "osprojects/__init__.py"
 test = []
 
 [tool.hatch.build.targets.wheel]
-packages = [
-  "osprojects",
-]
+only-include = ["osprojects"]
+
+[tool.hatch.build.targets.wheel.sources]
+"osprojects" = "osprojects"
+
 
 [project.scripts]
 issue2ticket = "osprojects.osproject:main"
 gitlog2wiki = "osprojects.osproject:gitlog2wiki"
+checkos = "osprojects.checkos:main"

pyopensourceprojects-0.2.0/scripts/doc

@@ -0,0 +1,88 @@
+#!/bin/bash
+# create docs for a configurable project
+# WF 2024-07-30 - updated
+
+# Extract project name from pyproject.toml
+PROJECT_NAME=$(grep "\[project\]" pyproject.toml -A1 | grep name | cut -d '=' -f2 | tr -d ' "')
+PACKAGE_NAME=$(grep "\[tool.hatch.build.targets.wheel.sources\]" pyproject.toml -A1 | tail -1 | cut -d '=' -f2 | tr -d ' "')
+
+
+# Function to print usage information
+print_usage() {
+    echo "Usage: $0 [OPTIONS]"
+    echo "Options:"
+    echo "  -pr, --project NAME    Set the project name (default: $PROJECT_NAME)"
+    echo "  -pa, --package NAME    Set the package name (default: $PACKAGE_NAME)"
+    echo "  -d, --deploy          Deploy the documentation after building"
+    echo "  -h, --help            Display this help message"
+}
+
+# Parse command line arguments
+DEPLOY=false
+while [[ "$#" -gt 0 ]]; do
+    case $1 in
+        -pr|--project) PROJECT_NAME="$2"; shift ;;
+        -pa|--package) PACKAGE_NAME="$2"; shift ;;
+        -d|--deploy) DEPLOY=true ;;
+        -h|--help) print_usage; exit 0 ;;
+        *) echo "Unknown parameter: $1"; print_usage; exit 1 ;;
+    esac
+    shift
+done
+
+# Ensure we're in the correct directory
+if [[ ! -d "$PACKAGE_NAME" ]]; then
+    echo "Error: $PACKAGE_NAME package directory not found. Are you in the correct directory?"
+    exit 1
+fi
+
+# Check if mkdocs is installed
+if ! command -v mkdocs &> /dev/null; then
+    pip install mkdocs mkdocs-material mkdocstrings[python]
+fi
+
+# Create or update mkdocs.yml
+cat << EOF > mkdocs.yml
+site_name: $PROJECT_NAME API Documentation
+theme:
+  name: material
+plugins:
+  - search
+  - mkdocstrings:
+      handlers:
+        python:
+          setup_commands:
+            - import sys
+            - import os
+            - sys.path.insert(0, os.path.abspath("."))
+          selection:
+            docstring_style: google
+          rendering:
+            show_source: true
+nav:
+  - API: index.md
+EOF
+
+# Create or update index.md
+index_md=docs/index.md
+mkdir -p docs
+cat << EOF > $index_md
+# $PROJECT_NAME API Documentation
+
+::: $PACKAGE_NAME
+    options:
+      show_submodules: true
+EOF
+
+# Ignore DeprecationWarnings during build
+export PYTHONWARNINGS="ignore::DeprecationWarning"
+
+# Build the documentation
+mkdocs build --config-file ./mkdocs.yml
+
+# Deploy if requested
+if [ "$DEPLOY" = true ]; then
+    mkdocs gh-deploy --force --config-file ./mkdocs.yml
+fi
+
+echo "Documentation process completed for $PROJECT_NAME."

{pyopensourceprojects-0.1.2 → pyopensourceprojects-0.2.0}/tests/basetest.py

@@ -3,6 +3,7 @@ Created on 2021-08-19
 
 @author: wf
 """
+
 import getpass
 import io
 import os

{pyopensourceprojects-0.1.2 → pyopensourceprojects-0.2.0}/tests/test_osproject.py

@@ -3,6 +3,7 @@ Created on 2022-01-24
 
 @author: wf
 """
+
 import unittest
 
 from osprojects.osproject import Commit, GitHub, OsProject, Ticket, gitlog2wiki, main
@@ -23,7 +24,7 @@ class TestOsProject(BaseTest):
         expectedTicket = self.getSampleById(Ticket, "number", 2)
         expectedTicket.project = osProject
         comparison_ticket_dict = tickets[-2].__dict__
-        comparison_ticket_dict.pop('body', None)
+        comparison_ticket_dict.pop("body", None)
         self.assertDictEqual(expectedTicket.__dict__, comparison_ticket_dict)
         commit = Commit()
         ticket = Ticket()
@@ -102,6 +103,76 @@ class TestGitHub(BaseTest):
                 self.assertEqual(expectedOwner, owner)
                 self.assertEqual(expectedProject, project)
 
+    def testListProjects(self):
+        """
+        tests the list_projects_as_os_projects method
+        """
+        owner = "WolfgangFahl"
+        github = GitHub()
+
+        # Test list_projects_as_os_projects
+        projects = github.list_projects_as_os_projects(owner)
+        debug = self.debug
+        debug = True
+        if debug:
+            for project in projects:
+                print(project)
+        self.assertIsInstance(projects, list)
+        self.assertTrue(len(projects) > 0, "No projects found for WolfgangFahl")
+
+        # Check if pyOpenSourceProjects is in the list
+        pyosp_found = any(project.id == "pyOpenSourceProjects" for project in projects)
+        self.assertTrue(
+            pyosp_found, "pyOpenSourceProjects not found in the list of projects"
+        )
+
+        # Test a sample project's structure
+        sample_project = projects[0]
+        expected_attributes = {
+            "id",
+            "owner",
+            "title",
+            "url",
+            "description",
+            "language",
+            "created_at",
+            "updated_at",
+            "stars",
+            "forks",
+        }
+        self.assertTrue(
+            all(hasattr(sample_project, attr) for attr in expected_attributes),
+            "OsProject instance is missing expected attributes",
+        )
+
+        # Check if all items are OsProject instances
+        self.assertTrue(
+            all(isinstance(project, OsProject) for project in projects),
+            "Not all items are OsProject instances",
+        )
+
+        # Test a sample OsProject
+        sample_os_project = projects[0]
+        self.assertEqual(sample_os_project.owner, owner)
+        self.assertIsInstance(sample_os_project.id, str)
+        self.assertEqual(sample_os_project.ticketSystem, GitHub)
+
+    def testGetSpecificProject(self):
+        """
+        tests getting a specific project
+        """
+        owner = "WolfgangFahl"
+        project_name = "pyOpenSourceProjects"
+        github = GitHub()
+
+        project = github.list_projects_as_os_projects(owner, project_name=project_name)[
+            0
+        ]
+        self.assertIsInstance(project, OsProject)
+        self.assertEqual(project.id, project_name)
+        self.assertEqual(project.owner, owner)
+        self.assertEqual(project.ticketSystem, GitHub)
+
 
 class TestCommit(BaseTest):
     """

pyopensourceprojects-0.1.2/osprojects/__init__.py

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

pyopensourceprojects-0.1.2/scripts/doc

@@ -1,88 +0,0 @@
-#!/bin/bash
-# WF 2020-01-31
-
-#
-# check whether the given command is installed
-#
-checkinstalled() {
-  local l_cmd="$1"
-  which $l_cmd > /dev/null
-  if [ $? -ne 0 ]
-  then
-    echo "$l_cmd need to be installed" 1>&2
-    exit 1
-  fi
-}
-
-fixconf() {
-  local l_year="$1"
-  local l_author="$2"
-  conf=conf.py
-  # fix sys path
-  # https://stackoverflow.com/questions/10324393/sphinx-build-fail-autodoc-cant-import-find-module
-  grep "# sys.path" $conf
-  if [ $? -eq 0 ]
-  then
-    tmpconf=/tmp/conf$$.py
-    cat $conf | awk -v author="$l_author" -v year="$l_year" '
-    BEGIN {
-      quote="\x27"
-      squote="\047"
-    }
-    /# import os/ { next }
-    /# import sys/ { next }
-    /copyright/ {
-      printf "copyright = %s%s, %s%s\n",squote,year,author,squote
-      next
-    }
-    /author/ {
-      printf "author = %s%s%s\n",squote,author,squote
-      next
-    }
-    /html_theme = / {
-      # html_theme = 'alabaster'
-      printf "html_theme = %ssphinx_rtd_theme%s\n",squote,squote
-      printf "master_doc = %sindex%s\n",squote,squote
-      next
-    }
-    # add sphinx_rtd extension
-    /extensions = / {
-      print $0
-      printf "\t%ssphinx_rtd_theme%s,\n",squote,squote
-      printf "\t%ssphinx.ext.napoleon%s,\n",squote,squote
-      next
-    }
-    /# sys.path/ {
-      print("#https://stackoverflow.com/a/44980548/1497139")
-      print("import os")
-      print("import sys")
-      print("import sphinx_rtd_theme")
-      printf("basepath=os.path.abspath(%s../..%s)\n",squote,squote)
-      printf("print(%sadding basepath %%s%s %% (basepath))\n",squote,squote)
-      print("sys.path.insert(0, basepath)")
-      printf("print(%ssys.path is now: %%s%s %% (sys.path))\n",squote,squote)
-      next
-    }
-    { print }
-    END {
-      print ("#additional settings")
-      print ("#https://stackoverflow.com/a/5599712/1497139")
-      print ("autoclass_content = '\''both'\''")
-    }' > $tmpconf
-    #diff $tmpconf $conf
-    mv $tmpconf $conf
-    echo "$src/conf.py has been fixed"
-  fi
-}
-
-src=docs/source
-checkinstalled  sphinx-apidoc
-sphinx-apidoc --full -f -o $src .
-cd $src
-
-fixconf 2020-2021 "Wolfgang Fahl"
-make clean html
-if [ "$GHACTIONS" != "ACTIVE" ]
-then
-  open _build/html/index.html
-fi