epitome

🐍 Demonstration Python package using the PDS template

https://github.com/nasa-pds-engineering-node/epitome

Science Score: 67.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 3 DOI reference(s) in README
  • Academic publication links
    Links to: zenodo.org
  • Committers with academic emails
    2 of 3 committers (66.7%) from academic institutions
  • Institutional organization owner
    Organization nasa-pds-engineering-node has institutional domain (pds.nasa.gov)
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (17.1%) to scientific vocabulary
Last synced: 10 months ago · JSON representation

Repository

🐍 Demonstration Python package using the PDS template

Basic Info
  • Host: GitHub
  • Owner: nasa-pds-engineering-node
  • License: other
  • Language: Python
  • Default Branch: main
  • Homepage:
  • Size: 6.01 MB
Statistics
  • Stars: 0
  • Watchers: 1
  • Forks: 0
  • Open Issues: 2
  • Releases: 31
Created over 4 years ago · Last pushed 11 months ago
Metadata Files
Readme Changelog License Codeowners Security Zenodo

README.md

🪐 Epitome

DOI

This is a demonstration package that uses the PDS Python template repository.

Please visit our website at: https://nasa-pds-engineering-node.github.io/epitome

It has useful information for developers and end-users.

Prerequisites

None.

User Quickstart

Install with:

pip install pds.epitome

To execute, run:

pds-epitome

Code of Conduct

All users and developers of the NASA-PDS software are expected to abide by our Code of Conduct. Please read this to ensure you understand the expectations of our community.

Development

To develop this project, use your favorite text editor, or an integrated development environment with Python support, such as PyCharm.

Contributing

For information on how to contribute to NASA-PDS codebases please take a look at our Contributing guidelines.

Installation

Install in editable mode and with extra developer dependencies into your virtual environment of choice:

pip install --editable '.[dev]'

Configure the pre-commit hooks:

pre-commit install && pre-commit install -t pre-push

Packaging

To isolate and be able to re-produce the environment for this package, you should use a Python Virtual Environment. To do so, run:

python -m venv venv

Then exclusively use venv/bin/python, venv/bin/pip, etc.

If you have tox installed and would like it to create your environment and install dependencies for you run:

tox --devenv <name you'd like for env> -e dev

Dependencies for development are specified as the dev extras_require in setup.cfg; they are installed into the virtual environment as follows:

pip install --editable '.[dev]'

All the source code is in a sub-directory under src.

Tooling

The dev extras_require included in the template repo installs black, flake8 (plus some plugins), and mypy along with default configuration for all of them. You can run all of these (and more!) with:

tox -e lint

Tests

This section describes testing for your package.

A complete "build" including test execution, linting (mypy, black, flake8, etc.), and documentation build is executed via:

tox

Unit tests

Your project should have built-in unit tests, functional, validation, acceptance, etc., tests.

For unit testing, check out the unittest module, built into Python 3.

Tests objects should be in packages test modules or preferably in project 'tests' directory which mirrors the project package structure.

Our unit tests are launched with command:

pytest

If you want your tests to run automatically as you make changes start up pytest in watch mode with:

ptw

Build

pip install wheel
python setup.py sdist bdist_wheel

Owner

  • Name: NASA PDS Engineering Node
  • Login: nasa-pds-engineering-node
  • Kind: organization
  • Email: pdsen-dev@jpl.nasa.gov
  • Location: Pasadena, CA

Software, templates, and documentation specific to the PDS Engineering Node

GitHub Events

Total
  • Create event: 8
  • Issues event: 1
  • Release event: 4
  • Delete event: 8
  • Push event: 23
Last Year
  • Create event: 8
  • Issues event: 1
  • Release event: 4
  • Delete event: 8
  • Push event: 23

Committers

Last synced: over 3 years ago

All Time
  • Total Commits: 197
  • Total Committers: 3
  • Avg Commits per committer: 65.667
  • Development Distribution Score (DDS): 0.051
Top Committers
Name Email Commits
PDSEN CI Bot p****i@j****v 187
Michael Joyce M****e@j****v 7
Sean Kelly k****y@s****z 3
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 10 months ago

All Time
  • Total issues: 2
  • Total pull requests: 1
  • Average time to close issues: N/A
  • Average time to close pull requests: less than a minute
  • Total issue authors: 1
  • Total pull request authors: 1
  • Average comments per issue: 0.0
  • Average comments per pull request: 0.0
  • Merged pull requests: 1
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 2
  • Pull requests: 0
  • Average time to close issues: N/A
  • Average time to close pull requests: N/A
  • Issue authors: 1
  • Pull request authors: 0
  • Average comments per issue: 0.0
  • Average comments per pull request: 0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • nutjob4life (2)
Pull Request Authors
  • nutjob4life (1)
Top Labels
Issue Labels
bug (1) open.3.8.0 (1)
Pull Request Labels

Dependencies

.github/workflows/stable-cicd.yaml actions
  • actions/cache v2 composite
  • actions/checkout v2 composite
  • nasa-pds-engineering-node/roundup-action main composite
.github/workflows/unstable-cicd.yaml actions
  • actions/cache v2 composite
  • actions/checkout v2 composite
  • nasa-pds-engineering-node/roundup-action main composite
pyproject.toml pypi
setup.py pypi