feat: added endpoint option to date_range

.github/workflows/auto-update-bulletin-a.yml

@@ -11,18 +11,7 @@ on:
 jobs:
   build:
 
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        os: [ubuntu-latest]
-        python-version: [3.11]
-    env:
-      OS: ${{ matrix.os }}
-      PYTHON: ${{ matrix.python-version }}
-    defaults:
-      run:
-        shell: bash -l {0}
-
+    runs-on: ubuntu-slim
     steps:
     - uses: actions/checkout@v4
     - name: Set up pixi environment

.github/workflows/auto-update-files.yml

@@ -11,18 +11,7 @@ on:
 jobs:
   build:
 
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        os: [ubuntu-latest]
-        python-version: [3.11]
-    env:
-      OS: ${{ matrix.os }}
-      PYTHON: ${{ matrix.python-version }}
-    defaults:
-      run:
-        shell: bash -l {0}
-
+    runs-on: ubuntu-slim
     steps:
     - uses: actions/checkout@v4
     - name: Set up pixi environment

.github/workflows/python-publish.yml

@@ -5,15 +5,13 @@ name: Upload Python Package
 
 on:
   release:
-    types: [created]
+    types: [released]
 
 jobs:
   deploy:
-
-    runs-on: ubuntu-latest
-
+    runs-on: ubuntu-slim
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
     - name: Set up Python
       uses: actions/setup-python@v4
       with:

.github/workflows/python-request.yml

