claude-code-templates 1.16.0 → 1.17.0

package/templates/python/examples/django-app/.claude/commands/admin.md

@@ -1,264 +0,0 @@
-# Django Admin Configuration
-
-Configure Django admin interface with custom admin classes and functionality.
-
-## Purpose
-
-This command helps you create comprehensive Django admin configurations with advanced features and customizations.
-
-## Usage
-
-```
-/admin
-```
-
-## What this command does
-
-1. **Registers models** with custom admin classes
-2. **Creates advanced admin interfaces** with filtering, search, and actions
-3. **Adds inline editing** for related models
-4. **Customizes list displays** and forms
-5. **Implements admin actions** for bulk operations
-
-## Example Output
-
-```python
-# admin.py
-from django.contrib import admin
-from django.utils.html import format_html
-from django.urls import reverse
-from django.utils.safestring import mark_safe
-from .models import Post, Category, Tag, Comment
-
-@admin.register(Category)
-class CategoryAdmin(admin.ModelAdmin):
-    """Admin configuration for Category model."""
-    list_display = ['name', 'slug', 'post_count', 'created_at']
-    list_filter = ['created_at']
-    search_fields = ['name', 'description']
-    prepopulated_fields = {'slug': ('name',)}
-    readonly_fields = ['created_at', 'updated_at']
-    
-    def post_count(self, obj):
-        """Display number of posts in this category."""
-        count = obj.posts.count()
-        url = reverse('admin:blog_post_changelist') + f'?category__id__exact={obj.id}'
-        return format_html('<a href="{}">{} posts</a>', url, count)
-    post_count.short_description = 'Posts'
-
-class CommentInline(admin.TabularInline):
-    """Inline admin for comments."""
-    model = Comment
-    extra = 0
-    readonly_fields = ['created_at', 'author']
-    fields = ['author', 'content', 'is_approved', 'created_at']
-
-@admin.register(Post)
-class PostAdmin(admin.ModelAdmin):
-    """Advanced admin configuration for Post model."""
-    list_display = [
-        'title', 
-        'author', 
-        'category', 
-        'status', 
-        'view_count',
-        'created_at',
-        'post_preview'
-    ]
-    list_filter = [
-        'status', 
-        'category', 
-        'created_at', 
-        'updated_at',
-        ('author', admin.RelatedOnlyFieldListFilter)
-    ]
-    search_fields = ['title', 'content', 'author__username']
-    prepopulated_fields = {'slug': ('title',)}
-    readonly_fields = ['created_at', 'updated_at', 'view_count', 'post_preview']
-    
-    # Custom form layout
-    fieldsets = (
-        ('Content', {
-            'fields': ('title', 'slug', 'content', 'status')
-        }),
-        ('Metadata', {
-            'fields': ('author', 'category', 'tags'),
-            'classes': ('collapse',)
-        }),
-        ('SEO', {
-            'fields': ('meta_description', 'meta_keywords'),
-            'classes': ('collapse',)
-        }),
-        ('Timestamps', {
-            'fields': ('created_at', 'updated_at', 'view_count'),
-            'classes': ('collapse',)
-        }),
-    )
-    
-    # Many-to-many field display
-    filter_horizontal = ['tags']
-    
-    # Inline models
-    inlines = [CommentInline]
-    
-    # Custom list display methods
-    def post_preview(self, obj):
-        """Show thumbnail preview of post."""
-        if obj.featured_image:
-            return format_html(
-                '<img src="{}" width="50" height="50" style="border-radius: 5px;" />',
-                obj.featured_image.url
-            )
-        return "No image"
-    post_preview.short_description = 'Preview'
-    
-    # Custom admin actions
-    actions = ['make_published', 'make_draft', 'duplicate_posts']
-    
-    def make_published(self, request, queryset):
-        """Bulk action to publish selected posts."""
-        updated = queryset.update(status='published')
-        self.message_user(
-            request, 
-            f'{updated} posts were successfully marked as published.'
-        )
-    make_published.short_description = "Mark selected posts as published"
-    
-    def make_draft(self, request, queryset):
-        """Bulk action to set selected posts as draft."""
-        updated = queryset.update(status='draft')
-        self.message_user(
-            request, 
-            f'{updated} posts were successfully marked as draft.'
-        )
-    make_draft.short_description = "Mark selected posts as draft"
-    
-    def duplicate_posts(self, request, queryset):
-        """Bulk action to duplicate selected posts."""
-        count = 0
-        for post in queryset:
-            post.pk = None  # Create new instance
-            post.title = f"Copy of {post.title}"
-            post.slug = f"copy-of-{post.slug}"
-            post.status = 'draft'
-            post.save()
-            count += 1
-        
-        self.message_user(
-            request,
-            f'{count} posts were successfully duplicated.'
-        )
-    duplicate_posts.short_description = "Duplicate selected posts"
-
-@admin.register(Tag)
-class TagAdmin(admin.ModelAdmin):
-    """Admin configuration for Tag model."""
-    list_display = ['name', 'slug', 'post_count', 'color_preview']
-    search_fields = ['name']
-    prepopulated_fields = {'slug': ('name',)}
-    
-    def post_count(self, obj):
-        """Display number of posts with this tag."""
-        return obj.posts.count()
-    post_count.short_description = 'Posts'
-    
-    def color_preview(self, obj):
-        """Show color preview if tag has color field."""
-        if hasattr(obj, 'color') and obj.color:
-            return format_html(
-                '<span style="background-color: {}; padding: 2px 8px; border-radius: 3px; color: white;">{}</span>',
-                obj.color,
-                obj.name
-            )
-        return obj.name
-    color_preview.short_description = 'Preview'
-
-@admin.register(Comment)
-class CommentAdmin(admin.ModelAdmin):
-    """Admin configuration for Comment model."""
-    list_display = ['author', 'post', 'content_preview', 'is_approved', 'created_at']
-    list_filter = ['is_approved', 'created_at', 'post__category']
-    search_fields = ['content', 'author__username', 'post__title']
-    readonly_fields = ['created_at', 'updated_at']
-    actions = ['approve_comments', 'disapprove_comments']
-    
-    def content_preview(self, obj):
-        """Show truncated content preview."""
-        return obj.content[:50] + "..." if len(obj.content) > 50 else obj.content
-    content_preview.short_description = 'Content'
-    
-    def approve_comments(self, request, queryset):
-        """Bulk approve comments."""
-        updated = queryset.update(is_approved=True)
-        self.message_user(request, f'{updated} comments were approved.')
-    approve_comments.short_description = "Approve selected comments"
-    
-    def disapprove_comments(self, request, queryset):
-        """Bulk disapprove comments."""
-        updated = queryset.update(is_approved=False)
-        self.message_user(request, f'{updated} comments were disapproved.')
-    disapprove_comments.short_description = "Disapprove selected comments"
-
-# Custom admin site configuration
-admin.site.site_header = "Blog Administration"
-admin.site.site_title = "Blog Admin Portal"
-admin.site.index_title = "Welcome to Blog Administration"
-```
-
-## Advanced Features
-
-### Custom List Display
-- **Thumbnail previews** for images
-- **Related object counts** with links
-- **Status indicators** with colors
-- **Custom formatting** for data display
-
-### Filtering and Search
-- **Advanced filters** including date ranges
-- **Related field filtering** for foreign keys
-- **Search across multiple fields** including relations
-- **Custom filter classes** for complex queries
-
-### Inline Editing
-- **TabularInline** for compact editing
-- **StackedInline** for detailed forms
-- **Custom inline forms** with additional functionality
-- **Readonly fields** in inlines
-
-### Bulk Actions
-- **Status changes** for multiple objects
-- **Data export** functionality
-- **Batch operations** for efficiency
-- **Custom business logic** in actions
-
-### Form Customization
-- **Fieldsets** for organized layouts
-- **Collapsed sections** for advanced options
-- **Custom widgets** for better UX
-- **Validation** and error handling
-
-## Security Considerations
-
-- **Permission checks** in custom methods
-- **Input sanitization** in admin actions
-- **CSRF protection** (automatic)
-- **User authentication** (built-in)
-
-## Performance Optimization
-
-```python
-# Optimize queries with select_related/prefetch_related
-class PostAdmin(admin.ModelAdmin):
-    def get_queryset(self, request):
-        queryset = super().get_queryset(request)
-        return queryset.select_related('author', 'category').prefetch_related('tags')
-```
-
-## Custom Admin Templates
-
-```python
-# Override admin templates
-class PostAdmin(admin.ModelAdmin):
-    change_form_template = 'admin/blog/post/change_form.html'
-    change_list_template = 'admin/blog/post/change_list.html'
-```

