txt: ## dist_zef-deoac-App-APOTD.md
  [![Actions Status](https://github.com/deoac/App-APOTD/actions/workflows/test.yml/badge.svg)](https://github.com/deoac/App-APOTD/actions)
  
  ### multi sub MAIN
  
  ```
  multi sub MAIN(
      Bool :$pod!
  ) returns Mu
  
  ```
  
  Run with '--pod' to see all of the POD6 objects
  
  ### multi sub MAIN
  
  ```
  multi sub MAIN(
      Str :$doc!
  ) returns Mu
  
  ```
  
  Run with '--doc' to generate a document from the POD6 It will be rendered in Text format unless specified with the --format option. e.g. --format=HTML
  
  # TITLE
  
  Astronomy Picture of the Day
  
  # SUBTITLE
  
  Download Today's Astronomy Picture of the Day
  
  # VERSION
  
  This documentation refers to `apotd` version 1.0.9
  
  # USAGE
  
  ```
  apotd [-v|-V|--version] [--verbose]
  apotd [-d|--dir=<Str>] [-f|--filename=<Str>] [-a|--prepend-count]
  
    -d|--dir=<Str>         What directory should the image be saved to? [default: '$*HOME/Pictures/apotd']
    -f|--filename=<Str>    What filename should it be saved under? [default: the caption of the image]
    -a|--prepend-count     Add a count to the start of the filename. [default: False]
  
  ```
  
  To downloand the image and save it using the default behavior, simply:
  
  ```
  $ apotd
  
  ```
  
  # DESCRIPTION
  
  [Astronomy Picture of the Day](https://apod.nasa.gov/apod/astropix.html) is a website provided by NASA and Michigan Technological University which provides a different astronomy picture every day.
  
  **Each day a different image or photograph of our fascinating universe is**
  
  featured, along with a brief explanation written by a professional astronomer.
  
  Set `apotd` as a cronjob (\*nux), launch agent (MacOS), or Task Scheduler (Windows) and you'll accumulate a beautiful collection of images for wallpaper, screen savers, etc.
  
  # SYNOPSIS
  
  By default, `apotd` will save to
  
  ```
  ~/Pictures/apotd/
  
  ```
  
  with the filename taken from the caption of the photo e.g.
  
  ```
  Dark Nebulae and Star Formation in Taurus.jpg
  
  ```
  
  and will optionally prepend a number which increments with each new image, e.g.
  
  ```
  2483-Dark Nebulae and Star Formation in Taurus.jpg
  
  ```
  
  Macintosh allows a comment to be associated with each file. So on Macs, `apodt` will copy the `alt` text and the permalink for the image into the file's comment, e.g.
  
  **A star field strewn with bunches of brown dust is pictured. In the center is a bright area of light brown dust, and in the center of that is a bright region of star formation.**
  
  <https://apod.nasa.gov/apod/ap230321.html>
  
  # OPTIONS
  
  ```
  # Save to directory "foo"
  $ apotd --dir=foo
  $ apotd    -d=foo
  
  # Save with the filename "bar"
  # The image's extension, e.g. ".jpg", will be automatically added.
  $ apotd --file=bar
  $ apotd     -f=bar
  
  # Prepend a count to the filename
  $ apotd --prepend-count
  $ apotd  -p
  
  ```
  
  # DIAGNOSTICS
  
  ## General problems
  
  Failed to get the directory contents of <*directory*>: Failed to open dir: No such file or directory
  
  Failed to create directory <*directory*>: Failed to mkdir: No such file or directory
  
  Failed to resolve host name 'apod.nasa.gov'
  
  ## Problems specific to `apotd`
  
  Couldn't find an image on the site. It's probably a video today.
  
  The image has already been saved as <*filename*>.
  
  Couldn't write the alt-text to <*path*>.
  
  ## Success
  
  Successfully wrote Pictures/apotd/ 2483-Dark Nebulae and Star Formation in Taurus.jpg
  
  Successfully wrote the alt-text and permanent link as a comment to the file.
  
  # DEPENDENCIES
  
  ```
  LWP::Simple;
  Filetype::Magic;
  Digest::SHA1::Native;
  
  ```
  
  # ASSUMPTIONS
  
  `apotd` assumes that the caption of the photo is the first `<b> ... </b>` line in the HTML code.
  
  And that the image is the first `<IMG SRC=` html tag.
  
  And that tag has an `alt=` attribute.
  
  # BUGS AND LIMITATIONS
  
  There are no known bugs in this module.
  
  # AUTHOR
  
  Shimon Bollinger [deoac.shimon@gmail.com](mailto:deoac.shimon@gmail.com)
  
  Source can be located at: <https://github.com/deoac/apotd.git>
  
  Comments, suggestions, and pull requests are welcome.
  
  # LICENSE AND COPYRIGHT
  
  © 2023 Shimon Bollinger
  
  This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See [perlartistic](http://perldoc.perl.org/perlartistic.html).
  
  This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  