Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added demokit metadata #76

Closed
wants to merge 2 commits into from
Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
82 changes: 82 additions & 0 deletions mdakits/demokit/metadata.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,82 @@
# TEMPLATE MDAKit file
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

replace with something else so that it doesn't look like a template

# --------------------
#
# Please replace ALL entries with appropriate content for YOUR MDAKit.
# Below we use the placeholder GH_HOST_ACCOUNT for the GitHub account where
# the source code repository is held, typically your username or the
# organization that you're part off.
# MYPROJECT is the name of your project (the repository name and here
# we assume that this is also the PyPi/conda package name) whereas
# MYPACKAGE is how you import it in python.
Comment on lines +4 to +10
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'd remove this, too.

#
# See https://mdakits.mdanalysis.org/add.html for more information.
#
# Required entries
## str: name of the project (the respository name)
project_name: demokit
## List(str): a link to the authors file (preferred) or a list of authors
authors:
- https://github.com/ianmkenney/demokit/blob/main/AUTHORS
## List(str): a list of maintainers
maintainers:
- ianmkenney
## str: a free form description of the mdakit
description:
Implements the RMSF analysis class from MDAnalysis core.
## List(str): a list of keywords which describe the mdakit
keywords:
- RMSF
## str: the license the mdakit falls under
license: GPL-2.0-or-later
## str: the link to the project's code
project_home: https://github.com/ianmkenney/demokit/
## str: the link to the project's documentation
documentation_home: https://demokit.readthedocs.io
## str: the type of documentation available [UserGuide, API, README]
documentation_type: API

# Optional entries
## List(str): a list of commands to use when installing the latest
## release of the code. Note: only one installation method can currently
## be defined. We suggest using mamba where possible (e.g.
## mamba -c conda-forge install MYPROJECT
## for a conda package installation)
## List(str): a list of commands to use when installing the mdakit from its
## source code.
src_install:
- pip install git+https://github.com/ianmkenney/demokit@main
## str: the package name used to import the mdakit
import_name: demokit
## str: a specification for the range of Python versions supported by this MDAKit
python_requires: ">=3.9"
## str: a specification for the range of MDAnalysis versions supported by this MDAKit
mdanalysis_requires: ">=2.0.0"
## List(str): a list of commands to use when attempting to run the MDAKit's tests
## If you package your tests inside your package then you can typically use the
## pytest --pyargs MYPACKAGE.tests
## command as shown below.
## Otherwise you need to include commands to make the tests available.
## For example, if the tests are in the repository at the top level under `./tests`:
## First use `git clone latest` to either clone the top commit for "develop" runs or check out
## the latest tag for "latest release" checks. Then then run pytest:
## - git clone latest
## - pytest -v ./tests
## Feel free to ask for advice on your pull request!
run_tests:
- pytest --pyargs demokit.tests
## List(str): a list of commands to use to install the necessary dependencies required
## to run the MDAKit's tests.
## The default below _might_ be sufficient or you might not even need MDAnalysisTests:
## make sure that it is appropriate for how you run tests.
test_dependencies:
- mamba install pytest MDAnalysisTests
## str: the organisation name the MDAKit falls under
## str: the development status of the MDAKit
## See https://pypi.org/classifiers/ for development status classifiers.
development_status: Productions/Stable
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

bold statement :-)

## List(str) a list of publications to cite when using the MDAKit
## Links to scientific publications or stable URLs (typically of the form
## https://doi.org/<DOI> or to a preprint server)
## str: a link to the MDAKit's community (mailing list, github discussions, etc...)
## str: a link to the MDAKit's changelog
changelog: https://github.com/ianmkenney/demokit/blob/main/CHANGELOG.md