Merge branch 'master' into mandelbrot

Author: bzaczynski

dwitter-part-1/README.md

@@ -0,0 +1,57 @@
+# Dwitter - Your tiny social network built with Django
+
+This web app models the basic functionality of Twitter.
+
+You can:
+
+- **Post** short text-based messages
+- **View** all users on the platform
+- **Follow** and unfollow other users
+- **Inspect** a feed of messages from users that you follow
+
+Follow the [step-by-step instructions](https://realpython.com/django-social-network-1/) on _Real Python_ to build your own version of Dwitter.
+
+## Setup
+
+You can run the provided example project on your local machine by following the steps outlined below.
+
+Create a new virtual environment:
+
+```bash
+python3 -m venv venv
+```
+
+Activate the virtual environment:
+
+```bash
+source ./venv/bin/activate
+```
+
+Navigate to the folder for the step you're currently on.
+
+Install the dependencies for this project if you haven't installed them yet:
+
+```bash
+(venv) $ python -m pip install -r requirements.txt
+```
+
+Make and apply the migrations for the project to build your local database:
+
+```bash
+(venv) $ python manage.py makemigrations
+(venv) $ python manage.py migrate
+```
+
+Create a superuser that allows you to log in to your Django admin portal:
+
+```bash
+(venv) $ python manage.py createsuperuser
+```
+
+Run the Django development server:
+
+```bash
+(venv) $ python manage.py runserver
+```
+
+Navigate to `http://localhost:8000/admin` and log in with your superuser credentials. You can create users through the Django admin and explore your social media platform with multiple users.

dwitter-part-1/source_code_final/dwitter/__init__.py

@@ -0,0 +1,18 @@
+from django.contrib import admin
+from django.contrib.auth.models import User, Group
+from .models import Profile
+
+
+class ProfileInline(admin.StackedInline):
+    model = Profile
+
+
+class UserAdmin(admin.ModelAdmin):
+    model = User
+    fields = ["username"]
+    inlines = [ProfileInline]
+
+
+admin.site.unregister(User)
+admin.site.register(User, UserAdmin)
+admin.site.unregister(Group)

dwitter-part-1/source_code_final/dwitter/admin.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class DwitterConfig(AppConfig):
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "dwitter"

dwitter-part-1/source_code_final/dwitter/apps.py

@@ -0,0 +1,25 @@
+# Generated by Django 3.2.8 on 2021-10-08 09:55
+
+from django.conf import settings
+from django.db import migrations, models
+import django.db.models.deletion
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='Profile',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('follows', models.ManyToManyField(blank=True, related_name='followed_by', to='dwitter.Profile')),
+                ('user', models.OneToOneField(on_delete=django.db.models.deletion.CASCADE, to=settings.AUTH_USER_MODEL)),
+            ],
+        ),
+    ]

dwitter-part-1/source_code_final/dwitter/migrations/0001_initial.py

@@ -0,0 +1,23 @@
+from django.db import models
+from django.db.models.signals import post_save
+from django.dispatch import receiver
+from django.contrib.auth.models import User
+
+
+class Profile(models.Model):
+    user = models.OneToOneField(User, on_delete=models.CASCADE)
+    follows = models.ManyToManyField(
+        "self", related_name="followed_by", symmetrical=False, blank=True
+    )
+
+    def __str__(self):
+        return self.user.username
+
+
+@receiver(post_save, sender=User)
+def create_profile(sender, instance, created, **kwargs):
+    if created:
+        user_profile = Profile(user=instance)
+        user_profile.save()
+        user_profile.follows.add(instance.profile)
+        user_profile.save()

dwitter-part-1/source_code_final/dwitter/migrations/__init__.py

@@ -0,0 +1,3 @@
+# from django.test import TestCase
+
+# Create your tests here.

dwitter-part-1/source_code_final/dwitter/models.py

@@ -0,0 +1,3 @@
+# from django.shortcuts import render
+
+# Create your views here.

dwitter-part-1/source_code_final/dwitter/tests.py

@@ -0,0 +1,22 @@
+#!/usr/bin/env python
+"""Django's command-line utility for administrative tasks."""
+import os
+import sys
+
+
+def main():
+    """Run administrative tasks."""
+    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "social.settings")
+    try:
+        from django.core.management import execute_from_command_line
+    except ImportError as exc:
+        raise ImportError(
+            "Couldn't import Django. Are you sure it's installed and "
+            "available on your PYTHONPATH environment variable? Did you "
+            "forget to activate a virtual environment?"
+        ) from exc
+    execute_from_command_line(sys.argv)
+
+
+if __name__ == "__main__":
+    main()