Skip to content

Commit 1d37519

Browse files
pombredannepombredanne
authored
Initial commit
0 parents  commit 1d37519

60 files changed

Lines changed: 6947 additions & 0 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.gitattributes‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# Ignore all Git auto CR/LF line endings conversions
2+
* -text
3+
pyproject.toml export-subst

‎.github/workflows/docs-ci.yml‎

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
name: CI Documentation
2+
3+
on: [push, pull_request]
4+
5+
jobs:
6+
build:
7+
runs-on: ubuntu-24.04
8+
9+
strategy:
10+
max-parallel: 4
11+
matrix:
12+
python-version: [3.13]
13+
14+
steps:
15+
- name: Checkout code
16+
uses: actions/checkout@v4
17+
18+
- name: Set up Python ${{ matrix.python-version }}
19+
uses: actions/setup-python@v5
20+
with:
21+
python-version: ${{ matrix.python-version }}
22+
23+
- name: Install Dependencies
24+
run: ./configure --dev
25+
26+
- name: Check documentation and HTML for errors and dead links
27+
run: make docs-check
28+
29+
- name: Check documentation for style errors
30+
run: make doc8
31+
32+

‎.github/workflows/pypi-release.yml‎

Lines changed: 87 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,87 @@
1+
name: Create library release archives, create a GH release and publish PyPI wheel and sdist on tag in main branch
2+
3+
4+
# This is executed automatically on a tag in the main branch
5+
6+
# Summary of the steps:
7+
# - build wheels and sdist
8+
# - upload wheels and sdist to PyPI
9+
# - create gh-release and upload wheels and dists there
10+
# TODO: smoke test wheels and sdist
11+
# TODO: add changelog to release text body
12+
13+
# WARNING: this is designed only for packages building as pure Python wheels
14+
15+
on:
16+
workflow_dispatch:
17+
push:
18+
tags:
19+
- "v*.*.*"
20+
21+
jobs:
22+
build-pypi-distribs:
23+
name: Build and publish library to PyPI
24+
runs-on: ubuntu-24.04
25+
26+
steps:
27+
- uses: actions/checkout@v4
28+
- name: Set up Python
29+
uses: actions/setup-python@v5
30+
with:
31+
python-version: 3.12
32+
33+
- name: Install pypa/build and twine
34+
run: python -m pip install --user --upgrade build twine pkginfo
35+
36+
- name: Build a binary wheel and a source tarball
37+
run: python -m build --wheel --sdist --outdir dist/
38+
39+
- name: Validate wheel and sdis for Pypi
40+
run: python -m twine check dist/*
41+
42+
- name: Upload built archives
43+
uses: actions/upload-artifact@v4
44+
with:
45+
name: pypi_archives
46+
path: dist/*
47+
48+
49+
create-gh-release:
50+
name: Create GH release
51+
needs:
52+
- build-pypi-distribs
53+
runs-on: ubuntu-24.04
54+
55+
steps:
56+
- name: Download built archives
57+
uses: actions/download-artifact@v4
58+
with:
59+
name: pypi_archives
60+
path: dist
61+
62+
- name: Create GH release
63+
uses: softprops/action-gh-release@v2
64+
with:
65+
draft: true
66+
files: dist/*
67+
68+
69+
create-pypi-release:
70+
name: Create PyPI release
71+
needs:
72+
- create-gh-release
73+
runs-on: ubuntu-24.04
74+
environment: pypi-publish
75+
permissions:
76+
id-token: write
77+
78+
steps:
79+
- name: Download built archives
80+
uses: actions/download-artifact@v4
81+
with:
82+
name: pypi_archives
83+
path: dist
84+
85+
- name: Publish to PyPI
86+
if: startsWith(github.ref, 'refs/tags')
87+
uses: pypa/gh-action-pypi-publish@release/v1

‎.gitignore‎

Lines changed: 76 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,76 @@
1+
# Python compiled files
2+
*.py[cod]
3+
4+
# virtualenv and other misc bits
5+
/src/*.egg-info
6+
*.egg-info
7+
/dist
8+
/build
9+
/bin
10+
/lib
11+
/scripts
12+
/Scripts
13+
/Lib
14+
/pip-selfcheck.json
15+
/tmp
16+
/venv
17+
.Python
18+
/include
19+
/Include
20+
/local
21+
*/local/*
22+
/local/
23+
/share/
24+
/tcl/
25+
/.eggs/
26+
27+
# Installer logs
28+
pip-log.txt
29+
30+
# Unit test / coverage reports
31+
.cache
32+
.coverage
33+
.coverage.*
34+
nosetests.xml
35+
htmlcov
36+
37+
# Translations
38+
*.mo
39+
40+
# IDEs
41+
.project
42+
.pydevproject
43+
.idea
44+
org.eclipse.core.resources.prefs
45+
.vscode
46+
.vs
47+
48+
# Sphinx
49+
docs/_build
50+
docs/bin
51+
docs/build
52+
docs/include
53+
docs/Lib
54+
doc/pyvenv.cfg
55+
pyvenv.cfg
56+
57+
# Various junk and temp files
58+
.DS_Store
59+
*~
60+
.*.sw[po]
61+
.build
62+
.ve
63+
*.bak
64+
/.cache/
65+
66+
# pyenv
67+
/.python-version
68+
/man/
69+
/.pytest_cache/
70+
lib64
71+
tcl
72+
73+
# Ignore Jupyter Notebook related temp files
74+
.ipynb_checkpoints/
75+
/.ruff_cache/
76+
.env

‎.readthedocs.yml‎

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
# .readthedocs.yml
2+
# Read the Docs configuration file
3+
# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
4+
5+
# Required
6+
version: 2
7+
8+
# Build in latest ubuntu/python
9+
build:
10+
os: ubuntu-22.04
11+
tools:
12+
python: "3.13"
13+
14+
# Build PDF & ePub
15+
formats:
16+
- epub
17+
- pdf
18+
19+
# Where the Sphinx conf.py file is located
20+
sphinx:
21+
configuration: docs/source/conf.py
22+
23+
# Setting the python version and doc build requirements
24+
python:
25+
install:
26+
- method: pip
27+
path: .
28+
extra_requirements:
29+
- dev

‎AUTHORS.rst‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
The following organizations or individuals have contributed to this repo:
2+
3+
-

‎CHANGELOG.rst‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
Changelog
2+
=========
3+
4+
5+
v0.0.0
6+
------
7+
8+
*xxxx-xx-xx* -- Initial release.

‎CODE_OF_CONDUCT.rst‎

Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,86 @@
1+
Contributor Covenant Code of Conduct
2+
====================================
3+
4+
Our Pledge
5+
----------
6+
7+
In the interest of fostering an open and welcoming environment, we as
8+
contributors and maintainers pledge to making participation in our
9+
project and our community a harassment-free experience for everyone,
10+
regardless of age, body size, disability, ethnicity, gender identity and
11+
expression, level of experience, education, socio-economic status,
12+
nationality, personal appearance, race, religion, or sexual identity and
13+
orientation.
14+
15+
Our Standards
16+
-------------
17+
18+
Examples of behavior that contributes to creating a positive environment
19+
include:
20+
21+
- Using welcoming and inclusive language
22+
- Being respectful of differing viewpoints and experiences
23+
- Gracefully accepting constructive criticism
24+
- Focusing on what is best for the community
25+
- Showing empathy towards other community members
26+
27+
Examples of unacceptable behavior by participants include:
28+
29+
- The use of sexualized language or imagery and unwelcome sexual
30+
attention or advances
31+
- Trolling, insulting/derogatory comments, and personal or political
32+
attacks
33+
- Public or private harassment
34+
- Publishing others’ private information, such as a physical or
35+
electronic address, without explicit permission
36+
- Other conduct which could reasonably be considered inappropriate in a
37+
professional setting
38+
39+
Our Responsibilities
40+
--------------------
41+
42+
Project maintainers are responsible for clarifying the standards of
43+
acceptable behavior and are expected to take appropriate and fair
44+
corrective action in response to any instances of unacceptable behavior.
45+
46+
Project maintainers have the right and responsibility to remove, edit,
47+
or reject comments, commits, code, wiki edits, issues, and other
48+
contributions that are not aligned to this Code of Conduct, or to ban
49+
temporarily or permanently any contributor for other behaviors that they
50+
deem inappropriate, threatening, offensive, or harmful.
51+
52+
Scope
53+
-----
54+
55+
This Code of Conduct applies both within project spaces and in public
56+
spaces when an individual is representing the project or its community.
57+
Examples of representing a project or community include using an
58+
official project e-mail address, posting via an official social media
59+
account, or acting as an appointed representative at an online or
60+
offline event. Representation of a project may be further defined and
61+
clarified by project maintainers.
62+
63+
Enforcement
64+
-----------
65+
66+
Instances of abusive, harassing, or otherwise unacceptable behavior may
67+
be reported by contacting the project team at pombredanne@gmail.com
68+
or on the Gitter chat channel at https://gitter.im/aboutcode-org/discuss .
69+
All complaints will be reviewed and investigated and will result in a
70+
response that is deemed necessary and appropriate to the circumstances.
71+
The project team is obligated to maintain confidentiality with regard to
72+
the reporter of an incident. Further details of specific enforcement
73+
policies may be posted separately.
74+
75+
Project maintainers who do not follow or enforce the Code of Conduct in
76+
good faith may face temporary or permanent repercussions as determined
77+
by other members of the project’s leadership.
78+
79+
Attribution
80+
-----------
81+
82+
This Code of Conduct is adapted from the `Contributor Covenant`_ ,
83+
version 1.4, available at
84+
https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
85+
86+
.. _Contributor Covenant: https://www.contributor-covenant.org

‎MANIFEST.in‎

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
graft src
2+
graft docs
3+
graft etc
4+
5+
include *.LICENSE
6+
include NOTICE
7+
include *.ABOUT
8+
include *.toml
9+
include *.yml
10+
include *.rst
11+
include *.png
12+
include setup.*
13+
include configure*
14+
include requirements*
15+
include .dockerignore
16+
include .gitignore
17+
include .readthedocs.yml
18+
include manage.py
19+
include Dockerfile*
20+
include Makefile
21+
include MANIFEST.in
22+
23+
include .VERSION
24+
25+
global-exclude *.py[co] __pycache__ *.*~

0 commit comments

Comments
 (0)