@@ -9,30 +9,31 @@ on:
       - timescale/**
       - test/**
       - .github/workflows/python-request.yml
-  schedule:
-    # * is a special character in YAML so you have to quote this string
-    - cron:  '0 0 1 * *'
-  workflow_dispatch:
+    types: [opened, synchronize, reopened, ready_for_review]
+
+# set permissions for the workflow
+permissions:
+  contents: read
+  pull-requests: write
 
 jobs:
   build:
 
+    if: github.event.pull_request.draft == false
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
-        python-version: [3.11]
     env:
       OS: ${{ matrix.os }}
-      PYTHON: ${{ matrix.python-version }}
     defaults:
       run:
         shell: bash -l {0}
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v6
     - name: Set up pixi environment
-      uses: prefix-dev/setup-pixi@v0.9.1
+      uses: prefix-dev/setup-pixi@v0.9.4
     - name: Lint with flake8
       run: |
         # stop the build if there are Python syntax errors or undefined names
@@ -48,14 +49,19 @@ jobs:
             --username=${{ secrets.EARTHDATA_USERNAME }} \
             --password=${{ secrets.EARTHDATA_PASSWORD }}
     - name: Create coverage comment
-      uses: MishaKav/pytest-coverage-comment@main
+      if: github.event.pull_request.head.repo.full_name == github.repository
+      uses: MishaKav/pytest-coverage-comment@v1
       with:
         pytest-xml-coverage-path: coverage.xml
         junitxml-path: pytest.xml
         unique-id-for-comment: ${{ matrix.os }}
         title: Coverage for Python on ${{ matrix.os }}
+        hide-report: true
+        remove-links-to-files: true
+        remove-links-to-lines: true
     - name: Archive code coverage results
-      uses: actions/upload-artifact@v4
+      if: github.event.pull_request.head.repo.full_name == github.repository
+      uses: actions/upload-artifact@v6
       with:
         name: code-coverage-report-${{ matrix.os }}
-        path: coverage.xml
+        path: coverage.xml

.github/workflows/ruff-format.yml

@@ -9,9 +9,9 @@ on:
 
 jobs:
   ruff-format:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-slim
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
       - name: Format and annotate PR
         uses: astral-sh/ruff-action@v3
         with:

doc/source/conf.py

@@ -11,22 +11,24 @@
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 #
 import os
+
 # import sys
 import datetime
 import warnings
+
 # sys.path.insert(0, os.path.abspath('.'))
 import importlib.metadata
 
 
 # -- Project information -----------------------------------------------------
-on_rtd = os.environ.get('READTHEDOCS') == 'True'
+on_rtd = os.environ.get("READTHEDOCS") == "True"
 
 # package metadata
 metadata = importlib.metadata.metadata("timescale")
 project = metadata["Name"]
 year = datetime.date.today().year
 copyright = f"2023\u2013{year}, Tyler C. Sutterley"
-author = 'Tyler C. Sutterley'
+author = "Tyler C. Sutterley"
 
 # software version
 version = metadata["version"]
@@ -44,32 +46,32 @@
 # ones.
 extensions = [
     "numpydoc",
-    'sphinxcontrib.bibtex',
+    "sphinxcontrib.bibtex",
     "sphinx.ext.autodoc",
     "sphinx.ext.graphviz",
     "sphinx.ext.viewcode",
     "sphinx_design",
-    "sphinxarg.ext"
+    "sphinxarg.ext",
 ]
 
 # Add any paths that contain templates here, relative to this directory.
-templates_path = ['_templates']
+templates_path = ["_templates"]
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
 # This pattern also affects html_static_path and html_extra_path.
-exclude_patterns = ['**.ipynb_checkpoints']
+exclude_patterns = ["**.ipynb_checkpoints"]
 
 # location of master document (by default sphinx looks for contents.rst)
-master_doc = 'index'
+master_doc = "index"
 
 # -- Configuration options ---------------------------------------------------
 autosummary_generate = True
-autodoc_member_order = 'bysource'
+autodoc_member_order = "bysource"
 numpydoc_show_class_members = False
-pygments_style = 'native'
-bibtex_bibfiles = ['_assets/timescale-refs.bib']
-bibtex_default_style = 'plain'
+pygments_style = "native"
+bibtex_bibfiles = ["_assets/timescale-refs.bib"]
+bibtex_default_style = "plain"
 
 # -- Options for HTML output -------------------------------------------------
 
@@ -82,7 +84,7 @@
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-html_theme = 'sphinx_rtd_theme'
+html_theme = "sphinx_rtd_theme"
 html_theme_options = {
     "logo_only": True,
 }
@@ -91,14 +93,14 @@
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
 html_logo = "_assets/timescale_logo.png"
-html_static_path = ['_static']
+html_static_path = ["_static"]
 # fetch the project urls
 project_urls = {}
-for project_url in metadata.get_all('Project-URL'):
-    name, _, url = project_url.partition(', ')
+for project_url in metadata.get_all("Project-URL"):
+    name, _, url = project_url.partition(", ")
     project_urls[name.lower()] = url
 # fetch the repository url
-repository_url = project_urls.get('repository')
+repository_url = project_urls.get("repository")
 # add html context
 html_context = {
     "menu_links": [
@@ -117,6 +119,7 @@
     ],
 }
 
+
 # Load the custom CSS files (needs sphinx >= 1.6 for this to work)
 def setup(app):
-    app.add_css_file("style.css")
+    app.add_css_file("style.css")

pyproject.toml

@@ -93,7 +93,6 @@ exclude = [
     ".git",
     ".pixi",
     "build",
-    "doc",
     "run",
     "test",
 ]

test/test_time.py

@@ -211,6 +211,16 @@ def test_earth_rotation_angle():
     expected = 0.8730204642501604
     assert np.isclose(360.0*expected, ts.era).all()
 
+def test_from_range():
+    """Test that from_range functions produce expected outputs
+    """
+    ts = timescale.from_range('2020-01-01','2020-02-01',1,'D')
+    exp = 58849 + np.arange(32)
+    assert np.all(ts.MJD == exp) 
+    ts = timescale.from_range('2020-01-01','2020-02-01',1,'D',endpoint=False)
+    exp = 58849 + np.arange(31)
+    assert np.all(ts.MJD == exp) 
+
 def test_gps_week():
     """Test that the GPS week matches expected outputs
     """

timescale/__init__.py

@@ -16,7 +16,7 @@
 # shortcut wrapper functions for timescale.time.Timescale methods
 # delta time
 def from_deltatime(*args, **kwargs):
-    """Wrapper for ``timescale.time.Timescale().from_deltatime``"""
+    """Wrapper for :py:func:`timescale.time.Timescale.from_deltatime`"""
     return timescale.time.Timescale.from_deltatime(*args, **kwargs)
 
 
@@ -27,34 +27,36 @@ def from_julian(ut1, **kwargs):
 
 # Besselian years
 def from_besselian(B, **kwargs):
-    """Wrapper for creating a ``Timescale`` object from Besselian years"""
+    """Wrapper for creating a :py:class:`timescale.time.Timescale`
+    object from Besselian years"""
     # convert Besselian year to MJD
     MJD = 15019.81352 + (B - 1900.0) * 365.242198781
     return timescale.time.Timescale(MJD)
 
 
 # calendar dates
 def from_calendar(*args, **kwargs):
-    """Wrapper for ``timescale.time.Timescale().from_calendar``"""
+    """Wrapper for :py:func:`timescale.time.Timescale.from_calendar`"""
     return timescale.time.Timescale.from_calendar(*args, **kwargs)
 
 
 # datetime arrays
 def from_datetime(*args, **kwargs):
-    """Wrapper for ``timescale.time.Timescale().from_datetime``"""
+    """Wrapper for :py:func:`timescale.time.Timescale.from_datetime`"""
     return timescale.time.Timescale.from_datetime(*args, **kwargs)
 
 
 # range of dates
 def from_range(start, end, *args, **kwargs):
-    """Wrapper for creating a ``Timescale`` object from a range of dates"""
+    """Wrapper for creating a :py:class:`timescale.time.Timescale`
+    object from a range of dates"""
     d = timescale.time.date_range(start, end, *args, **kwargs)
     return timescale.time.Timescale.from_datetime(d)
 
 
 # list of timescale objects
 def from_list(*args, **kwargs):
-    """Wrapper for ``timescale.time.Timescale().from_list``"""
+    """Wrapper for :py:func:`timescale.time.Timescale.from_list`"""
     return timescale.time.Timescale.from_list(*args, **kwargs)
 
 

timescale/time.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python
 """
 time.py
-Written by Tyler Sutterley (12/2025)
+Written by Tyler Sutterley (04/2026)
 Utilities for calculating time operations
 
 PYTHON DEPENDENCIES:
@@ -16,6 +16,8 @@
     utilities.py: download and management utilities for syncing files
 
 UPDATE HISTORY:
+    Updated 04/2026: added endpoint option (defaults to True) to date_range
+        added default day and month values to from_calendar function
     Updated 12/2025: allow conversion to datetime be in different units
     Updated 08/2025: add nominal years (365.25 days long) to Timescale class
     Updated 07/2025: verify Bulletin-A entries are not already in merged file
@@ -269,6 +271,7 @@ def date_range(
     end: str | np.datetime64 | datetime.datetime,
     step: int | float = 1,
     units: str = "D",
+    endpoint: bool = True,
 ):
     """
     Create a range of dates
@@ -292,14 +295,17 @@ def date_range(
             - ``'m'``: minute
             - ``'s'``: second
             - ``'ms'``: millisecond
+    endpoint: bool, default True
+        If True, include the end date in the output
     """
     # convert start and end dates to datetime64
     if isinstance(start, str):
         start = np.array(parse(start), dtype=f"datetime64[{units}]")
     if isinstance(end, str):
         end = np.array(parse(end), dtype=f"datetime64[{units}]")
     # create date range
-    return np.arange(start, end + step, step)
+    stop = end + step if endpoint else end
+    return np.arange(start, stop, step)
 
 
 # days per month in a leap and a standard year
@@ -877,8 +883,8 @@ def from_deltatime(
     def from_calendar(
         cls,
         year: np.ndarray,
-        month: np.ndarray,
-        day: np.ndarray,
+        month: np.ndarray | float = 1.0,
+        day: np.ndarray | float = 1.0,
         hour: np.ndarray | float = 0.0,
         minute: np.ndarray | float = 0.0,
         second: np.ndarray | float = 0.0,
@@ -890,9 +896,9 @@ def from_calendar(
         ----------
         year: np.ndarray
             calendar year
-        month: np.ndarray
+        month: np.ndarray or float, default 1.0
             month of the year
-        day: np.ndarray
+        day: np.ndarray or float, default 1.0
             day of the month
         hour: np.ndarray or float, default 0.0
             hour of the day