Metadata-Version: 2.4
Name: stackalytics
Version: 1.0.1.dev1429
Summary: OpenStack Contribution Dashboard
Home-page: https://www.stackalytics.io
Author: OpenStack
Author-email: openstack-discuss@lists.openstack.org
Project-URL: Bug Tracker, https://bugs.launchpad.net/stackalytics
Project-URL: Documentation, https://wiki.openstack.org/wiki/Stackalytics
Project-URL: Source Code, https://opendev.org/x/stackalytics
Classifier: Environment :: OpenStack
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.9
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: alabaster<0.7.14
Requires-Dist: pbr>=2.0.0
Requires-Dist: Babel>=2.3.4
Requires-Dist: itsdangerous<2.1
Requires-Dist: Flask!=0.11,<1.0,>=0.10
Requires-Dist: iso8601>=0.1.11
Requires-Dist: Jinja2<3.1.0
Requires-Dist: jsonschema!=2.5.0,<3.0.0,>=2.0.0
Requires-Dist: oslo.config>=3.22.0
Requires-Dist: oslo.i18n>=2.1.0
Requires-Dist: oslo.log>=3.22.0
Requires-Dist: oslo.serialization>=1.10.0
Requires-Dist: oslo.utils>=3.20.0
Requires-Dist: paramiko>=2.0
Requires-Dist: psutil>=3.2.2
Requires-Dist: PyGithub
Requires-Dist: python-memcached>=1.56
Requires-Dist: PyYAML>=3.10.0
Requires-Dist: requests!=2.12.2,!=2.13.0,>=2.10.0
Requires-Dist: requests-file
Requires-Dist: sh
Requires-Dist: six>=1.9.0
Requires-Dist: setuptools!=50.0.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

Stackalytics
============

Application Features
--------------------
Stackalytics is a service that automatically analyzes OpenStack
development activities and displays statistics on contribution. The features are:

* Extraction of author information from git log, store it in the database;
* Calculate metrics on number of lines changed (LOC) and commits;
* Mapping authors to companies and launchpad ids;
* Filter statistics by time, modules, companies, authors;
* Extract blueprint and bug ids from commit messages;
* Auto-update of database.

Quickstart
----------

To run Stackalytics, you first need to create two kind of configuration files.
The one is default_data.json which shows which sources(git repo, ml, etc.) need
to be analyzed. Another is stackalytics.conf which shows basic configuration like
HTTP listening host and port, etc. Stackalytics repository contains the default
files of these configuration under etc/ directory. It would be useful to copy and
change them as you like.

#. You need to install Stackalytics. This is done with pip after you check out
   Stackalytics repository::

    $ git clone https://opendev.org/x/stackalytics
    $ cd stackalytics
    $ sudo pip install -r requirements.txt
    $ sudo python setup.py install

#. Install and run memcached DB::

    $ sudo apt-get install memcached
    $ memcached -u memcache -d

#. Analyze data which are specifed on default_data.json and store the data into memcached DB::

    $ stackalytics-processor

#. Start HTTP server of Stackalytics::

    $ stackalytics-dashboard

#. Users can access Stackalytics site on http://127.0.0.1:8080 as the default.


Project Info
------------

 * Web-site: https://stackalytics.io/
 * Source Code: https://opendev.org/x/stackalytics
 * Wiki: https://wiki.openstack.org/wiki/Stackalytics
 * Launchpad: https://launchpad.net/stackalytics
 * Blueprints: https://blueprints.launchpad.net/stackalytics
 * Bugs: https://bugs.launchpad.net/stackalytics
 * Code Reviews: https://review.opendev.org/#/q/status:open+project:x/stackalytics,n,z
 * IRC: #openstack-stackalytics at OFTC

