NATION

PASSWORD

[v2.0] Spyglass - Open Source Region Timesheet Generator

Bug reports, general help, ideas for improvements, and questions about how things are meant to work.
User avatar
Spyglass Development Team
Political Columnist
 
Posts: 2
Founded: Mar 20, 2022
Ex-Nation

[v2.0] Spyglass - Open Source Region Timesheet Generator

Postby Spyglass Development Team » Sun Mar 20, 2022 9:03 pm

Spyglass
Open Source NationStates Update Timesheet Generator

About
Spyglass generates Excel Spreadsheets that can be used to predict the update time of a NationStates region, usually to coordinate an invasion, liberation, or other military gameplay action.

  • Estimated update times: View estimated major and minor update times for all regions.
  • R/D metagame prioritization: Identify regions based the presence/absence of a founder, WA delegate, and password.
  • WFE and Embassy preview: Preview world factbook entries and regional embassies to quickly determine if a region has been impacted by the R/D metagame.

To learn more about what information Spyglass provides, view the documentation.

Spyglass is open source. If you want to take part in its development by reporting issues, requesting features, or contributing code, visit us on Github!

Licensing and Credits
Spyglass version 2.0 and onward are licensed under the terms of the GNU General Public License version 3.0.

Spyglass was originally developed by Devi and is now additionally maintained by Khronion, Zizou, and Aav. The icon was contributed by Vleerian.

Downloads
Spyglass downloads are hosted on Github.

You may also use an online version of Spyglass via Google Colab.


Windows and macOS users should use the pre-packaged release files for their operating system. These versions contain all the files needed to run Spyglass. Linux users should see the instructions for setting up a development environment.

Important note: Microsoft Defender Smartscreen may block execution of programs it doesn't recognize, like Spyglass. You may bypass these warnings by clicking "Run Anyway" on the Smartscreen warning dialog.

After downloading the latest version of Spyglass, run the program and follow the on-screen prompts. Spyglass currently runs in a command prompt window, but a graphical user interface is planned for the future. Spyglass will then create an Excel spreadsheet in the same directory where it is located.

Disclaimer: Although Spyglass is designed to comply with NationStates API rules and rate limits, players are ultimately responsible for the behavior of any scripts, tools, or other programs that they use. Players are encouraged to report any issues or unexpected behavior in this forum thread, or by filing an issue on GitHub.
Last edited by Spyglass Development Team on Mon Mar 21, 2022 10:27 am, edited 1 time in total.

User avatar
Spyglass Development Team
Political Columnist
 
Posts: 2
Founded: Mar 20, 2022
Ex-Nation

Postby Spyglass Development Team » Sun Mar 20, 2022 9:05 pm

reserved

User avatar
Devi
Spokesperson
 
Posts: 165
Founded: Nov 09, 2018
Anarchy

Postby Devi » Sun Mar 20, 2022 9:09 pm

big props to ziz/aav/khron/souls for getting stuff to a cleaner, more modern state and actually vaguely understanding how github works despite 2016 devi's best attempts to make things a pain <3
-puppetmaster behind the thrones of warzones europe and africa-
-deputy overseer of tbh's terra corps-
-gremlin-
-some lame r/d utility i guess-

User avatar
Ever-Wandering Souls
Negotiator
 
Posts: 6774
Founded: Jan 01, 2014
Father Knows Best State

Postby Ever-Wandering Souls » Sun Mar 20, 2022 9:24 pm

Thanks Devi <3

