Где найти стандартные правила наименования url, class base view и методов моделей?

Question

[whiteBlackness]

Есть ли стандартные или хотя бы общепринятые правила именования для django?

Например я называю view

class BlaBlaCreate(CreateView):
...

class BlaBlaUpdate(UpdateView):
....

class BlaBlaDetail(DetailView):
...

к ним делаю url

url(r'^blabla/create'$, BlaBlaCreate.as_vew(), name='create_blabla')
url(r'^^blabla/(?P<pk>\d+)/edit$', BlaBlaUpdate.as_vew(), name='edit_blabla')
url(r'^blabla/(?P<pk>\d+)$', BlaBlaDetail.as_vew(), name='blabla_detail')

соответственно в модели у меня есть следующие методы для получения url

class BlaBla(Model):

  def get_absolute_url(self):
    ...
   def get_edit_url(self):
   ...

   @staticmethod
   def get_create_url():
    ...

Но что-то я начинаю путаться где у меня edit а где update.
Да и хочется сделать более стандартные именования.
Есть ли где документация по стандартным названиям? Что-то никак не могу найти.

Answer 1

[Дмитрий Воронков]

Все что хочешь в рамках PEP8
Я обычно делаю так:
articles/models/article.py:

# -*- coding: utf-8 -*-
from __future__ import unicode_literals

from django.db import models


class Article(models.Model):
    title = models.CharField(max_lenght=32, verbose_name=_('name'))

articles/views/article.py:

# -*- coding: utf-8 -*-
from __future__ import unicode_literals

from django.views import generic


class ArticleMixin(object):
    fields = ['title']
    model = Article
    paginate_by = 30

    def get_success_url(self):
        return reverse('articles_article_index')


class Index(ArticleMixin, generic.ListView):
    template_name = 'articles/index.html'


class Create(ArticleMixin, generic.CreateView):
    template_name = 'articles/create.html'


class Update(ArticleMixin, generic.UpdateView):
    template_name = 'articles/update.html'


class Delete(ArticleMixin, generic.DeleteView):
    template_name = 'articles/delete.html'


index = Index.as_view()
create = Create.as_view()
update = Update.as_view()
delete = Delete.as_view()

articles/urls.py

# -*- coding: utf-8 -*-
from __future__ import unicode_literals

from django.conf.urls import url
from django.conf.urls import patterns

from articles.views import article

urlpatterns = patterns('',
                       url(r'^$', article.index, name='articles_article_index'),
                       url(r'^update/(?P<pk>[\w-]+)/$', article.update, name='articles_article_update'),
                       url(r'^delete/(?P<pk>[\w-]+)/$', article.delete, name='articles_article_delete'),
                       url(r'^create/$', article.create, name='articles_article_create'),
                       )

Comments

[Roman K]

Красота! Позаимствую, если не против?

[Дмитрий Воронков]

Roman Kitaev: Не против, это я просто пример накидал. на самом деле у меня миксинов гораздо больше обычно в проектах, миксины с правами доступа, с ajax запросами и прочее. Удобно очень разруливать все.

[Roman K]

Дмитрий Воронков: Это понятно. Я имею ввиду разделение вьюх на отдельные файлы по каждой модели и в конце файла index = Index.as_view()

[Дмитрий Воронков]

Roman Kitaev: Это очень удобно. я по сути разделяю еще формы и ObjectManager. То есть у меня в моделях только структура и и какие-то методы, в менеджерах выборки какие-то, тоже удобно, чтоб не писать портянки во вью. Ну и формы так же. Искать что-то по коду, потом очень удобно, потому что знаешь, что где происходит, если выборка или какие-то инсерты или апдейты то в менеджерах.

[Roman K]

Дмитрий Воронков: Если не секрет, почему до сих пор второй питон?

[Дмитрий Воронков]

Roman Kitaev: В проектах, в которых сейчас работаю старенькие версии django и есть приложения сторонние, которые уже не поддерживаются, переписывать под третий нет времени. Новый проект вот стартовал, на 3 пробую и последнюю версию django.

[sim3x]

Когда понадобится сделать import('article/urls.py') то в шаблонах появятся сопли в виде 'article:articles_article_delete'

[Дмитрий Воронков]

sim3x: Я специально называю так приложение_модель_акшен и в шаблонах потом пишу так же {% url 'приложение_модель_акшен' %} Не сказал бы что какие-то сопли появились, название у меня еще не разу нигде не пересекались.

[sim3x]

Дмитрий Воронков: я указал не на пересечение, а на повтор названия аппа, когда придется перенести блок урлов в article/ursl.py

https://docs.djangoproject.com/en/1.9/topics/http/...
https://docs.djangoproject.com/en/1.9/topics/http/...

[Дмитрий Воронков]

sim3x: Я в курсе. Мне так удобнее. Жесткого ограничения нет. Так же как и с ClassBaseView. Кто-то не использует их.

Answer 2

[ТыжСисАдмин]

Посмотрите проекты на github-e, поучитесь как говориться у мастеров.
Поищите style guide

Answer 3

[sim3x]

Именуй самым понятным для себя способом
пока вью не стало жирным от функционала - 'ArticleUpdateView'
когда стало - 'ArticleCustomiseSomeShitView'
перфикс Article поможет при наборе кода при наличии intellisense, а суффикс 'View' поможет отличить класс от моделей и других классов
Сосредоточься не на именовании, а на коментариях к классам

использовать delete = ArticleDeleteView.as_view() стоит с осторожностью - не уверен, что as_view lazy, что может привести к веселому дебагу