Imager api

.gitignore

@@ -27,6 +27,7 @@ bin/
 lib64
 pyvenv.cfg
 share/
+pip-selfcheck.json
 
 # PyInstaller
 #  Usually these files are written by a python script from a template
@@ -91,3 +92,7 @@ ENV/
 
 # Rope project settings
 .ropeproject
+
+# Ignore the files in the Media directory, but not the directory itself
+imagersite/MEDIA/*
+!imagersite/MEDIA/.gitkeep

.travis.yml

@@ -0,0 +1,25 @@
+language: python
+python:
+  - "2.7"
+  - "3.5"
+
+# command to install dependencies
+install:
+  # - pip install .
+  - pip install -r requirements.pip
+
+services:
+  - postgresql
+
+before_script:
+  - psql -c 'create database travis_ci_test;' -U postgres
+
+env:
+  global:
+    secure: "c3J0p4fxJkSRfcwkYRmsRcjkgcwnZsIk9ODOwp0061iOHMSMdgzwbxBKWloSboBHuqpH+3qR+BsmW0CiuZo2sFnifT8NTMnllhNyVOSVTVflCMHZ/rkk5VYkEsBr+ao9r1k47OZKsq6297m116ou2iOGIJVokCpRHh0cOBY28FNSt6+x9lXksfdQKS8JT8DchO7ZCbYdv3FEPGhnnyQ8bpWV9VCdBcCoXOLQfYdXXyptUwbbW9sxCyHbTKgaPl85uBchFAG6H0l9kM2jOrFfXPgCTik5pJiznS2pLbTgq+p3WhqAJcU1kBeJcZJ+TGod3kvM3mHGRklMs8evKl7edcfVHCtGMGt9vuP6uOPM+JlY2m3ANkfM2wpTz3HgO/pxg1vG0HMqywhm6Q7rxhoBZAFqGdB/oePrDesBR7JRsVis1kE5nT9Lp/9XFiLhJ0K8p1hHZW2MW3HQs10JQwqDLNCkeA9rBnOaRy2chQ2uXkOJeT6E22cD4ktYHse6ay6XWQX9VA8oiYNc4eadCT7dbdaev7J2iesNCP9FOx7We4zVtDa5gzP1p++zhiP9yFz++3Dl47HTAZrxAxtyFI4zH0l/UuCws3Z66SxjFTEs5PcwC6uIktSeGjXvabMSHZmi1KDh9zg9bXjCzf/KZXZ2OprkFgUqWjoPtP7VZ50YQ6g="
+
+# command to run tests
+script: python imagersite/manage.py test
+
+notifications:
+  email: false

README.md

@@ -1,2 +1,111 @@
-# django-imager
-django introduction assignment
+[![Build Status](https://travis-ci.org/pasaunders/django-imager.svg?branch=deployment)](https://travis-ci.org/pasaunders/django-imager)
+# Django-Imager
+An image display app built in django as a learning project
+
+Creators:
+
+Amos Bolder, Patrick Saunders
+
+URL: http://ec2-54-202-239-113.us-west-2.compute.amazonaws.com/
+
+
+##Getting Started
+
+Clone this repository into whatever directory you want to work from.
+```
+https://github.com/pasaunders/django-imager.git
+```
+Assuming that you have access to Python 3 at the system level, start up a new virtual environment.
+```
+$ cd django-imager
+$ python3 -m venv ENV
+$ source ENV/bin/activate
+```
+Once your environment has been activated, make sure to install Django and all of this project's required packages.
+```
+$ pip install -r requirements.pip
+```
+Navigate to the project root, imagersite, and apply the migrations for the app.
+```
+$ cd imagersite
+
+$ ./manage.py migrate
+```
+Finally, run the server in order to server the app on localhost
+```
+$ ./manage.py runserver
+```
+Django will typically serve on port 8000, unless you specify otherwise. You can access the locally-served site at the address http://localhost:8000.
+
+
+##Current Models (outside of Django built-ins):
+
+This application allow users to store and organize photos.
+
+**The `ImagerProfile` model contains:**
+
+- Address
+- Bio
+- Personal website
+- Whether the user is for hire
+- Distance the user is willing to travel for work
+- Phone contact
+- User's preferred style of photography
+- The model manager has been edited to provide a list of active users
+
+**The `Photo` model contains:**
+
+- The Image
+- Image title
+- A description of the image
+- Records of the dates when the image was uploaded, last modified, and published.
+- Whether the image is public, private or shared
+Photos are associated with users in a many-to-one relationship
+
+**The `Album` model contains:**
+
+- An album cover image
+- Album title
+- A description of the album
+- Date the album was created, modified and published
+- Whether the album is public, private or shared
+Albums are associated with users in a many-to-one relationship
+Albums are associated with photos in a many-to-many relationship
+
+##Current URL Routes
+
+- `/admin` Superuser admin page
+- `/` Home page
+- `/login` Login page
+- `/logout` Logout route, no view
+- `/accounts/register` Register a user form
+- `/accounts/activate/complete/` Activation complete view
+- `/accounts/register/complete/` Registration complete, email sent
+- `/profile/` Authenticated user's profile view
+- `/profile/edit/` Profile edit view
+- `/profile/<username>/` Profile view for named user
+- `/images/photos/add/` Add a photo
+- `/images/<photo_id>/` View a single photo
+- `/images/<photo_id>/edit` Edit a photo
+- `/images/photos/` View all of an authenticated user's authorized photos
+- `/images/albums/<album_id>/` View a particular album
+- `/images/albums/<album_id>/edit` Edit an album
+- `/images/albums/add/` Add an album
+- `/images/albums/` View all authorized volumes
+- `/images/library/` View authenticated user's library
+- `/images/tagged/<slug>/` View photos with a tag
+- `/api/v1/` Api access
+- `/oauth/` Social django package
+
+
+##Running Tests
+
+Running tests for the django-imager is fairly straightforward. Navigate to the same directory as the manage.py file and type:
+```
+$ coverage run manage.py test
+```
+This will show you which tests have failed, which tests have passed. If you'd like a report of the actual coverage of your tests, type
+```
+$ coverage report
+```
+This will read from the included .coverage file, with configuration set in the .coveragerc file. Currently the configuration will show which lines were missing from the test coverage.

imagersite/.coveragerc

@@ -0,0 +1,20 @@
+[run]
+omit =
+   */migrations/*,
+   */tests.py
+   manage.py
+   imagersite/wsgi.py
+   imagersite/urls.py
+   imagersite/views.py
+   */apps.py
+   */admin.py
+   */__init__.py
+
+source =
+   imagersite
+   imager_images
+   imager_api
+   imager_profile
+
+[report]
+show_missing = True

