xaizek / zograscope (License: AGPLv3 only) (since 2018-12-07)
Mainly a syntax-aware diff that also provides a number of additional tools.
<root> / tools / gdiff / Repository.hpp (647714229d96b7288cf49e098731c8f13cf79569) (2,359B) (mode 100644) [raw]
// Copyright (C) 2018 xaizek <xaizek@posteo.net>
//
// This file is part of zograscope.
//
// zograscope is free software: you can redistribute it and/or modify
// it under the terms of version 3 of the GNU Affero General Public License as
// published by the Free Software Foundation.
//
// zograscope 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 zograscope.  If not, see <http://www.gnu.org/licenses/>.

#ifndef ZOGRASCOPE_TOOLS_GDIFF_REPOSITORY_HPP_
#define ZOGRASCOPE_TOOLS_GDIFF_REPOSITORY_HPP_

#include <string>
#include <vector>

// This unit provides facilities for interacting with a repository.  With git
// being the only VCS that is supported.

struct git_repository;

class DiffEntry;

// Simple RAII class to keep track of libgit2 usage.
class LibGitUser
{
public:
    // Informs libgit2 about one more client.
    LibGitUser();
    // No copy/move constructing.
    LibGitUser(const LibGitUser &rhs) = delete;
    // No copy/move assigning.
    LibGitUser & operator=(const LibGitUser &rhs) = delete;
    // Informs libgit2 about one less client.
    ~LibGitUser();
};

// Provides high-level access to repository data.
class Repository
{
public:
    // Creates an instance from path to or in repository.  Throws
    // `std::runtime_error` on failure to find or open repository.
    explicit Repository(const std::string &path);

    // No copy/move constructing.
    Repository(const Repository &rhs) = delete;
    // No copy/move assigning.
    Repository & operator=(const Repository &rhs) = delete;

    // Frees resources allocated for the repository.
    ~Repository();

public:
    // Lists either staged or unstaged modified entries in the working directory
    // of the repository.
    std::vector<DiffEntry> listStatus(bool staged);

    // Lists change set of specified reference against its parent.
    std::vector<DiffEntry> listCommit(const std::string &ref);

public:
    const LibGitUser libgitUser; // libgit2 lifetime management.
    git_repository *repo;        // Repository handle.
};

#endif // ZOGRASCOPE_TOOLS_GDIFF_REPOSITORY_HPP_
Hints

Before first commit, do not forget to setup your git environment:
git config --global user.name "your_name_here"
git config --global user.email "your@email_here"

Clone this repository using HTTP(S):
git clone https://code.reversed.top/user/xaizek/zograscope

Clone this repository using ssh (do not forget to upload a key first):
git clone ssh://rocketgit@code.reversed.top/user/xaizek/zograscope

You are allowed to anonymously push to this repository.
This means that your pushed commits will automatically be transformed into a pull request:
... clone the repository ...
... make some changes and some commits ...
git push origin master