astro-subframe-organizer 0.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (53) hide show
  1. checksums.yaml +7 -0
  2. data/LICENSE +21 -0
  3. data/README.md +737 -0
  4. data/exe/astro-subframe-organizer +8 -0
  5. data/lib/astro_subframe_organizer/astrophoto.rb +122 -0
  6. data/lib/astro_subframe_organizer/commands/cleanup/empty_directories.rb +27 -0
  7. data/lib/astro_subframe_organizer/commands/cleanup/thumbnails.rb +38 -0
  8. data/lib/astro_subframe_organizer/commands/cleanup/unorganize.rb +25 -0
  9. data/lib/astro_subframe_organizer/commands/equipment_options.rb +30 -0
  10. data/lib/astro_subframe_organizer/commands/init.rb +54 -0
  11. data/lib/astro_subframe_organizer/commands/inspect.rb +101 -0
  12. data/lib/astro_subframe_organizer/commands/organize/base.rb +43 -0
  13. data/lib/astro_subframe_organizer/commands/organize/bias.rb +13 -0
  14. data/lib/astro_subframe_organizer/commands/organize/darks.rb +12 -0
  15. data/lib/astro_subframe_organizer/commands/organize/flats.rb +14 -0
  16. data/lib/astro_subframe_organizer/commands/organize/lights.rb +14 -0
  17. data/lib/astro_subframe_organizer/commands/raw/rename_from_exif.rb +45 -0
  18. data/lib/astro_subframe_organizer/commands/raw/revert_name.rb +28 -0
  19. data/lib/astro_subframe_organizer/commands/run.rb +28 -0
  20. data/lib/astro_subframe_organizer/commands/shared_options.rb +29 -0
  21. data/lib/astro_subframe_organizer/commands/version.rb +15 -0
  22. data/lib/astro_subframe_organizer/commands.rb +64 -0
  23. data/lib/astro_subframe_organizer/config.rb +140 -0
  24. data/lib/astro_subframe_organizer/equipment/camera.rb +14 -0
  25. data/lib/astro_subframe_organizer/equipment/filter.rb +14 -0
  26. data/lib/astro_subframe_organizer/equipment/telescope.rb +14 -0
  27. data/lib/astro_subframe_organizer/equipment_selector.rb +103 -0
  28. data/lib/astro_subframe_organizer/file_metadata.rb +135 -0
  29. data/lib/astro_subframe_organizer/file_set.rb +107 -0
  30. data/lib/astro_subframe_organizer/filename_parser.rb +106 -0
  31. data/lib/astro_subframe_organizer/filename_parsers/cr2_filename_parser.rb +67 -0
  32. data/lib/astro_subframe_organizer/filename_parsers/fits_filename_parser.rb +67 -0
  33. data/lib/astro_subframe_organizer/filename_parsers/fits_header_parser.rb +120 -0
  34. data/lib/astro_subframe_organizer/fits_organizer.rb +154 -0
  35. data/lib/astro_subframe_organizer/logging.rb +10 -0
  36. data/lib/astro_subframe_organizer/organizer.rb +125 -0
  37. data/lib/astro_subframe_organizer/path_builder.rb +55 -0
  38. data/lib/astro_subframe_organizer/path_builders/base_path_builder.rb +33 -0
  39. data/lib/astro_subframe_organizer/path_builders/bias_path_builder.rb +38 -0
  40. data/lib/astro_subframe_organizer/path_builders/dark_path_builder.rb +61 -0
  41. data/lib/astro_subframe_organizer/path_builders/flat_path_builder.rb +48 -0
  42. data/lib/astro_subframe_organizer/path_builders/light_path_builder.rb +53 -0
  43. data/lib/astro_subframe_organizer/utils/empty_directory_cleaner.rb +36 -0
  44. data/lib/astro_subframe_organizer/utils/exif_renamer.rb +132 -0
  45. data/lib/astro_subframe_organizer/utils/exposure_format.rb +25 -0
  46. data/lib/astro_subframe_organizer/utils/file_utils.rb +10 -0
  47. data/lib/astro_subframe_organizer/utils/fits_stripper.rb +115 -0
  48. data/lib/astro_subframe_organizer/utils/raw_stripper.rb +47 -0
  49. data/lib/astro_subframe_organizer/utils/thumbnail_cleaner.rb +26 -0
  50. data/lib/astro_subframe_organizer/utils/unorganizer.rb +54 -0
  51. data/lib/astro_subframe_organizer/version.rb +5 -0
  52. data/lib/astro_subframe_organizer.rb +103 -0
  53. metadata +182 -0
