python-jira-plus 0.1.0__tar.gz

python_jira_plus-0.1.0/LICENSE

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

python_jira_plus-0.1.0/MANIFEST.in

@@ -0,0 +1,2 @@
+include README.md
+include LICENSE

python_jira_plus-0.1.0/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: python-jira-plus
+Version: 0.1.0
+Summary: Enhanced Python client for JIRA with better error handling, pagination, and metadata validation
+Home-page: https://github.com/yourusername/python-jira-plus
+Author: Avi Zaguri
+Author-email: 
+Project-URL: Repository, https://github.com/aviz92/python-jira-plus
+Keywords: jira,atlassian,api,client
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: jira>=3.1.1
+Requires-Dist: retrying>=1.3.3
+Requires-Dist: python-jira-plus>=0.1.4
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Python JIRA Plus
+
+[![PyPI version](https://badge.fury.io/py/python-jira-plus.svg)](https://badge.fury.io/py/python-jira-plus)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+An enhanced Python client for JIRA that extends the functionality of the official `jira` package, providing better error handling, pagination, metadata validation, and more.
+
+---
+
+## Features
+- ✅ Simplified connection to JIRA Cloud and On-Premise instances
+- ✅ Robust error handling with automatic retries
+- ✅ Built-in pagination for large result sets
+- ✅ Field validation against JIRA metadata
+- ✅ Enhanced issue creation, retrieval, and updating
+- ✅ Support for allowed values validation
+
+---
+
+## Installation
+```bash
+pip install python-jira-plus
+```
+
+---
+
+## Requirements
+- Python 3.9+
+- `jira` package
+- `retrying` package
+- `custom-python-logger` package
+
+---
+
+## Configuration
+The package uses environment variables for authentication and configuration:
+
+```bash
+# Required environment variables
+JIRA_USER_NAME=your_jira_username
+JIRA_TOKEN=your_jira_api_token
+JIRA_BASE_URL=your-instance.atlassian.net  # Only used if base_url is not provided to constructor
+```
+
+## Examples
+
+### Creating an Issue with Custom Fields
+```python
+from python_jira_plus.jira_plus import JiraPlus
+
+jira_client = JiraPlus()
+issue = jira_client.create_issue(
+    project_key="PROJ",
+    summary="Implement new feature",
+    description="This feature will improve performance",
+    issue_type="Task",
+    custom_fields={
+        "priority": "Critical",  # Priority
+        "customfield_10003": {"name": "Sprint 1"}  # Sprint
+    }
+)
+```
+
+### Searching for Issues
+```python
+from python_jira_plus.jira_plus import JiraPlus
+
+jira_client = JiraPlus()
+issues = jira_client.get_objects_by_query(
+    query="project = PROJ AND status = 'In Progress' ORDER BY created DESC",
+    max_results=50,
+    specific_fields=["summary", "status", "assignee"],
+    json_result=False
+)
+
+for issue in issues:
+    print(f"{issue.key}: {issue.fields.summary} - {issue.fields.status.name}")
+```
+
+### Updating an Issue
+```python
+from python_jira_plus.jira_plus import JiraPlus
+
+jira_client = JiraPlus()
+issue = jira_client.get_issue_by_key(key="PROJ-123", json_result=False)
+
+fields_to_update = {
+    "summary": "Updated summary",
+    "description": "Updated description",
+    "customfield_10003": {"name": "Sprint 2"},  # Update Sprint
+}
+_ = jira_client.update_issue(
+    issue_key=issue.key,
+    fields_to_update=fields_to_update
+)
+```
+
+---
+
+## 🤝 Contributing
+If you have a helpful tool, pattern, or improvement to suggest:
+Fork the repo
+Create a new branch
+Submit a pull request
+I welcome additions that promote clean, productive, and maintainable development.
+
+---
+
+## 🙏 Thanks
+Thanks for exploring this repository!
+Happy coding!

python_jira_plus-0.1.0/README.md

@@ -0,0 +1,111 @@
+# Python JIRA Plus
+
+[![PyPI version](https://badge.fury.io/py/python-jira-plus.svg)](https://badge.fury.io/py/python-jira-plus)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+An enhanced Python client for JIRA that extends the functionality of the official `jira` package, providing better error handling, pagination, metadata validation, and more.
+
+---
+
+## Features
+- ✅ Simplified connection to JIRA Cloud and On-Premise instances
+- ✅ Robust error handling with automatic retries
+- ✅ Built-in pagination for large result sets
+- ✅ Field validation against JIRA metadata
+- ✅ Enhanced issue creation, retrieval, and updating
+- ✅ Support for allowed values validation
+
+---
+
+## Installation
+```bash
+pip install python-jira-plus
+```
+
+---
+
+## Requirements
+- Python 3.9+
+- `jira` package
+- `retrying` package
+- `custom-python-logger` package
+
+---
+
+## Configuration
+The package uses environment variables for authentication and configuration:
+
+```bash
+# Required environment variables
+JIRA_USER_NAME=your_jira_username
+JIRA_TOKEN=your_jira_api_token
+JIRA_BASE_URL=your-instance.atlassian.net  # Only used if base_url is not provided to constructor
+```
+
+## Examples
+
+### Creating an Issue with Custom Fields
+```python
+from python_jira_plus.jira_plus import JiraPlus
+
+jira_client = JiraPlus()
+issue = jira_client.create_issue(
+    project_key="PROJ",
+    summary="Implement new feature",
+    description="This feature will improve performance",
+    issue_type="Task",
+    custom_fields={
+        "priority": "Critical",  # Priority
+        "customfield_10003": {"name": "Sprint 1"}  # Sprint
+    }
+)
+```
+
+### Searching for Issues
+```python
+from python_jira_plus.jira_plus import JiraPlus
+
+jira_client = JiraPlus()
+issues = jira_client.get_objects_by_query(
+    query="project = PROJ AND status = 'In Progress' ORDER BY created DESC",
+    max_results=50,
+    specific_fields=["summary", "status", "assignee"],
+    json_result=False
+)
+
+for issue in issues:
+    print(f"{issue.key}: {issue.fields.summary} - {issue.fields.status.name}")
+```
+
+### Updating an Issue
+```python
+from python_jira_plus.jira_plus import JiraPlus
+
+jira_client = JiraPlus()
+issue = jira_client.get_issue_by_key(key="PROJ-123", json_result=False)
+
+fields_to_update = {
+    "summary": "Updated summary",
+    "description": "Updated description",
+    "customfield_10003": {"name": "Sprint 2"},  # Update Sprint
+}
+_ = jira_client.update_issue(
+    issue_key=issue.key,
+    fields_to_update=fields_to_update
+)
+```
+
+---
+
+## 🤝 Contributing
+If you have a helpful tool, pattern, or improvement to suggest:
+Fork the repo
+Create a new branch
+Submit a pull request
+I welcome additions that promote clean, productive, and maintainable development.
+
+---
+
+## 🙏 Thanks
+Thanks for exploring this repository!
+Happy coding!

python_jira_plus-0.1.0/pyproject.toml

@@ -0,0 +1,11 @@
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.black]
+line-length = 100
+target-version = ["py39", "py310", "py311"]
+
+[tool.isort]
+profile = "black"
+line_length = 100

python_jira_plus-0.1.0/python_jira_plus/__init__.py

@@ -0,0 +1,35 @@
+# python-jira-plus
+
+"""
+Python JIRA Plus
+
+An enhanced Python client for JIRA with better error handling,
+pagination, metadata validation, and more.
+"""
+
+__version__ = '0.1.0'
+
+from dotenv import load_dotenv
+load_dotenv()
+
+from python_jira_plus.jira_plus import JiraPlus, ServerType
+from python_jira_plus.describe_allowed_value import describe_allowed_value
+
+load_dotenv()
+
+BASIC_FIELDS = [
+    'created',
+    'updated',
+    'issuetype',
+    'project',
+    'status',
+    'summary',
+    'description',
+    'reporter',
+    'assignee',
+    'priority',
+    'labels',
+    'resolution',
+    'parent'
+]
+__all__ = ['JiraPlus', 'ServerType', 'BASIC_FIELDS']

python_jira_plus-0.1.0/python_jira_plus/describe_allowed_value.py

@@ -0,0 +1,38 @@
+# describe_allowed_value.py
+
+from functools import singledispatch
+
+
+@singledispatch
+def describe_allowed_value(value, allowed_values: set = None):
+    raise NotImplementedError(f"cannot describe this object of type {type(value)}")
+
+
+@describe_allowed_value.register
+def _(value: int, allowed_values: list = None):
+    return value == allowed_values
+
+
+@describe_allowed_value.register
+def _(value: float, allowed_values: list = None):
+    return value == allowed_values
+
+
+@describe_allowed_value.register
+def _(value: str, allowed_values: list = None):
+    return value == allowed_values
+
+
+@describe_allowed_value.register
+def _(value: list, allowed_values: list = None):
+    return any(v in allowed_values for v in value)
+
+
+@describe_allowed_value.register
+def _(value: set, allowed_values: list = None):
+    return any(v in allowed_values for v in value)
+
+
+@describe_allowed_value.register
+def _(value: dict, allowed_values: list = None):
+    return any(v in allowed_values for v in value.values())

python_jira_plus-0.1.0/python_jira_plus/jira_plus.py

@@ -0,0 +1,314 @@
+# jira_plus.py
+
+import json
+import logging
+import os
+import time
+from enum import Enum
+from typing import Any, Union, Optional
+from jira import JIRA, JIRAError, Issue
+from jira.client import ResultList
+from retrying import retry
+
+from python_jira_plus.describe_allowed_value import describe_allowed_value
+
+
+class ServerType(Enum):
+    CLOUD = 'cloud'
+    ON_PREMISE = 'on_premise'
+
+
+class JiraPlus:
+    def __init__(
+        self, base_url: Optional[str] = None,
+        server_type: ServerType = ServerType.CLOUD,
+        urllib3_log_level: int = logging.WARNING
+    ) -> None:
+        self.logger = logging.getLogger()
+        logging.getLogger("urllib3").setLevel(urllib3_log_level)
+
+        self.jira_username = os.getenv('JIRA_USER_NAME')
+        self.jira_token = os.getenv('JIRA_TOKEN')
+
+        if not base_url:
+            self.base_url = os.getenv('JIRA_BASE_URL')
+
+        self.server_type = server_type
+        self.server = f'https://{self.base_url}'
+
+        self.jira_client = self.create_connection()
+        self.check_client_connection()
+
+    @retry(stop_max_attempt_number=3,
+           wait_fixed=180000)  # Retry 3 times with a 3-min (180000) delay between each attempt
+    def create_connection(self) -> Optional[JIRA]:
+        jira_client = JIRA(
+            basic_auth=(self.jira_username, self.jira_token),
+            options={'server': self.server},
+            timeout=580
+        )
+
+        if jira_client.projects():
+            self.logger.info(f"Jira Connection Successful")
+            return jira_client
+        else:
+            self.logger.error(f"Jira Connection Failed")
+            raise JIRAError("Jira Connection Failed")
+
+    def close_connection(self) -> None:
+        try:
+            self.jira_client.close()
+        except JIRAError as err:
+            self.logger.exception(f"JIRAError \n{err}")
+        except Exception as err:
+            self.logger.exception(f"Exception \n{err}")
+
+        self.check_client_connection()
+
+    def check_client_connection(self) -> bool:
+        try:
+            if self.jira_client.projects():
+                return True
+            else:
+                self.logger.info("Jira client is closed")
+                return False
+        except JIRAError as err:
+            self.logger.exception(f"JIRAError \n{err}")
+            return False
+        except Exception as err:
+            self.logger.exception(f"Exception \n{err}")
+            return False
+
+    def get_issue_by_key(
+        self,
+        key: str,
+        specific_fields: str | list[str] = '*all',
+        json_result: bool = True
+    ) -> None | Issue | dict[str, Any]:
+        try:
+            jira_issue = self.jira_client.issue(id=key, fields=specific_fields)
+            if json_result:
+                return jira_issue.raw
+            return jira_issue
+        except JIRAError as err:
+            self.logger.exception(f"JIRAError \n{err}")
+            return None
+        except Exception as err:
+            self.logger.exception(f"Exception \n{err}")
+            return None
+
+    def get_objects_by_query(
+        self,
+        query: str,
+        max_results: int = 5000,
+        specific_fields: Union[str, list[str]] = "*all",
+        jira_err_count: int = 3,
+        json_result: bool = True,
+    ) -> Optional[Union[ResultList[Issue], dict]]:
+        return self._paginate_query(
+            query=query,
+            max_results=max_results,
+            specific_fields=specific_fields,
+            jira_err_limit=jira_err_count,
+            json_result=json_result,
+        )
+
+    def _paginate_query(
+        self,
+        query: str,
+        max_results: int,
+        specific_fields: Union[str, list[str]],
+        jira_err_limit: int,
+        json_result: bool
+    ) -> Union[ResultList[Issue] | list]:
+        start_at = 0
+        all_issues = []
+        retries = 0
+        while True:
+            try:
+                self.logger.debug(f"Fetching issues from startAt={start_at}")
+                page = self.jira_client.search_issues(
+                    jql_str=query,
+                    startAt=start_at,
+                    maxResults=max_results,
+                    fields=specific_fields,
+                    json_result=json_result
+                )
+                all_issues += page['issues'] if json_result else page
+                if json_result:
+                    start_at += page['maxResults']
+                else:
+                    start_at += page.maxResults
+                if start_at >= max_results:
+                    break
+                retries = 0  # reset on success
+            except JIRAError as err:
+                retries += 1
+                self.logger.warning(f"Retry {retries}/{jira_err_limit} after JIRAError: {err}")
+                if retries >= jira_err_limit:
+                    self.logger.exception("Max retries exceeded.")
+                    return []
+                time.sleep(300 if retries == jira_err_limit - 1 else 90)
+        return all_issues
+
+    def _fetch_metadata(self, project_key: str, issue_type: str) -> tuple[dict, dict]:
+        meta = self.jira_client.createmeta(
+            projectKeys=project_key,
+            issuetypeNames=issue_type,
+            expand="projects.issuetypes.fields"
+        )
+
+        project_meta = next((p for p in meta['projects'] if p['key'] == project_key), None)
+        if not project_meta:
+            raise ValueError(f"Project {project_key} not found in metadata")
+
+        issue_meta = next(
+            (it for it in project_meta['issuetypes'] if it['name'].lower() == issue_type.lower()),
+            None
+        )
+        if not issue_meta:
+            raise ValueError(f"Issue type '{issue_type}' not found in project '{project_key}'")
+        return meta, issue_meta
+
+    def get_allowed_values(
+        self,
+        project_key: str,
+        issue_type: str,
+        field_id_or_name: str,
+    ) -> Optional[list]:
+        """
+        Returns the allowed values for a specific field in a project + issue type context.
+        """
+        _, issue_meta = self._fetch_metadata(project_key=project_key, issue_type=issue_type)
+
+        # Try to find by ID or fallback to case-insensitive name
+        field = issue_meta['fields'].get(field_id_or_name)
+        if not field:
+            # Try matching by name (case-insensitive)
+            for fid, fmeta in issue_meta['fields'].items():
+                if fmeta['name'].lower() == field_id_or_name.lower():
+                    field = fmeta
+                    break
+
+        if not field:
+            raise ValueError(
+                f"Field '{field_id_or_name}' not found in project '{project_key}' with issue type '{issue_type}'")
+
+        allowed = field.get('allowedValues')
+        if not allowed:
+            self.logger.info(f"No allowed values found for field '{field_id_or_name}'")
+            return None
+
+        return allowed
+
+    def _is_value_allowed(self, value: Any, allowed_values: list[Any]) -> bool:
+        allowed_names = {av.get('name') for av in allowed_values}
+        allowed_keys = {av.get('key') for av in allowed_values}
+        allowed_values = allowed_names | allowed_keys
+        return describe_allowed_value(value, allowed_values=allowed_values)
+
+    def validate_fields(
+        self,
+        project_key: str,
+        issue_type: str,
+        fields: Optional[dict] = None
+    ) -> None:
+        meta, issue_meta = self._fetch_metadata(project_key=project_key, issue_type=issue_type)
+        field_types = meta['projects'][0]['issuetypes'][0]['fields']
+        for custom_field, value in fields.items():
+            if custom_field not in issue_meta['fields']:
+                raise ValueError(
+                    f'Invalid field(s) for project "{project_key}", issue type "{issue_type}": "{custom_field}"'
+                )
+
+            if allowed_value := issue_meta['fields'][custom_field].get('allowedValues'):
+                if not self._is_value_allowed(value=value, allowed_values=allowed_value):
+                    raise ValueError(
+                        f"Invalid value '{value}' for field '{custom_field}' in project '{project_key}' with issue type '{issue_type}'."
+                        f"The allowed values are: {json.dumps(allowed_value, indent=4, sort_keys=True)}"
+                    )
+
+            field_type = field_types[custom_field]['schema']['type']
+            if field_type == 'string' and not isinstance(value, str):
+                raise ValueError(f"Field '{custom_field}' must be a string")
+            elif field_type == 'number' and not isinstance(value, (int, float)):
+                raise ValueError(f"Field '{custom_field}' must be a number")
+            elif field_type == 'boolean' and not isinstance(value, bool):
+                raise ValueError(f"Field '{custom_field}' must be a boolean")
+            elif field_type == 'array' and not isinstance(value, list):
+                raise ValueError(f"Field '{custom_field}' must be an array")
+            elif field_type == 'object' and not isinstance(value, dict):
+                raise ValueError(f"Field '{custom_field}' must be an object")
+            elif field_type == 'issuetype' and not isinstance(value, dict):
+                raise ValueError(f"Field '{custom_field}' must be an issue type")
+            # Add more field type checks as needed
+        return issue_meta['fields'].keys()
+
+    def create_issue(
+        self,
+        project_key: str,
+        summary: str,
+        description: str,
+        issue_type: str,
+        assignee: Optional[str] = None,
+        custom_fields: Optional[dict] = None,
+    ) -> Optional[Issue]:
+        issue_fields = {
+            "project": {"key": project_key},
+            "issuetype": {"name": issue_type},
+            "summary": summary,
+            "description": description,
+        }
+        if assignee:
+            issue_fields["assignee"] = {"accountId": assignee} if self.server_type == ServerType.CLOUD else {"name": assignee}
+
+        if custom_fields:
+            issue_fields = issue_fields | custom_fields
+        self.validate_fields(project_key=project_key, issue_type=issue_type, fields=issue_fields)
+
+        try:
+            issue = self.jira_client.create_issue(fields=issue_fields)
+            self.logger.info(f"Issue {issue.key} created successfully.")
+            return issue
+        except JIRAError as err:
+            self.logger.error(f"JIRAError while creating issue: {err.text}")
+            return None
+        except Exception as err:
+            self.logger.exception(f"Unexpected error: {err}")
+            return None
+
+    def update_issue(
+        self,
+        issue_key: str,
+        fields_to_update: dict
+    ) -> Optional[Issue]:
+        try:
+            issue = self.jira_client.issue(issue_key)
+            self.validate_fields(
+                project_key=issue.fields.project.key,
+                issue_type=issue.fields.issuetype.name,
+                fields=fields_to_update
+            )
+
+            issue.update(fields=fields_to_update)
+            self.logger.info(f"Issue {issue.key} updated successfully.")
+            return issue
+        except JIRAError as err:
+            self.logger.error(f"JIRAError while updating issue: {err.text}")
+            return None
+        except Exception as err:
+            self.logger.exception(f"Unexpected error: {err}")
+            return None
+
+    def delete_issue(self, issue_key: str) -> bool:
+        try:
+            issue = self.get_issue_by_key(key=issue_key)
+            issue.delete()
+            self.logger.info(f"Issue {issue_key} deleted successfully.")
+            return True
+        except JIRAError as err:
+            self.logger.error(f"JIRAError while deleting issue: {err.text}")
+            return False
+        except Exception as err:
+            self.logger.exception(f"Unexpected error: {err}")
+            return False

python_jira_plus-0.1.0/python_jira_plus.egg-info/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: python-jira-plus
+Version: 0.1.0
+Summary: Enhanced Python client for JIRA with better error handling, pagination, and metadata validation
+Home-page: https://github.com/yourusername/python-jira-plus
+Author: Avi Zaguri
+Author-email: 
+Project-URL: Repository, https://github.com/aviz92/python-jira-plus
+Keywords: jira,atlassian,api,client
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: jira>=3.1.1
+Requires-Dist: retrying>=1.3.3
+Requires-Dist: python-jira-plus>=0.1.4
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# Python JIRA Plus
+
+[![PyPI version](https://badge.fury.io/py/python-jira-plus.svg)](https://badge.fury.io/py/python-jira-plus)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+An enhanced Python client for JIRA that extends the functionality of the official `jira` package, providing better error handling, pagination, metadata validation, and more.
+
+---
+
+## Features
+- ✅ Simplified connection to JIRA Cloud and On-Premise instances
+- ✅ Robust error handling with automatic retries
+- ✅ Built-in pagination for large result sets
+- ✅ Field validation against JIRA metadata
+- ✅ Enhanced issue creation, retrieval, and updating
+- ✅ Support for allowed values validation
+
+---
+
+## Installation
+```bash
+pip install python-jira-plus
+```
+
+---
+
+## Requirements
+- Python 3.9+
+- `jira` package
+- `retrying` package
+- `custom-python-logger` package
+
+---
+
+## Configuration
+The package uses environment variables for authentication and configuration:
+
+```bash
+# Required environment variables
+JIRA_USER_NAME=your_jira_username
+JIRA_TOKEN=your_jira_api_token
+JIRA_BASE_URL=your-instance.atlassian.net  # Only used if base_url is not provided to constructor
+```
+
+## Examples
+
+### Creating an Issue with Custom Fields
+```python
+from python_jira_plus.jira_plus import JiraPlus
+
+jira_client = JiraPlus()
+issue = jira_client.create_issue(
+    project_key="PROJ",
+    summary="Implement new feature",
+    description="This feature will improve performance",
+    issue_type="Task",
+    custom_fields={
+        "priority": "Critical",  # Priority
+        "customfield_10003": {"name": "Sprint 1"}  # Sprint
+    }
+)
+```
+
+### Searching for Issues
+```python
+from python_jira_plus.jira_plus import JiraPlus
+
+jira_client = JiraPlus()
+issues = jira_client.get_objects_by_query(
+    query="project = PROJ AND status = 'In Progress' ORDER BY created DESC",
+    max_results=50,
+    specific_fields=["summary", "status", "assignee"],
+    json_result=False
+)
+
+for issue in issues:
+    print(f"{issue.key}: {issue.fields.summary} - {issue.fields.status.name}")
+```
+
+### Updating an Issue
+```python
+from python_jira_plus.jira_plus import JiraPlus
+
+jira_client = JiraPlus()
+issue = jira_client.get_issue_by_key(key="PROJ-123", json_result=False)
+
+fields_to_update = {
+    "summary": "Updated summary",
+    "description": "Updated description",
+    "customfield_10003": {"name": "Sprint 2"},  # Update Sprint
+}
+_ = jira_client.update_issue(
+    issue_key=issue.key,
+    fields_to_update=fields_to_update
+)
+```
+
+---
+
+## 🤝 Contributing
+If you have a helpful tool, pattern, or improvement to suggest:
+Fork the repo
+Create a new branch
+Submit a pull request
+I welcome additions that promote clean, productive, and maintainable development.
+
+---
+
+## 🙏 Thanks
+Thanks for exploring this repository!
+Happy coding!

python_jira_plus-0.1.0/python_jira_plus.egg-info/SOURCES.txt

@@ -0,0 +1,18 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+setup.py
+python_jira_plus/__init__.py
+python_jira_plus/describe_allowed_value.py
+python_jira_plus/jira_plus.py
+python_jira_plus.egg-info/PKG-INFO
+python_jira_plus.egg-info/SOURCES.txt
+python_jira_plus.egg-info/dependency_links.txt
+python_jira_plus.egg-info/requires.txt
+python_jira_plus.egg-info/top_level.txt
+usage_example/__init__.py
+usage_example/create_jira_issue.py
+usage_example/featch_jira_issues.py
+usage_example/get_jira_issue.py
+usage_example/update_jira_issue.py

python_jira_plus-0.1.0/python_jira_plus.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

python_jira_plus-0.1.0/python_jira_plus.egg-info/requires.txt

@@ -0,0 +1,3 @@
+jira>=3.1.1
+retrying>=1.3.3
+python-jira-plus>=0.1.4

python_jira_plus-0.1.0/python_jira_plus.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+python_jira_plus
+usage_example

python_jira_plus-0.1.0/setup.cfg

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

python_jira_plus-0.1.0/setup.py

@@ -0,0 +1,33 @@
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="python-jira-plus",
+    version="0.1.0",
+    author='Avi Zaguri',
+    author_email="",
+    description="Enhanced Python client for JIRA with better error handling, pagination, and metadata validation",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/yourusername/python-jira-plus",
+    project_urls={
+        'Repository': 'https://github.com/aviz92/python-jira-plus',
+    },
+    packages=find_packages(),
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: Developers",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3",
+    ],
+    python_requires=">=3.9",
+    install_requires=[
+        "jira>=3.1.1",
+        "retrying>=1.3.3",
+        "python-jira-plus>=0.1.4",
+    ],
+    keywords="jira, atlassian, api, client",
+)

python_jira_plus-0.1.0/usage_example/create_jira_issue.py

@@ -0,0 +1,26 @@
+# create_jira_issue.py
+
+import logging
+from custom_python_logger.logger import get_logger
+
+from python_jira_plus import JiraPlus
+
+
+def main():
+    _ = get_logger(
+        project_name='Logger Project Test',
+        log_level=logging.DEBUG,
+        extra={'user': 'test_user'}
+    )
+
+    jira_plus = JiraPlus()
+    _ = jira_plus.create_issue(
+        project_key="JIRA TEST",
+        issue_type='Story',
+        summary='Test issue',
+        description='This is a test issue.',
+    )
+
+
+if __name__ == '__main__':
+    main()

python_jira_plus-0.1.0/usage_example/featch_jira_issues.py

@@ -0,0 +1,28 @@
+# featch_jira_issue.py
+
+import logging
+from custom_python_logger.logger import get_logger
+
+from python_jira_plus import BASIC_FIELDS
+from python_jira_plus.jira_plus import JiraPlus
+
+QUERY = 'project = "JIRA TEST" AND issuetype = Story'
+
+
+def main():
+    _ = get_logger(
+        project_name='Logger Project Test',
+        log_level=logging.DEBUG,
+        extra={'user': 'test_user'}
+    )
+
+    jira_plus = JiraPlus()
+    _ = jira_plus.get_objects_by_query(
+        query=QUERY,
+        specific_fields=BASIC_FIELDS,
+        max_results=300,
+    )
+
+
+if __name__ == '__main__':
+    main()

python_jira_plus-0.1.0/usage_example/get_jira_issue.py

@@ -0,0 +1,24 @@
+# get_jira_issue.py
+
+import logging
+from custom_python_logger.logger import get_logger
+
+from python_jira_plus.jira_plus import JiraPlus
+
+ISSUE_KEY = 'Test-123'
+
+
+def main():
+    _ = get_logger(
+        project_name='Logger Project Test',
+        log_level=logging.DEBUG,
+        extra={'user': 'test_user'}
+    )
+
+    jira_plus = JiraPlus()
+    _ = jira_plus.get_issue_by_key(key=ISSUE_KEY)
+    print()
+
+
+if __name__ == '__main__':
+    main()

python_jira_plus-0.1.0/usage_example/update_jira_issue.py

@@ -0,0 +1,28 @@
+# update_jira_issue.py
+
+import logging
+from custom_python_logger.logger import get_logger
+
+from python_jira_plus.jira_plus import JiraPlus
+
+ISSUE_KEY = 'Test-123'
+
+
+def main():
+    _ = get_logger(
+        project_name='Logger Project Test',
+        log_level=logging.DEBUG,
+        extra={'user': 'test_user'}
+    )
+
+    jira_plus = JiraPlus()
+    _ = jira_plus.update_issue(
+        issue_key=ISSUE_KEY,
+        fields_to_update={
+            'priority': {'name': 'Critical'},
+        }
+    )
+
+
+if __name__ == '__main__':
+    main()