Skip to content

Commit ad05d8c

Browse files
author
Jon Wayne Parrott
authored
Basic project setup (googleapis#4)
1 parent 074bbad commit ad05d8c

22 files changed

Lines changed: 1419 additions & 0 deletions

‎packages/google-auth/.coveragerc‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
[run]
2+
branch = True
3+
4+
[report]
5+
omit =
6+
*/samples/*
7+
*/conftest.py
8+
exclude_lines =
9+
# Re-enable the standard pragma
10+
pragma: NO COVER
11+
# Ignore debug-only repr
12+
def __repr__
13+
# Don't complain if tests don't hit defensive assertion code:
14+
raise NotImplementedError

‎packages/google-auth/.gitignore‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
# Build artifacts
2+
*.py[cod]
3+
__pycache__
4+
*.egg-info/
5+
build/
6+
dist/
7+
8+
# Documentation-related
9+
docs/_build
10+
11+
# Test files
12+
.tox/
13+
.cache/
14+
15+
# Django test database
16+
db.sqlite3
17+
18+
# Coverage files
19+
.coverage
20+
coverage.xml
21+
nosetests.xml
22+
htmlcov/
23+
24+
# Files with private / local data
25+
scripts/local_test_setup
26+
tests/data/key.json
27+
tests/data/key.p12
28+
tests/data/user-key.json
29+
30+
# PyCharm configuration:
31+
.idea

‎packages/google-auth/.travis.yml‎

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
language: python
2+
sudo: false
3+
matrix:
4+
include:
5+
- python: 3.5
6+
env: TOXENV=lint
7+
- python: 3.5
8+
env: TOXENV=docs
9+
- python: 2.7
10+
env: TOXENV=py27
11+
- python: 3.4
12+
env: TOXENV=py34
13+
- python: 3.5
14+
env: TOXENV=py35
15+
- python: 3.5
16+
env: TOXENV=cover
17+
cache:
18+
directories:
19+
- ${HOME}/.cache
20+
install:
21+
- pip install --upgrade tox
22+
script:
23+
- tox

‎packages/google-auth/CONTRIBUTING.rst‎

Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,78 @@
1+
Contributing
2+
============
3+
4+
#. **Please sign one of the contributor license agreements below.**
5+
#. Fork the repo, develop and test your code changes, add docs.
6+
#. Make sure that your commit messages clearly describe the changes.
7+
#. Send a pull request.
8+
9+
Here are some guidelines for hacking on ``google-auth-library-python``.
10+
11+
Making changes
12+
--------------
13+
14+
A few notes on making changes to ``google-auth-libary-python``.
15+
16+
- If you've added a new feature or modified an existing feature, be sure to
17+
add or update any applicable documentation in docstrings and in the
18+
documentation (in ``docs/``). You can re-generate the reference documentation
19+
using ``tox -e docgen``.
20+
21+
- The change must work fully on the following CPython versions: 2.7,
22+
3.4, and 3.5 across macOS, Linux, and Windows.
23+
24+
- The codebase *must* have 100% test statement coverage after each commit.
25+
You can test coverage via ``tox -e cover``.
26+
27+
Testing changes
28+
---------------
29+
30+
To test your changes, run unit tests with ``tox``::
31+
32+
$ tox -e py27
33+
$ tox -e py34
34+
$ tox -e py35
35+
36+
Coding Style
37+
------------
38+
39+
This library is PEP8 & Pylint compliant. Our Pylint config is defined at
40+
``pylintrc`` for package code and ``pylintrc.tests`` for test code. Use
41+
``tox`` to check for non-compliant code::
42+
43+
$ tox -e lint
44+
45+
Documentation Coverage and Building HTML Documentation
46+
------------------------------------------------------
47+
48+
If you fix a bug, and the bug requires an API or behavior modification, all
49+
documentation in this package which references that API or behavior must be
50+
changed to reflect the bug fix, ideally in the same commit that fixes the bug
51+
or adds the feature.
52+
53+
To build and review docs use ``tox``::
54+
55+
$ tox -e docs
56+
57+
The HTML version of the docs will be built in ``docs/_build/html``
58+
59+
Versioning
60+
----------
61+
62+
This library follows `Semantic Versioning`_.
63+
64+
.. _Semantic Versioning: http://semver.org/
65+
66+
It is currently in major version zero (``0.y.z``), which means that anything
67+
may change at any time and the public API should not be considered
68+
stable.
69+
70+
Contributor License Agreements
71+
------------------------------
72+
73+
Before we can accept your pull requests you'll need to sign a Contributor License Agreement (CLA):
74+
75+
- **If you are an individual writing original source code** and **you own the intellectual property**, then you'll need to sign an `individual CLA <https://developers.google.com/open-source/cla/individual>`__.
76+
- **If you work for a company that wants to allow you to contribute your work**, then you'll need to sign a `corporate CLA <https://developers.google.com/open-source/cla/corporate>`__.
77+
78+
You can sign these electronically (just scroll to the bottom). After that, we'll be able to accept your pull requests.

‎packages/google-auth/CONTRIBUTORS.md‎

Lines changed: 96 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,96 @@
1+
# Contribors to oauth2client / google-auth
2+
3+
## Maintainers
4+
5+
* [Jon Wayne Parrott](https://github.com/jonparrott)
6+
* [Danny Hermes](https://github.com/dhermes)
7+
* [Brian Watson](https://github.com/bjwatson)
8+
9+
Previous maintainers:
10+
11+
* [Nathaniel Manista](https://github.com/nathanielmanistaatgoogle)
12+
* [Craig Citro](https://github.com/craigcitro)
13+
* [Joe Gregorio](https://github.com/jcgregorio)
14+
15+
## Contributors
16+
17+
This list is generated from git commit authors.
18+
19+
* aalexand <aalexand@google.com>
20+
* Aaron <aaronwinter@users.noreply.github.com>
21+
* Adam Chainz <me@adamj.eu>
22+
* ade@google.com
23+
* Alexandre Vivien <alx.vivien@gmail.com>
24+
* Ali Afshar <afshar@google.com>
25+
* Andrzej Pragacz <apragacz@o2.pl>
26+
* api.nickm@gmail.com
27+
* Ben Demaree <bendemaree@gmail.com>
28+
* Bill Prin <waprin@gmail.com, waprin@google.com>
29+
* Brendan McCollam <brendan@mccoll.am, bmccollam@uchicago.edu>
30+
* Craig Citro <craigcitro@gmail.com, craigcitro@google.com>
31+
* Dan Ring <dfring@gmail.com>
32+
* Daniel Hermes <dhermes@google.com, daniel.j.hermes@gmail.com>
33+
* Danilo Akamine <danilowz@gmail.com>
34+
* daryl herzmann <akrherz@iastate.edu>
35+
* dlorenc <lorenc.d@gmail.com>
36+
* Dominik Miedziński <dominik@mdzn.pl>
37+
* dr. Kertész Csaba-Zoltán <cskertesz@gmail.com>
38+
* Dustin Farris <dustin@dustinfarris.com>
39+
* Eddie Warner <happyspace@gmail.com>
40+
* Edwin Amsler <EdwinGuy@GMail.com>
41+
* elibixby <elibixby@google.com>
42+
* Emanuele Pucciarelli <ep@acm.org>
43+
* Eric Koleda <eric.koleda@google.com>
44+
* Frederik Creemers <frederikcreemers@gmail.com>
45+
* Guido van Rossum <guido@google.com>
46+
* Harsh Vardhan <harshvd95@gmail.com>
47+
* Herr Kaste <thdz.x@gmx.net>
48+
* INADA Naoki <inada-n@klab.com>
49+
* JacobMoshenko <moshenko@google.com>
50+
* Jay Lee <jay0lee@gmail.com>
51+
* Jed Hartman <jhartman@google.com>
52+
* Jeff Terrace <jterrace@gmail.com, jterrace@google.com>
53+
* Jeffrey Sorensen <sorensenjs@users.noreply.github.com>
54+
* Jeremi Joslin <jeremi@collabspot.com>
55+
* Jin Liu <liujin@google.com>
56+
* Joe Beda <jbeda@google.com>
57+
* Joe Gregorio <jcgregorio@google.com, joe.gregorio@gmail.com>
58+
* Johan Euphrosine <proppy@google.com>
59+
* John Asmuth <jasmuth@gmail.com, jasmuth@google.com>
60+
* John Vandenberg <jayvdb@gmail.com>
61+
* Jon Wayne Parrott <jon.wayne.parrott@gmail.com, jonwayne@google.com>
62+
* Jose Alcerreca <jalc@google.com>
63+
* KCs <cskertesz@gmail.com>
64+
* Keith Maxwell <keith.maxwell@gmail.com>
65+
* Ken Payson <kpayson@google.com>
66+
* Kevin Regan <regank@google.com>
67+
* lraccomando <lraccomando@gmail.com>
68+
* Luar Roji <cyberplant@users.noreply.github.com>
69+
* Luke Blanshard <leadpipe@google.com>
70+
* Marc Cohen <marccohen@google.com>
71+
* Mark Pellegrini <markpell@google.com>
72+
* Martin Trigaux <mat@odoo.com>
73+
* Matt McDonald <mmcdonald@google.com>
74+
* Nathan Naze <nanaze@gmail.com>
75+
* Nathaniel Manista <nathaniel@google.com>
76+
* Orest Bolohan <orest@google.com>
77+
* Pat Ferate <pferate@gmail.com>
78+
* Patrick Costello <pcostello@google.com>
79+
* Rafe Kaplan <rafek@google.com>
80+
* rahulpaul@google.com <rahulpaul@google.com>
81+
* RM Saksida <rsaksida@gmail.com>
82+
* Robert Kaplow <rkaplow@google.com>
83+
* Robert Spies <wilford@google.com>
84+
* Sergei Trofimovich <siarheit@google.com>
85+
* sgomes@google.com <sgomes@google.com>
86+
* Simon Cadman <src@niftiestsoftware.com>
87+
* soltanmm <soltanmm@users.noreply.github.com>
88+
* Sébastien de Melo <sebastien.de-melo@ubicast.eu>
89+
* takuya sato <sato-taku@klab.com>
90+
* thobrla <thobrla@google.com>
91+
* Tom Miller <tom.h.miller@gmail.com>
92+
* Tony Aiuto <aiuto@google.com>
93+
* Travis Hobrla <thobrla@google.com>
94+
* Veres Lajos <vlajos@gmail.com>
95+
* Vivek Seth <vivekseth.m@gmail.com>
96+
* Éamonn McManus <eamonn@mcmanus.net>

‎packages/google-auth/MANIFEST.in‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
include README.rst
2+
graft google
3+
graft tests
4+
global-exclude *.pyc __pycache__

‎packages/google-auth/README.rst‎

Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,53 @@
1+
Google Auth Python Library (Experimental)
2+
=========================================
3+
4+
|build| |docs| |pypi|
5+
6+
This library simplifies using Google's various server-to-server authentication
7+
mechanisms to access Google APIs.
8+
9+
.. |build| image:: https://travis-ci.org/GoogleCloudPlatform/google-auth-library-python.svg?branch=master
10+
:target: https://travis-ci.org/GoogleCloudPlatform//google-auth-library-python
11+
.. |docs| image:: https://readthedocs.org/projects/google-auth/badge/?version=latest
12+
:target: https://google-auth.readthedocs.io/en/latest/
13+
.. |pypi| image:: https://img.shields.io/pypi/v//google-auth.svg
14+
:target: https://pypi.python.org/pypi/google-auth
15+
16+
Installing
17+
----------
18+
19+
You can install directly from `GitHub`_::
20+
21+
$ pip install git+https://github.com/GoogleCloudPlatform/google-auth-library-python.git
22+
23+
This package is not currently available from PyPI because it is experimental.
24+
25+
.. _GitHub: https://github.com/GoogleCloudPlatform/google-auth-library-python
26+
27+
Documentation
28+
-------------
29+
30+
Google Auth Python Library has usage and reference documentation at `google-auth.readthedocs.io <https://google-auth.readthedocs.io>`_.
31+
32+
Maintainers
33+
-----------
34+
35+
- `@jonparrott <https://github.com/jonparrott>`_ (Jon Wayne Parrott)
36+
- `@dhermes <https://github.com/dhermes>`_ (Danny Hermes)
37+
- `@bjwatson <https://github.com/bjwatson>`_ (Brian Watson)
38+
39+
Contributing
40+
------------
41+
42+
Contributions to this library are always welcome and highly encouraged.
43+
44+
See `CONTRIBUTING`_ for more information on how to get started.
45+
46+
.. _CONTRIBUTING: https://github.com/GoogleCloudPlatform/google-auth-library-python/blob/master/CONTRIBUTING.rst
47+
48+
License
49+
-------
50+
51+
Apache 2.0 - See `LICENSE`_ for more information.
52+
53+
.. _LICENSE: https://github.com/GoogleCloudPlatform/google-auth-library-python/blob/master/LICENSE

0 commit comments

Comments
 (0)