Skip to main content

Credit parser and markdown language for scientific software.

Project description

CiteLang

PyPI version

https://raw.githubusercontent.com/vsoch/citelang/main/docs/assets/img/citelang-tree.png

Welcome to CiteLang! This is the first markdown syntax for citing software. Importantly, when you use CiteLang to reference software.

  1. Generate basic software credit trees (citelang graph, badge, or credit)
  2. Give credit accounting for dependencies! (see software-credit.md)
  3. Actions (automation) for the above!

No - we aren't using DOIs! A manually crafted identifier that a human has to remember to generate, in addition to a publication or release, is too much work for people to reasonably do. As research software engineers we also want to move away from the traditional "be valued like an academic" model. We are getting software metadata and a reference to an identifier via a package manager. This means that when you publish your software, you should publish it to an appropriate package manager.

⭐️ Documentation ⭐️

TODO

  • citelang should be able to parse requirements.txt or go.sum, etc.
  • add graphic summary (need static version to go into markdown)
  • colors should be meaningful
  • finish GitHub actions (render, docs, remember to mention to use token, etc.)
  • add gha to run here!

Contributors

We use the all-contributors tool to generate a contributors graphic below.


Vanessasaurus

💻

License

This code is licensed under the MPL 2.0 LICENSE.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

citelang-0.0.14.tar.gz (44.9 kB view details)

Uploaded Source

Built Distribution

citelang-0.0.14-py3-none-any.whl (58.9 kB view details)

Uploaded Python 3

File details

Details for the file citelang-0.0.14.tar.gz.

File metadata

  • Download URL: citelang-0.0.14.tar.gz
  • Upload date:
  • Size: 44.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/4.8.2 pkginfo/1.8.2 requests/2.27.1 requests-toolbelt/0.9.1 tqdm/4.63.0 CPython/3.9.7

File hashes

Hashes for citelang-0.0.14.tar.gz
Algorithm Hash digest
SHA256 cc780de8de5b8de46f8b6e4ad61b7afd234306512744dd360335724a406cb111
MD5 8214340bcc357882d862c4878cab14db
BLAKE2b-256 fa4f7c22f9528a8cb3b13c9b09f71101967142208da8b16e97759b5b55978709

See more details on using hashes here.

Provenance

File details

Details for the file citelang-0.0.14-py3-none-any.whl.

File metadata

  • Download URL: citelang-0.0.14-py3-none-any.whl
  • Upload date:
  • Size: 58.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.7.1 importlib_metadata/4.8.2 pkginfo/1.8.2 requests/2.27.1 requests-toolbelt/0.9.1 tqdm/4.63.0 CPython/3.9.7

File hashes

Hashes for citelang-0.0.14-py3-none-any.whl
Algorithm Hash digest
SHA256 bb4010909fe98dac7db7b1fb158c975be177929d2b1b5feccfc566da5502bed2
MD5 2776aa798a315b0614a948791bf823ac
BLAKE2b-256 5fe4cfe446c88a4fb4f6019c7b44664b26c7ae74de999681e5edc0f20e4925ca

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page