-
Notifications
You must be signed in to change notification settings - Fork 2
/
Copy pathChanges
1554 lines (1106 loc) · 53.4 KB
/
Changes
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
0.168 2025-01-05 T. R. Wyant
Remove McCants' 'rcs' catalog.
Remove all code for Space Track options to celestrak(). These have
been put through a deprecation cycle and were already fatal.
Drop 'orbcomm' from Celestrak supplemental data.
Add 'css' to Celestrak supplemental data.
0.167 2024-09-15 T. R. Wyant
Add celestrak catalog 'eutelsat'.
Further deprecate Iridium status, 'direct' attribute.
0.166 2024-06-16 T. R. Wyant
Correct celestrak_supplemental() status when an unknown catalog is
specified. The previous was the oxymoronic '400 OK'. The intended
(and now implemented) is 404 with a custom error message.
Add back Celestrak SES supplemental data.
Add Project Kuiper to Celestrak supplemental data.
0.165 2024-05-04 T. R. Wyant
Space Track options in celestrak() are now fatal.
Mike McCants removes his RCS data file. The corresponding mccants()
catalog is documented as 404, and to be removed 2024-11-01 unless it
shows back up in the interim. The corresponding test is now TODO.
Track changes in Kelso data set names. He renamed the data sets for
the Chinese and Russian ASAT test debris. The old names are retained
as synonyms. The data supporting the synonyms etc got refactired
from the test into Astro::SpaceTrack so I could display the notes in
names->( 'celestrak' )
Kelso dropped Iridium status and SES supplemental data April 26
2024.
0.164 2024-01-31 T. R. Wyant
Deprecate iridium_status() and associated attributes
Further deprecate 'direct', which now warns on first use.
Dropped METEOSAT from Celestrak Supplemental.
0.163 2023-10-24 T. R. Wyant
Track Celestrak response to non-existent catalogs.
Space Track options to celestrak() now warn on every use.
Fix missed changes to Mike McCants' new web site.
0.162 2023-05-31 T. R. Wyant
Track Mike McCants' move to new web site.
0.161 2023-04-16 T. R. Wyant
Space Track options to celestrak() warn on first use.
0.160 2023-03-09 T. R. Wyant
Remove spaceflight() and all supporting code.
0.159 2022-12-21 T. R. Wyant
Add Celestrak supplemental catalog ast (AST Space Mobile). This is
currently only Bluewalker 3, but I assume the Bluebirds will go here
too.
0.158 2022-10-05 T. R. Wyant
Implement new Celestrak API. Add options --format and --query to
celestrak() and celestrak_supplemental(). Deprecate Space Track
options on celestrak().
Drop celestrak() code involving the 'direct' attribute. The
retained code assumes direct => 1.
0.157 2022-09-10 T. R. Wyant
Method spaceflight() now dies.
0.156 2022-08-02 T. R. Wyant
t/complete.t should skip, not fail, if no /dev/tty.
Track changes in necessary Celestrak error detecton
Add command completion.
0.155 2022-07-17 T. R. Wyant
Track changes in Celestrak Supplemental API.
0.154 2022-06-30 T. R. Wyant
Convert celestrak_supplemental() TLE data to new API. Additional
functionality based on the new API to follow. Of course, this is
what I said last year when I converted celestrak(). The RMS and
Match data still use the old API.
0.153 2022-05-20 T. R. Wyant
CelesTrak Indian ASAT Debris data set retired.
0.152 2022-03-30 T. R. Wyant
Add match data to celestrak_supplemental. This is accessed with the
--match option. This option may not be specified with the --rms
option.
0.151 2022-03-08 T. R. Wyant
The deprecated spaceflight() method now warns on every use. It also
returns a 403 error, since the web site it scrapes has gone the way
of the dodo.
0.150 2022-02-20 T. R. Wyant
Convert celestrak() to new API. Additional functionality based on
this API to follow.
0.149 2022-01-22 T. R. Wyant
Add Celestrak Iridium Next supplemental element catalog
0.148 2021-11-28 T. R. Wyant
Add Celestrak catalog 1982-092 (Russian ASAT debris)
Add Celestrak catalogs for historical debris events
Add celestrak option 'observing_list'. If this is true, and the
'direct' attribute is false, you get back the observing list stored
on Celestrak, rather than the Space Track TLEs specified by the
observing list.
Use https: for Celestrak.
commit 64bce81410add91be6b014cda3b39cd8b18871a2
Author: Tom Wyant <[email protected]>
Date: Tue Nov 16 10:48:11 2021 -0500
Add file CONTRIBUTING
0.147 2021-09-08 T. R. Wyant
Warn on first use of deprecated spaceflight() method. It does not
work anyway since the underlying web site has gone away.
0.146 2021-07-06 T. R. Wyant
Update AMSAT URL.
Correct generation of 'provides' metadata. Thanks to Favio Poletti
for blogging
https://github.polettix.it/ETOOBUSY/2021/06/15/the-real-pause-workaround/,
and ultimately to Joel Berger for the pointer to
https://metacpan.org/pod/CPAN::Meta::Spec#no_index
0.145 2021-03-25 T. R. Wyant
Allow identity file to have .gpg suffix. This is for the benefit of
the vim-gnupg plugin, and potentially other such things.
Refactor authortest into three, so that I can run the
optional-modules tests without generating stub files.
0.144 2021-03-07 T. R. Wyant
Add rt.cpan.org back to bug reporting methods. Long live RT!
Document retirement of NASA Human Space Flight web site, and its
effect on this package.
Any access of iridium_status_mccants is now fatal
Get prerequisites up to snuff and add xt/author/prereq.t to ensure
they stay that way.
Add Celestrak catalog 'gnss'.
0.143 2021-01-09 T. R. Wyant
Add Travis CI testing.
Switch bug reporting to GitHub. R.I.P. rt.cpan.org
Add 'Swarm' to Celestrak catalog names.
0.142 2020-09-24 T. R. Wyant
Add Telesat to Celestrak Supplemental catalog
0.141 2020-08-17 T. R. Wyant
Attribute url_iridium_status_mccants now warns on all accesses. In
the first release after February 15 2021 all accesses will be fatal,
and it will be dropped from the list returned by attribute_names().
Remove prototypes from testing subroutines defined in t/*.t and
inc/My/Module/Test/*.pm.
0.140 2020-07-11 T. R. Wyant
Add Celestrak Supplemental catalog for Planet.
Update canned status table for decay of
- Iridium 96
0.139 2020-03-29 T. R. Wyant
Add Celestrak Supplimental catalog for OneWeb.
0.138 2020-02-18 T. R. Wyant
Add Celestrak catalog 'oneweb'.
0.137 2020-02-04 T. R. Wyant
Use of McCants' Iridium status now throws exception, per deprecation
schedule.
0.136 2020-01-15 T. R. Wyant
Remove Celestrak supplemental Starlink 3 pre-launch TLE catalog.
Kelso took it down once the launch occurred.
0.135 2020-01-06 T. R. Wyant
Add Celestrak supplemental Starlink 3 pre-launch TLE catalog.
Update canned status table for decay of
- Iridium 97
0.134 2019-12-24 T. R. Wyant
Document 'TBA' as valid OBJECT_TYPE in modeldef.
Rework Space Track -exclude query logic and add -include. If both
are specified, -include rules.
Move modeldef script to tools/
0.133 2019-11-21 T. R. Wyant
Add celestrak_supplemental() 'starlink' dataset
Eliminate redirects in POD URL links.
0.132 2019-08-05 T. R. Wyant
Update canned status table for decay of
- Iridium 61
0.131 2019-07-20 T. R. Wyant
Fix broken POD links, and add test to ensure they stay fixed.
Further deprecate McCants' Iridium status. This is really moot,
since as of July 10 2019 his Iridium status page is 404. It was last
seen by me June 9 2019.
Correct the test suite's check for whether Mike McCants' web site is
live.
0.130 2019-06-05 T. R. Wyant
Add Celestrak Starlink catalog.
0.129 2019-05-19 T. R. Wyant
Update canned status table for decay of
- Iridium 46
- Iridium 54
0.128 2019-04-14 T. R. Wyant
Update canned status table for decay of
- Iridium 55
- Iridium 58
- Iridium 64
- Iridium 95
Do Space Track tests with dummy data by default. You can test live
by setting environment variable SPACETRACK_TEST_LIVE to a true
value.
0.127 2019-03-21 T. R. Wyant
Update canned status table for decay of
- Iridium 14
- Iridium 32
- Iridium 59
- Iridium 60
- Iridium 91
0.126 2019-02-12 T. R. Wyant
Add satnogs to known Celestrak catalogs.
0.125 2019-02-02 T. R. Wyant
Update canned status table for decay of
- Iridium 90
0.124 2019-01-03 T. R. Wyant
Update canned status table for decay of
- Iridium 31
- Iridium 35
0.123 2018-11-29 T. R. Wyant
Skip data tests in t/query_spacetrack.t on fetch error. Also skip
the fetch if it returns a 500. This completes the test work started
in version 0.121.
0.122 2018-11-13 T. R. Wyant
Update canned status table for decay of
- Iridium 52
- Iridium 62
- Iridium 83
- Iridium 84
0.121 2018-10-26 T. R. Wyant
Update canned status table for decay of
- Iridium 11
- Iridium 20
Skip data tests on fetch error. All tests but t/query_spacetrack.t
also skip the fetch if it returns a 500.
0.120 2018-10-17 T. R. Wyant
RT 127371 Dependency problem when bulding with Module::Build.
Thanks to Slaven Rezic for finding this (unlike many dependency
problems it does NOT manifest when run against a base Perl
installation) and reporting it in such detail that all I had to do
was pick an implementation. CPAN TESTERS RULE!
Add Celestrak catalogs 'active' and 'analyst'. 'Active' seems to be
satellites actually in service, based on correlating this list with
the Iridium status list. 'Analyst' seems not to be real satellites,
and may be pathological test cases.
Update canned status table for decay of
- Iridium 15
- Iridium 56
- Iridium 70
0.119 2018-10-08 T. R. Wyant
Update canned status table for decay of
- Iridium 10
- Iridium 53
- Iridium 86
0.118 2018-09-27 T. R. Wyant
Update canned status table for decay of
- Iridium 40
- Iridium 50
0.117 2018-09-06 T. R. Wyant
Update canned status table for decay of
- Iridium 12
- Iridium 47
- Iridium 76
0.116 2018-08-29 T. R. Wyant
Update canned status table for decay of
- Iridium 18
- Iridium 66
- Iridium 98
0.115 2018-08-18 T. R. Wyant
Update canned status table for decay of
- Iridium 80
0.114 2018-07-30 T. R. Wyant
Update canned status table for decay of
- Iridium 41
0.113 2018-07-23 T. R. Wyant
Update canned status table for decay of
- Iridium 65
- Iridium 81
0.112 2018-07-15 T. R. Wyant
Update canned status table for decay of
- Iridium 67
- Iridium 75
0.111 2018-06-16 T. R. Wyant
Update canned status table for decay of
- Iridium 68
0.110 2018-06-04 T. R. Wyant
Update canned status table for decay of
- Iridium 37
- Iridium 21
- Iridium 25
- Iridium 72
Fix portability issue in eg/sh_script. Thanks to Thomas Klausner for
picking up on this.
Added -identity as valid option for script/SpaceTrack.
0.108 2018-05-08 T. R. Wyant
Iridium 13 decayed. Canned status update.
0.107 2018-04-27 T. R. Wyant
Update canned status for decay of Iridium 94.
0.106 2018-04-16 T. R. Wyant
Iridium 19 decayed April 7 2018. Canned status update.
Use Browser::Open for help if webcmd is '1'. Other true values are
deprecated and will eventually result in errors.
0.105 2018-04-05 T. R. Wyant
Add 'identity' to canned help text.
Launch meta::cpan for help if webcmd attribute set.
Iridium 23 decayed March 28 2018. This necessitates updating all
the canned Iridium status tables.
Kelso marks Iridiums 12, 13 & 76 partly operational.
Replace reference names with manifest constants. That is, replace
'ARRAY' by ARRAY_REF, where ARRAY_REF is 'ref []'. And so on.
Kelso marks Iridium 94 as spare.
0.104 2018-02-22 T. R. Wyant
Add Celestrak Planet Labs & Spire Global datasets
Canned status updates for decay of Iridiums 3, 43, and 49.
Iridium 49 decay Feb 13 2018.
Normalize names of Iridium satellites in canned status table by
removing leading zeroes.
0.103 2018-01-16 T. R. Wyant
Iridium 34 decayed January 8 2017. So marked in canned status.
0.102 2017-12-30 T. R. Wyant
Iridium 6 decayed December 23 2017. Update canned Space Track status
for this.
Update Sladen Iridium status web page scraper for changes in web
page.
0.101 2017-12-07 T. R. Wyant
Make 'decayed' internal status override anything from external
sources. The idea is that the canned table is from Space Track, and
therefore authoritative as to whether a satellite is actually
on-orbit.
Iridium 8 decayed.
Sladen tweaks web page; scraper change needed.
Further deprecate Iridium status from McCants. Mike McCants has
announced that he is no longer maintaining his Iridium status. The
first use of his Iridium status will now generate a warning. In a
further 6 months there will be a warning on every use, and 6 months
after that it will become fatal.
0.100 2017-10-12 T. R. Wyant
Added Iridium status decayed ('[D]', portable status is 3 --
BODY_STATUS_IS_DECAYED).
Add iridium_status() format 'spacetrack'. Space Track has no idea
whether a given satellite is in service or not, but does know
whether it has decayed. So the status reported for a given OID is
from Celestrak if it has it and the satellite is still in orbit.
If a satellite is not in the Celestrak data but Space Track reports
it as still in orbit, its status will be unknown ('[?]'), and its
portable status will be tumbling.
Add a hard-wired internal Iridium status table having the Space
Track data. This is used to supplement data from other sources,
since they typically drop a satellite once it has decayed.
Add iridium_status() option -raw, which reports statuses
un-supplemented by Celestrak or canned data to the extent this is
possible. This option can be specified either command-line style
(i.e. '-raw') or in a leading hash ref (i.e. '{ raw => 1 }'). This
is in support of generating the above hard-wired table.
Add script 'tools/all_iridium_classic', which queries Space Track
for all Iridium satellites, and reports the status of the
original-design Iridiums. This is for generating the canned status
tables in Astro::SpaceTrack and Astro::Coord::ECI::TLE.
Remove tests for iridium_status( 'mccants' ), since this is both
unmaintained and deprecated.
0.099 2017-05-24 T. R. Wyant
Deprecate McCants' Iridium status.
0.098 2017-03-15 T. R. Wyant
Move SpaceTrack script from bin/ to script/
Don't 'use Exporter qw{ import };'. Instead, subclass Exporter.
eval() autoflush() in test routines, requiring 'IO::Handle' first.
0.097 2017-02-09 T. R. Wyant
Add Celestrak catalogs 'iridium-NEXT' and 'ses'.
0.096 2017-01-15 T. R. Wyant
Ditch 'use base'.
Astro::SpaceTrack is no longer a subclass of Exporter. Instead
import() was imported into its name space.
In the case of the inc/ files, 'use base' was replaced by a 'use' of
the appropriate module, followed by assignment to @ISA.
Have relevant author tests use identity file.
Document the use of environment variable CI_GPG to get gpg2 even
though gpg is also installed.
0.095 2016-11-07 T. R. Wyant
Support Config::Identity file. Both the file and Config::Identity are
optional. The file name is spacetrack.id (MSWin32 and VMS) or
.spacetrack-identity (anything else) in the user's home directory.
The file itself can be GnuPG encrypted.
Rod Sladen Iridium status update.
0.094 2016-08-07 T. R. Wyant
Implement Kelso Iridium status '[B]' as spare, and implement all
other status codes documented on the Celestrak web site.
Update copyright date returned by banner().
0.093 2016-01-20 T. R. Wyant
Make t/query_iridium_status_*.t skip rather than fail if the server is
unavailable.
Add GitHub repository to metadata.
0.092 2015-05-27 T. R. Wyant
Add new Space Track catalog "files" (canned queries, really). These
are:
medium_earth_orbit
low_earth_orbit
highly_elliptical
0.091 2015-04-15 T. R. Wyant
Add dependency on Mozilla::CA in hope to quash some of the CPAN
testers CERT errors.
Simplify the -last5 handling code. Rather than defaulting it and then
removing it if unneeded, just insert it only if the query class ends
up being 'tle_latest'.
Fix a problem with bad Space Track queries being generated under
certain circumstances if TLE data were being requested and class
'tle' (rather than 'tle_latest') was being used to satisfy them. The
problem seems to have been the leakage of extraneous data from the
-last5 option (even if defaulted) into the REST query.
Thanks to Vidar Tyldum for finding this rather abstruse problem and
running it to ground.
0.090 2015-02-11 T. R. Wyant
Add CPF data to celestrak_supplemental().
0.089 2015-01-06 T. R. Wyant
Supply missing initialization in JSON code. This was a problem only
if no data were returned, and maybe then only under restricted and
poorly-understood corcumstances.
Fix warnings in McCants' Iridium status code under Perl 5.21.7 and up.
With this Perl, sprintf() started complaining about extraneous
arguments.
Add new spacetrack() catalogs bright_geosynchronous, human_spaceflight
and well_tracked_objects. The first two correspond to Space Track
curated queries; the last does not, but is based on their Face Book
entry for December 3 2014, and represents objects that can not be
assigned to a country or launch site.
Fix option hash validation warning in spacetrack(). This affected
catalog 'payload'.
Fix exception in names() when an unsupported argument is passed. The
desired functionality was to return a 404 error, which is now
implememted and documented.
Change verify_hostname default back to true, since it appears that
Perl is accepting Mike McCants' Cert again.
0.088 2014-08-31 T. R. Wyant
Properly apply Space Track default fetch options when the options were
passed to a Space Track search method in a hash reference, rather
than command-line style.
0.087 2014-08-29 T. R. Wyant
Use global variable $SPACETRACK_DELAY_SECONDS to control the delay
between Space Track queries. This is initialized from environment
variable SPACETRACK_DELAY_SECONDS if it is true; otherwise it is
initialized to 3.
Throttle Space Track queries to 1 every 3 seconds. Space Track
announced August 19 2014 that they intend to throttle queries to
less than 20 per minute per user as of September 22 2014. They seem
to have jumped the gun though, since throttling seems necessary now.
Remove all RCS-specific functionality. This includes making -rcs do
nothing. On August 18 2014 Space Track started returning 0 for RCS,
instead going for "small," "medium," and "large" in a new JSON
field. The -rcs option is now deprecated, and being put through the
usual deprecation cycle.
Set default value of verify_hostname attribute to false. This is
because Perl does not accept Mike McCants' GoDaddy certificate. The
default can be overridden using environment variable
SPACETRACK_VERIFY_HOSTNAME if it is defined.
Remove all references to obsolete spacetrack() canned queries
full_fast and geosynchronous_fast in the documentation. The queries
themselves are long gone.
Prepare for removal of the RCSVALUE datum in Space Track's satcat
data, which is announced for August 18 2014.
Add 'prompt' attribute.
Add ISS data to celestrak_supplemental.
Support the various Space Track data formats. This involves providing
a -format option, with values corresponding to the Space Track
formats, plus 'legacy' (the default) to provide what is essentially
the Version 1 data format. The old -json option is equivalent to
-format json.
0.086 2014-04-26 T. R. Wyant
Eliminate ugly warning generated when searching Space Track if
-start_epoch or -end_epoch options are specified.
Eliminate use of each() built-in.
0.085 2014-03-20 T. R. Wyant
When mccants() and friends return data from cache, fabricate
Last-Modified header with file modification date.
Bypass mccants() cache test for installation, since it seems to fail
sporadically, and the data appear to be unaffected.
Try to address test failures in mccants() under older Windows (plus
one under FreeBSD) due to unseekability of the handle produced by
open my $fh, '+<', \( $resp->content() );
Fix problem in the login() method detecting a Space Track login
failure.
Add method mccants() to access TLE, magnitude, and RCS data mainteined
by Mike McCants on his web site. Because these do not get updated
that often, there is a 'file' option which, if specified, caches the
results and fetches them from the web only if the cache is stale.
Add 'file' option (as above) to amsat() and celestrak_supplemental().
Add cache_hit() and associated machinery to determine whether
information came from the web or from a file.
Add information on celestrak() catalog 'argos'.
Factor the query tests into multiple files, so they can run in
parallel.
0.084 2014-01-01 T, R, Wyant
Have celestrak() and celestrak_supplemental() return error status if
the argument is undefined.
Drop deprecated spacetrack() catalogs full_fast and
geosynchronous_fast.
Add celestrak_supplemental() catalog 'ses'.
Remove support for environment variables SPACETRACK_REST_RANGE_OPERATOR
and SPACETRACK_REST_FRACTIONAL_DATE.
0.083 2013-11-23 T. R. Wyant
Add Space Track search option -comment. This adds the Comment field to
the satcat results returned by the search_* methods.
0.082 2013-11-08 T. R. Wyant
Use O-O version of Getopt::Long to parse command-style options, to
prevent configuration leaking in (or out). This requires
Getopt::Long 2.39.
Validate options passed as a hash reference, at least for unexpected
keys. The previous version simply ignored these, but I decided I
wanted feedback to the caller. It is a warning for now, but will
eventually become fatal.
Environment variable SPACETRACK_SKIP_OPTION_HASH_VALIDATION can be set
to suppress the warning.
0.081 2013-10-21 T. R. Wyant
Add object status 'TBA' (added by Space Track October 1 2013). This
_should_ only affect the -exclude option.
Delete commented-out code that goes back to the v1 interface.
Build queries using standard names and data represenations, rather
than Space-Track-specific ones. This change _should_ not affect the
user.
0.080 2013-10-05 T. R. Wyant
Correct failures in t/query.t due to incorrect URL being used to see
if Mike McCants' web site is actually available.
0.079 2013-10-02 T. R. Wyant
Try to handle failures due to the U. S. government shutdown so that
they do not cause test failures. They're still errors, though, just
forced to 402 Payment required.
0.078 2013-09-28 T. R. Wyant
Fix attempt to modify read-only variable in t/query.t.
Strip out all code that refers to version 1 of the Space Track API.
Remove all reference to the Celestrak 'sts' catalog or the Human
Spaceflight 'shuttle' catalog.
Silence uninitialized value warning in t/spacetrack_request.t under
older Perls.
0.077 2013-07-15 T. R. Wyant
Make it an error to set space_track_version to 1. Eliminate all
documentation of the version 1 API, and make version 2 documentaion
not refer to API version. Code for the version 1 API will be removed
in subsequent releases.
0.076 2013-07-01 T. R. Wyant
Deprecated spacetrack() queries (the *_fast ones) become fatal.
Document intent to remove support for environment variables
SPACETRACK_REST_RANGE_OPERATOR and SPACETRACK_REST_FRACTIONAL_DATE
in the first release after January 1 2014.
Install the SpaceTrack script by default.
Eliminate prompting for whether to install SpaceTrack. The -y and -n
options are still available.
Move the SpaceTrackTk script to the eg/ directory.
Eliminate Win32 and VMS specific code in the installers.
Document the desupport of the Space Track version 1 interface as of
this release.
No longer test version 1 of the Space Track interface, since it is
scheduled to stop working.
0.075 2013-06-14 T. R. Wyant
Document that the Space Track version 1 API will be shut down July 16
2013.
Emit a warning any time the space_track_version attribute is set to 1.
This warning can not be suppressed by 'no warnings qw{ deprecated }'.
Add Beidou navigation satellites to the list of named element sets
available via the celestrak() method.
0.074 2013-05-12 T. R. Wyant
Make the value returned by launch_sites( { json => 1 } ) under the v2
interface conform to the documentation. I was really sloppy with
this and returned the raw JSON (which was an array ref) when the
docs called for (and I really wanted) the JSON for a hash ref.
0.073 2013-02-21 T. R. Wyant
Move Space Track REST interface to production web site.
Deprecate the version 1 Space Track interface.
0.072 2013-02-17 T. R. Wyant
Make default value of space_track_version attribute 2.
0.071 2013-02-16 T. R. Wyant
Attempts to retrieve Space Shuttle data (via celestrak('sts') or
spaceflight('shuttle') now cause exceptions. Retrieval of historical
data from Space Track should still work as before.
Convert the REST version of the launch_sites() method to use the new
launch_site data instead of canned data.
Space Track dropped RCSSOURCE from class satcat of the REST interface.
This revision eliminates all references to this field.
0.070 2012-12-26 T. R. Wyant
Add notification that I plan to change the way Makefile.PL and
Build.PL decide whether to install executables July 1 2013.
Add method favorite() to access the Space Track 'Favorites'
functionality. This only works for the Space Track version 2
interface.
Add to the spacetrack() method for version 2 of the interface those
bulk data catalogs which are represented by 'Global Favorites'.
Add 'YUN' (Yunsong, DPRK) to hard-coded list of launch sites returned
by the Space Track REST interface.
Re-instate the use of hour, minute, and second spacifications in
-start_epoch and -end_epoch for the Space Track REST interface.
Go back to using OID ranges in the retrieve() method if the Space
Track REST interface is being used.
Document environment varoables SPACETRACK_REST_RANGE_OPERATOR and
SPACETRACK_REST_FRACTIONAL_DATE, so users can get themselves going
again if there are further glitches in the related functionality.
Add method celestrak_supplemental() to retrieve the supplemental TLEs
not derived from SpaceTrack.
Correct bug in celestrak() method, in which the Space Track REST
options were being parsed when they should not have been. This was
really two bugs: use of get() rather than getv() to check the Space
Track version, and failure to check the 'direct' attribute.
0.069 2012-11-09 T. R. Wyant
Do not pass the time portion of a date/time query to the Space Track
REST interface, since it seems not to handle it (though I thought it
did at one time).
0.068 2012-10-26 T. R. Wyant
Retract use of ranges when fetching from Space Track REST interface by
OID, since it appears this is not stable yet.
0.067 2012-10-25 T. R. Wyant
Document a new Celestrak "direct-fetch only" data set, 2012-044, which
represents the explosion of a Breeze-M upper stage (2012-044C) on
October 16 2012.
Re-instate the use of ranges when fetching a number of OIDs via the
Space Track REST interface, since they are supported now.
Fix bug that allowed Kelso's Iridium status to "bleed through" into
the McCants status data.
0.066 2012-10-15 T. R. Wyant
Add methods country_names() and launch_sites(), to return the
expansions of the relevant abbreviations in either tabular form or
JSON. Under space_track_version == 2, launch_sites() is hard-coded,
since this information is not available under the REST interface.
The box_score() method now takes option -json, to return the data in
JSON format. If space_track_version == 1, the JSON is made up from
the tabular data.
0.065 2012-10-09 T. R. Wyant
Retract the merging of names from observing lists (in celestrak() and
file()) in REST queries, since we can now get them direct from the
REST interface in all cases. This was introduced in 0.062, with the
statement that it was temporary.
Don't use OID ranges in REST queries, since they do not work in
combination with comma-separated lists.
Change the size of a retrieve() batch to 200, since larger queries
seem to be faster.
Add method update(). This works with the REST interface only, and
therefore ignores the space_track_version setting. It takes as its
argument the name of a JSON file containing TLE data, and updates it
using '/FILE/>...'. The return is whatever format you want.
Make the REST options work with the spacetrack() method.
Enable the -sort and -descending options on REST queries. These were
previously hard-wired (to -sort epoch -descending) because of
problems early in the beta, which seem to be solved.
Recode the REST versions of spacetrack( 'full' ) and spacetrack(
'geosynchronous' ) to go through class satcat to eliminate bodies
that have decayed. Provide 'full_fast' and 'geosynchronous_fast' for
those who like to live dangerously. The last two are considered
experimental, and may be retracted.
Get the object name from field OBJECT_NAME when using the Space Track
REST interface, in all cases.
Make use of the new TLE_LINE0 field in the tle and tle_latest classes
to have the version 2 retrieve() method return common names.
INCOMPATIBLE CHANGE: In JSON output, the object name is now in field
OBJECT_NAME. Previously there was no object name in the tle data,
and I was hammering it into field SATNAME, since that is where it
was in the satcat data.
Give spacetrack_query_v2() the ability to add header pragmas if it
discovers it was called from outside the Astro::SpaceTrack name
space. It adds 'spacetrack-type = modeldef' if the query is
'basicspacedata => "modeldef"', and 'spacetrack-type = orbit' if the
query is 'basicspacedata => "query", class => 'tle'" or '... class
=> "tle_latest"'.
Change attribute verify_hostname's default value to true again, since
Space Track says they have their act together.
Correct documented name of class used to retrieve current TLE data
using the Space Track REST interface. It's 'tle_latest', not
'tle_current'.
0.064 2012-09-05 T. R. Wyant
Add REST support for as many of the spacetrack() bulk data sets as I
can figure out. The analysis is in Astro::SpaceTrack::BulkData.
The default -status for a REST query is now 'onorbit'. The default for
version 1 queries remains 'all'.
Space Track REST queries now use the 'tle_latest' class unless
historical data are needed, as indicated by use of -start_epoch,
-end_epoch, -since_file, or some -status other than 'onorbit'.
Add 'time' and 'olist' meta-commands to the shell() method. The latter
is experimental, and may go away.
Eliminate superfluous REST queries issued by search_name() and
search_oid(). These were introduced in 0.060_07.
Suppress appending of '--rcs' to the common name by the REST interface
when RCSVALUE is null.
Fix problem with merging names from an observing list into JSON REST
data.
0.063 2012-08-29 T. R. Wyant
Imposed Space Track REST cookie expiration of an hour. The cookie
appears to come with no expiration, but the docs say it's only good
for about 2 hours.
Followed change to representation if International Launch Designator
(INTLDES) in Space Track REST class tle. It was yyyy-lllp, but is
now yylllp, just like Space Track version 1.
0.062 2012-08-25 T. R. Wyant
Fix the joining of JSON data when one of the lists is empty.
Have the celestrak() and file() methods supply common names from their
sources if the with_name attribute is true and the
space_track_version attribute is 2. This functionality will be
retracted when (and if) the Space Track REST interface becomes
capable of supplying NASA-format TLEs.
Document the fact that Space Track has deprecated bulk data downloads,
and plans to remove them in October 2012. This will break the
spacetrack() method.
Use more recent datas for launch date and historical query tests in
t/query.t, since it seems that Space Track purged the version 2 TLE
database on August 24 2012.
0.061 2012-08-15 T. R. Wyant
Reinstate the headings returned by -notle searches done with
space_track_version set to 1. These were lost in version 0.060_09.
When the space_track_version attribute is 2, implement the -exclude
search option in terms of the OBJECT_TYPE field rather than by
simulating the version 1 exclusion rules in the client. This can
mean different search results depending on the interface used (e.g.
Westford needles are debris under v1, but payload under v2), but
since the change seems to be deliberate on the part of Space Track,
I am following it.
0.060_12 2012-08-07 T. R. Wyant
Turn on autoflush in t/query.t to try to prevent overwriting of
prompt.
Have the REST version of retrieve() issue multiple queries if the
number of OIDs is over 50.
Add the ability to handle OID ranges to the REST versions of
retrieve() and search_oid().
Have the output of names( 'spacetrack' ) depend on the value of the
space_track_version attribute.
Have the shell() method extract redirections from the command line
before un-quoting and un-escaping the data, so that we have a way to
force something that looks like a redirection to be taken as an
argument.
Add ':' to the list of 'safe' characters when URI-escaping arguments
to the Space Track REST interface. Percent-encoded colons seemed to
stop working some time between 13:15 and 19:15 GMT on July 27 2012.
Un-encoded colons go through fine.
Accept ':' as well as '/' as punctuation between username and password
in environment variable SPACETRACK_USER.
Have t/query.t try to load Term::ReadKey. If successful, it uses it to
turn off password echoing. If not successful, it adds '(ECHOED)' to
the prompt.
Fix problem associating RCS data with TLEs when using version 1 of the
Space Track interface and the OID in the search results is less than
five digits.
Change default value of verify_hostname attribute to false. And about
time.
Add attribute 'pretty' to reqest that JSON text (and potentially
others) be pretty-formatted.
Expose the name of the Space Track session cookie as an attribute.
This is one of those attributes which have distinct values for each
value of space_track_version.