как писать clean code/опрятный код

Ну например, «Программист-прагматик» Эндрю Ханта — как приземлённое дополнение к витающему в облаках Фаулеру. Не столько непосредственно про код, сколько про организацию труда программиста вообще.

фаулер лох и зануда. Верь своим ощущениям, бро.

благо код на питоне, так что половина дела уже сделано (как мы все знаем, на нем тяжело писать неотформатированный код).

следующим шагом, должно быть грамотное комментирование кода. почитай вот это http://www.stack.nl/~dimitri/doxygen/docblocks.html#pythonblocks

Больше кода читай.

Clean Code. Robert C. Martin

Насчет «визуального» качества кода - это вопрос, я считаю, (несмотря на всевозможные стандарты и рекомендации) исключительно субъективный. Единственное, что тут может помочь - это здравый смысл, и, до некоторой степени, PEP8.

То, насколько хорошо код структурирован, можно легко определить по тому, насколько просто к нему писать тесты и документацию. То есть, если в процессе написания тестов вы говорите себе «черт, ума не приложу, как это ... тестировать», значит можно (нужно) еще лучше сделать, как-то так.

Старое доброе /usr/src/linux/Documentation/CodingStyle даже для питона актуально.

Ага, особенно отступы в 8 символов

Опрятный код? На путхоне?! Вы должно быть шутите!

да хоть на haskell. принципы везде одинаковые.

> что посоветуйте прочитать/поделать?

Просто читай больше кода открытых проектов.

Книги тоже надо читать. Часто информация там в более сконцентрированном виде приведена. А код больше как пример.

Пиши так, чтобы у тебя не было претензий к своему коду. Если что то не нравится - пойми, что, и переписывай, пока не начнёт нравится. Желательно без компромиссов.

Так можно и hello world не закончить.

> Часто информация там в более сконцентрированном виде приведена

Там слишком много хеловордов и мало реальных проблем. Кроме того, авторы книг зарабатывают тем, что пишут книги, а не тем, что пишут код. Я предпочитаю больше верить тем, кто пишет код.

А код больше как пример.

Код отражает представление реальных инженеров о том, как решать конкретные проблемы и как оформлять эти решения. Если хорошие книги по разным теоретическим аспектам, но за практикой лучше идти смотреть код.

Попроси у аналитиков кривого убогого макаронного эталонного быдлокода, потрать неделю на работу с ним. Эффект будет великолепный.

Сможешь писать так же? Очень великолепный эффект.

pylint

Ещё полистай Code Complete Макконела.

Хорошие книги по разным фундаментальным теоретическим и практическим аспектам и имел ввиду. А быдлокниги с быдлохелловордами, каких сейчас огромное засилие, разумеется в топку.

На самом деле все просто и сложно. Пиши код так, чтобы его можно было читать. Т.е. ставь на первое место читабельность кода. При чем не только своего кода, но и того кода, который будет написан с помощью твоего (ты ведь фреймворк делаешь). Это тоже важно, потому что твой фреймворк должен давать людям возможность писать тоже читабельный код.

Это просто, потому что всего-лишь взгляд с другой стороны. Это сложно, потому что понимание приходит только с опытом и подругому никак нельзя. Готовься к тому, что будет и не мало ошибок.

На книжки забей. Умного в них ничего не пишут в наши дни за редким исключением. Лучше перенимай опыт у «бывалых» если есть возможность.

Почитай «Совершенный Код» С. Макконнелла