package/templates/python/examples/django-app/.claude/commands/django-model.md

@@ -1,124 +0,0 @@
-# Django Model Generator
-
-Create Django models with proper structure and relationships.
-
-## Purpose
-
-This command helps you quickly create Django models with fields, relationships, and best practices.
-
-## Usage
-
-```
-/django-model
-```
-
-## What this command does
-
-1. **Creates model classes** with proper field definitions
-2. **Adds relationships** (ForeignKey, ManyToMany, OneToOne)
-3. **Includes meta options** and model methods
-4. **Generates migrations** automatically
-5. **Follows Django conventions** and best practices
-
-## Example Output
-
-```python
-# models.py
-from django.db import models
-from django.contrib.auth.models import User
-
-class Category(models.Model):
-    name = models.CharField(max_length=100, unique=True)
-    slug = models.SlugField(unique=True)
-    description = models.TextField(blank=True)
-    created_at = models.DateTimeField(auto_now_add=True)
-    updated_at = models.DateTimeField(auto_now=True)
-    
-    class Meta:
-        verbose_name_plural = "categories"
-        ordering = ['name']
-    
-    def __str__(self):
-        return self.name
-
-class Post(models.Model):
-    STATUS_CHOICES = [
-        ('draft', 'Draft'),
-        ('published', 'Published'),
-        ('archived', 'Archived'),
-    ]
-    
-    title = models.CharField(max_length=200)
-    slug = models.SlugField(unique=True)
-    content = models.TextField()
-    status = models.CharField(max_length=20, choices=STATUS_CHOICES, default='draft')
-    author = models.ForeignKey(User, on_delete=models.CASCADE, related_name='posts')
-    category = models.ForeignKey(Category, on_delete=models.SET_NULL, null=True, blank=True)
-    tags = models.ManyToManyField('Tag', blank=True)
-    created_at = models.DateTimeField(auto_now_add=True)
-    updated_at = models.DateTimeField(auto_now=True)
-    
-    class Meta:
-        ordering = ['-created_at']
-        verbose_name = 'blog post'
-        verbose_name_plural = 'blog posts'
-    
-    def __str__(self):
-        return self.title
-    
-    def get_absolute_url(self):
-        return reverse('post_detail', kwargs={'slug': self.slug})
-
-class Tag(models.Model):
-    name = models.CharField(max_length=50, unique=True)
-    slug = models.SlugField(unique=True)
-    
-    def __str__(self):
-        return self.name
-```
-
-## Field Types Supported
-
-- **CharField** - Text fields with max length
-- **TextField** - Large text fields
-- **IntegerField** - Integer numbers
-- **FloatField** - Floating point numbers
-- **BooleanField** - True/False values
-- **DateField** - Date only
-- **DateTimeField** - Date and time
-- **EmailField** - Email addresses
-- **URLField** - URLs
-- **ImageField** - Image uploads
-- **FileField** - File uploads
-- **JSONField** - JSON data (PostgreSQL)
-
-## Relationships
-
-- **ForeignKey** - One-to-many relationships
-- **ManyToManyField** - Many-to-many relationships
-- **OneToOneField** - One-to-one relationships
-
-## Best Practices Included
-
-- Proper field choices and defaults
-- Appropriate related_name attributes
-- __str__ methods for admin interface
-- Meta class with ordering and verbose names
-- get_absolute_url methods where appropriate
-- Proper use of null and blank parameters
-- Field validation and constraints
-
-## After Creating Models
-
-```bash
-# Create and apply migrations
-python manage.py makemigrations
-python manage.py migrate
-
-# Register in admin (optional)
-# Add to admin.py:
-from django.contrib import admin
-from .models import Post, Category, Tag
-
-admin.site.register([Post, Category, Tag])
-```