To give a tldr/sorta changelog:
-Spyglass had 4 (raider) pages: Devi's main (stuck in 1.3), Khron's 1.4 fork (upkeep vulnerability fixes), and then Aav and Ziz's 1.5 and 1.6 versions (converted to Py3, added GUI, etc).
-We've now gotten together, made some MORE updates(some time fixes, better documentation, better runtime flags, better handling of dependencies when running from source, added GPLv3.0 license), and gotten the Main back up to date - now hosting 2.0.
-2.0 is currently CLI only, but the GUI will be re-added soon in 2.1, alongside some further codebase improvements.
-We also now have both Windows and Mac executables on the release.
-Documentation referencing 'tagging' has been replaced with 'subject to military gameplay actions' so fendas can use it guilt-free.
-We've also created this thread and the relevant dispatch to give Spyglass a proper home NS-Side
-In case you somehow missed it in the past, any version of Spyglass older than 1.4.4 contains a security vulnerability that allows code injection due to improper sanitization. "KD8NPQ" and "Courelli" (NSLeft, I think?) still have forks based on pre-1.4.4 versions.
Last edited by Ever-Wandering Souls on Sun Mar 20, 2022 9:42 pm, edited 5 times in total.
Proud Raider; General of The Black Hawks, Ret.
TG me anytime; I'm always happy to talk about anything!

The Alicorns (Equestria) wrote:Let them stay, no need to badmouth them...From our view a bunch of nations just came in, seized the delegate position, and changed a few superficial things...we play NationStates differently...there's really no reason for us to be butthurt.
http://www.nationstates.net/page=rmb/postid=8944227
http://www.nationstates.net/page=rmb/postid=8951258

Misley wrote:
Hobbesistan wrote:Don't think I understand the question.
The color or what?..

Jesus, Hobbes, it's 2015. You can't just call someone "the color".

Reploid Productions wrote:Raiders are endlessly creative

How Do I Telegram API?

Omnis delenda est.

User avatar
Merni
Ambassador
 
Posts: 1726
Founded: May 03, 2016
Democratic Socialists

Postby Merni » Sun Mar 20, 2022 10:21 pm

Very cool! One feature that could make it even more useful specifically for detagging is a column on ROs in the region. (i made a rather crude fork of the 1.4.4 version for this, which some people in defending have found useful.)
Donate your free time | GA Committee List | OOC by default
The Labyrinth | Admins: Please allow blocking WA TGs! | TGW Warden Lieutenant
RIP Residency 3.5.16-18.11.21, killed by simplistic calculation
Econ -9.5 Soc -3.85
meth
I've noticed that everybody that is for abortion has already been born. — Ronald Reagan (eww)
When the people are being beaten with a stick, they are not much happier if it is called 'the People’s Stick.' — Mikhail Bakunin (to Karl Marx)
You're supposed to be employing the arts of diplomacy, not the ruddy great thumping sledgehammers of diplomacy. — Ardchoille
The West won the world not by the superiority of its ideas or values or religion [...] but rather by its superiority in applying organised violence. — Samuel P. Huntington (even he said that!)

User avatar
United Calanworie
Envoy
 
Posts: 234
Founded: Dec 12, 2018
Democratic Socialists

Postby United Calanworie » Sun Mar 20, 2022 10:27 pm

Merni wrote:Very cool! One feature that could make it even more useful specifically for detagging is a column on ROs in the region. (i made a rather crude fork of the 1.4.4 version for this, which some people in defending have found useful.)


We've got a large backlog of stuff that we're putting together for a 2.1 release, so I'm honestly not sure we'd have time to put this together any time soon. If you want to fork and write it yourself though, feel free to submit a pull request and we'll definitely figure out how it could merge in ^-^
Discord: Aav#7564
She/Her/Hers
My Projects:
HYPR: TG API software (GitHub) | Spyglass (forum) (GitHub) (Latest Release)

||||||||||||||||||||
||||||||||||||||||||

User avatar
Merni
Ambassador
 
Posts: 1726
Founded: May 03, 2016
Democratic Socialists

Postby Merni » Sun Mar 20, 2022 10:29 pm

United Calanworie wrote:
Merni wrote:Very cool! One feature that could make it even more useful specifically for detagging is a column on ROs in the region. (i made a rather crude fork of the 1.4.4 version for this, which some people in defending have found useful.)


We've got a large backlog of stuff that we're putting together for a 2.1 release, so I'm honestly not sure we'd have time to put this together any time soon. If you want to fork and write it yourself though, feel free to submit a pull request and we'll definitely figure out how it could merge in ^-^

