Merge pull request #1 from shenxianpeng/master

Support Python 3.9

.github/workflows/pre-commit.yml

@@ -0,0 +1,10 @@
+name: Run pre-commit
+
+on:
+  push:
+  pull_request:
+    types: opened
+
+jobs:
+  pre-commit:
+    uses: shenxianpeng/.github/.github/workflows/pre-commit.yml@main

.gitignore

@@ -0,0 +1 @@
+venv/

.pre-commit-config.yaml

@@ -0,0 +1,21 @@
+repos:
+-   repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+    -   id: check-yaml
+    -   id: check-toml
+    -   id: end-of-file-fixer
+    -   id: trailing-whitespace
+    -   id: requirements-txt-fixer
+-   repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.13.0
+    hooks:
+    -   id: mypy
+-   repo: https://github.com/psf/black
+    rev: 24.10.0
+    hooks:
+    -   id: black
+-   repo: https://github.com/codespell-project/codespell
+    rev: v2.3.0
+    hooks:
+    -   id: codespell

README.md

@@ -0,0 +1,43 @@
+# gitstats
+
+gitstats is a statistics generator for git repositories. It is mostly intended
+for developers, as a way to check some development statistics for a project.
+
+Currently it produces only HTML output with tables and graphs.
+
+> [!NOTE]
+> This project is a fork of [gitstats](https://github.com/hoxu/gitstats), which only supports Python 2.7 and is no longer maintained.
+>
+> I forked the project to update it for compatibility with Python 3.9+ and to introduce new features.
+
+Requirements
+============
+- Python 3.9+
+- Gnuplot (http://www.gnuplot.info/)
+
+Usage
+=====
+
+    ./gitstats --help
+
+    Usage: gitstats [options] <gitpath..> <outputpath>
+
+    Options:
+    -c key=value     Override configuration value
+
+    Default config values:
+    {'max_domains': 10, 'max_ext_length': 10, 'style': 'gitstats.css', 'max_authors': 20, 'authors_top': 5, 'commit_begin': '', 'commit_end': 'HEAD', 'linear_linestats': 1, 'project_name': '', 'processes': 8, 'start_date': ''}
+
+    Please see the manual page for more details.
+
+Examples
+--------
+
+    ./gitstats ../gitstats ~/public_html
+
+The output will be generated in the given directory.
+
+Contributions
+=============
+Patches should be sent under "GPLv2 or later" license - this will allow
+upgrading to newer GPL versions if they are sensible.

doc/AUTHOR

@@ -6,4 +6,3 @@ See the following command for list of authors who have contributed:
 
 Also thanks to the following people:
 Alexander Botero-Lowry
-

doc/TODO.txt

@@ -74,4 +74,3 @@
 	- Commits (% of all)
 	- Author top ten
 	- Month statistics
-

doc/gitstats.pod

@@ -112,4 +112,3 @@ http://gitstats.sourceforge.net/
 =head1 SEE ALSO
 
 L<git(1)>
-