improved release process

Author: vilosource

.github/workflows/publish.yml

@@ -0,0 +1,48 @@
+name: Publish to PyPI
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  build-publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - name: Install Poetry
+        run: |
+          curl -sSL https://install.python-poetry.org | python3 -
+          echo "export PATH=$HOME/.local/bin:$PATH" >> $GITHUB_ENV
+
+      - name: Configure git
+        run: |
+          git config user.name "GitHub Actions"
+          git config user.email "actions@github.com"
+
+      - name: Bump patch version
+        run: |
+          poetry version patch
+          git add pyproject.toml
+          git commit -m "ci: bump version [skip ci]"
+          git tag v$(poetry version -s)
+          git push origin main --tags
+
+      - name: Install dependencies
+        run: poetry install
+
+      - name: Build package
+        run: poetry build
+
+      - name: Publish to PyPI
+        env:
+          POETRY_PYPI_TOKEN_PYPI: ${{ secrets.PYPI_API_TOKEN }}
+        run: poetry publish --username __token__ --password $POETRY_PYPI_TOKEN_PYPI

.vscode/settings.json

@@ -3,5 +3,6 @@
         "tests"
     ],
     "python.testing.unittestEnabled": false,
-    "python.testing.pytestEnabled": true
+    "python.testing.pytestEnabled": true,
+    "makefile.configureOnOpen": false
 }

Makefile

@@ -1,6 +1,6 @@
 # Taskra Makefile - Development and testing utilities
 
-.PHONY: clean test test-all test-core test-models test-integration lint examples setup
+.PHONY: clean test test-all test-core test-models test-integration lint examples setup publish
 
 # Default Python interpreter
 PYTHON = python
@@ -79,6 +79,12 @@ doc:
 doc-serve:
 	cd $(DOC_DIR) && mkdocs serve
 
+# Publish package to PyPI with version bump
+publish:
+	poetry version patch
+	poetry build
+	poetry publish
+
 # Help command
 help:
 	@echo "Available targets:"
@@ -95,3 +101,4 @@ help:
 	@echo "  watch       - Watch for file changes and run tests"
 	@echo "  doc         - Build documentation"
 	@echo "  doc-serve   - Serve documentation locally"
+	@echo "  publish     - Publish package to PyPI"

README.md

@@ -1,6 +1,6 @@
 # Taskra
 
-Taskra is a command-line tool for managing Jira projects, issues, worklogs, and reports efficiently from your terminal. It aims to streamline your workflow by providing quick access to common Jira operations without leaving the command line.
+Taskra is a powerful command-line tool for managing Jira projects, issues, worklogs, and generating reports directly from your terminal. It streamlines your workflow by providing fast, scriptable access to Jira, saving you time and reducing context switching.
 
 ---
 
@@ -18,19 +18,19 @@ pip install -r requirements.txt
 
 ### Configuration
 
-Before using Taskra, add your Jira account credentials:
+Before using Taskra, configure your Jira account:
 
 ```bash
 taskra config add
 ```
 
 You will be prompted for:
 
-- Jira URL (e.g., `https://yourcompany.atlassian.net`)
-- Email address
-- API token (create at https://id.atlassian.com/manage-profile/security/api-tokens)
+- **Jira URL** (e.g., `https://yourcompany.atlassian.net`)
+- **Email address**
+- **API token** (create at [Atlassian API tokens](https://id.atlassian.com/manage-profile/security/api-tokens))
 
-You can list, remove, or set default accounts with:
+Manage accounts:
 
 ```bash
 taskra config list
@@ -58,12 +58,24 @@ Fetch details of a specific issue:
 taskra issue <ISSUE-KEY>
 ```
 
-Create a new issue (interactive prompt):
+Create a new issue interactively:
 
 ```bash
 taskra issue create
 ```
 
+Update an issue:
+
+```bash
+taskra issue update <ISSUE-KEY>
+```
+
+Add a comment to an issue:
+
+```bash
+taskra issue comment <ISSUE-KEY> --message "Your comment here"
+```
+
 #### Tickets Report
 
 Generate a report of tickets in a project with filters:
@@ -72,7 +84,12 @@ Generate a report of tickets in a project with filters:
 taskra tickets <PROJECT-KEY> --start-date YYYY-MM-DD --end-date YYYY-MM-DD --status "In Progress" --assignee "john.doe"
 ```
 
-Options include grouping, sorting, and output format (table, JSON, CSV).
+Options:
+
+- `--group-by status|assignee|none`
+- `--sort-by created|updated|status|assignee|priority`
+- `--format table|json|csv`
+- `--reverse/--no-reverse` (sort order)
 
 #### Worklogs
 
@@ -88,6 +105,12 @@ Add a worklog to an issue:
 taskra worklogs add <ISSUE-KEY> <time-spent> --comment "Worked on feature X"
 ```
 
+Example:
+
+```bash
+taskra worklogs add PROJ-123 2h30m --comment "Bug fixes and testing"
+```
+
 #### Reports
 
 Generate cross-project reports:
@@ -98,14 +121,29 @@ taskra report cross --projects PROJ1,PROJ2 --start-date YYYY-MM-DD --end-date YY
 
 ---
 
-### Debugging
+### Debugging & Verbose Output
 
-Enable debug output with:
+Enable debug output to troubleshoot API calls:
 
 ```bash
 taskra --debug verbose <command>
 ```
 
+Debug levels:
+
+- `none` (default)
+- `error`
+- `info`
+- `verbose`
+
+---
+
+## Tips
+
+- Use shell completion for faster command entry (see `scripts/taskra-completion.bash`).
+- Combine filters to narrow down results.
+- Use `--json` to get raw API data for scripting.
+
 ---
 
 ## License
@@ -116,5 +154,7 @@ MIT License
 
 ## Contributing
 
-Contributions are welcome! Please open issues or pull requests.
+Contributions, bug reports, and feature requests are welcome! Please open an issue or submit a pull request.
+
+---
 

pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "taskra"
-version = "0.1.1"
+version = "0.1.2"
 description = "A command-line tool for task and project management"
 authors = ["JV <jason.viloria@outlook.com>"]
 readme = "README.md"