pynims 1.0.0__tar.gz

pynims-1.0.0/.gitignore

@@ -0,0 +1,7 @@
+__pycache__/
+legacy/
+downloaded_images/
+image_lists/
+.coverage
+.kiro/
+internal-docs/

pynims-1.0.0/.gitlab-ci.yml

@@ -0,0 +1,102 @@
+stages:
+  - test
+  - release
+
+# --- Security scanning (all branches) ---
+
+sast:
+  stage: test
+
+include:
+  - template: Security/SAST.gitlab-ci.yml
+  - template: Security/Secret-Detection.gitlab-ci.yml
+
+# --- Lint and test (main only) ---
+
+lint:
+  stage: test
+  image: python:3.10
+  rules:
+    - if: '$CI_COMMIT_BRANCH == "main"'
+    - if: '$CI_PIPELINE_SOURCE == "merge_request_event" && ($CI_MERGE_REQUEST_TARGET_BRANCH_NAME == "main" || $CI_MERGE_REQUEST_TARGET_BRANCH_NAME =~ /^\d+\.\d+\.\d+/)'
+  before_script:
+    - pip install uv
+    - uv sync
+  script:
+    - uv run ruff check .
+
+test:
+  stage: test
+  image: python:3.10
+  rules:
+    - if: '$CI_COMMIT_BRANCH == "main"'
+    - if: '$CI_PIPELINE_SOURCE == "merge_request_event" && ($CI_MERGE_REQUEST_TARGET_BRANCH_NAME == "main" || $CI_MERGE_REQUEST_TARGET_BRANCH_NAME =~ /^\d+\.\d+\.\d+/)'
+  before_script:
+    - pip install uv
+    - uv sync
+  script:
+    - uv run coverage run -m pytest
+    - uv run coverage report --include="pynims/*" --fail-under=96
+
+# --- Release (main only, manual trigger) ---
+
+release:
+  stage: release
+  image: python:3.10
+  variables:
+    GIT_DEPTH: 0
+  rules:
+    - if: '$CI_COMMIT_BRANCH == "main" && $CI_COMMIT_MESSAGE !~ /^chore\(release\)/'
+      when: manual
+  before_script:
+    - pip install uv
+    - uv sync
+  script:
+    - git config user.name "ci-bot"
+    - git config user.email "ci-bot@code.usgs.gov"
+    - git checkout $CI_COMMIT_BRANCH
+    - git reset --hard origin/$CI_COMMIT_BRANCH
+    - uv run semantic-release version
+    - uv run python -m build
+    - TWINE_PASSWORD=${CI_JOB_TOKEN} uv run twine upload --repository-url ${CI_API_V4_URL}/projects/${CI_PROJECT_ID}/packages/pypi -u gitlab-ci-token dist/*
+
+# --- USGS software release (manual triggers) ---
+
+usgs-release-prepare:
+  stage: release
+  image: python:3.10
+  rules:
+    - if: '$CI_COMMIT_TAG =~ /^v\d+\.\d+\.\d+$/'
+      when: manual
+  script:
+    - 'VERSION=${CI_COMMIT_TAG#v}'
+    - git clone https://ci-bot:${GITLAB_TOKEN}@code.usgs.gov/wim/usgs-imagery/sdk/pynims.git repo
+    - cd repo
+    - git config user.name "ci-bot"
+    - git config user.email "ci-bot@code.usgs.gov"
+    - git checkout main
+    - python scripts/update_code_json.py $VERSION
+    - git add code.json
+    - 'git commit -m "chore: update code.json for v${VERSION}"'
+    - git push origin main
+    - git checkout -b $VERSION
+    - 'python scripts/update_code_json.py $VERSION --status "Release Candidate"'
+    - git add code.json
+    - 'git commit -m "chore: set release candidate status for v${VERSION}"'
+    - git push origin $VERSION
+
+usgs-release-finalize:
+  stage: release
+  image: python:3.10
+  rules:
+    - if: '$CI_COMMIT_BRANCH =~ /^\d+\.\d+\.\d+/'
+      when: manual
+  script:
+    - git config user.name "ci-bot"
+    - git config user.email "ci-bot@code.usgs.gov"
+    - git remote set-url origin https://ci-bot:${GITLAB_TOKEN}@code.usgs.gov/wim/usgs-imagery/sdk/pynims.git
+    - git checkout $CI_COMMIT_BRANCH
+    - python scripts/finalize_release_candidate.py $CI_COMMIT_BRANCH
+    - git add DISCLAIMER.md code.json
+    - 'git commit -m "chore: finalize release ${CI_COMMIT_BRANCH}"'
+    - git push

pynims-1.0.0/CHANGELOG.md

@@ -0,0 +1,447 @@
+# CHANGELOG
+
+
+## v1.0.0 (2026-04-21)
+
+### Bug Fixes
+
+- Add input validation for CLI filter flags and image name parsing
+  ([`df63a4a`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/df63a4af916457d741d5db8bd6bc47f27a45f540))
+
+### Chores
+
+- Disable allow_zero_version for 1.0.0 release
+  ([`570bc12`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/570bc12af5ae2caaee367105a1107f0fcf01bf15))
+
+- Gitignore all .kiro/ files and untrack steering docs
+  ([`8beb1cc`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/8beb1cca3d3106590f9c595ae6e205ecaa6cc437))
+
+- Stop tracking .kiro/specs/ in git
+  ([`6ea9b1c`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/6ea9b1c316c5918f488e4d70201d72890eb6d779))
+
+- Update dependencies to resolve CVEs in cryptography, pygments, pytest
+  ([`f495847`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/f4958476186530556d747a4561ce6540308d3fa1))
+
+### Code Style
+
+- Format cli.py with ruff
+  ([`998d720`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/998d720218f44ed2603d6de3af3e194a506a18ec))
+
+### Continuous Integration
+
+- Add full clone depth and reset to release job
+  ([`df1d8bf`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/df1d8bf09d981ae43bc9a0f8f9bafe99238f5f99))
+
+### Documentation
+
+- Add AI disclosure to README
+  ([`739268f`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/739268f19c2dd7eaacbf9239434bc58d5338d926))
+
+- Add guidance on addressing review feedback during USGS release
+  ([`75f3b72`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/75f3b72093dbf000af94300b68d2ac1e1800395d))
+
+- Remove registry install instructions from README, clean up CI/CD doc
+  ([`c07fdb4`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/c07fdb409092cecd51343f956cfccf2604ffbd03))
+
+- Update CHANGELOG.md commit SHAs after history rewrite
+  ([`397feb3`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/397feb369561cf700fd1ffcad28bf96eb044e9a0))
+
+- Update filtering guide for warn_threshold parameter
+  ([`7f6b94c`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/7f6b94ce496e0888cd378820eba190dcb7086173))
+
+### Features
+
+- V1.0.0 stable release
+  ([`7fc268b`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/7fc268bd331de014dd3572c6dd1aa14a2ff19fd0))
+
+- Warn when times-of-day filter matches far from target
+  ([`51b294d`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/51b294dd2be2b88b9e6970d43789c014ba9c1e0f))
+
+
+## v0.7.0 (2026-04-18)
+
+### Chores
+
+- Lint, format, and clean up filtering module
+  ([`c15a3eb`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/c15a3ebf9dc59a3cc14c7770f3d30d009acef627))
+
+### Documentation
+
+- Add filtering guide and README filtering section
+  ([`72ec700`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/72ec7002aee2f853ebe7858d08ddb4fdcc68be82))
+
+- Update structure steering doc with filtering module
+  ([`6d337f4`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/6d337f4c769a40666f6fa6d983a8dff8905fe81d))
+
+### Features
+
+- Add apply_filters helper for ordered filter application
+  ([`ac9e6bb`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/ac9e6bb45fb9dc577830c1027a8636109458cfbb))
+
+- Add attribute filters (day of week, day of month, month, year)
+  ([`8bfad52`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/8bfad52541edb0f61d056de8ed51b83fedff7d63))
+
+- Add filter flags to image-list and download-images CLI commands
+  ([`6d84429`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/6d84429b5f113928eac0ee7d0798d35c3a6f3801))
+
+- Add filtering module with ImageList type and conversion functions
+  ([`42f8ac1`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/42f8ac1195bf2ec1b3e34cda577dd25269fe7ab0))
+
+- Add match_nearest_to_times for pairing images with external time series
+  ([`c896179`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/c896179c9d1bc84c9f4d53d0f13bfef0876fe432))
+
+- Add range filters (time of day, date range, recurring range)
+  ([`3b9ce3a`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/3b9ce3a5196ab5f463c1d05d5f1b7ded775ca04c))
+
+- Add selection filters (interval, nth per group, times of day)
+  ([`549c98c`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/549c98c7f0537d227e3b160a169743a8d02a3c11))
+
+- Integrate filtering into workflow functions with optional tz override
+  ([`f977573`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/f97757344e309558bfd82b4bf28c44dd52756208))
+
+### Testing
+
+- Add coverage for CLI flag parsing, apply_filters branches, and edge cases
+  ([`45b85a3`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/45b85a3460b8ba35ef34269670b120484e053969))
+
+
+## v0.6.0 (2026-04-17)
+
+### Bug Fixes
+
+- Quote YAML special characters in CI job scripts
+  ([`29287a6`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/29287a657fdd9d1caef3eea9d5a1011425ab6812))
+
+- Resolve YAML parsing in usgs-release-finalize job
+  ([`9bbc607`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/9bbc607d9fdf24dcbe126abe172e696a0d798085))
+
+- Set git config inside cloned repo in usgs-release-prepare
+  ([`4d0df74`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/4d0df7494a87a9d6fecd10ea11c6787b420dc42c))
+
+- Use GITLAB_TOKEN for push in usgs-release-finalize
+  ([`de4c3ae`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/de4c3ae9856cfbc94baaf6a6441e64a1136fd400))
+
+### Chores
+
+- Update code.json for v0.6.0
+  ([`32202f9`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/32202f94a3ea28bcd592f1dbc9d699dc7d2c3aed))
+
+- Update code.json for v0.6.0
+  ([`f310502`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/f31050242db4ced3597fd6f9ee50bbb475118041))
+
+### Documentation
+
+- Add USGS release jobs to tech stack steering doc
+  ([`f75a5d5`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/f75a5d53aaaf09b2fe82d268649eb8b02798d862))
+
+- Add USGS software release guide and README updates
+  ([`389d7d9`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/389d7d9c2a8a7c10c379da69955b5abc2d11380b))
+
+- Update CI job docs with protected tag/branch requirements
+  ([`b924fa9`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/b924fa9cbc3d8e70eae20d475d1c51da2d7f3627))
+
+### Features
+
+- Add USGS release CI jobs and scripts
+  ([`fc4a6c0`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/fc4a6c03454ebc60f7c5a6541635bea77cec81ee))
+
+- Add USGS software release compliance files
+  ([`3821e0b`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/3821e0b0a462adc4df02e1b76de90a099bce6798))
+
+
+## v0.5.0 (2026-04-16)
+
+### Documentation
+
+- Add download-results spec
+  ([`b17d60b`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/b17d60b0015bb0d011fb518954852e38d1f82e09))
+
+### Features
+
+- Return download result counts from download_images_for_camera
+  ([`7c1eb3c`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/7c1eb3cede03f6e0283b28c1f89e13743745e22a))
+
+
+## v0.4.0 (2026-04-16)
+
+### Bug Fixes
+
+- Skip 404 images in download_image instead of raising
+  ([`ad82506`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/ad82506b25a437e035f05970cab1e94b491ad186))
+
+- Use coverage cli for fail-under so CI actually fails on coverage drops
+  ([`a45e2c4`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/a45e2c403a3fbbf56f8c165f0bcd94e60fb4e98b))
+
+### Documentation
+
+- Add Package Registry install instructions to README
+  ([`6d095d2`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/6d095d23ff4b5a159f23bba804f212007c706e93))
+
+- Add registry authentication instructions for internal project
+  ([`80b4eff`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/80b4effa3a12572b669fe85fa53d3ebd1c70dde8))
+
+- Add remove-image-utils spec
+  ([`f28e8bc`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/f28e8bc4b56cc97a588189c43b681d56f9058b2b))
+
+- Clarify installation options and reorder by audience
+  ([`17a808e`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/17a808e8b2381bd1beee9f7c90596e9e6393a96f))
+
+- Improve README clarity for installation, Python API, and CLI sections
+  ([`c8aabff`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/c8aabff241d77463800f1425de700bc11fd1fa32))
+
+### Features
+
+- Remove image_utils module (migrated to usgs-imagery-tools)
+  ([`cebce24`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/cebce24a8a8005ff7a885227479bf972feab2990))
+
+
+## v0.3.0 (2026-04-01)
+
+### Bug Fixes
+
+- Remove duplicate Unreleased section from changelog
+  ([`df67b1c`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/df67b1c7680054315790fe65978ac18616a870d6))
+
+### Chores
+
+- Update lockfile and add gitlab-registry-publishing spec docs
+  ([`ea5ac8f`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/ea5ac8fd4c775f98d01a4f7228ee4b15cd0517ce))
+
+### Continuous Integration
+
+- Add GitLab Secret Detection scanning
+  ([`c44edc8`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/c44edc8649d2e82b92744de7c9539c676b518d31))
+
+### Documentation
+
+- Update CI/CD guide with package registry publishing and secret detection
+  ([`8e9feb1`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/8e9feb13b87baeddaccf676672cb40dfd9bd30dd))
+
+### Features
+
+- Add GitLab Package Registry publishing to release job
+  ([`fbc1c91`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/fbc1c9134895d5e546440cc976a45347c2f4af5d))
+
+
+## v0.2.1 (2026-03-31)
+
+### Bug Fixes
+
+- Remove debug line from release job
+  ([`417f66f`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/417f66fc06bc30ff3ee412ab159232dbb7a5f049))
+
+- Rewrite recursive image list fetch as iterative loop
+  ([`2578ae4`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/2578ae4561bd02bfdb1b4b89d8c336b742ac20f0))
+
+- Replace recursion with bounded for-loop (max 100 pages) - Fix single-image range returning empty
+  list - Send explicit limit=50000 to API - Parse start/end datetimes once before loop - Log
+  progress on multi-page fetches - Log warning if max pagination cap reached
+
+### Chores
+
+- Add .coverage to gitignore
+  ([`19c008c`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/19c008c09b20874b7fc04c24eafd8caf15fb3363))
+
+- Include uv.lock for pytest-cov dependency
+  ([`d6ed962`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/d6ed962d41948b2f36e7814362fef21c421298c6))
+
+### Code Style
+
+- Fix lint and formatting in test files
+  ([`315635c`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/315635c916102a64b5131a5501acbd7bc1357759))
+
+### Continuous Integration
+
+- Enforce 97% test coverage threshold
+  ([`cb49fa7`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/cb49fa7de685faccf7b5df548fa1d743c298429c))
+
+### Documentation
+
+- Add CI/CD and release automation guide
+  ([`c5978c1`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/c5978c1f230a4156be31a8c682ac5f95dfab7483))
+
+- Add pytest-cov to tech stack
+  ([`bb6a6d1`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/bb6a6d1cf92812fe902ba74998c210162d85882d))
+
+- Add recursive-fetch-improvements spec
+  ([`54a5b72`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/54a5b721ce3a9d6cabc5cf1ebe3847573d87a3ce))
+
+- Add test-improvements spec
+  ([`b93cdfc`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/b93cdfc892f58215d56c7f5cbd09623e1ab7f536))
+
+### Testing
+
+- Add CLI error-path tests
+  ([`3abf98a`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/3abf98ac3f47261e3be9c5cad323b5ab3a6b52b7))
+
+- Add client validation and edge-case tests
+  ([`7bc5d19`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/7bc5d198503f1f5b3c4fd52ccf4995bf8fb3fcc2))
+
+- Add context manager and utils edge-case tests
+  ([`a9e75e2`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/a9e75e206a4b0e8e09994b0ba40439abf1309bd7))
+
+- Add image list result count assertions
+  ([`0a2e6e0`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/0a2e6e07de0a4f0a6713bf26d71aa7eafeb90526))
+
+- Add image_utils missing-function tests
+  ([`569596f`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/569596f55f91743ba56b981fc0531e2e354c278b))
+
+- Add pytest-cov dependency and _make_request retry tests
+  ([`d3b77eb`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/d3b77ebb8f104fc89b071f3e47d6cc2fe759dc26))
+
+- Add workflow error-path and output tests
+  ([`72bfab8`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/72bfab8d12b94ced6c5de0d8bd14d33f30a9b0c9))
+
+
+## v0.2.0 (2026-03-31)
+
+### Bug Fixes
+
+- Checkout branch before semantic-release to avoid detached HEAD
+  ([`a57a867`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/a57a8679e15285cbb2e9f89ade5805e6a8b5c8c3))
+
+- Configure semantic-release for zero-version and v-prefixed tags
+  ([`0048057`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/004805719ba92bea19593cf272045f1c165ef51a))
+
+- Correct broken timezone check in get_nims_image_name_from_date_time_and_cam_id
+  ([`0fc8549`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/0fc8549da831c19463038834fa1ef97cb20da99a))
+
+- Correct CLI examples and add image_lists to gitignore
+  ([`cd12649`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/cd12649af5b775867ebe7b6d2cb52ea08f9c8d60))
+
+### Chores
+
+- Add ruff to dev dependencies, fix lint and format
+  ([`e34a13e`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/e34a13ec934314e18829abb4045cf654e4cdf25b))
+
+- Fix logger placement in client.py and verify all tests pass
+  ([`c100d22`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/c100d22ed7d8acd0c4e75ec4a66bf4944607b876))
+
+### Documentation
+
+- Add ci-and-packaging spec
+  ([`a784791`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/a784791cf6c604cf90193bf5ae85a1bf0b2c6784))
+
+- Add workflow preferences steering doc
+  ([`ee2248b`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/ee2248bab1c046e17ae6b091d8db3a41b119eb6b))
+
+- Expand workflow.md with TDD, code review, and post-spec completion guidelines
+  ([`f9cd5e7`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/f9cd5e72919213c2d4e69e9f2f345933900eb705))
+
+- Update README and steering for image URL methods
+  ([`fa6e7d2`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/fa6e7d2c3e5df00e85c36da70fa0919fa17676b1))
+
+- Update README CLI section with new commands and flags
+  ([`2836c84`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/2836c843c6ab4e1fc962a2fea08a3a6e190a521d))
+
+- Update README examples to lead with site-filtered camera usage
+  ([`f850933`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/f850933e718db5816313082ecde139f6f185e9df))
+
+- Update steering commit strategy to group related tasks
+  ([`7a09c2c`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/7a09c2c8024b65328619cffeecb81477c9d423a1))
+
+- Update steering docs for CI/CD pipeline and semantic-release
+  ([`6651932`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/665193221ef3228b8f9d5877e59efa79a8ce75b3))
+
+- Update steering docs to reflect client improvements
+  ([`126b515`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/126b51559b2332612abc0759c601a886715589fa))
+
+- Update structure.md for API coverage and CLI polish changes
+  ([`ad1901a`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/ad1901ac6e13b2146903cd5a49d6328bb4975355))
+
+- Update structure.md to reflect logging usage in client, workflows, and CLI
+  ([`cb4b7eb`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/cb4b7ebe761aac14829474a494ce4f01db843cd1))
+
+### Features
+
+- Add --site-id and --cam-id CLI options to cameras command
+  ([`7c99956`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/7c99956eb20547f29b776bbe0aec489283389897))
+
+- Add --size option to download workflow and CLI
+  ([`48d37ca`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/48d37caddee7fa7c4328e3567559887226c95349))
+
+- Add API key support with X-Api-Key header
+  ([`4200cbd`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/4200cbd08e5b307525a0d5994893431448ad5135))
+
+- Add camera caching to avoid redundant API calls
+  ([`50c005c`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/50c005ca4f37540f02474a4832a13b85aaf6c7ff))
+
+- Add CI/CD pipeline and packaging infrastructure
+  ([`4a67185`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/4a67185170b148e6b25810b460d90a4df5f1ca04))
+
+- Add image size support and URL convenience methods
+  ([`af950a3`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/af950a3a72712bc39d016156d97a1b1f0040b7ad))
+
+- Add optional image_list parameter to download_images_for_camera
+  ([`b84636c`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/b84636ca8800c2794c6b35a6f33ef236a4d5a5d9))
+
+- Add raw_item parameter to get_image_list()
+  ([`1bf7bba`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/1bf7bbacd10e16c229176d7851caf77ccb641c98))
+
+- Add return_fields parameter to get_cameras()
+  ([`0a50fd2`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/0a50fd2d29531626486d793c99763486e0c3b303))
+
+- Add site_id and cam_id params to get_camera_list() workflow
+  ([`d00aad4`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/d00aad4e432e32e17c92cb2909ec0174f9b91c46))
+
+- Add site_id and cam_id params to NIMSClient.get_cameras()
+  ([`71360b9`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/71360b99b3df093a90ceb8294a2f114ca42066f9))
+
+- Add type annotations, logging, and snake_case renames in client.py
+  ([`1c692e6`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/1c692e6d02cdddc31e7f1b3f05902d8a89d5c912))
+
+- Cli polish — version flag, camera command, --full, --json, stdout default
+  ([`1c971bd`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/1c971bd9400d0b8b7569bfebd1f584fcd8dcefcf))
+
+- Fix config and base URL to use public NIMS API
+  ([`f1841b3`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/f1841b3af00359cf13d6c66e84e844445c3d75ea))
+
+- Fix packaging and exports
+  ([`7af9806`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/7af98066d0bf9630b8d846ffe5c7d17abf1417b9))
+
+- Improve get_camera_attribute error message and implement max_results in recursive fetch
+  ([`dce8d2e`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/dce8d2e0f5a702d4570ba079e5068bb6b5fa3802))
+
+- Improve workflow robustness and add get_image_list_for_camera
+  ([`61ecb88`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/61ecb882cf0c40ae5bb5c99a4cc992d7cc0314d9))
+
+- Make camera_id optional in download-images when image list is provided
+  ([`7507150`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/750715056a0cd626ec63f63c23ceeb1e0efad60a))
+
+- Rename camelCase to snake_case and add type annotations in image_utils.py
+  ([`cfb4db3`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/cfb4db31484978580568e80eba601fa99584a8c5))
+
+- Rename camelCase to snake_case and add type annotations in utils.py
+  ([`fbd3e65`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/fbd3e6535b8da62eaf7a08a842309ea90d137600))
+
+- Reorganize utils into utils.py and image_utils.py
+  ([`b504642`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/b504642a92c92a0727f4d4cc1947f54c21f2ae14))
+
+- Replace hardcoded image URL with camera base path lookup
+  ([`37d7373`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/37d737319bbc0acab00a5a3fc8c3f7c81cf5f49f))
+
+- Replace print() with logging in workflows.py
+  ([`1ffc8ea`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/1ffc8eaec81d6b54a9a4baa30b94d5c64dea5004))
+
+- Rewrite README with docs links, API key section, and quick start
+  ([`bc89918`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/bc89918a7a90d4486e92ffc6768f76b1e1f1d55b))
+
+- Wire up CLI with API key support and verify end-to-end
+  ([`0b8b8ff`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/0b8b8ff033c6374691e697c4f89cd866d5090d15))
+
+### Testing
+
+- Add tests for API coverage and CLI polish features
+  ([`1743ff8`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/1743ff8b21f80d8e15fc936c704b99a4ac16f0b8))
+
+- Add tests for get_camera_attribute error and max_results; configure CLI logging
+  ([`63dd5ae`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/63dd5ae1d374e633d46378d9f147996dbc05424b))
+
+- Add tests for image URL methods and base dir lookup
+  ([`c560745`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/c560745b5377885b1c0574ce5daadd8f1ebf04a6))
+
+- Add tests for site_id and cam_id query params
+  ([`c2f7289`](https://code.usgs.gov/usgs-imagery-packages/pynims/-/commit/c2f7289e488ab40711313614bd4bff5738b12fe6))
+
+
+## v0.1.0 (2025-02-26)

pynims-1.0.0/DISCLAIMER.md

@@ -0,0 +1,11 @@
+# Disclaimer
+
+This software has been approved for release by the U.S. Geological Survey
+(USGS). Although the software has been subjected to rigorous review, the USGS
+reserves the right to update the software as needed pursuant to further analysis
+and review. No warranty, expressed or implied, is made by the USGS or the U.S.
+Government as to the functionality of the software and related material nor
+shall the fact of release constitute any such warranty. Furthermore, the
+software is released on condition that neither the USGS nor the U.S. Government
+shall be held liable for any damages resulting from its authorized or
+unauthorized use.

pynims-1.0.0/LICENSE.md

@@ -0,0 +1,37 @@
+# License
+
+Unless otherwise noted, This project is in the public domain in the United
+States because it contains materials that originally came from the United
+States Geological Survey, an agency of the United States Department of
+Interior. For more information, see the official USGS copyright policy at
+<https://www.usgs.gov/information-policies-and-instructions/copyrights-and-credits>
+
+Additionally, we waive copyright and related rights in the work
+worldwide through the CC0 1.0 Universal public domain dedication.
+
+## CC0 1.0 Universal Summary
+
+This is a human-readable summary of the
+[Legal Code](https://creativecommons.org/publicdomain/zero/1.0/legalcode).
+
+## No Copyright
+
+The person who associated a work with this deed has dedicated the work to
+the public domain by waiving all of his or her rights to the work worldwide
+under copyright law, including all related and neighboring rights, to the
+extent allowed by law.
+
+You can copy, modify, distribute and perform the work, even for commercial
+purposes, all without asking permission.
+
+## Other Information
+
+In no way are the patent or trademark rights of any person affected by CC0,
+nor are the rights that other persons may have in the work or in how the
+work is used, such as publicity or privacy rights.
+
+Unless expressly stated otherwise, the person who associated a work with
+this deed makes no warranties about the work, and disclaims liability for
+all uses of the work, to the fullest extent permitted by applicable law.
+When using or citing the work, you should not imply endorsement by the
+author or the affirmer.