@swimlane/nodegit 1.1.2

package/.dockerignore

@@ -0,0 +1,2 @@
+node_modules
+test

package/.github/workflows/publish.yml

@@ -0,0 +1,126 @@
+on:
+  push:
+    tags:
+      - v*
+  workflow_dispatch:
+
+jobs:
+  build:
+    # TODO: should we run the tests, or can we assume that a v* tag ought to
+    # get published?
+    name: build
+    strategy:
+      matrix:
+        node: [18.17.0]
+        os:
+          # macos-14 is arm64 (m1)
+          - name: darwin
+            host: macos-14
+
+          # macos-13 is x86
+          - name: mac-x64
+            host: macos-13
+
+          # ubuntu-20.04 is x86. Still no arm linux runners yet
+          # https://docs.github.com/en/actions/using-github-hosted-runners/about-github-hosted-runners/about-github-hosted-runners#standard-github-hosted-runners-for-public-repositories
+          - name: linux
+            host: ubuntu-20.04
+    env:
+      CC: clang
+      CXX: clang++
+      npm_config_clang: 1
+      GYP_DEFINES: use_obsolete_asm=true
+    runs-on: ${{ matrix.os.host }}
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: true
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          check-latest: true
+      - name: Prebuildify
+        run: |
+          [[ $(uname -o) == *Linux ]] && \
+            sudo apt-get update && \
+            sudo apt-get install -y software-properties-common git build-essential clang libssl-dev libkrb5-dev libc++-dev wget python3
+          npm ci --ignore-scripts
+          npm run preinstall
+          npx prebuildify --napi --strip --tag-libc -t "$(node --version | tr -d 'v')"
+      - uses: actions/upload-artifact@v4
+        with:
+          name: prebuild-${{ runner.os }}-${{ runner.arch }}
+          path: ./prebuilds
+          retention-days: 14
+
+  cross-compile:
+    name: "cross compile linux/arm"
+    runs-on: ubuntu-20.04
+    steps:
+      - uses: actions/checkout@v4
+      - uses: docker/setup-qemu-action@v3
+      - name: build linux glibc arm
+        run: |
+          docker build --platform=linux/arm64 --tag nodegit-linux-glibc-arm64 -f scripts/Dockerfile.debian .
+          docker create --platform=linux/arm64 --name nodegit-linux-glibc-arm64 nodegit-linux-glibc-arm64
+          docker cp "nodegit-linux-glibc-arm64:/app/prebuilds" .
+      - name: build linux musl x64
+        run: |
+          docker build --platform=linux/amd64 --tag nodegit-linux-musl-amd64 -f scripts/Dockerfile.alpine .
+          docker create --platform=linux/amd64 --name nodegit-linux-musl-amd64 nodegit-linux-musl-amd64
+          docker cp "nodegit-linux-musl-amd64:/app/prebuilds" .
+      # - name: build linux musl arm
+      #   run: |
+      #     docker build --platform=linux/arm64 --tag nodegit-linux-musl-arm64 -f scripts/Dockerfile.alpine .
+      #     docker create --platform=linux/arm64 --name nodegit-linux-musl-arm64 nodegit-linux-musl-arm64
+      #     docker cp "nodegit-linux-musl-arm64:/app/prebuilds" .
+      - name: "list the generated files"
+        run: find prebuilds
+      - uses: actions/upload-artifact@v4
+        with:
+          name: prebuild-linux-arm64
+          path: ./prebuilds
+          retention-days: 14
+
+  # https://docs.npmjs.com/generating-provenance-statements#publishing-packages-with-provenance-via-github-actions
+  publish:
+    runs-on: ubuntu-latest
+    needs: [build, cross-compile]
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: true
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          check-latest: true
+          registry-url: "https://registry.npmjs.org"
+          scope: "swimlane"
+      - name: download built libraries
+        id: download
+        uses: actions/download-artifact@v4
+        with:
+          path: prebuilds
+      - name: copy libs
+        run: |
+          set -x
+          mkdir -p prebuilds/linux-arm64
+          mkdir -p prebuilds/linux-x64
+          mkdir -p prebuilds/darwin-arm64
+          mkdir -p prebuilds/darwin-x64
+          find ${{ steps.download.outputs.download-path }}
+          mv ${{ steps.download.outputs.download-path}}/prebuild-Linux-X64/linux-x64/* ./prebuilds/linux-x64/
+          mv ${{ steps.download.outputs.download-path}}/prebuild-linux-arm64/linux-arm64/* ./prebuilds/linux-arm64/
+          mv ${{ steps.download.outputs.download-path}}/prebuild-linux-arm64/linux-x64/* ./prebuilds/linux-x64/
+          mv ${{ steps.download.outputs.download-path}}/prebuild-macOS-ARM64/darwin-arm64/* ./prebuilds/darwin-arm64/
+          mv ${{ steps.download.outputs.download-path}}/prebuild-macOS-X64/darwin-x64/* ./prebuilds/darwin-x64/
+          find ./prebuilds
+      - name: npm install
+        run: npm ci --ignore-scripts
+      - name: publish
+        run: |
+          (cat "$NPM_CONFIG_USERCONFIG" || true) && npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.github/workflows/tests.yml

@@ -0,0 +1,85 @@
+on:
+  push:
+    branches:
+      - master
+      - backport/*
+    tags:
+      - v*.*.*
+  pull_request:
+
+jobs:
+  linux-test:
+    name: "test on linux"
+    env:
+      CC: clang
+      CXX: clang++
+      npm_config_clang: 1
+      GYP_DEFINES: use_obsolete_asm=true
+      DEBIAN_FRONTEND: "noninteractive"
+    runs-on: ubuntu-20.04
+    container: ubuntu:20.04
+    steps:
+      - name: prerequisites
+        run: |
+          apt-get update
+          apt-get install -y software-properties-common git build-essential clang libssl-dev libkrb5-dev libc++-dev wget python3
+      - uses: actions/checkout@v4
+        with:
+          submodules: true
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          check-latest: true
+      - name: Test
+        run: |
+          set -xe
+          mkdir ~/.ssh_tests
+          chmod 700 ~/.ssh_tests
+          printf "%b" "Host *\n\tStrictHostKeyChecking no\n" > ~/.ssh_tests/config
+          printf "%b" "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDBkHMoNRRkHYNE7EnQLdFxMgVcqGgNPYDhrWiLMlYuzpmEcUnhwW3zNaIa4J2JlGkRNgYZVia1Ic1V3koJPE3YO2+exAfJBIPeb6O1qDADc2hFFHzd28wmHKUkO61yzo2ZjDQfaEVtjN39Yiy19AbddN3bzNrgvuQT574fa6Rghl2RfecKYO77iHA1RGXIFc8heXVIUuUV/jHjb56WqoHH8vyt1DqUz89oyiHq8Cku0qzKN80COheZPseA1EvT0zlIgbXBxwijN4xRmvInK0fB5Kc9r3kddH2tT7V09bOFJsvGQaQmQ1WFTCqjpBFw1CHKcbfPLOxbLpVIR9gyx03R\n" > ~/.ssh_tests/id_rsa.pub
+          printf "%b" "-----BEGIN RSA PRIVATE KEY-----\nMIIEogIBAAKCAQEAwZBzKDUUZB2DROxJ0C3RcTIFXKhoDT2A4a1oizJWLs6ZhHFJ\n4cFt8zWiGuCdiZRpETYGGVYmtSHNVd5KCTxN2DtvnsQHyQSD3m+jtagwA3NoRRR8\n3dvMJhylJDutcs6NmYw0H2hFbYzd/WIstfQG3XTd28za4L7kE+e+H2ukYIZdkX3n\nCmDu+4hwNURlyBXPIXl1SFLlFf4x42+elqqBx/L8rdQ6lM/PaMoh6vApLtKsyjfN\nAjoXmT7HgNRL09M5SIG1wccIozeMUZryJytHweSnPa95HXR9rU+1dPWzhSbLxkGk\nJkNVhUwqo6QRcNQhynG3zyzsWy6VSEfYMsdN0QIDAQABAoIBABsZNPYBEFy/wPvq\nNJ8/et3lCdkh/oc0ABIYK9Wo82XUKKvhDF3drZ3p+UrX/VYgf+EX9hyf8gVTuSJ3\nX1gRqDhIgeTxPsHGrwt6B6pL5ITnKEbbimuo9Ni1E+2RqUO0ZSCE/1sSRv4CRaXO\nk8HZawif7ttxv4bNUrLys6xEbpvQlOMzgs4s/OBB/XMEqnFRGPJeeTy8bkOWyTwl\nLj06nq2brs4qK4eijI/MoGy1CD8JCpL4gG39GPTXd8GpudXmdelDn1E0t9nhL6Se\naOMaiPhy7kBJD4wZ//WZTSR1XyjNBH3DGkNZxPIWcX+wJFyNoLbSbVSda/7Dtvp3\nCPfiNhECgYEA/+3JswSzcVEANNF5OLZ76x+TODkZ9T6YF4SR8/uJjNViWgUpX7vw\nmyXF+2AwzNaotbBKmNG619BcUeMmQB76c+UiMLeJuJcT/Jj0xmEUopHonGqEIcvg\nHg6cafE1is7d+l669bfjitlx+3muF2CYnylSN1LWHxIITVUj3BmcWqUCgYEAwZ45\nWdaHfK7G6GjI7liDQT4ZlslA8dmLv2Jl2ExBBMoY3m3Sre428z2ZFa4O/nsBYP0a\nDxgYmX20fQGcbPugKdCYHc7HkKbMU1GwiVCGpDYZCm2gJKTvam3dYNaiAfq5DyhP\nzDCZNJ5rrSMprXsuRv2O4c5u8qtJ5ByaOJBjOr0CgYBMlkAxzkpUssS5CaaZDiLv\nLbfEr3HRLjYdc5KpzLBQ8NpJzhmfiIJsK1Wf8B0qb2J1XJg2Oy0KwFOgPbWIoryY\nSg19Pq98Cdn1UWCOrSabr8ZIaKe55WTgGcc8/O3k6BsNfaO9PJZfSssNUlCCtml1\n18u+uo9RJPhPDBd7Gj7r8QKBgFraxWy7t24xkZMDgK4fiM/3tQhFvhz/CY2wPbxG\n5Ae8UfkmLcOCUfTIReqfd9fAnsAFZNIKa5izHRu/wsh9NwYIJSlvm8PsEVtTrPRy\nfgvWet+i24/2eYZGsag8b19gaLCNKQzXDT1czYg8RNVsRSX427BoLzXeXNkW9uNu\nFbI9AoGAV2kxcdcKS4BtNHKPeGgV87dM0DWhQaAtEXEIcQquFtba0lAXioGHg8U4\nzeiugl4Qzchwk5qd3wnZ4SOhx0s16/5gQDlnkbjFR6EREUnvLRwV92zBXUTOGIkh\nZ7Z4rcgUKlVAaHT3OHN/lTyqJG/ib+K4wZhbztl/ox+JUFsvD98=\n-----END RSA PRIVATE KEY-----\n" > ~/.ssh_tests/id_rsa
+          ls ~/.ssh_tests
+          chmod 600 ~/.ssh_tests/id_rsa*
+          git config --global user.name "John Doe"
+          git config --global user.email johndoe@example.com
+
+          eval "$(ssh-agent -s)"
+          ssh-add ~/.ssh_tests/id_rsa
+
+          npm install
+          npm test
+
+  mac-test:
+    name: "macOS tests"
+    env:
+      CC: clang
+      CXX: clang++
+      npm_config_clang: 1
+      GYP_DEFINES: use_obsolete_asm=true
+    runs-on: macos-13
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: true
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          check-latest: true
+      - name: Test
+        run: |
+          set -xe
+          mkdir ~/.ssh_tests
+          chmod 700 ~/.ssh_tests
+          printf "%b" "Host *\n\tStrictHostKeyChecking no\n" > ~/.ssh_tests/config
+          printf "%b" "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDBkHMoNRRkHYNE7EnQLdFxMgVcqGgNPYDhrWiLMlYuzpmEcUnhwW3zNaIa4J2JlGkRNgYZVia1Ic1V3koJPE3YO2+exAfJBIPeb6O1qDADc2hFFHzd28wmHKUkO61yzo2ZjDQfaEVtjN39Yiy19AbddN3bzNrgvuQT574fa6Rghl2RfecKYO77iHA1RGXIFc8heXVIUuUV/jHjb56WqoHH8vyt1DqUz89oyiHq8Cku0qzKN80COheZPseA1EvT0zlIgbXBxwijN4xRmvInK0fB5Kc9r3kddH2tT7V09bOFJsvGQaQmQ1WFTCqjpBFw1CHKcbfPLOxbLpVIR9gyx03R\n" > ~/.ssh_tests/id_rsa.pub
+          printf "%b" "-----BEGIN RSA PRIVATE KEY-----\nMIIEogIBAAKCAQEAwZBzKDUUZB2DROxJ0C3RcTIFXKhoDT2A4a1oizJWLs6ZhHFJ\n4cFt8zWiGuCdiZRpETYGGVYmtSHNVd5KCTxN2DtvnsQHyQSD3m+jtagwA3NoRRR8\n3dvMJhylJDutcs6NmYw0H2hFbYzd/WIstfQG3XTd28za4L7kE+e+H2ukYIZdkX3n\nCmDu+4hwNURlyBXPIXl1SFLlFf4x42+elqqBx/L8rdQ6lM/PaMoh6vApLtKsyjfN\nAjoXmT7HgNRL09M5SIG1wccIozeMUZryJytHweSnPa95HXR9rU+1dPWzhSbLxkGk\nJkNVhUwqo6QRcNQhynG3zyzsWy6VSEfYMsdN0QIDAQABAoIBABsZNPYBEFy/wPvq\nNJ8/et3lCdkh/oc0ABIYK9Wo82XUKKvhDF3drZ3p+UrX/VYgf+EX9hyf8gVTuSJ3\nX1gRqDhIgeTxPsHGrwt6B6pL5ITnKEbbimuo9Ni1E+2RqUO0ZSCE/1sSRv4CRaXO\nk8HZawif7ttxv4bNUrLys6xEbpvQlOMzgs4s/OBB/XMEqnFRGPJeeTy8bkOWyTwl\nLj06nq2brs4qK4eijI/MoGy1CD8JCpL4gG39GPTXd8GpudXmdelDn1E0t9nhL6Se\naOMaiPhy7kBJD4wZ//WZTSR1XyjNBH3DGkNZxPIWcX+wJFyNoLbSbVSda/7Dtvp3\nCPfiNhECgYEA/+3JswSzcVEANNF5OLZ76x+TODkZ9T6YF4SR8/uJjNViWgUpX7vw\nmyXF+2AwzNaotbBKmNG619BcUeMmQB76c+UiMLeJuJcT/Jj0xmEUopHonGqEIcvg\nHg6cafE1is7d+l669bfjitlx+3muF2CYnylSN1LWHxIITVUj3BmcWqUCgYEAwZ45\nWdaHfK7G6GjI7liDQT4ZlslA8dmLv2Jl2ExBBMoY3m3Sre428z2ZFa4O/nsBYP0a\nDxgYmX20fQGcbPugKdCYHc7HkKbMU1GwiVCGpDYZCm2gJKTvam3dYNaiAfq5DyhP\nzDCZNJ5rrSMprXsuRv2O4c5u8qtJ5ByaOJBjOr0CgYBMlkAxzkpUssS5CaaZDiLv\nLbfEr3HRLjYdc5KpzLBQ8NpJzhmfiIJsK1Wf8B0qb2J1XJg2Oy0KwFOgPbWIoryY\nSg19Pq98Cdn1UWCOrSabr8ZIaKe55WTgGcc8/O3k6BsNfaO9PJZfSssNUlCCtml1\n18u+uo9RJPhPDBd7Gj7r8QKBgFraxWy7t24xkZMDgK4fiM/3tQhFvhz/CY2wPbxG\n5Ae8UfkmLcOCUfTIReqfd9fAnsAFZNIKa5izHRu/wsh9NwYIJSlvm8PsEVtTrPRy\nfgvWet+i24/2eYZGsag8b19gaLCNKQzXDT1czYg8RNVsRSX427BoLzXeXNkW9uNu\nFbI9AoGAV2kxcdcKS4BtNHKPeGgV87dM0DWhQaAtEXEIcQquFtba0lAXioGHg8U4\nzeiugl4Qzchwk5qd3wnZ4SOhx0s16/5gQDlnkbjFR6EREUnvLRwV92zBXUTOGIkh\nZ7Z4rcgUKlVAaHT3OHN/lTyqJG/ib+K4wZhbztl/ox+JUFsvD98=\n-----END RSA PRIVATE KEY-----\n" > ~/.ssh_tests/id_rsa
+          ls ~/.ssh_tests
+          chmod 600 ~/.ssh_tests/id_rsa*
+          git config --global user.name "John Doe"
+          git config --global user.email johndoe@example.com
+
+          eval "$(ssh-agent -s)"
+          ssh-add ~/.ssh_tests/id_rsa
+
+          npm install
+          npm test

package/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2014 Tim Branyen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,193 @@
+# NodeGit
+
+> Node bindings to the [libgit2](http://libgit2.github.com/) project.
+
+[![Actions Status](https://github.com/nodegit/nodegit/workflows/Testing/badge.svg)](https://github.com/nodegit/nodegit/actions)
+
+**Stable (libgit2@v0.28.3): 0.28.3**
+
+## Have a problem? Come chat with us!
+
+Visit [slack.libgit2.org](http://slack.libgit2.org/) to sign up, then join us in #nodegit.
+
+## Maintained by
+
+Readme
+
+### Alumni Maintainers
+
+Tim Branyen [@tbranyen](http://twitter.com/tbranyen),
+John Haley [@johnhaley81](http://twitter.com/johnhaley81),
+Max Korp [@maxkorp](http://twitter.com/MaximilianoKorp),
+Steve Smith [@orderedlist](https://twitter.com/orderedlist),
+Michael Robinson [@codeofinterest](http://twitter.com/codeofinterest), and
+Nick Kallen [@nk](http://twitter.com/nk)
+
+## API Documentation.
+
+[http://www.nodegit.org/](http://www.nodegit.org/)
+
+## Getting started.
+
+NodeGit will work on most systems out-of-the-box without any native
+dependencies.
+
+```bash
+npm install nodegit
+```
+
+If you receive errors about libstdc++, which are commonly experienced when
+building on Travis-CI, you can fix this by upgrading to the latest
+libstdc++-4.9.
+
+In Ubuntu:
+
+```sh
+sudo add-apt-repository ppa:ubuntu-toolchain-r/test
+sudo apt-get update
+sudo apt-get install libstdc++-4.9-dev
+```
+
+In Travis:
+
+```yaml
+addons:
+  apt:
+    sources:
+      - ubuntu-toolchain-r-test
+    packages:
+      - libstdc++-4.9-dev
+```
+
+In CircleCI:
+
+```yaml
+dependencies:
+  pre:
+    - sudo add-apt-repository -y ppa:ubuntu-toolchain-r/test
+    - sudo apt-get update
+    - sudo apt-get install -y libstdc++-4.9-dev
+```
+
+If you receive errors about _lifecycleScripts_ preinstall/install you probably miss _libssl-dev_
+In Ubuntu:
+
+```
+sudo apt-get install libssl-dev
+```
+
+You will need the following libraries installed on your linux machine:
+
+- libpcre
+- libpcreposix
+- libkrb5
+- libk5crypto
+- libcom_err
+
+When building locally, you will also need development packages for kerberos and pcre, so both of these utilities must be present on your machine:
+
+- pcre-config
+- krb5-config
+
+If you are still encountering problems while installing, you should try the
+[Building from source](http://www.nodegit.org/guides/install/from-source/)
+instructions.
+
+## API examples.
+
+### Cloning a repository and reading a file:
+
+```javascript
+var Git = require("nodegit");
+
+// Clone a given repository into the `./tmp` folder.
+Git.Clone("https://github.com/nodegit/nodegit", "./tmp")
+  // Look up this known commit.
+  .then(function (repo) {
+    // Use a known commit sha from this repository.
+    return repo.getCommit("59b20b8d5c6ff8d09518454d4dd8b7b30f095ab5");
+  })
+  // Look up a specific file within that commit.
+  .then(function (commit) {
+    return commit.getEntry("README.md");
+  })
+  // Get the blob contents from the file.
+  .then(function (entry) {
+    // Patch the blob to contain a reference to the entry.
+    return entry.getBlob().then(function (blob) {
+      blob.entry = entry;
+      return blob;
+    });
+  })
+  // Display information about the blob.
+  .then(function (blob) {
+    // Show the path, sha, and filesize in bytes.
+    console.log(blob.entry.path() + blob.entry.sha() + blob.rawsize() + "b");
+
+    // Show a spacer.
+    console.log(Array(72).join("=") + "\n\n");
+
+    // Show the entire file.
+    console.log(String(blob));
+  })
+  .catch(function (err) {
+    console.log(err);
+  });
+```
+
+### Emulating git log:
+
+```javascript
+var Git = require("nodegit");
+
+// Open the repository directory.
+Git.Repository.open("tmp")
+  // Open the master branch.
+  .then(function (repo) {
+    return repo.getMasterCommit();
+  })
+  // Display information about commits on master.
+  .then(function (firstCommitOnMaster) {
+    // Create a new history event emitter.
+    var history = firstCommitOnMaster.history();
+
+    // Create a counter to only show up to 9 entries.
+    var count = 0;
+
+    // Listen for commit events from the history.
+    history.on("commit", function (commit) {
+      // Disregard commits past 9.
+      if (++count >= 9) {
+        return;
+      }
+
+      // Show the commit sha.
+      console.log("commit " + commit.sha());
+
+      // Store the author object.
+      var author = commit.author();
+
+      // Display author information.
+      console.log("Author:\t" + author.name() + " <" + author.email() + ">");
+
+      // Show the commit date.
+      console.log("Date:\t" + commit.date());
+
+      // Give some space and show the message.
+      console.log("\n    " + commit.message());
+    });
+
+    // Start emitting events.
+    history.start();
+  });
+```
+
+For more examples, check the `examples/` folder.
+
+## Unit tests.
+
+You will need to build locally before running the tests. See above.
+
+```bash
+npm test
+```

package/lib/attr.js

@@ -0,0 +1,20 @@
+var util = require("util");
+var NodeGit = require("../");
+
+NodeGit.Attr.STATES = {};
+var DEPRECATED_STATES = {
+  UNSPECIFIED_T: "UNSPECIFIED",
+  TRUE_T: "TRUE",
+  FALSE_T: "FALSE",
+  VALUE_T: "STRING"
+};
+
+Object.keys(DEPRECATED_STATES).forEach((key) => {
+  const newKey = DEPRECATED_STATES[key];
+  Object.defineProperty(NodeGit.Attr.STATES, key, {
+    get: util.deprecate(
+      () => NodeGit.Attr.VALUE[newKey],
+      `Use NodeGit.Attr.VALUE.${newKey} instead of NodeGit.Attr.STATES.${key}.`
+    )
+  });
+});

package/lib/blob.js

@@ -0,0 +1,51 @@
+var util = require("util");
+var NodeGit = require("../");
+var Blob = NodeGit.Blob;
+var LookupWrapper = NodeGit.Utils.lookupWrapper;
+var TreeEntry = NodeGit.TreeEntry;
+
+var _filteredContent = Blob.filteredContent;
+
+/**
+* Retrieves the blob pointed to by the oid
+* @async
+* @param {Repository} repo The repo that the blob lives in
+* @param {String|Oid|Blob} id The blob to lookup
+* @return {Blob}
+*/
+Blob.lookup = LookupWrapper(Blob);
+
+/**
+ * Retrieve the content of the Blob.
+ *
+ * @return {Buffer} Contents as a buffer.
+ */
+Blob.prototype.content = function() {
+  return this.rawcontent().toBuffer(this.rawsize());
+};
+
+/**
+ * Retrieve the Blob's type.
+ *
+ * @return {Number} The filemode of the blob.
+ */
+Blob.prototype.filemode = function() {
+  var FileMode = TreeEntry.FILEMODE;
+
+  return this.isBinary() ? FileMode.EXECUTABLE : FileMode.BLOB;
+};
+
+/**
+ * Retrieve the Blob's content as String.
+ *
+ * @return {String} Contents as a string.
+ */
+Blob.prototype.toString = function() {
+  return this.content().toString();
+};
+
+Blob.filteredContent = util.deprecate(
+  _filteredContent,
+  "NodeGit.Blob.filteredContent is deprecated" +
+  " use NodeGit.Blob.prototype.filter instead."
+);

