Gitem
Gitem is a tool for performing Github organizational reconnaissance.
This could include information for:
- OSINT
- Spearphishing
- Recruitment
- Competitive analysis
- OPSEC self-assessment
Installing
$ pip install gitem
$ gitem -h
OR
$ git clone https://github.com/mschwager/gitem.git
$ cd gitem
$ pip install --requirement requirements.txt
$ PYTHONPATH=lib/ python -m gitem -h
Using
Gitem can be used to collect information at various levels of granularity from Github.
Note, most commands will shorten output by default, specify --verbose to change this behavior
For example, let's grab some information about Facebook:
$ gitem organization facebook
Website: https://code.facebook.com/projects/
Username: facebook
Description: We work hard to contribute our work back to the web, mobile, big data, & infrastructure communities. NB: members must have two-factor auth.
Created: 2009-04-02T03:35:22Z
Github URL: https://github.com/facebook
Last Updated: 2016-09-21T15:36:43Z
# of Public Repositories: 173
Location: Menlo Park, California
Organization Name: Facebook
Email Address:
Public Members:
...
Public Repositories:
Repository Name: react
Watchers: 50773
Description: A declarative, efficient, and flexible JavaScript library for building user interfaces.
Created: 2013-05-24T16:15:54Z
Github URL: https://github.com/facebook/react
Last Updated: 2016-10-01T15:09:54Z
Stars: 50773
Forks: 8855
Last Pushed: 2016-10-01T14:27:58Z
Repository Name: react-native
Watchers: 38364
Description: A framework for building native apps with React.
Created: 2015-01-09T18:10:16Z
Github URL: https://github.com/facebook/react-native
Last Updated: 2016-10-01T14:37:29Z
Stars: 38364
Forks: 8531
Last Pushed: 2016-10-01T14:15:31Z
Repository Name: pop
Watchers: 16481
Description: An extensible iOS and OS X animation library, useful for physics-based interactions.
Created: 2014-03-30T22:29:12Z
Github URL: https://github.com/facebook/pop
Last Updated: 2016-10-01T14:12:35Z
Stars: 16481
Forks: 2630
Last Pushed: 2016-08-23T17:23:10Z
...
From here we can drill down into a certain repository:
$ gitem repository facebook react
Repository Name: react
Watchers: 50773
Description: A declarative, efficient, and flexible JavaScript library for building user interfaces.
Last Pushed: 2016-10-01T14:27:58Z
Created: 2013-05-24T16:15:54Z
Github URL: https://github.com/facebook/react
Last Updated: 2016-10-01T15:09:54Z
Language: JavaScript
Stars: 50773
Forks: 8855
Homepage: https://facebook.github.io/react/
Contributors:
Username: zpao
Contributions: 1755
Username: spicyj
Contributions: 1108
Username: jimfb
Contributions: 456
Username: sebmarkbage
Contributions: 378
Username: petehunt
Contributions: 332
...
And finally, we can analyze specific users:
Note, this task is easily parallelizable, so we can specify --processes 4
$ gitem --processes 4 user <redacted>
Username: <redacted>
Updated: 2016-09-29T02:06:31Z
Name: <redacted>
Created: 2008-04-25T04:38:22Z
Github URL: <redacted>
Company: Facebook
Blog: <redacted>
Location: <redacted>
Email Address: <redacted>
Organizations:
Organization: facebook
Organization: reactjs
Organization: relayjs
Repositories:
<redacted>
...
Emails:
<redacted>
...
Developing
First, install development packages:
$ pip install -r requirements-dev.txt
$ pip install -e .
Testing
$ pytest
Linting
$ flake8
Coverage
$ pytest --cov
Metadata
Release files for gitem 0.9.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| gitem-0.9.2-py2.py3-none-any.whl | Python 3, Python 2 | none | any | Details for gitem-0.9.2-py2.py3-none-any.whl |
Release files / gitem-0.9.2-py2.py3-none-any.whl
| Download URL | gitem-0.9.2-py2.py3-none-any.whl |
|---|---|
| Size | 22.9 kB |
| Tags | Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
49452ff765fdb38f210e2b527755ee00c78c36a46746a86a52064df5ef3a23d6
|
|
BLAKE2b-256 checksum How to use checksums |
4254741fed92c350c877df7272c0720202e7621077a2fdedd3231980a8b0e05c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/2.0.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.6.8
|
Security for gitem 0.9.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.