{"id":16752012,"url":"https://github.com/pennyhow/schengulator","last_synced_at":"2025-04-10T15:51:27.878Z","repository":{"id":57464334,"uuid":"442566742","full_name":"PennyHow/schengulator","owner":"PennyHow","description":"Schengulator is a tool to calculate how many days an individual has been in Schengen countries out of a specified 180-day period","archived":false,"fork":false,"pushed_at":"2024-01-18T20:45:56.000Z","size":325,"stargazers_count":3,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-09-25T09:16:19.389Z","etag":null,"topics":["90-180","90days","europe","schengen","travel","visa"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PennyHow.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-12-28T19:42:01.000Z","updated_at":"2024-04-23T05:24:37.000Z","dependencies_parsed_at":"2022-09-19T05:30:41.161Z","dependency_job_id":"af74bb52-d468-40c9-aaa0-6dae8a1c6386","html_url":"https://github.com/PennyHow/schengulator","commit_stats":{"total_commits":4,"total_committers":2,"mean_commits":2.0,"dds":0.25,"last_synced_commit":"d58c275505a01003e110eb80d7f4c88f9408f75b"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PennyHow%2Fschengulator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PennyHow%2Fschengulator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PennyHow%2Fschengulator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PennyHow%2Fschengulator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PennyHow","download_url":"https://codeload.github.com/PennyHow/schengulator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248245089,"owners_count":21071413,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["90-180","90days","europe","schengen","travel","visa"],"created_at":"2024-10-13T02:45:37.248Z","updated_at":"2025-04-10T15:51:27.861Z","avatar_url":"https://github.com/PennyHow.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Schengulator\n\n[![Documentation Status](https://readthedocs.org/projects/schengulator/badge/?version=latest)](https://schengulator.readthedocs.io/en/latest/?badge=latest) [![PyPI version](https://badge.fury.io/py/schengulator.svg)](https://badge.fury.io/py/schengulator)\n\nSchengulator is a tool to calculate how many days an individual has been in Schengen countries out of a specified 180-day period.\n\n## The Schengen Visa Rule\n\nThe schengulator determines the number of days spent and remaining based on the 90/180-day Schengen Visa Rule, where an individual can stay in Schengen countries for 90 days out of an 180 day time period. The 180-day window is defined as:\n    \n*\"The 180-day period keeps rolling. Therefore, anytime you wish to enter the Schengen, you just have to count backwards the last 180 days, and see if you have been present in the Schengen for more than 90 days throughout that period\"* (as stated [here](https://www.schengenvisainfo.com/visa-calculator))\n\nTherefore, schengulator calculates the days spent in the Schengen area based on the 180 days prior to a user-defined date.\n\nFor more on the Schengen Visa Rule, see these links:\n+ [Schengen visa info](https://www.schengenvisainfo.com)\n+ [The 90/180-day rule made easy](https://newlandchase.com/the-schengen-areas-90-180-day-rule-made-easy/)\n+ [UK Government on visa permits in Europe](https://www.gov.uk/guidance/check-if-you-need-a-visa-or-permit-for-europe)\n+ [The Schengen rule: here's how it works](https://www.frenchentree.com/brexit/eu-90-180-day-rule-heres-how-it-works/)\n\nThere are many Schengen stay calculators available online or as apps. The purpose of schengulator is to create a workflow that is **transparent** (i.e. you can see the workings) and **non-repetitive** (i.e. you don't have to log each and every one of your trips to the Schengen area every time you need to use the tool).\n \n\n## Quickstart\nTo get started, install schengulator using pip.\n\n```python\npip install schengulator\n```\n\nCheck that the package works by opening a python console and importing it.\n\n```python\npython3\nimport schengulator\n```\n\nThere are a number of examples in the scripts provided in the [examples](https://github.com/PennyHow/schengulator/tree/main/examples) directory of the [schengulator Github repository](https://github.com/PennyHow/schengulator) to test the installation and see how it works. \n\n```python\nfrom schengulator.schengenstay import SchengenStay\nfrom schengulator.check_stay import check_stay\nfrom schengulator.check_days_left import check_days_left\nfrom schengulator.stays_from_csv import stays_from_csv\n\n# Example 1. Check Schengen stays from specific date using SchengenStay obj\n#Initialise Schengen evaluation from 01/05/2022\nss = SchengenStay('2022-05-01')\n\n#Add all stays\nss.add_stay('2021-07-01', '2021-07-15')         # Holiday in Greece\nss.add_stay('2021-09-03', '2021-09-08')         # Business trip in The Netherlands\nss.add_stay('2021-09-20', '2021-09-25')         # Visiting family in Belgium\nss.add_stay('2021-12-20', '2022-01-03')         # Family Christmas in Belgium\nss.add_stay('2022-04-18', '2022-05-01')         # Proposed holiday to Italy\n\n#Check number of days spent in Schengen on 01/05/2022\nflag = ss.check_days()\nif flag==True:\n    print('All okay!')\n    \n   \n# Example 2. Check Schengen stays for all dates in proposed future stay\n#Create list of all stays\ntrips = [['2021-07-01','2021-07-15'],         # Holiday in Greece\n        ['2021-09-03', '2021-09-08'],         # Business trip in The Netherlands\n        ['2021-09-20', '2021-09-25'],         # Visiting family in Belgium\n        ['2021-12-20', '2022-01-03'],         # Family Christmas in Belgium\n        ['2022-04-18', '2022-05-01']]         # Proposed holiday to Italy\n\n#Check if new stay is within Schengen 90-day limits\ncheck_stay(['2022-04-18', '2022-05-01'], trips[:-1])\n\n#See how many days left in Schengen after proposed trip\ncheck_days_left(trips)\n\n\n# Example 3. Check Schengen stays from CSV file\n#Import stays from csv file\ninfile = 'example_stays.csv'\ncsv_trips = stays_from_csv(infile)\n\n#Check if new trip is within Schengen 90-day limits\nnew_trip = ['2022-01-05', '2022-01-20']\ncheck_stay(new_trip, csv_trips)\n\n#Check how many days left in Schengen after new trip\ncsv_trips.append(new_trip)\ncheck_days_left(csv_trips, d=new_trip[1]) \n```\n\n## Acknowledgements\nThis tool was inspired by these related python repositories:\n+ [schengen](https://github.com/weddige/schengen)\n+ [schengencalc](https://github.com/nuno-filipe/schengencalc)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpennyhow%2Fschengulator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpennyhow%2Fschengulator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpennyhow%2Fschengulator/lists"}