gitar

{{repository-description}}

{% block main %}

{% with mdac=materialDesign_accentColor %} {# You'll see why this is handy shortly. #}

<div class="section {{ materialDesign_color }} lighten-2">

</div>

<div class="section">

    <div class="row">

        <div class="col hide-on-med-and-down l4">

            <!-- Add tertiary information such as branches and licensing here.  -->

            <h3 class="{{mdc}}-text">{{repository-name}}</h3>

            {{repository-description}}

            {% for branch in branches %}

            <a class="{{mdac}}-text text-accent-3" href="{% url 'gitar-repository' repository-name branch %}">

            </a><br />

            {% endfor %}

            <h5 class="{{mdc}}-text">{% trans "Extra information" %}</h5>

            <div class="chip">

                {{repository-language}}

            </div><br />

            <div class="chip">

                {{repository-license}}

            </div><br />

        </div>

        <div class="col s12 m8 l5">

            <!-- Main area with links to files and subdirectories -->

            <table class="highlight">

                {% if subdirectories %}

                <thead>

                    {% for subdirectory in subdirectories %}

                    <a href="{% url 'gitar-repository' repository-name branch subdirectory.path %}">

                </thead>

                {% endif %}

                <tbody>

                    {% for file in files %}

                    <a href="{% url 'gitar-repository' repository-name branch file.path %}">

                        </tr>

                </tbody>

            </table>

        </div>

        <div class="col hide-on-small-only m4 l3">

            <!-- List of commits on the current branch, chronologically. -->

            <h3 class="{{mdac}}-text text-accent-3">Commits</h3>

            {% for commit in commits %}

            <hr />

            <a class="{{mdac}}-text text-accent-3" href="{% url 'gitar-commit' repository-name commit.hash">

            </a>

            <span class="{{mdc}}-text text-lighten-2">

                {% trans "by" %} {{commit.author}}

            </span><br />

            {{commit.description|lower|capfirst}}{% if commit.description|last != "." %}.{% endif %}

            {% endfor %}

        </div>

    </div>

</div>

{% endwith %}

{% endblock main %}

    Copyright © 2016 Maarten "Vngngdn" Vangeneugden

    This program is free software: you can redistribute it and/or modify

    it under the terms of the GNU Affero General Public License as

    published by the Free Software Foundation, either version 3 of the

    License, or (at your option) any later version.

    This program is distributed in the hope that it will be useful,

    but WITHOUT ANY WARRANTY; without even the implied warranty of

    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

    GNU Affero General Public License for more details.

    You should have received a copy of the GNU Affero General Public License

    along with this program. If not, see https://www.gnu.org/licenses/agpl.html.

"""

from django.conf.urls import url

from . import views # Imports the views from the same directory (which is views.py).

urlpatterns = [

        url(r'^$', views.index, name='gitar-index'),

        url(r'^(?P<repository_name>\w+)$', views.repositories, name='gitar-repository'),

        url(r'^(?P<repository_name>\w+)/(?P<commit>[0-9a-f]{20})$', views.commit, name='gitar-commit'),

        url(r'^(?P<repository_name>\w+)/(?P<branch>\w+)$', views.repositories, name='gitar-repository'),

        url(r'^(?P<repository_name>\w+)/(?P<branch>\w+)/(?P<path>([^/]+/)+)$', views.path_explorer, name='gitar-path-explorer'),

        ]

# XXX: The URL patterns are a bit error-prone, and assume the repository is not

# named as if R2-D2 would. For example: a hexadecimal string of 20 characters

# is most likely a commit hash, but is a perfectly valid branch name, as well

# as a file AND directory name. But the chance of someone naming his/her branch

# like that is so unlikely I'd rather have it this way for now.

    Copyright © 2016 Maarten "Vngngdn" Vangeneugden

    This program is free software: you can redistribute it and/or modify

    it under the terms of the GNU Affero General Public License as

    published by the Free Software Foundation, either version 3 of the

    License, or (at your option) any later version.

    This program is distributed in the hope that it will be useful,

    but WITHOUT ANY WARRANTY; without even the implied warranty of

    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

    GNU Affero General Public License for more details.

    You should have received a copy of the GNU Affero General Public License

    along with this program. If not, see https://www.gnu.org/licenses/agpl.html.

"""

from django.shortcuts import get_object_or_404, render  # This allows to render the template with the view here. It's pretty cool and important.

from django.http import HttpResponseRedirect, HttpResponse

from django.core.urlresolvers import reverse

from .models import *

from .GitActions import RepoInfo

from git import Repo  # GitPython functionality.

import git

from .syntax import *

# First, I list some standard variables that are common for most of the sites of this app.

def footer_description():

    return "Gitar is a simple web app that allows its users to easily share Git repos in combination with the Django framework."

def footer_links():

    footer_links = [

            #['Source', 'OHGODHELPNOTDONEYET'],

            ['Personal website', reverse('about-index')],

            ]

    return footer_links

def standard_context():

    context = {

            'materialDesign_color': "blue-grey",

            'materialDesign_accentColor': "green",

            'navbar_title': "Gitar",

            'navbar_backArrow': False,

            'footer_title': "Gitar",

            'footer_description': footer_description(),

            'footer_links': footer_links(),

            }

    return context

# From here, the actual views start.

def index(request):

    """ The start page of Gitar.

    The goal of this view, is to collect all the available repositories,

    including some additional information, such as programming language,

    license, description, ... in order to give a fast overview of the most

    prominent information.

    """

    # Collecting the available repositories:

    # Template:

    template = "gitar/index.html"

    # Requesting the repositories:

    modelRepos = Repository.objects.all()

    # From here, we start collecting info about all the repositories:

    class BlankRepository: pass  # Blank object in which all data will be collected.

    repositories = []

    for modelRepo in modelRepos:

        repository = BlankRepository()

        # TODO: Find a way to add all of modelRepo's fields without having to

        # hardcode them. This is prone to errors and is redundant.

        repository.name = str(modelRepo)

        repository.programmingLanguage = modelRepo.programmingLanguage

        repository.license = modelRepo.license

        repository.description = RepoInfo.get_description(modelRepo)

        #gitRepo = Repo.init(modelRepo.directory(), bare=True)  # Connects to the Git Repo.

        # See tests.py, which assures all repositories exist. Tests are handy.

        #repository.description = gitRepo.description

        # This is mostly personal taste, but I like to show the amount of files.

        #repoTree = gitRepo.heads.master.commit.tree

        #repository.fileCount = len(repoTree.blobs)  # blobs are files.

        repositories.append(repository)

    # After that, I extend the standard context with the repositories:

    context = standard_context()

    context['repositories'] = repositories

    # And finally, sending everything back.

    return render(request, template, context)

def commit(request, repository, commit):

    pass  # TODO

def repositories(request, repository_name, branch="master"):

    # A repo's root is a directory by default, so this will automatically return

    # a directory view. But still, this is a bit nicer.

    return path_explorer(request, repository_name, branch, "")

def path_explorer(request, repository_name, branch, path):

    """ Checks whether the given path is a file or a directory, and calls the

    appropriate view function accordingly.

    """

    repository = RepoInfo.get_repository_object(repository_name)

    # From the GitPython documentation:

    # You can obtain the tree object of a repository, which is the directory of

    # that repo. This tree can be accessed as if it were a native Python list,

    # where the elements are the subdirectories and files. So, the idea to

    # determine whether a file, or a directory was requested, is simple:

    # 1. Split the path with "/" as seperator.

    # 2. Replace the current tree variable with the one retrieved from the

    # subtree element

    # 3. Repeat 2. until all parts of the given path are exhausted.

    # If we now still have a tree, we're looking at a directory, so display the

    # files (and subdirectories) of this directory.

    # Else, if we hit a blob, display the file contents.

    path_parts = path.split(sep="/")

    # FIXME: This is a bug at the URL regex part that I haven't been able to fix

    # yet. This serves as a temporary fix:

    # If the last part of the path is an empty string (which happens when the

    # last symbol was a '/'), remove that part from the list.

    # Of course, this is bad monkeypatching, but I suck at regex, so as long as

    # I don't find the solution, this'll have to do.

    print(path_parts)

    if path_parts[len(path_parts)-1] == "":

        path_parts.pop()

    if len(path_parts) == 0:

        directory = repository.heads[branch].commit.tree

        return directory_view(request, repository_name, path, directory)

    assert len(path_parts) != 0

    # FIXME: If the user gives a "<something>/../<somethingElse>", that should

    # become "<something>". Obviously, although I think that's done by default

    # already.

    directory = repository.heads[branch].commit.tree

    for i in range(len(path_parts)):

        subdirectories = directory.trees

        #if len(subdirectories) == 0:

            # This can't happen, as this would imply there is a directory inside

            # a file.

        #    assert False

        #else:

        for subdirectory in subdirectories:

            if subdirectory.name == path_parts[i]:

                directory = subdirectory

                #break  # Useless optimization

    # When there are no more directories to traverse, check if the last part of

    # the path is either a file, or a directory:

    blobs = directory.blobs

    print(path_parts)

    last_part = path_parts[len(path_parts)-1]

    for blob in directory.blobs:

        print(blob.name)

        if blob.name == last_part:

            file_blob = blob

            print("Returning file view")

            return file_view(request, repository_name, branch, path, file_blob)

        else:

            print("blob name: " + blob.name)

            print("last part: " + last_part)

    return directory_view(request, repository_name, branch, path, directory)

def directory_view(request, repository_name, branch, path, directory):

    """ Collects the given directories's files and subdirectories, and renders a

    template to display this data.

    """

    # Collecting files in this directory

    repository = RepoInfo.get_repository_object(repository_name)

    files = []

    for file in directory.blobs:

        files.append({

            name:file.name,

    # Collecting commits for this branch

    commits = []

    for commit in repository.iter_commits(branch):

        commits.append({

            hash:commit.binsha,

    # Collecting subdirectories

    subdirectories = []

    for subdirectory in directory.trees:

        subdirectories.append({

            path:subdirectory.path,

    # Collecting rendering information:

    template = "gitar/directory.html"

    context = standard_context()

    context["files"] = files

    context["subdirectories"] = subdirectories

    context["commits"] = commits

    context["branch"] = branch

    context["repository-name"] = repository_name

    for repo in Repository.objects.all():

        if str(repo) == repository_name:

            context["repository-language"] = repo.programmingLanguage

    return render(request, template, context)

def file_view(request, repository_name, branch, path, ffile):

    """ Collects the file contents of the given file path, and returns it to the

    template, with the file contents already formatted in HTML using Pygments.

    """

    # Turning the file's contents in HTML ready output:

    raw_file_data = ffile.data_stream.read()

    html_code = code_to_HTML(raw_file_data, ffile.name)

    # Collecting rendering information:

    template = "gitar/file.html"

    context = standard_context()

    context["content"] = html_code

    return render(request, template, context)