# updateCitation
updateCitation is a Python tool that automates the maintenance of citation metadata in software projects. It helps researchers and developers ensure their work is properly citeable while maintaining consistent metadata across different platforms.
## Key Features
- Automatic generation and updates of CITATION.cff files
- Seamless integration with Python package metadata from pyproject.toml
- Synchronization with GitHub release information
- Integration with PyPI package metadata
- Validation of citation metadata format
- GitHub Actions support for automated updates
## Installation
```bash
pip install updateCitation
```
## Usage
The simplest way to use updateCitation is to run it from your repository root:
```python
import updateCitation
updateCitation.here()
```
For custom pyproject.toml locations:
```python
updateCitation.here("path/to/pyproject.toml")
```
## GitHub Actions Integration
updateCitation provides a GitHub Action that automatically updates your citation metadata on each push. To enable this:
1. Create `.github/workflows/updateCitation.yml` in your repository
2. Copy the provided workflow configuration
3. Commit and push to activate automated citation updates
## Configuration
updateCitation primarily uses your project's `pyproject.toml` file for configuration. Essential fields include:
### Required Fields
- `name`: Package name
- `version`: Current version
- `authors`: List of authors with names and emails
### Recommended Fields
- `description`: Project description
- `keywords`: Search keywords
- `license`: License information
- `urls`: Project URLs (homepage, repository, etc.)
### Optional Tool Settings
You can customize updateCitation's behavior in the `[tool.updateCitation]` section of pyproject.toml.
## Documentation
For detailed documentation, examples, and best practices, visit our [GitHub repository](https://github.com/hunterhogan/updateCitation).
## Contributing
Contributions are welcome! Please feel free to submit pull requests.
## My recovery
[](https://HunterThinks.com/support)
[](https://www.youtube.com/@HunterHogan)
## How to code
Coding One Step at a Time:
0. WRITE CODE.
1. Don't write stupid code that's hard to revise.
2. Write good code.
3. When revising, write better code.
[](https://creativecommons.org/licenses/by-nc/4.0/)
Raw data
{
"_id": null,
"home_page": null,
"name": "updateCitation",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "academic-software, automation, cff, citation, citation-files, doi, github, metadata, publishing, references, research-software, scholarly-communication, software-citation, zenodo",
"author": null,
"author_email": "Hunter Hogan <HunterHogan@pm.me>",
"download_url": "https://files.pythonhosted.org/packages/a1/ca/211a02adb91325a2bda76d036bb04d033b00eec9174380a672f1a4e2bc81/updatecitation-0.0.11.tar.gz",
"platform": null,
"description": "# updateCitation\n\nupdateCitation is a Python tool that automates the maintenance of citation metadata in software projects. It helps researchers and developers ensure their work is properly citeable while maintaining consistent metadata across different platforms.\n\n## Key Features\n\n- Automatic generation and updates of CITATION.cff files\n- Seamless integration with Python package metadata from pyproject.toml\n- Synchronization with GitHub release information\n- Integration with PyPI package metadata\n- Validation of citation metadata format\n- GitHub Actions support for automated updates\n\n## Installation\n\n```bash\npip install updateCitation\n```\n\n## Usage\n\nThe simplest way to use updateCitation is to run it from your repository root:\n\n```python\nimport updateCitation\nupdateCitation.here()\n```\n\nFor custom pyproject.toml locations:\n\n```python\nupdateCitation.here(\"path/to/pyproject.toml\")\n```\n\n## GitHub Actions Integration\n\nupdateCitation provides a GitHub Action that automatically updates your citation metadata on each push. To enable this:\n\n1. Create `.github/workflows/updateCitation.yml` in your repository\n2. Copy the provided workflow configuration\n3. Commit and push to activate automated citation updates\n\n## Configuration\n\nupdateCitation primarily uses your project's `pyproject.toml` file for configuration. Essential fields include:\n\n### Required Fields\n\n- `name`: Package name\n- `version`: Current version\n- `authors`: List of authors with names and emails\n\n### Recommended Fields\n\n- `description`: Project description\n- `keywords`: Search keywords\n- `license`: License information\n- `urls`: Project URLs (homepage, repository, etc.)\n\n### Optional Tool Settings\n\nYou can customize updateCitation's behavior in the `[tool.updateCitation]` section of pyproject.toml.\n\n## Documentation\n\nFor detailed documentation, examples, and best practices, visit our [GitHub repository](https://github.com/hunterhogan/updateCitation).\n\n## Contributing\n\nContributions are welcome! Please feel free to submit pull requests.\n\n## My recovery\n\n[](https://HunterThinks.com/support)\n[](https://www.youtube.com/@HunterHogan)\n\n## How to code\n\nCoding One Step at a Time:\n\n0. WRITE CODE.\n1. Don't write stupid code that's hard to revise.\n2. Write good code.\n3. When revising, write better code.\n\n[](https://creativecommons.org/licenses/by-nc/4.0/)\n",
"bugtrack_url": null,
"license": "CC-BY-NC-4.0",
"summary": "Automatically update citation files (CITATION.cff) in a GitHub repository from `pyproject.toml`, GitHub releases, and PyPI releases.",
"version": "0.0.11",
"project_urls": {
"Donate": "https://www.patreon.com/integrated",
"Homepage": "https://github.com/hunterhogan/updateCitation",
"Repository": "https://github.com/hunterhogan/updateCitation.git"
},
"split_keywords": [
"academic-software",
" automation",
" cff",
" citation",
" citation-files",
" doi",
" github",
" metadata",
" publishing",
" references",
" research-software",
" scholarly-communication",
" software-citation",
" zenodo"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "a3e5e492bc70d78bb4d8091571f8105c233ee99255211f32beff31cc6ae7d18f",
"md5": "9332609c71355c9bfc6a89d7f06efd54",
"sha256": "e12bf5bc24b4720e76188c225a57a07a803fdab9ab3325b2398d4aed19cbd3c0"
},
"downloads": -1,
"filename": "updatecitation-0.0.11-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9332609c71355c9bfc6a89d7f06efd54",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 27390,
"upload_time": "2025-07-12T20:14:01",
"upload_time_iso_8601": "2025-07-12T20:14:01.524567Z",
"url": "https://files.pythonhosted.org/packages/a3/e5/e492bc70d78bb4d8091571f8105c233ee99255211f32beff31cc6ae7d18f/updatecitation-0.0.11-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "a1ca211a02adb91325a2bda76d036bb04d033b00eec9174380a672f1a4e2bc81",
"md5": "08d1692cd085712e8a0cbbb597053103",
"sha256": "ab2f0a4ad7a223c0ac591962482256c37b9fff3be26051ea94497149ff1b2a59"
},
"downloads": -1,
"filename": "updatecitation-0.0.11.tar.gz",
"has_sig": false,
"md5_digest": "08d1692cd085712e8a0cbbb597053103",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 24159,
"upload_time": "2025-07-12T20:14:02",
"upload_time_iso_8601": "2025-07-12T20:14:02.610039Z",
"url": "https://files.pythonhosted.org/packages/a1/ca/211a02adb91325a2bda76d036bb04d033b00eec9174380a672f1a4e2bc81/updatecitation-0.0.11.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-12 20:14:02",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "hunterhogan",
"github_project": "updateCitation",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "updatecitation"
}
JSON