package/templates/python/examples/django-app/.claude/commands/views.md

@@ -1,222 +0,0 @@
-# Django Views Generator
-
-Create Django views with proper structure and best practices.
-
-## Purpose
-
-This command helps you quickly create Django views (Function-Based Views and Class-Based Views) following Django conventions.
-
-## Usage
-
-```
-/views
-```
-
-## What this command does
-
-1. **Creates view functions/classes** with proper structure
-2. **Handles HTTP methods** (GET, POST, PUT, DELETE)
-3. **Includes form handling** and validation
-4. **Adds authentication/authorization** checks
-5. **Follows Django best practices** and security guidelines
-
-## Example Output
-
-```python
-# views.py
-from django.shortcuts import render, get_object_or_404, redirect
-from django.contrib.auth.decorators import login_required
-from django.contrib import messages
-from django.http import JsonResponse
-from django.views.generic import ListView, DetailView, CreateView, UpdateView, DeleteView
-from django.contrib.auth.mixins import LoginRequiredMixin
-from django.urls import reverse_lazy
-from .models import Post, Category
-from .forms import PostForm
-
-# Function-Based Views
-def post_list(request):
-    """Display list of posts with pagination and filtering."""
-    posts = Post.objects.filter(status='published').select_related('author', 'category')
-    
-    # Search functionality
-    search_query = request.GET.get('search')
-    if search_query:
-        posts = posts.filter(title__icontains=search_query)
-    
-    # Category filtering
-    category_id = request.GET.get('category')
-    if category_id:
-        posts = posts.filter(category_id=category_id)
-    
-    context = {
-        'posts': posts,
-        'categories': Category.objects.all(),
-        'search_query': search_query,
-    }
-    return render(request, 'blog/post_list.html', context)
-
-def post_detail(request, slug):
-    """Display individual post details."""
-    post = get_object_or_404(Post, slug=slug, status='published')
-    
-    context = {
-        'post': post,
-        'related_posts': Post.objects.filter(
-            category=post.category,
-            status='published'
-        ).exclude(id=post.id)[:3]
-    }
-    return render(request, 'blog/post_detail.html', context)
-
-@login_required
-def post_create(request):
-    """Create new post."""
-    if request.method == 'POST':
-        form = PostForm(request.POST, request.FILES)
-        if form.is_valid():
-            post = form.save(commit=False)
-            post.author = request.user
-            post.save()
-            form.save_m2m()  # Save many-to-many relationships
-            messages.success(request, 'Post created successfully!')
-            return redirect('post_detail', slug=post.slug)
-    else:
-        form = PostForm()
-    
-    return render(request, 'blog/post_form.html', {'form': form})
-
-@login_required
-def post_edit(request, slug):
-    """Edit existing post."""
-    post = get_object_or_404(Post, slug=slug, author=request.user)
-    
-    if request.method == 'POST':
-        form = PostForm(request.POST, request.FILES, instance=post)
-        if form.is_valid():
-            form.save()
-            messages.success(request, 'Post updated successfully!')
-            return redirect('post_detail', slug=post.slug)
-    else:
-        form = PostForm(instance=post)
-    
-    return render(request, 'blog/post_form.html', {
-        'form': form, 
-        'post': post
-    })
-
-# Class-Based Views
-class PostListView(ListView):
-    """List view for posts with pagination."""
-    model = Post
-    template_name = 'blog/post_list.html'
-    context_object_name = 'posts'
-    paginate_by = 10
-    
-    def get_queryset(self):
-        return Post.objects.filter(status='published').select_related('author', 'category')
-    
-    def get_context_data(self, **kwargs):
-        context = super().get_context_data(**kwargs)
-        context['categories'] = Category.objects.all()
-        return context
-
-class PostDetailView(DetailView):
-    """Detail view for individual posts."""
-    model = Post
-    template_name = 'blog/post_detail.html'
-    context_object_name = 'post'
-    
-    def get_queryset(self):
-        return Post.objects.filter(status='published')
-
-class PostCreateView(LoginRequiredMixin, CreateView):
-    """Create view for new posts."""
-    model = Post
-    form_class = PostForm
-    template_name = 'blog/post_form.html'
-    
-    def form_valid(self, form):
-        form.instance.author = self.request.user
-        return super().form_valid(form)
-
-class PostUpdateView(LoginRequiredMixin, UpdateView):
-    """Update view for existing posts."""
-    model = Post
-    form_class = PostForm
-    template_name = 'blog/post_form.html'
-    
-    def get_queryset(self):
-        return Post.objects.filter(author=self.request.user)
-
-class PostDeleteView(LoginRequiredMixin, DeleteView):
-    """Delete view for posts."""
-    model = Post
-    template_name = 'blog/post_confirm_delete.html'
-    success_url = reverse_lazy('post_list')
-    
-    def get_queryset(self):
-        return Post.objects.filter(author=self.request.user)
-
-# API Views
-def api_post_list(request):
-    """API endpoint for post list."""
-    posts = Post.objects.filter(status='published').values(
-        'id', 'title', 'slug', 'created_at', 'author__username'
-    )
-    return JsonResponse(list(posts), safe=False)
-```
-
-## View Types Supported
-
-- **Function-Based Views (FBV)** - Simple, explicit control
-- **Class-Based Views (CBV)** - Reusable, inheritance-based
-- **Generic Views** - ListView, DetailView, CreateView, etc.
-- **API Views** - JSON responses for AJAX/API calls
-
-## Features Included
-
-- **Authentication checks** with decorators/mixins
-- **Permission handling** for user authorization
-- **Form processing** with validation
-- **Error handling** and user feedback
-- **SEO-friendly URLs** with slugs
-- **Database optimization** with select_related/prefetch_related
-- **Pagination** for large datasets
-- **Search and filtering** functionality
-
-## Security Best Practices
-
-- CSRF protection (automatic with forms)
-- User authentication and authorization
-- SQL injection prevention (ORM)
-- XSS protection with template escaping
-- Proper error handling
-
-## URL Configuration
-
-```python
-# urls.py
-from django.urls import path
-from . import views
-
-app_name = 'blog'
-
-urlpatterns = [
-    # Function-based views
-    path('', views.post_list, name='post_list'),
-    path('post/<slug:slug>/', views.post_detail, name='post_detail'),
-    path('create/', views.post_create, name='post_create'),
-    path('edit/<slug:slug>/', views.post_edit, name='post_edit'),
-    
-    # Class-based views
-    path('posts/', views.PostListView.as_view(), name='post_list_cbv'),
-    path('posts/<slug:slug>/', views.PostDetailView.as_view(), name='post_detail_cbv'),
-    path('posts/create/', views.PostCreateView.as_view(), name='post_create_cbv'),
-    path('posts/<slug:slug>/edit/', views.PostUpdateView.as_view(), name='post_edit_cbv'),
-    path('posts/<slug:slug>/delete/', views.PostDeleteView.as_view(), name='post_delete_cbv'),
-    
-    # API endpoints
-    path('api/posts/', views.api_post_list, name='api_post_list'),
-]
-```