package/lib/branch.js

@@ -0,0 +1,19 @@
+var NodeGit = require("../");
+var Branch = NodeGit.Branch;
+
+var _remoteName = Branch.remoteName;
+
+/**
+ * Retrieve the Branch's Remote Name as a String.
+ *
+ *  @async
+ * @param {Repository} repo The repo to get the remote name from
+ * @param {String} the refname of the branch
+ * @return {String} remote name as a string.
+ */
+Branch.remoteName = function(repo, remoteRef) {
+  return _remoteName.call(this, repo, remoteRef)
+    .then(function(remoteNameBuffer) {
+      return remoteNameBuffer.toString();
+    });
+};

package/lib/buf.js

@@ -0,0 +1,43 @@
+var util = require("util");
+var NodeGit = require("../");
+var Buf = NodeGit.Buf;
+
+var _set = Buf.prototype.set;
+var _grow = Buf.prototype.grow;
+var _isBinary = Buf.prototype.isBinary;
+var _containsNul = Buf.prototype.containsNul;
+
+/**
+ * Sets the content of a GitBuf to a string.
+ * @param {string} The utf8 value to set in the buffer.
+ *                 The string will be null terminated.
+ */
+var _setString = function(content) {
+  const buf = Buffer.from(content + "\0", "utf8");
+  this.set(buf, buf.length);
+};
+
+Buf.prototype.set = util.deprecate(
+  _set,
+  "NodeGit.Buf.prototype.set is deprecated."
+);
+
+Buf.prototype.setString = util.deprecate(
+  _setString,
+  "NodeGit.Buf.prototype.setString is deprecated."
+);
+
+Buf.prototype.grow = util.deprecate(
+  _grow,
+  "NodeGit.Buf.prototype.grow is deprecated."
+);
+
+Buf.prototype.isBinary = util.deprecate(
+  _isBinary,
+  "NodeGit.Buf.prototype.isBinary is deprecated."
+);
+
+Buf.prototype.containsNul = util.deprecate(
+  _containsNul,
+  "NodeGit.Buf.prototype.containsNul is deprecated."
+);