@@ -0,0 +1,103 @@
1
+ # frozen_string_literal: true
2
+
3
+ require 'astro_subframe_organizer/version'
4
+ require 'astro_subframe_organizer/utils/file_utils'
5
+ require 'astro_subframe_organizer/logging'
6
+ require 'astro_subframe_organizer/utils/exposure_format'
7
+
8
+ require 'astro_subframe_organizer/commands'
9
+
10
+ require 'astro_subframe_organizer/config'
11
+ require 'astro_subframe_organizer/equipment/camera'
12
+ require 'astro_subframe_organizer/equipment/filter'
13
+ require 'astro_subframe_organizer/equipment/telescope'
14
+
15
+ require 'astro_subframe_organizer/filename_parser'
16
+ require 'astro_subframe_organizer/filename_parsers/cr2_filename_parser'
17
+ require 'astro_subframe_organizer/filename_parsers/fits_filename_parser'
18
+ require 'astro_subframe_organizer/filename_parsers/fits_header_parser'
19
+
20
+ require 'astro_subframe_organizer/path_builders/base_path_builder'
21
+ require 'astro_subframe_organizer/path_builders/bias_path_builder'
22
+ require 'astro_subframe_organizer/path_builders/dark_path_builder'
23
+ require 'astro_subframe_organizer/path_builders/flat_path_builder'
24
+ require 'astro_subframe_organizer/path_builders/light_path_builder'
25
+ require 'astro_subframe_organizer/path_builder'
26
+
27
+ require 'astro_subframe_organizer/astrophoto'
28
+ require 'astro_subframe_organizer/file_metadata'
29
+ require 'astro_subframe_organizer/file_set'
30
+
31
+ require 'astro_subframe_organizer/equipment_selector'
32
+ require 'astro_subframe_organizer/organizer'
33
+ require 'astro_subframe_organizer/fits_organizer'
34
+
35
+ require 'astro_subframe_organizer/utils/thumbnail_cleaner'
36
+ require 'astro_subframe_organizer/utils/empty_directory_cleaner'
37
+ require 'astro_subframe_organizer/utils/unorganizer'
38
+
39
+ require 'logger'
40
+ require 'fileutils'
41
+ require 'date'
42
+ require 'tty-progressbar'
43
+ require 'tty-prompt'
44
+ require 'yaml'
45
+
46
+ FILENAME_DT_FORMAT = '%Y%m%d-%H%M%S'
47
+
48
+ # The main module for the AstroSubframeOrganizer gem, which provides functionality to organize astrophotography
49
+ # FITS and RAW files based on their metadata.
50
+ #
51
+ # This module includes:
52
+ # - Configuration management for user preferences and settings.
53
+ # - Equipment classes representing cameras, filters, and telescopes.
54
+ # - Filename parsers for extracting metadata from FITS headers and RAW filenames.
55
+ # - Path builders that construct folder paths based on image metadata for use with PixInsight's WBPP script.
56
+ # - The main Organizer class that orchestrates the file organization process.
57
+ # - Utility classes for tasks like renaming files based on EXIF data, cleaning thumbnails, and reverting organization.
58
+ #
59
+ # The gem is designed to be used as a command-line tool, but its components can also be used programmatically in
60
+ # other Ruby applications.
61
+ module AstroSubframeOrganizer
62
+ class << self
63
+ attr_writer :logger
64
+
65
+ def logger
66
+ @logger ||= default_logger
67
+ end
68
+
69
+ def prompt
70
+ @prompt ||= default_prompt
71
+ end
72
+
73
+ def default_logger
74
+ logger = Logger.new($stdout)
75
+ logger.level = Logger::INFO
76
+ logger.formatter = proc do |severity, _datetime, _progname, msg|
77
+ case severity
78
+ when 'ERROR', 'FATAL' then "✗ #{msg}\n"
79
+ when 'WARN' then "⚠ #{msg}\n"
80
+ when 'DEBUG' then "[debug] #{msg}\n"
81
+ else "#{msg}\n" # INFO → plain output
82
+ end
83
+ end
84
+ logger
85
+ end
86
+
87
+ private
88
+
89
+ def default_prompt
90
+ TTY::Prompt.new(
91
+ active_color: :bright_cyan,
92
+ help_color: :bright_white,
93
+ error_color: :bright_red,
94
+ )
95
+ end
96
+ end
97
+
98
+ def self.run(dry_run: nil)
99
+ logger.info "Using config file at #{Config.config_file}" if Config.config_file
100
+ organizer = FitsOrganizer.new(dry_run: dry_run)
101
+ organizer.organize
102
+ end
103
+ end
metadata ADDED
@@ -0,0 +1,182 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: astro-subframe-organizer
3
+ version: !ruby/object:Gem::Version
4
+ version: 0.0.2
5
+ platform: ruby
6
+ authors:
7
+ - Joshua Kovach
8
+ bindir: exe
9
+ cert_chain: []
10
+ date: 1980-01-02 00:00:00.000000000 Z
11
+ dependencies:
12
+ - !ruby/object:Gem::Dependency
13
+ name: dry-cli
14
+ requirement: !ruby/object:Gem::Requirement
15
+ requirements:
16
+ - - "~>"
17
+ - !ruby/object:Gem::Version
18
+ version: '1.1'
19
+ type: :runtime
20
+ prerelease: false
21
+ version_requirements: !ruby/object:Gem::Requirement
22
+ requirements:
23
+ - - "~>"
24
+ - !ruby/object:Gem::Version
25
+ version: '1.1'
26
+ - !ruby/object:Gem::Dependency
27
+ name: exiftool_vendored
28
+ requirement: !ruby/object:Gem::Requirement
29
+ requirements:
30
+ - - "~>"
31
+ - !ruby/object:Gem::Version
32
+ version: '13.58'
33
+ type: :runtime
34
+ prerelease: false
35
+ version_requirements: !ruby/object:Gem::Requirement
36
+ requirements:
37
+ - - "~>"
38
+ - !ruby/object:Gem::Version
39
+ version: '13.58'
40
+ - !ruby/object:Gem::Dependency
41
+ name: fits_parser
42
+ requirement: !ruby/object:Gem::Requirement
43
+ requirements:
44
+ - - "~>"
45
+ - !ruby/object:Gem::Version
46
+ version: '0.1'
47
+ type: :runtime
48
+ prerelease: false
49
+ version_requirements: !ruby/object:Gem::Requirement
50
+ requirements:
51
+ - - "~>"
52
+ - !ruby/object:Gem::Version
53
+ version: '0.1'
54
+ - !ruby/object:Gem::Dependency
55
+ name: tty-progressbar
56
+ requirement: !ruby/object:Gem::Requirement
57
+ requirements:
58
+ - - "~>"
59
+ - !ruby/object:Gem::Version
60
+ version: '0.18'
61
+ type: :runtime
62
+ prerelease: false
63
+ version_requirements: !ruby/object:Gem::Requirement
64
+ requirements:
65
+ - - "~>"
66
+ - !ruby/object:Gem::Version
67
+ version: '0.18'
68
+ - !ruby/object:Gem::Dependency
69
+ name: tty-prompt
70
+ requirement: !ruby/object:Gem::Requirement
71
+ requirements:
72
+ - - "~>"
73
+ - !ruby/object:Gem::Version
74
+ version: '0.23'
75
+ type: :runtime
76
+ prerelease: false
77
+ version_requirements: !ruby/object:Gem::Requirement
78
+ requirements:
79
+ - - "~>"
80
+ - !ruby/object:Gem::Version
81
+ version: '0.23'
82
+ - !ruby/object:Gem::Dependency
83
+ name: fiddle
84
+ requirement: !ruby/object:Gem::Requirement
85
+ requirements:
86
+ - - ">="
87
+ - !ruby/object:Gem::Version
88
+ version: '0'
89
+ type: :runtime
90
+ prerelease: false
91
+ version_requirements: !ruby/object:Gem::Requirement
92
+ requirements:
93
+ - - ">="
94
+ - !ruby/object:Gem::Version
95
+ version: '0'
96
+ description: A command-line tool to sort and rename astrophotography data based on
97
+ metadata, facilitating use with PixInsight's WeightedBatchPreProcessing.
98
+ email:
99
+ - kovach.jc@gmail.com
100
+ executables:
101
+ - astro-subframe-organizer
102
+ extensions: []
103
+ extra_rdoc_files: []
104
+ files:
105
+ - LICENSE
106
+ - README.md
107
+ - exe/astro-subframe-organizer
108
+ - lib/astro_subframe_organizer.rb
109
+ - lib/astro_subframe_organizer/astrophoto.rb
110
+ - lib/astro_subframe_organizer/commands.rb
111
+ - lib/astro_subframe_organizer/commands/cleanup/empty_directories.rb
112
+ - lib/astro_subframe_organizer/commands/cleanup/thumbnails.rb
113
+ - lib/astro_subframe_organizer/commands/cleanup/unorganize.rb
114
+ - lib/astro_subframe_organizer/commands/equipment_options.rb
115
+ - lib/astro_subframe_organizer/commands/init.rb
116
+ - lib/astro_subframe_organizer/commands/inspect.rb
117
+ - lib/astro_subframe_organizer/commands/organize/base.rb
118
+ - lib/astro_subframe_organizer/commands/organize/bias.rb
119
+ - lib/astro_subframe_organizer/commands/organize/darks.rb
120
+ - lib/astro_subframe_organizer/commands/organize/flats.rb
121
+ - lib/astro_subframe_organizer/commands/organize/lights.rb
122
+ - lib/astro_subframe_organizer/commands/raw/rename_from_exif.rb
123
+ - lib/astro_subframe_organizer/commands/raw/revert_name.rb
124
+ - lib/astro_subframe_organizer/commands/run.rb
125
+ - lib/astro_subframe_organizer/commands/shared_options.rb
126
+ - lib/astro_subframe_organizer/commands/version.rb
127
+ - lib/astro_subframe_organizer/config.rb
128
+ - lib/astro_subframe_organizer/equipment/camera.rb
129
+ - lib/astro_subframe_organizer/equipment/filter.rb
130
+ - lib/astro_subframe_organizer/equipment/telescope.rb
131
+ - lib/astro_subframe_organizer/equipment_selector.rb
132
+ - lib/astro_subframe_organizer/file_metadata.rb
133
+ - lib/astro_subframe_organizer/file_set.rb
134
+ - lib/astro_subframe_organizer/filename_parser.rb
135
+ - lib/astro_subframe_organizer/filename_parsers/cr2_filename_parser.rb
136
+ - lib/astro_subframe_organizer/filename_parsers/fits_filename_parser.rb
137
+ - lib/astro_subframe_organizer/filename_parsers/fits_header_parser.rb
138
+ - lib/astro_subframe_organizer/fits_organizer.rb
139
+ - lib/astro_subframe_organizer/logging.rb
140
+ - lib/astro_subframe_organizer/organizer.rb
141
+ - lib/astro_subframe_organizer/path_builder.rb
142
+ - lib/astro_subframe_organizer/path_builders/base_path_builder.rb
143
+ - lib/astro_subframe_organizer/path_builders/bias_path_builder.rb
144
+ - lib/astro_subframe_organizer/path_builders/dark_path_builder.rb
145
+ - lib/astro_subframe_organizer/path_builders/flat_path_builder.rb
146
+ - lib/astro_subframe_organizer/path_builders/light_path_builder.rb
147
+ - lib/astro_subframe_organizer/utils/empty_directory_cleaner.rb
148
+ - lib/astro_subframe_organizer/utils/exif_renamer.rb
149
+ - lib/astro_subframe_organizer/utils/exposure_format.rb
150
+ - lib/astro_subframe_organizer/utils/file_utils.rb
151
+ - lib/astro_subframe_organizer/utils/fits_stripper.rb
152
+ - lib/astro_subframe_organizer/utils/raw_stripper.rb
153
+ - lib/astro_subframe_organizer/utils/thumbnail_cleaner.rb
154
+ - lib/astro_subframe_organizer/utils/unorganizer.rb
155
+ - lib/astro_subframe_organizer/version.rb
156
+ homepage: https://github.com/shekibobo/astro-subframe-organizer
157
+ licenses:
158
+ - MIT
159
+ metadata:
160
+ allowed_push_host: https://rubygems.org
161
+ homepage_uri: https://github.com/shekibobo/astro-subframe-organizer
162
+ source_code_uri: https://github.com/shekibobo/astro-subframe-organizer
163
+ changelog_uri: https://github.com/shekibobo/astro-subframe-organizer/blob/main/CHANGELOG.md
164
+ rubygems_mfa_required: 'true'
165
+ rdoc_options: []
166
+ require_paths:
167
+ - lib
168
+ required_ruby_version: !ruby/object:Gem::Requirement
169
+ requirements:
170
+ - - ">="
171
+ - !ruby/object:Gem::Version
172
+ version: 3.2.0
173
+ required_rubygems_version: !ruby/object:Gem::Requirement
174
+ requirements:
175
+ - - ">="
176
+ - !ruby/object:Gem::Version
177
+ version: '0'
178
+ requirements: []
179
+ rubygems_version: 4.0.11
180
+ specification_version: 4
181
+ summary: Organize astrophotography FITS and CR2 files for PixInsight WBPP
182
+ test_files: []