Skip to main content

lc_reconstruction_analysis

License Code Style semantic-release: angular Interrogate Coverage Python

Usage

  • To use this template, click the green Use this template button and Create new repository.
  • After github initially creates the new repository, please wait an extra minute for the initialization scripts to finish organizing the repo.
  • To enable the automatic semantic version increments: in the repository go to Settings and Collaborators and teams. Click the green Add people button. Add svc-aindscicomp as an admin. Modify the file in .github/workflows/tag_and_publish.yml and remove the if statement in line 65. The semantic version will now be incremented every time a code is committed into the main branch.
  • To publish to PyPI, enable semantic versioning and uncomment the publish block in .github/workflows/tag_and_publish.yml. The code will now be published to PyPI every time the code is committed into the main branch.
  • The .github/workflows/test_and_lint.yml file will run automated tests and style checks every time a Pull Request is opened. If the checks are undesired, the test_and_lint.yml can be deleted. The strictness of the code coverage level, etc., can be modified by altering the configurations in the pyproject.toml file and the .flake8 file.

Installation

To use the software, in the root directory, run

pip install -e .

To develop the code, run

pip install -e .[dev]

Contributing

Linters and testing

There are several libraries used to run linters, check documentation, and run tests.

  • Please test your changes using the coverage library, which will run the tests and log a coverage report:
coverage run -m unittest discover && coverage report
  • Use interrogate to check that modules, methods, etc. have been documented thoroughly:
interrogate .
  • Use flake8 to check that code is up to standards (no unused imports, etc.):
flake8 .
  • Use black to automatically format the code into PEP standards:
black .
  • Use isort to automatically sort import statements:
isort .

Pull requests

For internal members, please create a branch. For external members, please fork the repository and open a pull request from the fork. We'll primarily use Angular style for commit messages. Roughly, they should follow the pattern:

<type>(<scope>): <short summary>

where scope (optional) describes the packages affected by the code changes and type (mandatory) is one of:

  • build: Changes that affect build tools or external dependencies (example scopes: pyproject.toml, setup.py)
  • ci: Changes to our CI configuration files and scripts (examples: .github/workflows/ci.yml)
  • docs: Documentation only changes
  • feat: A new feature
  • fix: A bugfix
  • perf: A code change that improves performance
  • refactor: A code change that neither fixes a bug nor adds a feature
  • test: Adding missing tests or correcting existing tests

Semantic Release

The table below, from semantic release, shows which commit message gets you which release type when semantic-release runs (using the default configuration):

Commit message Release type
fix(pencil): stop graphite breaking when too much pressure applied Patch Fix Release, Default release
feat(pencil): add 'graphiteWidth' option Minor Feature Release
perf(pencil): remove graphiteWidth option

BREAKING CHANGE: The graphiteWidth option has been removed.
The default graphite width of 10mm is always used for performance reasons.
Major Breaking Release
(Note that the BREAKING CHANGE: token must be in the footer of the commit)

Documentation

To generate the rst files source files for documentation, run

sphinx-apidoc -o docs/source/ src

Then to create the documentation HTML files, run

sphinx-build -b html docs/source/ docs/build/html

More info on sphinx installation can be found here.

Metadata

Release files for lc-reconstruction-analysis 0.0.34

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for lc-reconstruction-analysis 0.0.34
File Size Uploaded
lc_reconstruction_analysis-0.0.34.tar.gz 65.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for lc-reconstruction-analysis 0.0.34
File Interpreter ABI Platform
lc_reconstruction_analysis-0.0.34-py3-none-any.whl Python 3 none any Details

Total release size: 106.8 kB

Release files / lc_reconstruction_analysis-0.0.34.tar.gz

Download URL lc_reconstruction_analysis-0.0.34.tar.gz
Size 65.8 kB
Tags Source
SHA-256 checksum
How to use checksums
f165a04ae174f66b32cc82c372b845d19b41b8faf8364aa2841b6f4091d8ece8
BLAKE2b-256 checksum
How to use checksums
8297ac981838a6a557570cb0db5e868098063ab44903e85546f84d480cb4ca04
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.12

Release files / lc_reconstruction_analysis-0.0.34-py3-none-any.whl

Download URL lc_reconstruction_analysis-0.0.34-py3-none-any.whl
Size 41.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fbdd950c8f394fe9337c9322004e1e7f66e99ddce0eed709324a5d00c16b62d1
BLAKE2b-256 checksum
How to use checksums
697b3346f8da78d1de69520e014c114c9343797388d37ca44dfcfb97d053156c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.12
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page