A maneira mais fácil de renomear um modelo usando Django / South?

Eu estava procurando uma resposta para isso no site da South, Google e SO, mas não consegui encontrar uma maneira simples de fazer isso.

Eu quero renomear um modelo Django usando South. Digamos que você tenha o seguinte:

class Foo(models.Model):
    name = models.CharField()

class FooTwo(models.Model):
    name = models.CharField()
    foo = models.ForeignKey(Foo)

e você deseja converter Foo para Bar, a saber

class Bar(models.Model):
    name = models.CharField()

class FooTwo(models.Model):
    name = models.CharField()
    foo = models.ForeignKey(Bar)

Para simplificar, estou apenas tentando alterar o nome de Foopara Bar, mas ignore o foomembro FooTwopor enquanto.

Qual é a maneira mais fácil de fazer isso usando o Sul?

1. Provavelmente eu poderia fazer uma migração de dados, mas isso parece bastante envolvido.
2. Escreva uma migração personalizada, por exemplo db.rename_table('city_citystate', 'geo_citystate'), mas não tenho certeza de como corrigir a chave estrangeira neste caso.
3. Uma maneira mais fácil que você conhece?

Para responder à sua primeira pergunta, a simples renomeação de modelo / tabela é bastante direta. Execute o comando:

./manage.py schemamigration yourapp rename_foo_to_bar --empty

(Atualização 2: tente em --autovez de --emptyevitar o aviso abaixo. Agradecemos a @KFB pela dica.)

Se você estiver usando uma versão mais antiga do sul, precisará em startmigrationvez de schemamigration.

Em seguida, edite manualmente o arquivo de migração para ficar assim:

class Migration(SchemaMigration):

    def forwards(self, orm):
        db.rename_table('yourapp_foo', 'yourapp_bar')


    def backwards(self, orm):
        db.rename_table('yourapp_bar','yourapp_foo')   

Você pode fazer isso mais simplesmente usando a db_tableopção Meta na sua classe de modelo. Mas sempre que você faz isso, aumenta o peso herdado da sua base de código - ter nomes de classes diferentes dos nomes de tabelas torna seu código mais difícil de entender e manter. Apoio totalmente a refatoração simples como essa por uma questão de clareza.

(atualização) Eu apenas tentei isso em produção e recebi um aviso estranho quando fui aplicar a migração. Dizia:

The following content types are stale and need to be deleted:

    yourapp | foo

Any objects related to these content types by a foreign key will also
be deleted. Are you sure you want to delete these content types?
If you're unsure, answer 'no'.

Eu respondi "não" e tudo parecia estar bem.

Faça as alterações models.pye execute

./manage.py schemamigration --auto myapp

Ao inspecionar o arquivo de migração, você verá que ele exclui uma tabela e cria uma nova

class Migration(SchemaMigration):

    def forwards(self, orm):
        # Deleting model 'Foo'                                                                                                                      
        db.delete_table('myapp_foo')

        # Adding model 'Bar'                                                                                                                        
        db.create_table('myapp_bar', (
        ...
        ))
        db.send_create_signal('myapp', ['Bar'])

    def backwards(self, orm):
        ...

Isto não é exatamente o que você deseja. Em vez disso, edite a migração para que se pareça com:

class Migration(SchemaMigration):

    def forwards(self, orm):
        # Renaming model from 'Foo' to 'Bar'                                                                                                                      
        db.rename_table('myapp_foo', 'myapp_bar')                                                                                                                        
        if not db.dry_run:
            orm['contenttypes.contenttype'].objects.filter(
                app_label='myapp', model='foo').update(model='bar')

    def backwards(self, orm):
        # Renaming model from 'Bar' to 'Foo'                                                                                                                      
        db.rename_table('myapp_bar', 'myapp_foo')                                                                                                                        
        if not db.dry_run:
            orm['contenttypes.contenttype'].objects.filter(app_label='myapp', model='bar').update(model='foo')

Na ausência da updateinstrução, a db.send_create_signalchamada criará um novo ContentTypecom o novo nome do modelo. Mas é melhor apenas updateo que ContentTypevocê já possui, caso haja objetos de banco de dados apontando para ele (por exemplo, via a GenericForeignKey).

Além disso, se você renomeou algumas colunas que são chaves estrangeiras para o modelo renomeado, não se esqueça de

db.rename_column(myapp_model, foo_id, bar_id)

O Sul não pode fazer isso sozinho - como ele sabe que Barrepresenta o que Foocostumava fazer? É para esse tipo de coisa que eu escreveria uma migração personalizada. Você pode alterar o seu ForeignKeycódigo como você fez acima e, em seguida, é apenas um caso de renomear os campos e tabelas apropriados, que você pode fazer da maneira que desejar.

Finalmente, você realmente precisa fazer isso? Eu ainda preciso renomear modelos - os nomes dos modelos são apenas um detalhe da implementação - particularmente dada a disponibilidade da verbose_nameopção Meta.

Eu segui a solução de Leopd acima. Mas isso não mudou os nomes dos modelos. Eu mudei manualmente no código (também em modelos relacionados, onde isso é chamado de FK). E fez outra migração para o sul, mas com a opção --fake. Isso faz com que os nomes dos modelos e da tabela sejam os mesmos.

Acabado de perceber, é possível primeiro começar com a alteração dos nomes dos modelos e editar o arquivo de migrações antes de aplicá-los. Muito mais limpo.