Skip to main content

Thin wrapper for interacting with the Github GraphQL API

Project description

ghgql

Thin wrapper for interacting with the Github GraphQL API.

Status

Documentation Status CodeQL ci-cd codecov release

Documentation

Please find the documentation and usage examples here: https://ghgql.readthedocs.io/en/latest/

Installation

$ pip install ghgql

Usage

For a more in-depth example, take a look at the example in the documentation. Here's a basic example.

import os
import fnc
import ghgql

query = """
query ($searchQuery: String!) {
  search(query: $searchQuery, type: ISSUE, first: 1) {
    edges {
      node {
        ... on Issue {
          id
          number
          title
          url
        }
      }
    }
  }
}
"""

with ghgql.GithubGraphQL(token=os.getenv("GITHUB_TOKEN")) as ghapi:
    result = ghapi.query(query=query, variables={"searchQuery": "llvm/llvm-project"})
    print(fnc.get("search.edges", result))

Should output something like this:

[{'node': {'id': 'I_kwDOHicqdc5RG-tC',
   'number': 16,
   'title': 'llvm/llvm-project',
   'url': 'https://github.com/KhushP786/open-sauced-goals/issues/16'}}]

Contributing

Interested in contributing? Check out the contributing guidelines. Please note that this project is released with a Code of Conduct. By contributing to this project, you agree to abide by its terms.

Commit message conventions and semantic versioniong (semver)

We use semantic versioning and these commit message conventions can be used to automatically bump the version number and generate the changelog.

License

ghgql was created by Konrad Kleine. It is licensed under the terms of the MIT license.

Credits

This project was created with the help of this python packaging documentation.

ghgql was created with cookiecutter and the py-pkgs-cookiecutter template.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ghgql-1.0.5.tar.gz (5.2 kB view hashes)

Uploaded Source

Built Distribution

ghgql-1.0.5-py3-none-any.whl (4.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page