Metadata-Version: 2.4
Name: chipshot
Version: 0.9.0
Summary: Set up game-winning headers!
License-Expression: MIT
License-File: LICENSE.txt
Author: Kurt McKee
Author-email: contactme@kurtmckee.org
Requires-Python: >=3.10
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Dist: click (>=8.1.7)
Requires-Dist: jinja2 (>=3.1.3)
Requires-Dist: tomli (>=2.0.1) ; python_version < "3.11"
Project-URL: Changelog, https://chipshot.readthedocs.io/en/latest/changelog/
Project-URL: Documentation, https://chipshot.readthedocs.io
Project-URL: Donate via GitHub, https://github.com/sponsors/kurtmckee
Project-URL: Donate via Ko-Fi, https://ko-fi.com/kurtmckee
Project-URL: Source, https://github.com/kurtmckee/chipshot
Description-Content-Type: text/x-rst

..
    This file is a part of Chipshot <https://github.com/kurtmckee/chipshot>
    Copyright 2022-2026 Kurt McKee <contactme@kurtmckee.org>
    SPDX-License-Identifier: MIT


Chipshot
########

*Set up game-winning headers!*

----

Chipshot helps standardize header information in software development files.

Its target goal is to ensure that copyright dates are standardized
and that licensing information is present.

It supports a wide range of file formats,
including source code and documentation formats.
It purposely does not support configuration file formats by default
(such as TOML, INI, or YAML)
but can be configured to support those, too.


Sample configuration
====================

Create a file named ``.chipshot.toml`` with the following content:

..  code-block:: toml

    [chipshot]
    template = """
    Copyright 2021-{{ year }} Developer or Company
    Released under the terms of the MIT license.
    SPDX-License-Identifier: MIT
    """

You can then run ``chipshot path1 path2`` to see what files will be modified.
If you're satisfied, run ``chipshot --update path1 path2`` to update the files.


Pre-commit hooks
================

Chipshot offers two pre-commit hooks to help you manage your projects:

*   ``check-headers``
*   ``update-headers``

Here's a sample configuration for ensuring your files have correct headers:

..  # [[[cog
..  # import assets.update_readme_pre_commit_example
..  # assets.update_readme_pre_commit_example.main()
..  # ]]]

..  DO NOT EDIT THIS CODE BLOCK!
..  INSTEAD, EDIT assets/update_readme_pre_commit_example.py.

..  code-block:: yaml

    # Filename: .pre-commit-config.yaml
    repos:
      - repo: 'https://github.com/kurtmckee/chipshot'
        rev: 'v0.9.0'
        hooks:
          - id: 'update-headers'

..  # [[[end]]]

