semvec/pypi-packages huggingface dataset:
yxf 1.0.0
Convert from XLSForm to YAML and back
Requires Python: >=3.9
Keywords: xlsform, xlsx, odk, pyxform

# Convert from XLSForm to YAML and back

yxf (short for **Y**AML **X**LS**F**orms) is a converter between XLSForms and
YAML files. With yxf, you can store forms as text-files. This brings a number of
advantages to managing many forms. For example, you can store forms in version
control, view differences between two forms, and easily share updates between
multiple forms.

## Usage

To convert an XLSForm to a YAML file: `python -m yxf form.xlsx`.

By default, the result will be called `form.yaml`, in other words, the same name
as the input file with the extension changed to `.yaml`. You can specify a
different output file name using the `--output othername.yaml` option.

To convert a YAML file to an XLSForm: `python -m yxf form.yaml`.

Here's a screenshot showing the YAML and XLSForm version of a form side-by-side:

![YAML and XLSForm version of a form](https://github.com/Sjlver/yxf/blob/main/docs/yxf-yaml-and-xlsx-side-by-side.png)

### Using Markdown

yxf can generate and read Markdown instead of YAML. The format is taken from
[md2xlsform](https://github.com/joshuaberetta/md2xlsform). This can be useful if
you would like something more compact than YAML, e.g., to paste into a community
forum.

To use Markdown, add a `--markdown` argument to the yxf invocation:

```shell
# Will generate form.md
python -m yxf --markdown form.xlsx
```

## Installation

Get the latest version from the GitHub repo:

```shell
python -m pip install yxf
```

## Features

### Comments in forms

yxf encourages adding comments to XLSForms. It uses a special column labeled `#`
to that end. Other tools ignore this column, so that it can be used for
explanations that are useful to the readers of the `.xlsx` or `.yaml` files.

### Pretty spreadsheets

yxf tries hard to make the XLSForm files look pretty. It is possible to use yxf
just for that purpose, without intending to store forms as YAML files. To do so,
simply convert a form to YAML and back:

```shell
python -m yxf form.xlsx
python -m yxf -o form-pretty.xlsx form.yaml
```

## Validating the form

yxf does not deeply validate forms. If you'd like to make sure that a form is
semantically valid, you can use the `xls2xform` command from the `pyxform`
package:

```shell
python -m pip install pyxform
xls2xform form.xlsx
```

## Development

yxf is still being developed. Feedback and contributions are welcome.
Please open issues in the [issue tracker](https://github.com/Sjlver/yxf/issues).

Please run all of the following before committing:

- Format the code: `black .`
- Run unit tests: `pytest`
- See lint warnings (and please fix them :)): `pylint yxf`

To publish on PyPI:

- Increment the version number in `pyproject.toml`.
- Run `uv build`.
- Upload using `python -m twine upload dist/*`.
debugpython 0.1.1
Example of posting a module to pypi
Requires Python: >=3.12

# debugPython

Example of posting a module to PyPI.

## How to Build

```bash
uv build --no-sources
```

## How to Publish

### Publish to PyPI

```bash
uv publish --token <your_token_from_pypi>
```

### Publish to Test PyPI

```bash
uv publish --publish-url https://test.pypi.org/legacy/ --token <your_token>
```

## Getting API Tokens

- **PyPI**: https://pypi.org/manage/account/token/
- **Test PyPI**: https://test.pypi.org/manage/account/token/
liveisstracker 2.2.1
Interactive 3D globe showing live ISS location
Requires Python: >=3.8

# Live ISS Tracker

🛰️ A simple desktop application and CLI that tracks the real-time location of the International Space Station.

![sample application](output-streamlit.gif)

## Quick Start

This application provides two main commands:
*   `run`: Launches the interactive 3D globe in a desktop window.
*   `location`: Prints the current latitude and longitude of the ISS to the console.

To use these commands, make sure you have a modern version of Python and `uv` installed, then simply run:

```bash
# To run the GUI application
uvx --from liveisstracker iss run

# To get the current location in your terminal
uvx --from liveisstracker iss location
```

## Other Ways to Run

### Using `pipx`

If you have `pipx` installed, you can use it to run the commands in an isolated environment:

```bash
pipx run --spec liveisstracker iss run
pipx run --spec liveisstracker iss location
```

### Using `pip`

You can also install the package directly into your Python environment using `pip`:

```bash
# Install the package
pip install liveisstracker

# Run the commands
iss run
iss location
```

## Development

To contribute to the development of this project, you can set it up locally:

1.  **Clone the repository:**
    ```bash
    git clone https://github.com/manojmanivannan/liveisstracker.git
    cd liveisstracker
    ```

2.  **Run the application commands:**
    The included `run.sh` script uses `uv` to install dependencies and run the app in a local virtual environment. You can pass the subcommands to it:
    ```bash
    # Run the GUI
    ./run.sh run

    # Get the location
    ./run.sh location
    ```

---

### Versioning and Releasing

This project includes an interactive script to simplify the process of versioning and creating new releases.

To create a new version, run:

```bash
./version_tag_push
```

This script will guide you through bumping the version number, creating a new Git tag, and pushing the tag to the remote repository. Pushing a new tag will automatically trigger the GitHub Actions workflow to publish the new version to PyPI.