imagersite/imager_api/admin.py

@@ -0,0 +1,3 @@
+from django.contrib import admin
+
+# Register your models here.

imagersite/imager_api/apps.py

@@ -0,0 +1,5 @@
+from django.apps import AppConfig
+
+
+class ImagerApiConfig(AppConfig):
+    name = 'imager_api'

imagersite/imager_api/models.py

@@ -0,0 +1,3 @@
+from django.db import models
+
+# Create your models here.

imagersite/imager_api/permissions.py

@@ -0,0 +1,10 @@
+"""Permissions for api."""
+from rest_framework import permissions
+
+
+class Owner(permissions.BasePermission):
+    """Permission to only allow owners of object to view."""
+
+    def has_object_permission(self, request, view, obj):
+        """Check object permissions against the request's user."""
+        return obj.user == request.user

imagersite/imager_api/serializers.py

@@ -0,0 +1,24 @@
+"""Serializers fo rest api."""
+from imager_images.models import Photo
+from rest_framework import serializers
+
+
+class PhotosSerializer(serializers.HyperlinkedModelSerializer):
+    """Serializer for Photos."""
+
+    user = serializers.ReadOnlyField(source='user.username')
+
+    class Meta:
+        """Meta."""
+
+        model = Photo
+        fields = (
+            'user',
+            'image',
+            'title',
+            'description',
+            'date_uploaded',
+            'date_modified',
+            'date_published',
+            'published'
+        )

imagersite/imager_api/tests.py

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

imagersite/imager_api/views.py

@@ -0,0 +1,16 @@
+"""Views for restfull api."""
+from imager_images.models import Photo
+from rest_framework import viewsets, permissions
+from imager_api.serializers import PhotosSerializer
+from imager_api.permissions import Owner
+
+
+class PhotoViewSet(viewsets.ReadOnlyModelViewSet):
+    """Provides a list of all photos belonging to a user."""
+
+    serializer_class = PhotosSerializer
+    permission_classes = (permissions.IsAuthenticated, Owner)
+
+    def get_queryset(self):
+        """Get photos owned by current user."""
+        return Photo.objects.filter(user=self.request.user)

imagersite/imager_images/admin.py

