django-cloudflareimages-toolkit 1.0.0__tar.gz

django_cloudflareimages_toolkit-1.0.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,167 @@
+name: 🐛 Bug Report
+description: Report a bug or unexpected behavior
+title: "[BUG] "
+labels: ["bug", "needs-triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug! Please fill out the information below to help us diagnose and fix the issue.
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Pre-submission Checklist
+      description: Please check the following before submitting
+      options:
+        - label: I have searched existing issues to ensure this is not a duplicate
+          required: true
+        - label: I have read the documentation and troubleshooting guide
+          required: true
+        - label: I am using a supported version of Django (4.2+)
+          required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Bug Description
+      description: A clear and concise description of what the bug is
+      placeholder: Describe the bug...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What did you expect to happen?
+      placeholder: I expected...
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+      description: What actually happened?
+      placeholder: Instead, what happened was...
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps to Reproduce
+      description: Provide detailed steps to reproduce the issue
+      placeholder: |
+        1. Install django-cloudflareimages-toolkit
+        2. Configure settings with...
+        3. Call cloudflare_service.create_direct_upload_url(...)
+        4. See error
+    validations:
+      required: true
+
+  - type: textarea
+    id: code
+    attributes:
+      label: Code Sample
+      description: Provide a minimal code sample that reproduces the issue
+      render: python
+      placeholder: |
+        # settings.py
+        INSTALLED_APPS = [
+            'django_cloudflareimages_toolkit',
+        ]
+
+        CLOUDFLARE_IMAGES = {
+            'ACCOUNT_ID': 'your-account-id',
+            'API_TOKEN': 'your-api-token',
+        }
+
+        # views.py
+        from django_cloudflareimages_toolkit.services import cloudflare_service
+        
+        image = cloudflare_service.create_direct_upload_url(
+            user=request.user,
+            metadata={'type': 'avatar'}
+        )
+
+  - type: textarea
+    id: error
+    attributes:
+      label: Error Message/Traceback
+      description: If applicable, provide the full error message or traceback
+      render: text
+      placeholder: Paste the full error message here...
+
+  - type: dropdown
+    id: django_version
+    attributes:
+      label: Django Version
+      description: Which version of Django are you using?
+      options:
+        - "5.2.x"
+        - "5.1.x"
+        - "5.0.x"
+        - "4.2.x (LTS)"
+        - "Other (please specify in additional context)"
+    validations:
+      required: true
+
+  - type: input
+    id: package_version
+    attributes:
+      label: django-cloudflareimages-toolkit Version
+      description: Which version of django-cloudflareimages-toolkit are you using?
+      placeholder: "1.0.0"
+    validations:
+      required: true
+
+  - type: input
+    id: python_version
+    attributes:
+      label: Python Version
+      description: Which version of Python are you using?
+      placeholder: "3.11.0"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: environment
+    attributes:
+      label: Environment
+      description: Where are you experiencing this issue?
+      options:
+        - "Development"
+        - "Staging"
+        - "Production"
+        - "Testing"
+    validations:
+      required: true
+
+  - type: textarea
+    id: configuration
+    attributes:
+      label: Configuration
+      description: Share relevant configuration (remove sensitive data)
+      render: python
+      placeholder: |
+        # settings.py
+        INSTALLED_APPS = [
+            'rest_framework',
+            'django_cloudflareimages_toolkit',
+        ]
+        
+        CLOUDFLARE_IMAGES = {
+            'ACCOUNT_ID': 'your-account-id',
+            'API_TOKEN': 'your-api-token',
+            'DEFAULT_EXPIRY_MINUTES': 30,
+            'REQUIRE_SIGNED_URLS': True,
+        }
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Add any other context about the problem here
+      placeholder: Any additional information that might be helpful...

django_cloudflareimages_toolkit-1.0.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,14 @@
+blank_issues_enabled: false
+contact_links:
+  - name: 📚 Documentation
+    url: https://github.com/Pacificient-Labs/django-cloudflareimages-toolkit/blob/main/README.md
+    about: Read the comprehensive documentation and examples
+  - name: 💬 GitHub Discussions
+    url: https://github.com/Pacificient-Labs/django-cloudflareimages-toolkit/discussions
+    about: Ask questions and discuss ideas with the community
+  - name: 🔧 Webhook Setup Guide
+    url: https://github.com/Pacificient-Labs/django-cloudflareimages-toolkit/blob/main/WEBHOOK_SETUP.md
+    about: Detailed guide for setting up Cloudflare webhooks
+  - name: 🌐 Cloudflare Images Documentation
+    url: https://developers.cloudflare.com/images/
+    about: Official Cloudflare Images API documentation

django_cloudflareimages_toolkit-1.0.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,140 @@
+name: ✨ Feature Request
+description: Suggest a new feature or enhancement
+title: "[FEATURE] "
+labels: ["enhancement", "needs-triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a new feature! Please provide as much detail as possible to help us understand your request.
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Pre-submission Checklist
+      description: Please check the following before submitting
+      options:
+        - label: I have searched existing issues to ensure this is not a duplicate
+          required: true
+        - label: I have read the documentation to confirm this feature doesn't already exist
+          required: true
+        - label: This feature would benefit the broader community, not just my specific use case
+          required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem Statement
+      description: What problem does this feature solve? What limitation are you facing?
+      placeholder: |
+        I'm trying to... but I can't because...
+        Currently, the toolkit doesn't support...
+        It would be helpful if...
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: What feature would solve this problem? How should it work?
+      placeholder: |
+        I would like to see...
+        The feature should work by...
+        Users would be able to...
+    validations:
+      required: true
+
+  - type: textarea
+    id: use_case
+    attributes:
+      label: Use Case
+      description: Provide a specific example of how you would use this feature
+      placeholder: |
+        In my Django application, I need to...
+        For example, when a user uploads an image...
+        This would allow me to...
+    validations:
+      required: true
+
+  - type: textarea
+    id: api_example
+    attributes:
+      label: API Design Example
+      description: If applicable, show how you envision the API would work
+      render: python
+      placeholder: |
+        # Example of how the feature might be used
+        from django_cloudflareimages_toolkit.services import cloudflare_service
+        
+        # Your proposed API usage
+        result = cloudflare_service.new_feature_method(
+            parameter1='value1',
+            parameter2='value2'
+        )
+
+  - type: dropdown
+    id: priority
+    attributes:
+      label: Priority
+      description: How important is this feature to you?
+      options:
+        - "Low - Nice to have"
+        - "Medium - Would be helpful"
+        - "High - Important for my project"
+        - "Critical - Blocking my use of the toolkit"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: complexity
+    attributes:
+      label: Estimated Complexity
+      description: How complex do you think this feature would be to implement?
+      options:
+        - "Low - Simple addition or modification"
+        - "Medium - Moderate changes required"
+        - "High - Significant new functionality"
+        - "Unknown - Not sure about implementation complexity"
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: What alternatives have you considered? What workarounds are you currently using?
+      placeholder: |
+        I've tried...
+        Currently I'm working around this by...
+        Other solutions I considered...
+
+  - type: textarea
+    id: implementation
+    attributes:
+      label: Implementation Ideas
+      description: If you have technical suggestions for how this could be implemented, share them here
+      placeholder: |
+        This could be implemented by...
+        It might require changes to...
+        The Cloudflare API supports...
+
+  - type: checkboxes
+    id: contribution
+    attributes:
+      label: Contribution
+      description: Would you be interested in contributing to this feature?
+      options:
+        - label: I would be willing to help implement this feature
+        - label: I would be willing to test this feature once implemented
+        - label: I would be willing to help with documentation for this feature
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Add any other context, screenshots, or examples about the feature request
+      placeholder: |
+        Links to relevant documentation...
+        Screenshots or mockups...
+        Related features in other libraries...

django_cloudflareimages_toolkit-1.0.0/.github/ISSUE_TEMPLATE/question.yml

@@ -0,0 +1,158 @@
+name: ❓ Question
+description: Ask a question about usage, configuration, or implementation
+title: "[QUESTION] "
+labels: ["question", "needs-triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for your question! Please provide as much detail as possible to help us give you the best answer.
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Pre-submission Checklist
+      description: Please check the following before submitting
+      options:
+        - label: I have searched existing issues and discussions for similar questions
+          required: true
+        - label: I have read the documentation and README
+          required: true
+        - label: I have checked the troubleshooting guide and examples
+          required: true
+
+  - type: textarea
+    id: question
+    attributes:
+      label: Question
+      description: What would you like to know? Be as specific as possible.
+      placeholder: |
+        How do I...?
+        What's the best way to...?
+        Why does... happen when I...?
+        Is it possible to...?
+    validations:
+      required: true
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Context
+      description: What are you trying to achieve? What's your use case?
+      placeholder: |
+        I'm building a Django application that...
+        I need to implement image uploads for...
+        My goal is to...
+    validations:
+      required: true
+
+  - type: textarea
+    id: attempted
+    attributes:
+      label: What I've Tried
+      description: What have you already attempted? Show your code and approach.
+      render: python
+      placeholder: |
+        # settings.py
+        CLOUDFLARE_IMAGES = {
+            'ACCOUNT_ID': 'my-account-id',
+            'API_TOKEN': 'my-api-token',
+        }
+
+        # views.py
+        from django_cloudflareimages_toolkit.services import cloudflare_service
+        
+        def my_view(request):
+            # What I tried...
+            image = cloudflare_service.create_direct_upload_url(
+                user=request.user
+            )
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Outcome
+      description: What result are you hoping to achieve?
+      placeholder: |
+        I expect to...
+        The result should be...
+        I want to see...
+
+  - type: textarea
+    id: current_behavior
+    attributes:
+      label: Current Behavior
+      description: What's happening instead? Include any error messages.
+      placeholder: |
+        Instead, I'm getting...
+        The error message is...
+        The behavior I see is...
+
+  - type: dropdown
+    id: django_version
+    attributes:
+      label: Django Version
+      description: Which version of Django are you using?
+      options:
+        - "5.2.x"
+        - "5.1.x"
+        - "5.0.x"
+        - "4.2.x (LTS)"
+        - "Other (please specify in additional context)"
+    validations:
+      required: true
+
+  - type: input
+    id: package_version
+    attributes:
+      label: django-cloudflareimages-toolkit Version
+      description: Which version of django-cloudflareimages-toolkit are you using?
+      placeholder: "1.0.0"
+    validations:
+      required: true
+
+  - type: dropdown
+    id: question_type
+    attributes:
+      label: Question Type
+      description: What type of question is this?
+      options:
+        - "Configuration - How to set up or configure the toolkit"
+        - "Usage - How to use specific features or methods"
+        - "Integration - How to integrate with other Django features"
+        - "Troubleshooting - Something isn't working as expected"
+        - "Best Practices - Recommendations for implementation"
+        - "Cloudflare API - Questions about Cloudflare Images features"
+        - "Other - General questions"
+    validations:
+      required: true
+
+  - type: textarea
+    id: configuration
+    attributes:
+      label: Current Configuration
+      description: Share your relevant configuration (remove sensitive data)
+      render: python
+      placeholder: |
+        # settings.py
+        INSTALLED_APPS = [
+            'rest_framework',
+            'django_cloudflareimages_toolkit',
+        ]
+        
+        CLOUDFLARE_IMAGES = {
+            'ACCOUNT_ID': 'your-account-id',
+            'API_TOKEN': 'your-api-token',
+            'DEFAULT_EXPIRY_MINUTES': 30,
+            'REQUIRE_SIGNED_URLS': True,
+        }
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: Additional Context
+      description: Any other information that might be helpful
+      placeholder: |
+        Links to relevant documentation...
+        Screenshots of the issue...
+        Related code or configuration...

django_cloudflareimages_toolkit-1.0.0/.github/workflows/publish.yml

@@ -0,0 +1,93 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      id-token: write  # IMPORTANT: this permission is mandatory for trusted publishing
+      contents: read
+    
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v4
+      with:
+        version: "latest"
+
+    - name: Set up Python
+      run: uv python install 3.11
+
+    - name: Install build dependencies
+      run: uv sync --extra dev
+
+    - name: Verify version matches tag
+      run: |
+        # Extract version from tag (remove 'v' prefix if present)
+        TAG_VERSION=${GITHUB_REF#refs/tags/}
+        TAG_VERSION=${TAG_VERSION#v}
+        
+        # Extract version from pyproject.toml
+        PACKAGE_VERSION=$(uv run python -c "import tomllib; print(tomllib.load(open('pyproject.toml', 'rb'))['project']['version'])")
+        
+        echo "Tag version: $TAG_VERSION"
+        echo "Package version: $PACKAGE_VERSION"
+        
+        if [ "$TAG_VERSION" != "$PACKAGE_VERSION" ]; then
+          echo "Error: Tag version ($TAG_VERSION) does not match package version ($PACKAGE_VERSION)"
+          exit 1
+        fi
+
+    - name: Build package
+      run: uv build
+
+    - name: Verify build
+      run: |
+        # List contents of the built packages
+        echo "Built packages:"
+        ls -la dist/
+        
+        # Check that both wheel and source distribution were created
+        if [ ! -f dist/*.whl ] || [ ! -f dist/*.tar.gz ]; then
+          echo "Error: Both wheel and source distribution should be created"
+          exit 1
+        fi
+        
+        # Basic verification that files exist and have reasonable sizes
+        echo "Package verification:"
+        for file in dist/*; do
+          echo "  $file: $(stat -c%s "$file") bytes"
+        done
+
+    - name: Publish to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        # Using trusted publishing (recommended)
+        # No need for API tokens when using trusted publishing
+        verbose: true
+        print-hash: true
+
+  notify:
+    needs: publish
+    runs-on: ubuntu-latest
+    if: always()
+    
+    steps:
+    - name: Notify success
+      if: needs.publish.result == 'success'
+      run: |
+        echo "✅ Successfully published django-cloudflareimages-toolkit to PyPI!"
+        echo "📦 Package should be available at: https://pypi.org/project/django-cloudflareimages-toolkit/"
+    
+    - name: Notify failure
+      if: needs.publish.result == 'failure'
+      run: |
+        echo "❌ Failed to publish django-cloudflareimages-toolkit to PyPI"
+        echo "Check the logs above for details"
+        exit 1