geoinfopy 0.1.0
Un package Python pour la géographie
Requires Python: >=3.6


# geoinfopy`

geoinfopy` is a python package that provides comprehensive geographical information about countries and continents. It allows you to obtain details such as the capital, population, area, official languages, currencies, timezones, flag, subregion, and neighboring countries of a given country. All data is stored locally, enabling offline use.

## Installation

To install the geoinfopy` package, make sure you have python 3.x installed. You can install the package directly from 

### pip install geoinfopy


## Usage

### Available Functions

#### Continent Functions

- **`get_continents()`**

  Returns the list of available continents.

  from geoinfopy import get_continents
  
  continents = get_continents()

  print(continents)


  **Example Output:**


  ['Africa', 'Europe']


- **`get_countries(continent)`**

  Returns the list of countries in a given continent.


  from geoinfopy import get_countries
  
  countries = get_countries('Africa')

  print(countries)


  **Example Output:**


  ['Nigeria', 'Egypt']


#### Country Information Functions

- **`get_capital(country_name)`**

  Returns the capital of a given country.


  from geoinfopy import get_capital
  
  capital = get_capital('Nigeria')

  print(capital)


  **Example Output:**


  'Abuja'


- **`get_population(country_name)`**

  Returns the population of a given country.


  from geoinfopy import get_population
  
  population = get_population('Egypt')

  print(population)


  **Example Output:**


  102334404


- **`get_area(country_name)`**

  Returns the area of a given country in kmÂ².


  from geoinfopy import get_area
  
  area = get_area('Germany')

  print(area)


  **Example Output:**


  357114


- **`get_languages(country_name)`**

  Returns the list of official languages of a given country.


  from geoinfopy import get_languages
  
  languages = get_languages('France')

  print(languages)


  **Example Output:**


  ['French']


- **`get_currencies(country_name)`**

  Returns the list of currencies of a given country.


  from geoinfopy import get_currencies
  
  currencies = get_currencies('France')

  print(currencies)


  **Example Output:**


  ['EUR']


- **`get_timezones(country_name)`**

  Returns the list of timezones of a given country.


  from geoinfopy import get_timezones
  
  timezones = get_timezones('Egypt')

  print(timezones)


  **Example Output:**


  ['UTC+02:00']


- **`get_flag(country_name)`**

  Returns the URL of the flag of a given country.


  from geoinfopy import get_flag
  
  flag_url = get_flag('Germany')

  print(flag_url)


  **Example Output:**


  'https://flagcdn.com/w320/de.png'


- **`get_subregion(country_name)`**

  Returns the subregion of a given country.


  from geoinfopy import get_subregion
  
  subregion = get_subregion('Nigeria')

  print(subregion)


  **Example Output:**


  'Western Africa'


- **`get_borders(country_name)`**

  Returns the list of neighboring countries of a given country.


  from geoinfopy import get_borders
  
  borders = get_borders('Nigeria')

  print(borders)


  **Example Output:**


  ['NER', 'BEN', 'CMR', 'TCD']


- **`get_all_info(country_name)`**

  Returns all available information about a given country.


  from geoinfopy import get_all_info
  
  all_info = get_all_info('Egypt')

  print(all_info)


  **Example Output:**


  {
      'country': 'Egypt',
      'capital': 'Cairo',
      'population': 102334404,
      'area_km2': 1002450,
      'languages': ['Arabic'],
      'currencies': ['EGP'],
      'timezones': ['UTC+02:00'],
      'flag': 'https://flagcdn.com/w320/eg.png',
      'subregion': 'Northern Africa',
      'borders': ['ISR', 'PSE', 'LBY', 'SDN']
  }