The SNEK project is an attempt to create a transparent, open-source non-profit platform that allows engineers to categorize and compare. It should enable engineers from adjacent fields to visualize each other's skills through visualization and project identification.
Intel serves as the 💚 of SNEK. Intel is the central data processing system for SNEK, providing interfaces to connect our other systems.
Report bug
·
Request feature
·
Documentation
- Installation
- Features
- Usage
- Contributing
- Bugs and feature requests
- Versioning
- Creators
- Thanks
- Copyright and license
The system can be installed using the npm install command:
$ npm install snek-intel- GitLab Querying
- GitHub Querying
- Statistics Generation
- Interface with various GraphQL APIs
- OAuth2-Authentication
- Session Management
/* GitHub Source Object */
let source = {
user: "schettn",
platform: { name: "github", url: "https://api.github.com/graphql" },
authorization: "token XXXXXXXXXXXXXXXX",
};
/* GitLab Source Object */
let source = {
user: "schettn",
platform: { name: "gitlab", url: "https://gitlab.com" },
};await intel.append(source);await intel.appendList([source1, source2]);let data = intel.get();This will erase all data in the database.
intel.resetReducer();Session are completely handled by the Intel.
/*
* Starts the session for an anonymous user or maintains the session if
* a user is logged in.
*/
await intel.snekclient.session.begin();
/*
* Overrides an active session with a new session using the credential
* pair.
*/
await intel.snekclient.session.begin({
username: "schettn",
password: "tschischkotschicko",
});
/* Ends the session */
await intel.snekclient.session.end();All tasks are session aware! Every task has the capability of token handling. Modifying a token is not suggested.
/** Authorization Tasks */
/* Login an anonymous user on the snek-engine */
let userData =
await intel.snekclient.session.tasks.auth.anon();
/* Login a real user on the snek-engine */
let userData =
await intel.snekclient.session.tasks.auth.nonanon();
/* Refresh the user tokens on the snek-engine */
let refreshState =
await intel.snekclient.session.tasks.auth.refresh();
/* Revoke the user tokens on the snek-engine */
let revokeState =
await intel.snekclient.session.tasks.auth.revoke();
/** General Tasks */
/* Get all profile pages from snek-engine */
let pagesData =
await intel.snekclient.session.tasks.general.allPageUrls();
/* Get all GitLab servers from the snek-engine */
let gitlabServerData =
await intel.snekclient.session.tasks.general.gitlabServer();
/** User Tasks */
/* Get all GitLab servers from the snek-engine */
let cachePageData =
await intel.snekclient.session.tasks.user.cache();
/* Get the profile page data from the snek-engine */
let profilePageData =
await intel.snekclient.session.tasks.user.profile();
/* Get the registration data from snek-engine */
let registrationData =
await intel.snekclient.session.tasks.user.registration();
/* Get the whoami data from snek-engine */
let whoamiData =
await intel.snekclient.session.tasks.user.whoami();The client ID, the client secret and the redirect URL are provided by an OAuth organization. To change this file, the repository has to be cloned in order to create a new config file manually.
{
"providers": {
"github": {
"details": {
"dev": {
"clientId": "1440dd4c1d1c4c0fa124",
"clientSecret": "0723a2b5bfef27efc8b2d26d837ead239fa0b0e6",
"redirectUrl": "http://localhost:3000/redirect",
"scope": "repo, user:email, read:user, read:org"
},
"deploy": {
"clientId": "b4337a9c1ad66984c060",
"clientSecret": "1b05648d36ca92d63766e32e8e9a7d740b214816",
"redirectUrl": "https://snek.at/redirect",
"scope": "repo, user:email, read:user, read:org"
}
},
"urls": {
"authorizeUrl": "https://github.com/login/oauth/authorize?redirect_uri=",
"accessTokenUrl": "https://github.com/login/oauth/access_token?code=",
"usernameUrl": "https://api.github.com/user"
}
}
},
"proxyUrl": "https://cors.snek.at/",
"devUrl": "http://localhost:3000"
}Currently, a solution to adapt the config file more easily is under development.
Put this script inside your redirect page to obtain the access token from the OAuth2 request.
/*
* The redirect script:
* Get name of window which was set by the parent to be the unique
* request key
*/
const requestKey = window.name;
// Update corresponding entry with the redirected url which should
// either contain the access token or the reason for failure in the query
// parameter / hash
localStorage.setItem(requestKey, window.location.href);
window.close();/* Import GithubProvider and the RSA */
import RSA, { GithubProvider } from "snek-intel/utils/oauth";
/* Gets the username and accessToken */
const openGitHubOAuth = () => {
return await RSA.acquireTokenAsync(GithubProvider)
};
/* Example on how to call the GitHub OAuth function */
const { data } = openGitHubOAuth();
console.log(data.username, data.accessToken)
Please read through our contributing guidelines. Included are directions for opening issues, coding standards, and notes on development.
All code should conform to the Code Guide, maintained by SNEK.
Do you have a bug or a feature request? Please first search for existing and closed issues. If your problem or idea has not been addressed yet, please open a new issue.
For reasons of transparency concering our release cycle and in striving to maintain backward compatibility, this repository is maintained under the Semantic Versioning guidelines. Some minor screw ups aside, we try to adhere to those rules whenever possible.
|
|
|
| Nico Schett | David Pinterics | Florian Kleber |
We do not have any external contributors yet, but if you want your name to be here, feel free to contribute to our project.
SPDX-License-Identifier: (EUPL-1.2) Copyright © 2019-2020 Simon Prast