@@ -0,0 +1,5 @@
+from django.contrib import admin
+from imager_images.models import Album, Photo
+
+admin.site.register(Album)
+admin.site.register(Photo)

imagersite/imager_images/apps.py

@@ -0,0 +1,5 @@
+from django.apps import AppConfig
+
+
+class ImagerImagesConfig(AppConfig):
+    name = 'imager_images'

imagersite/imager_images/migrations/0001_initial.py

@@ -0,0 +1,61 @@
+# -*- coding: utf-8 -*-
+# Generated by Django 1.10.5 on 2017-01-19 05:16
+from __future__ import unicode_literals
+
+from django.conf import settings
+from django.db import migrations, models
+import django.db.models.deletion
+import imager_images.models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='Album',
+            fields=[
+                ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('title', models.CharField(max_length=60)),
+                ('description', models.TextField(max_length=200)),
+                ('date_created', models.DateTimeField(auto_now_add=True)),
+                ('date_modified', models.DateTimeField(auto_now=True)),
+                ('date_published', models.DateTimeField(null=True)),
+                ('published', models.CharField(choices=[('private', 'private'), ('shared', 'shared'), ('public', 'public')], max_length=10)),
+            ],
+        ),
+        migrations.CreateModel(
+            name='Photo',
+            fields=[
+                ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('image', models.ImageField(upload_to=imager_images.models.image_path)),
+                ('title', models.CharField(max_length=60)),
+                ('description', models.TextField(max_length=120)),
+                ('date_uploaded', models.DateTimeField(auto_now_add=True)),
+                ('date_modified', models.DateTimeField(auto_now=True)),
+                ('date_published', models.DateTimeField(null=True)),
+                ('published', models.CharField(choices=[('private', 'private'), ('shared', 'shared'), ('public', 'public')], max_length=10)),
+                ('user', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='photos', to=settings.AUTH_USER_MODEL)),
+            ],
+        ),
+        migrations.AddField(
+            model_name='album',
+            name='cover',
+            field=models.ForeignKey(null=True, on_delete=django.db.models.deletion.CASCADE, related_name='albums_covered', to='imager_images.Photo'),
+        ),
+        migrations.AddField(
+            model_name='album',
+            name='photos',
+            field=models.ManyToManyField(related_name='albums', to='imager_images.Photo'),
+        ),
+        migrations.AddField(
+            model_name='album',
+            name='user',
+            field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='albums', to=settings.AUTH_USER_MODEL),
+        ),
+    ]

imagersite/imager_images/migrations/0002_auto_20170131_1449.py

@@ -0,0 +1,46 @@
+# -*- coding: utf-8 -*-
+# Generated by Django 1.10.5 on 2017-01-31 22:49
+from __future__ import unicode_literals
+
+from django.db import migrations, models
+import imager_images.models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('imager_images', '0001_initial'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='album',
+            name='date_published',
+            field=models.DateTimeField(blank=True, null=True),
+        ),
+        migrations.AlterField(
+            model_name='album',
+            name='published',
+            field=models.CharField(choices=[('private', 'private'), ('shared', 'shared'), ('public', 'public')], default='public', max_length=10),
+        ),
+        migrations.AlterField(
+            model_name='photo',
+            name='date_published',
+            field=models.DateTimeField(blank=True, null=True),
+        ),
+        migrations.AlterField(
+            model_name='photo',
+            name='description',
+            field=models.TextField(blank=True, max_length=120, null=True),
+        ),
+        migrations.AlterField(
+            model_name='photo',
+            name='image',
+            field=models.ImageField(blank=True, null=True, upload_to=imager_images.models.image_path),
+        ),
+        migrations.AlterField(
+            model_name='photo',
+            name='published',
+            field=models.CharField(choices=[('private', 'private'), ('shared', 'shared'), ('public', 'public')], default='public', max_length=10),
+        ),
+    ]

imagersite/imager_images/migrations/0003_photo_tags.py

@@ -0,0 +1,22 @@
+# -*- coding: utf-8 -*-
+# Generated by Django 1.10.5 on 2017-02-02 02:16
+from __future__ import unicode_literals
+
+from django.db import migrations
+import taggit.managers
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('taggit', '0002_auto_20150616_2121'),
+        ('imager_images', '0002_auto_20170131_1449'),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name='photo',
+            name='tags',
+            field=taggit.managers.TaggableManager(help_text='A comma-separated list of tags.', through='taggit.TaggedItem', to='taggit.Tag', verbose_name='Tags'),
+        ),
+    ]