I'll definitely try that when I have the time, thanks.
Donate your free time | GA Committee List | OOC by default
The Labyrinth | Admins: Please allow blocking WA TGs! | TGW Warden Lieutenant
RIP Residency 3.5.16-18.11.21, killed by simplistic calculation
Econ -9.5 Soc -3.85
meth
I've noticed that everybody that is for abortion has already been born. — Ronald Reagan (eww)
When the people are being beaten with a stick, they are not much happier if it is called 'the People’s Stick.' — Mikhail Bakunin (to Karl Marx)
You're supposed to be employing the arts of diplomacy, not the ruddy great thumping sledgehammers of diplomacy. — Ardchoille
The West won the world not by the superiority of its ideas or values or religion [...] but rather by its superiority in applying organised violence. — Samuel P. Huntington (even he said that!)

User avatar
Khronion
Chargé d'Affaires
 
Posts: 440
Founded: Dec 07, 2013
Inoffensive Centrist Democracy

Postby Khronion » Sun Mar 20, 2022 11:00 pm

Hi Merni, I appreciate that you are one of the few folks outside of the current development team who have worked with the code! Personally, I'm touched to see that many people across NS are still using Spyglass over its nearly six year history, and would love to see your old code (and any others) make its way back as a pull request in the future.

User avatar
Ever-Wandering Souls
Negotiator
 
Posts: 6774
Founded: Jan 01, 2014
Father Knows Best State

Postby Ever-Wandering Souls » Thu Aug 11, 2022 1:38 am

FYI: (probably) all versions of spyglass, ever, broke in the last day or two, likely due to a minor change on the NS end that broke some poor code in Spyglass related to downloading and saving the regions dump. A likely fix has been found, and will be implemented to the repository ASAP.

In the meantime, users can circumvent the bugged portion of the code by manually downloading the current data dump from https://www.nationstates.net/pages/regions.xml.gz and placing that file in the same folder Spyglass runs from - then in the initial options when running Spyglass, selecting the option to use the already-downloaded data dump, NOT download a new one.
Proud Raider; General of The Black Hawks, Ret.
TG me anytime; I'm always happy to talk about anything!

The Alicorns (Equestria) wrote:Let them stay, no need to badmouth them...From our view a bunch of nations just came in, seized the delegate position, and changed a few superficial things...we play NationStates differently...there's really no reason for us to be butthurt.
http://www.nationstates.net/page=rmb/postid=8944227
http://www.nationstates.net/page=rmb/postid=8951258

Misley wrote:
Hobbesistan wrote:Don't think I understand the question.
The color or what?..

Jesus, Hobbes, it's 2015. You can't just call someone "the color".

Reploid Productions wrote:Raiders are endlessly creative

How Do I Telegram API?

Omnis delenda est.

User avatar
Ever-Wandering Souls
Negotiator
 
Posts: 6774
Founded: Jan 01, 2014
Father Knows Best State

Postby Ever-Wandering Souls » Thu Aug 11, 2022 2:50 pm

Update: v2.0.2 resolves the issue. https://github.com/Derpseh/Spyglass/releases/tag/v2.0.2

"Now everyone will HAVE to update their old forks, yay" :twisted: :lol2:
Proud Raider; General of The Black Hawks, Ret.
TG me anytime; I'm always happy to talk about anything!

The Alicorns (Equestria) wrote:Let them stay, no need to badmouth them...From our view a bunch of nations just came in, seized the delegate position, and changed a few superficial things...we play NationStates differently...there's really no reason for us to be butthurt.
http://www.nationstates.net/page=rmb/postid=8944227
http://www.nationstates.net/page=rmb/postid=8951258

Misley wrote:
Hobbesistan wrote:Don't think I understand the question.
The color or what?..

Jesus, Hobbes, it's 2015. You can't just call someone "the color".

Reploid Productions wrote:Raiders are endlessly creative

How Do I Telegram API?

Omnis delenda est.


Advertisement

Remove ads

Return to Technical

Who is online

Users browsing this forum: Ungrias

Advertisement

Remove ads