Читатели като вас помагат в подкрепа на MUO. Когато правите покупка чрез връзки на нашия сайт, ние може да спечелим комисионна за партньор.

Проектите с отворен код са все по-търсени и има огромен брой, в който да потънете. За да започнете да работите по проект с отворен код, е полезно, ако можете лесно да клонирате изходния код и да настроите проекта локално.

Въпреки че клонирането може да изглежда лесно, то може да бъде предизвикателство с проекти, създадени с Django. Django има много зависимости и пакети, които причиняват конфликти, когато не са инсталирани.

Трябва да коригирате конфликтите, преди проектът да може да се изпълнява на вашата локална машина. Е, не е нужно да страдате повече.

В следващите стъпки ще научите как да клонирате, настроите и стартирате своя Django проект с минимални конфликти.

Какво ще ви трябва

За да извлечете максимума от това ръководство, трябва да имате следното:

  • Python (Python3 и по-нови)
  • Работно познаване на библиотеката Python-Django
  • Пип3
  • Познаване на виртуалните среди на Python
    • instagram viewer
  • Основни познания за Git и GitHub
  • Акаунт в GitHub
  • Git е инсталиран на вашата локална машина
  • Запознаване с командния ред

След като тези изисквания са изпълнени, вие сте готови да клонирате проект.

1. Клонирайте проекта от GitHub

Можете да клонирате примерен проект от GitHub и го конфигурирайте на вашата локална машина.

За да клонирате проекта, щракнете върху зеления бутон с етикет Код. От падащото меню изберете и копирайте HTTP или SSH връзки. Тези връзки са URL адресите на GitHub за проекта. Всеки от тях ще свърши работа.

Когато искаш допринесете за проект с отворен код, използвайки Git, първо ще трябва вилица проекта от хранилището на проекта, за да направите копие преди клониране.

Върнете се към вашето устройство, настройте папка с име clone_boma. Не забравяйте да отидете в папката с cd clone_boma команда.

След това изпълнете следната команда, за да клонирате проекта в папката.

git клонинг <URL адрес на хранилище>

И така, за да клонирате примерния проект през HTTP, използвайте тази команда:

git клонинг https://github.com/Dindihub/Boma-watch.git

2. Проверете файловете на проекта

След клонирането, използвайте командата ls за да проверите наличието на файлове от проекта Boma-watch. Тип ls за да изброите цялото съдържание в папката.

Можете да използвате текстов редактор по ваш избор, за да проверите съдържанието на всеки файл или да ги видите на уебсайта на GitHub.

3. Настройте виртуална среда

Трябва да настроите виртуална среда за проекта. Примерният проект идва със среда Pipenv, която определя зависимостите на проекта в два файла: Pipfile и Pipfile.lock.

Ще срещнете тази грешка, ако стартирате проекта със стария Pipfile:

ModuleNotFoundError: Няма модул с име „distutils.core“

Трябва да изтриете виртуалната среда и да я инсталирате наново. За да изтриете виртуалната среда и нейните зависимости, изпълнете следните команди последователно.

За да премахнете старата среда:

pipenv --rm

За да премахнете и двата Pipfile:

rm Pipfile*

За да инсталирате вашите Pipenv зависимости на вашата версия на python:

pipenv Инсталирай--python 3.10

След това изпълнете следната команда, за да инсталирате всички пакети Pipfiles:

pipenv Инсталирай заявки

След това активирайте виртуалната среда:

обвивка pipenv

Ще видите активирана виртуална среда от дясната страна на прозореца на вашия терминал.

Ако използвате Venv за създаване на вашата виртуална среда, изпълнете следното, за да инсталирате зависимости:

пипИнсталирай-ризисквания.текст

За да изброите всички инсталирани зависимости:

пип замразяване > изисквания.txt

4. Създаване на база данни

Трябва да инсталирате база данни, за да обработвате данните на проекта. Можете да изберете всякакъв вид база данни, която отговаря на вашите нужди. За примерния проект трябва да използвате PostgresSQL.

Научете как да инсталирайте PostgreSQL на Ubuntu или инсталирайте PostgreSQL на Windows.

След като всичко е настроено, стартирайте обвивката на Postgres, като използвате следните команди:

sudo -i -u postgres
psql

След това създайте база данни с име new_boma на сървъра:

postgres=# създаване на база данни new_boma;

Сървърът връща думата CREATE DATABASE, когато създава база данни. Потвърдете, че базата данни съществува, като посочите всички бази данни в системата с командата \l:

в settings.py, трябва да свържете базата данни с приложението. Направете това, като замените потребителя, името и паролата на базата данни с вашите собствени локални стойности:

#...
БАЗИ ДАННИ = {
'по подразбиране': {
'ДВИГАТЕЛ':'django.db.backends.postgresql',
'ИМЕ':'new_boma',
'ПОТРЕБИТЕЛ':'postgres',
'ПАРОЛА':'парола',
 }
}

Освен това не забравяйте да промените ЧАСОВА ЗОНА във файла settings.py, за да отговаря на вашето местоположение. Това ще поддържа приложението ви актуализирано.

Уверете се, че сте инсталирали Psycopg2 за да побере всички налични изображения:

$ pipenv Инсталирай psycopg2

5. Генерирайте таен ключ

Всеки Django проект има уникален таен ключ. Обикновено секретният ключ не се разкрива онлайн. Трябва да е в околна среда файл, в който трябва да включите файл .gitignore за изключване от хранилището.

Трябва да генерирате нов, за да стартира вашият проект. Създайте нов таен ключ с генератор на таен ключ, като Джекрети.

# ПРЕДУПРЕЖДЕНИЕ ЗА СИГУРНОСТ: пазете тайния ключ, използван в производството!
SECRET_KEY = 'секретният-ключ-идва-тук'

6. Мигриране на проекта към базата данни

Изпълнете следната команда, за да създадете таблици за приложението в новата база данни:

питонуправлявам.pyправят миграцииап

След това изпълнете следното, за да мигрирате:

питонуправлявам.pyмигрират

Когато стартирате python manage.py мигрират команда, получавате грешки. Грешките ви уведомяват за липсващи модули. Уверете се, че сте инсталирали всички модули, преди да мигрирате.

Когато имате инсталирани всички зависимости, стартирайте миграцията. Ако миграциите приключат, е време да стартирате проекта.

Когато имате инсталирани всички зависимости, стартирайте миграцията. Ако миграциите се изпълняват, е време да стартирате проекта.

7. Стартирайте проекта

Стартирайте проекта, за да се уверите, че всичко е наред, преди да добавите своя принос. Стартирайте приложението със следната команда:

питонуправлявам.pyrunserver

Ако няма грешки, отворете http://127.0.0.1:8000/ в уеб браузър. Ще видите целевата страница на проекта, както е показано по-долу:

Тайната на клонирането на Django проект

Клонирането на Django проекти помага да оптимизирате времето си. Можете да се концентрирате върху разработването на нови функции, вместо да стартирате проект от нулата.

Тайната на клонирането и стартирането на Django проект на локална машина е да знаете как да се справите със зависимостите. След клонирането се уверете, че създавате нова виртуална среда, инсталирате зависимости и се свързвате към надеждна система от бази данни.

Django е мощна библиотека на Python. Научете как да клонирате и използвате неговите проекти, за да създавате невероятни приложения, които оказват влияние върху технологичната общност.